ボクセラミング・スタジ‪オ‬ 4+

[ゲームモード使用可能] ボクセラミング・スタジオは、プログラミング初心者とジェネラティブアーティストのための、ARプログラミング学習アプリです。Python, JavaScript, Ruby, Swift and Scratch3 MOD でボクセルアートをプログラミングできます。

## ボクセラミングとは

ボクセラミング = ボクセル + プログラミング

ボクセラミング・スタジオは、ARを使ったプログラミング学習アプリです。パソコンでプログラムしたボクセル（ピクセルと同様に3D空間における最小単位の立方体）を仮想空間上に配置して遊ぶことができます。

## 使い方

### 内蔵コードエディターからボクセルアードを作成する

ver. 1.6.0以降は、内蔵のコードエディターからコードの作成、実行、セーブ、ロードができるようになりました。サンプルコードを参考に独自のボクセルアートを作成してください。

### パソコンの準備

パソコンは、Windows、Macの両対応です。お使いのパソコンに、プログラミング言語（Python、Node.js、Ruby、Swift）がインストールされていないときは、使いたい言語をインストールしてください。パソコンとデバイスのデータ通信はインターネット回線を使います（同じ回線に繋がなくてもよい）。以上で、パソコンの準備ができました。

### ベースアンカーの設置

ボクセラミングアプリを起動します。「Show Base Anchor」ボタンをタップすると、ベースアンカー（白と黒の平面）が表示されます。このベースアンカーを基準にして、ボクセルアートを配置できます。これで準備完了です。なお、ベースアンカーをドラッグして位置を変更できます。

### ボクセルのモデリング（プログラミング）

パソコン（Windows、Mac）でボクセルを設置するための「ボクセルデータ」をプログラミングします。ボクセルデータには、「位置、色、サイズ、設置する間隔など」の情報が含まれます。対応の言語は、Scratch3 MOD、Python、JavaScript (Node.js)、Ruby、Swiftです。

スクリプトを作成しましょう。[sampleフォルダー](https://github.com/creativival/voxelamming/tree/main/sample) のスクリプトを参考にしてください。WebSocketサーバーのルームに接続するために、変数room_name（roomName）をデバイスの画面中央に表示されている文字列に合わせることを忘れないようにしてください。

次に、各言語の繰り返し文や条件式などを使って、ボクセルデータを作成します。ボクセルの位置は、ベースアンカーを基準にして、x軸、y軸、z軸の値を指定します。x軸は左右、y軸は上下、z軸は奥行き（手前がプラス）を表します（単位はセンチメートル）。ボクセルの大きさは、1.0cmを基準にして小数で指定します。色はRGB値で0から1までの小数で指定します。そして、ボクセルを設置する間隔を秒で指定します。ボクセルを設置する間隔を指定することで、ボクセルが一気に設置されるのではなく、時間をかけて設置されるようになります。

### ARボクセルのビルド

スクリプトを実行すると、WebSocket通信でボクセルデータがデバイスに送信されます。データが受信できたら、デバイス画面の平面アンカーを基準にして、ARボクセルが設置されます。

＊ WebSocketサーバーが休止しているとき、データ送信が失敗する場合があります。そのときは、しばらく待ってから再度実行してください。