導入
ピンを接続することで、1つのノードから別のノードへデータを送信できます。接続されていないピンは直接編集可能です。
ピンの色はデータタイプを表します。すべてのデータタイプは、Pin Data Types ドキュメントで確認できます。
入力ピンと出力ピン
入力ピンはノードの左側に配置され、出力ピンはノードの右側に配置されます:
入力ピンは1つの接続しか持てませんが、出力ピンは複数の入力ピンをターゲットにできます:
ピーキング
ピーキングは、接続を通じて転送されている情報またはデータ、またはピンに存在するデータを表示します。
これを行うには、CTRLキーを押したままマウスカーソルをピンまたは接続の上に移動します:
NOTE: ピーカーウィンドウの上部の赤い線は、モジュールが使用されていないことを示します。
コレクションとベクターのデータタイプの場合、ピーカーのウィンドウからデータが溢れた際に、マウスのスクロールホイールでデータをスクロールできます:
ピン値パネル
ノードが選択されると、その入力ピンがピン値パネルに表示されます。
選択されたノードには、ピン値パネルに名前とタイプの値が表示されます。
名前は自動的に生成されます。ファイルを新しいノードとしてドラッグアンドドロップすると、ノードの名前はファイルの名前を使用し、ノードのタイプではなくなります。
名前は、複合体内で既に使用されている名前には変更できません。
入力ピンに接続がない場合、ピン値パネルでピンを変更できます。
入力ピンが接続されている場合、ピン値パネルでピンを変更できません。その値はグレー表示されます。
数値値の編集
数値値は、ピン値の編集フィールドからマウスをドラッグして正確に設定できます。
スカラー値とダブル値の場合、デフォルトの変更量は 0.01（1/100）です。
Shiftキーを押しながら変更すると、10倍（0.1）に増加します。
CTRLキーを押しながら変更すると、100倍（1）に増加します。
ShiftキーとCTRLキーを同時に押しながら変更すると、10倍（0.001）に減少します。
ALTキーを押しながらクリックすると、カーソル（テキスト選択カーソル）前の桁の小数点が変更されます：
これらの操作は、マウスではなくキーボードの上下矢印キーを使用しても可能です。また、Dash Scalar モジュールでスライダーに変換されたピンでも同様です。
整数も同様に変更できますが、変更量はスカラー値の100倍になります。
式
数値は式を使用して変更でき、基本的な計算が可能です。
このテキストをクリックすると、利用可能な式のリストが表示されます。
Available operators:
-
- +: Addition
- -: Subtraction
- *: Multiplication
- /: Division
- ^: Exponentiation
Available functions:
-
- abs(x): Absolute value
- acos(x): Arc cosine
- atan(x): Arc tangent
- asin(x): Arc sine
- avg(a, b): Average
- ceil(x): Ceiling
- clamp(x, a, b): Clamp
- cos(x): Cosine
- exp(x): Exponential
- floor(x): Floor
- inv(x): Inverse, calculated as 1 - x
- lerp(a, b, f): Interpolation
- log(x): Logarithm
- max(a, b): Maximum
- min(a, b): Minimum
- mod(a, b): Modulus
- modb(a, b, base): Modulus with base
- rec(x): Reciprocal, 1 / x
- round(x): Round
- sin(x): Sine
- sqr(x): Square
- sqrt(x): Square root
- tan(x): Tangent
- unlerp(x, a, b): Inverse interpolation
NOTE: Functions are computed first within expressions, trigonometric functions operate in degrees, and functions can be used without parentheses.
Builtin Constants:
-
- pi: π, 3.141593
- e: Euler's Number, 2.718282
-
特殊複合体: 式は編集可能な式を使用可能にし、追加の機能を提供します。
例は[チュートリアル]: スクリプト\式.xcompの複合体をご覧ください。
キーボードナビゲーション
キーボードを使用して、ピン値パネルでピンを移動したり変更したりできます。
上矢印と下矢印ボタンで選択中のピンを変更できます。Enterボタンでピンの編集と保存が可能です。
左矢印と右矢印は、Enter ボタンを使用せずにトグル（論理ピン）、リスト、数値を変更できます。
ピン値のコピー
ピンの値をコピーするには、ピンの名前を右クリックし、コピーを選択します：
その後、同様のタイプのピンに値を貼り付けることができます。フローエディター内のピンでもコピー＆ペーストが可能です：
ピン値のドラッグアンドドロップ
ピンの値をコピーする別の方法は、ピンの名前をドラッグして、別のピンの値フィールドにドロップすることです。フローエディターにドロップすると、ピンの値をコピーしたモジュールが作成されます：
ファイル参照の変更
ファイルの場所を指定するピンは、ファイルをドラッグアンドドロップで受け付けることができます：
3点リーダーをクリックすると、類似のファイルタイプを検索するブラウザウィンドウが開きます：
ブラウザウィンドウでInstant previewが選択されている場合、選択したファイルは「開く」ボタンを押さなくても即時で開いて再生されます:
これは、多くのファイルを確認し、プロジェクトやバーチャルワールドでの表示を確認したい場合に特に便利です。
ピン値のフォーマット方式
一部のデータタイプは異なる形式で表現またはフォーマットできます。そのような場合、ピンの値の近くに小さな下向き矢印が表示されます。
ベクターピン値のフォーマット
ベクターピンは、1次元ベクター（（スカラー））、2次元、3次元、4次元、または任意の長さのデータ配列（フリーベクター）を表すことができます。
例えば、フリーベクターモードでは、ベクターはコンマ区切りで追加できます:
NOTE: ベクター内の個々の数値は、マウスをドラッグして変更できます。詳細は数値の変更セクションを参照してください。
一部のモジュールでは、ベクターピンがデフォルトでFree Vector形式で設定されています。一方、通常は数学関連のモジュールでは、デフォルトでScalar形式で設定されています。
Scalar形式には追加の境界ボックスがあり、ScalarとFree Vectorのフォーマットを区別しやすくなっています：
変換ピン値フォーマット
変換ピンは、すべての軸でスケールが同じ（Pos-Rot-ScalUni）または軸ごとにスケールが異なる（Pos-Rot-ScalXYZ）変換を表すことができます。または、4x4変換マトリックスとして表すこともできます：
色ピン値フォーマット
色 ピンには多くのオプションがあります。
RGB は赤、緑、青を表します。Hex は16進数のHTMLカラーコードです。HSB は色相、彩度、明度を表します。HSL は色相、彩度、明度を表します。そしてA はアルファ値用の追加フィールドです。
ピンデータタイプ変換
一部のピンデータタイプは他のデータタイプに直接変換可能です。この画像は可能な変換を示しています:
注: ベクターは上記のすべてのデータタイプを変換可能です。
NOTE: コピーベクターモジュールはCopyと名付けられています。
これらの変換はモジュール間でのみ機能し、異なるデータタイプのピンに露出（点線）させることはできません。
他のピンデータタイプの変換を行うモジュールも存在します。例えば、スカラーからテキストへの変換モジュールなどです。
ピンと接続のツールチップ
マウス ポインターがピンまたは接続の上にある場合、データ型は左下隅に表示されます:
ビデオ プレイヤーの位置 (ダブル精度スカラー) はノードの名前 : ピン名 (データ型) を表します。
参照ピン
これらのピン タイプはデータの流れを表すものではなく、モジュール間の特定の関係を指定します。
モジュールの最下部に配置されています：
リセットとデフォルト設定
ほとんどのピンデータタイプにはデフォルト値を設定できます。ダッシュとコピーモジュールには、この目的のための「デフォルト使用」と「デフォルトピン」が用意されています。
ピンを右クリックし、「リセット」オプションを選択することで、デフォルト値を取得できます：
ダッシュボードパネルとコントロールボードでもピンをリセットできます。
リセットオプションは、複合ファイルに保存された値に戻します。
入力キャプチャ
ほとんどのピンデータタイプは、接続経由で受信しているデータをキャプチャできます。受信ピンを右クリックし、入力キャプチャを選択します：
入力キャプチャを押すと、そのフレームでピンが受信したデータがピンの値として記録されます（この値はピンが何も接続されていない場合に使用されます）：
このキャプチャされた値は、ピンを右クリックし、コピーオプションを選択することで簡単にコピーできます：
コレクションなどの複雑なデータをキャプチャするには、テキストブロックモジュールと、データをテキストに変換するモジュール（例：コレクションからJSONモジュール）を使用できます。テキストブロックモジュールにキャプチャされたデータは、テキスト編集ピンオプションを使用して簡単に編集できます：
ダッシュモジュール
ダッシュモジュールはピンをスライダーとして公開できます：
ピンコレクターの後にダッシュモジュールを接続すると、スライダーがコントロールボードのピン値パネルに表示されます。
NOTE: ピンの外観は、特定の名前を付けることでカスタマイズできます。例えば、これらの命名規則を使用してドロップダウンを作成できます。このカスタマイズについては、 Special Pin Names ページで説明されています。
トランスマット
トランスマットは、接続を使用せずにピンの値を転送できます。
これは、多くのコンパウンドを含む複雑なプロジェクトで特に便利です。Transmit モジュールは、コンパウンド同士がピンを接続せずにデータを転送できるようにします:
Transmit モジュールのInto Tunnel ピンが設定されると、Flow Editor がトンネルを登録し、他の Transmit モジュールはFrom Tunnel ピンを設定することでトンネルを使用できます。
Studio Camera コンパウンド（例: VirtualCam_3-Cam.xcomp）には、複数のトンネルが組み込まれています。これらは、シーン内のイベントをトリガーしたり、カメラコンパウンドの状態に基づいてロジックを構築したりするのに使用できます。
Global Irradiance Env Map と Global Specular Env Map は、環境マップ用に保持される特別なグローバルトンネル名です。これらのトンネルは、IBL シェーダーで使用されます。
Set ... Pin Modules
Set Scalar Pin などのモジュールは、モジュールに接続せずにモジュールのピン値を設定できます。
混乱を招く可能性があるため、ごく特殊な場合にのみ使用してください。ピン値が変更され、何が変更されたのかがわからなくなる状況に陥る可能性があります。
以下のスクリーンショットでは、Get Camera Transform トリガーを押すと、ダッシュボードの Transform ピンに Camera Tracking モジュールの変換が記入されます。
Set Transformation Pin のモジュールピンはモジュール名を指します。上記のスクリーンショットでは、Transform copy という名前のモジュールです。
複合体内のモジュール名にはバックスラッシュ文字 「\」 を使用して参照できます。一方、複合体外のモジュールには 「..\」 を使用してアクセスできます。
ここで Module ピンは、ロックされた TrackedCam 複合体内のピンコレクターの名前を指します：
TrackedCam 複合体内の参照されたピンコレクターとコントロールボード上のピンコレクター：
