Spreadsheet
Google Sheet、.csv または .xlsx ファイルからデータを読み取ります。
File - Assets Window から Google Sheet、.csv または .xlsx アセットをドラッグします。
Excel Sheet - .xlsx アセットからシート（タブ）を選択します。
Column Title - スプレッドシートから列を選択します。スプレッドシートの最初の行は予約されており、このリストの入力に使用されます。
Spreadsheet Utility は単一の列からのみデータを出力できます。同じアセットから複数の列を使用するには、出力する列ごとに Spreadsheet Utility を作成します。
Factorize - チェックすると、テキストの列を値に変換できます。例えば、Summer, Spring, Summer, Summer というテキストを含むデータ列は、値のリスト 1, 0, 1, 1 に変換できます。生成されたリストはアルファベット順に並べられます。
Factorize を使用する場合、パフォーマンス上の理由から、アセットも「factorize」する必要があります。Assets Window でアセットを右クリックし、Factorize をチェックします。
Remapping - データ内の最小値と最大値を基準に数値を再マッピングします。例えば、値 1 を 300px の高さの矩形で表現する必要がある棒グラフを作成する場合に使用できます。
- None - 再マッピングが無効です。
- Area Range - Area Range を参照してください。
- Number Range - Number Range を参照してください。
- Number Range to Color - Number Range to Color を参照してください。
データ内の最小値が 0、最大値が 10 で、単純な白黒グラデーションがある場合、値 0 は黒、値 10 は白を出力し、値 5 は 50% グレーに再マッピングされます。
Fixed Row - チェックすると、Row Index で指定された行の内容を出力します（タイトル行は含まれません）。Dynamic Rendering に便利です。
Row Index - 出力する行を指定します。値 0 はスプレッドシートの1行目を出力します（0行目は Column Title 用に予約されています）。
Row Offset - Row Index に値を加減算します。
Use Every Nth Row - 最初の行と、その後 N 行ごと（N = 値）にのみサンプリングします。
Row Count - 選択された列の行数を出力する読み取り専用属性です。
Column Count - データ内の列数を出力する読み取り専用属性です。カウントは最初の列から始まり、データを含む最後の列で終了することに注意してください。例えば、Google Sheet 経由で以下のデータをインポートした場合、Column Count として 7（列 A-G）が返されます：
| A | B | C | D | E | F | G | H | I |
|---|---|---|---|---|---|---|---|---|
| 1 | 1 | 1 |
.csv ファイルではこれが異なる場合があり、空の列も定義される可能性があることに注意してください。例えば、ColumnA,ColumnB,,,,, のカンマの後に定義された列は Column Count に含まれます。
Interpolate - チェックすると、列間でデータをブレンドできます。これには Column Title をアニメーション化する必要があり、Value Behaviour を Column Title に接続し、Value の Value 属性にキーフレームを設定することで実現できます。注意 - 値 0 は最初の列を表します。
Output Mode - レイヤーの出力を設定します：
- Data - 生データを出力します。
- Sort Order (Ascending) - 列データを最小から最大値のソート順で出力します。
- Sort Order (Descending) - 列データを最大から最小値のソート順で出力します。
Sort Order は列内の値を取得し、それらのソート順を出力します。例えば、Data という列に以下の値が含まれ、Output Mode が Sort Order (Ascending) に設定されている場合、Spreadsheet は Sort Order の値を出力します。
| Data | Sort Order |
|---|---|
| 56 | 3 |
| 3 | 0 |
| 17 | 1 |
| 40 | 2 |
Output Mode が Sort Order (Descending) に設定されている場合、Sort Order は逆になります。これはリーダーボードなどに便利です。
| Data | Sort Order |
|---|---|
| 56 | 0 |
| 3 | 3 |
| 17 | 2 |
| 40 | 1 |
出力は、例えば Duplicator の Shape Position Y を設定して、Linear Distribution で棒グラフの最大の棒を上に、最小の棒を下に配置するために使用できます。その後、Remapping を使用して Sort Order を意味のある位置値に変換できます。例えば、Sort Order 0, 1, 2 を値 0, 50, 100 に変換します。
- Text Shape、Duplicator、Spreadsheet Utility を作成します。
- ‘Name’ というタイトルの行とその下に複数の名前が記載された
.csvファイルを作成します。
Name,Ringo,John,George,Paul.csvファイルを Assets Window にインポートします。.csvを Spreadsheet Utility の File 属性にドラッグします。- Spreadsheet Utility で Column Title を ‘Name’ に設定します。
- 接続 textShape.id→duplicator.inputShapes。
- Duplicator の Distribution を Linear に設定します。
- Duplicator の Direction を Vertical に設定します。
- Duplicator の Count を 4 に設定します。
- 接続 spreadsheet.id→textShape.string。
.csv の最初の4つの名前（タイトルを除く）が表示されます。4つより多いか少ない名前の場合は、Duplicator の Count Y を調整してください。
- 以下のデータを含む
Google Sheet、.csvまたは.xlsxを作成します：
| Label | Value | Color |
|---|---|---|
| 235 | #00acee | |
| 1135 | #c13584 | |
| YouTube | 101 | #ff0000 |
| Vimeo | 2301 | #1ab7ea |
| TikTok | 764 | #69c9d0 |
- Google Sheet を使用する場合、Link Sharing が Anyone with the link に設定されていることを確認します。
- Assets Window 経由で
Google Sheet、.csvまたは.xlsxをインポートします。 - アセットを Viewport にドラッグします（これにより Spreadsheet Utility が作成され、アセットが接続されます）。
- Spreadsheet Utility で、Column Title を Value に設定します。
- Rectangle を作成します。
- spreadsheet.id→rectangle.size.height を接続します。
- Rectangle を選択し、Shelf の Duplicator アイコンをクリックします。
- Distribution を Linear に設定します。
- Count を 5 に設定します。
この時点で、データの Value 列の各行に応じた高さの5つの矩形ができているはずです。矩形を「フロア」に固定するには、Align Behaviour を使用できます。
- Align を作成します。
- align.id→rectangle.deformers を接続します。
- Align Behaviour で、Y を 1 に設定します。
データに小さい/大きい値が含まれている場合は、Composition により適した結果を生成するために値を再マッピングする必要があるかもしれません。
- Spreadsheet Utility で、Remapping を Number Range に設定します。
- Source Minimum を 0 に設定します。
- Source Maximum を 2500 に設定します。これらの2つの値は、データのおおよその範囲を含みます。
- Minimum を 0 に設定します。
- Maximum を 500 に設定します。
データ内の値 0 は 0 として出力され、値 2500 は 500 として出力されるようになります。この例では、実質的にすべての値を 2500/500 = 5 で割っているため、値 1000 は 200 に再マッピングされます。
通貨記号（例：£ € $）を含むフィールドは数値として認識されます。例えば、£123.45 は数値属性に接続されると 123.45 として解釈されます。
値に k、M、または B の接尾辞が付いている場合、結果はそれぞれ千、百万、十億倍されます。例えば、1.5k は数値属性に接続されると 1500 に変換されます。