マリオネットネットワーク
ネットワークは、関数スクリプトを作成するために連結された一連のノードであり、ノードでの定義に従ってコマンドを実行します。完全なネットワークは、マリオネットスクリプトと見なされます。スクリプトはすべて左から右に読み、データは一方向に流れます。ネットワークは2D／平面ビューでのみ作成、編集することができます。
ネットワークを作成する
ネットワークを作成するには：
セレクションツールを使用して、ノードのポート（出力または入力）上の制御点をクリックします。次に、カーソルを移動して別のノードのポートをクリックします。
セレクションツールの変形禁止モードが無効（オフ）になっていることを確認してください。
2つのポートがワイヤで連結されます。任意のノードの出力を、他のノードの複数の入力に連結できます。同様に、複数の出力を単一の入力ノードに連結することもできます。
複雑なネットワークを整理するには、整列コマンドを使用してノードを整列します。ワイヤの連結には影響しません（図形を整列／均等配置するを参照）。
ノードに名前を付ける
ノードに名前を付けるのは、ネットワークを作成して整理する上で重要であり、ラッパーノードに大きな影響を与えます。詳細はマリオネットのラッパー（Wrapper）ノードを参照してください。より複雑なネットワークの個々の段階を覚えておきやすいように、入力ノードと連結先のノードに名前を付けます。ノードに名前を付けるには、ノードを選択して、オブジェクト情報パレットの名前に入力します。
名前を付けた入力ノードは、ラッパーノードのオブジェクト情報パレット上にフィールドとして表示されます。これらのノードに名前を付けると、すばやく認識できるほか、実際のラッパーノードを編集しなくても値を調整できます。
名前を付けた入力ノードは、ラッパーノードにアルファベット順に表示されます。
名前を付けたノードで使用していないポートはラッパーノード上に表示され、他のネットワークに簡単に連結できます。この点でも、ノードに名前を付ける意味は十分にあります。
ネットワークを編集する
ノード間の連結を変更してネットワークを編集するには：
変更するノードまたはワイヤを選択します。ワイヤを選択すると、ネットワークの始点に近い方で連結されているノードが自動的に選択されます。ワイヤの連結の解除は、選択されていないノードからのみ行えるため、必要に応じてもう一方のノードを選択し、ワイヤを変更します。
ポートの制御点を選択し、制御点の連結を解除して移動します。プレビューが表示されます。
連結するポートをクリックします。ワイヤが移動します。
ワイヤの連結の解除は、選択されていないノードからのみ行えます。
あるいは、ネットワークからワイヤを削除するには、制御点を選択して図面の空白部分をクリックします。
1回の操作で、出力ポートに連結されているすべてのワイヤを別の出力ポートに移動することも、すべてのワイヤをネットワークから削除することもできます。
ポートに連結されているすべてのワイヤを一度に移動するには：
移動するポートから入力値を受け取っているノードの1つを選択します。
Ctrlキー（Windows）またはCommandキー（Mac）を押したままにします。
キーを押したままポートの制御点を選択し、制御点の連結を解除して移動します。連結されているすべてのワイヤのプレビューが表示されます。
連結するポートをクリックしてから、キーを離します。
あるいは、図面の空白部分をクリックしてワイヤを削除します。
連結先の出力ポートにすでにワイヤが連結されている場合は、ワイヤ再接続オプションダイアログボックスが開きます。ポートに連結されている既存のワイヤに新しいワイヤを追加するか、既存のワイヤを削除して新しいワイヤに置き換えるかを選択します。
ワイヤが移動します。
一方の出力ポートに連結されているすべてのワイヤを別の出力ポートに移動するには、Ctrlキー（Windows）またはCommandキー（Mac）を押したまま操作します。
ノードを削除すると、関連付けられたワイヤもすべて削除されます。
マリオネットスクリプトを実行する
|
コマンド |
パス |
|
マリオネットスクリプトを実行 |
コンテキストメニュー |
マリオネットスクリプトを実行するには、ネットワーク内の任意のノードを右クリックし、コマンドを選択します。または、オブジェクト情報パレットで実行を選択します。
スクリプトの実行時にエラーが発生すると、実行エラーダイアログボックスが開き、エラーの種類に関する情報とスクリプトの場所が表示されます。
マリオネットの設定では、スクリプトの実行後にどのオブジェクトを選択状態のままにするかを決定できます。現在のノードを選択するか、またはスクリプトによって生成されたオブジェクトを選択するかを選べます。詳細は、マリオネットツールを使用してノードを配置するを参照してください。
スクリプトの実行が完了すると、スクリプトを実行して作成されたオブジェクトはグループ化されます。スクリプトを続けて実行すると、以前にスクリプトを実行して作成した、グループ化されている図形が上書きされます。図形を残すには、グループの名前を変更するか、図形のグループを解除します。
マリオネットスクリプトをデバッグする
マリオネットツールのデバッグモードを使用すると、期待どおりに機能していないネットワークのトラブルシューティングを行うことができます。ラップされていないスクリプトをデバッグしたり、ラッパーノードまたはオブジェクトノードをダブルクリックして、その下層にあるスクリプトをデバッグしたりできます。デバッグモードでは、各出力ポートの隣に数字が表示され、その出力ポートから連結された入力ポートに送られる値の数が示されます。ワイヤをクリックすると、マリオネット接続ワイヤの値ダイアログボックスが開き、ワイヤを通過する値が表示されます。ダイアログボックスを閉じるとスクリプトが実行されます。
ワイヤをクリックするたびにスクリプトが実行されるのを回避するには、ツールバーの設定をクリックしてデバッグモードで最後に実行された値を取得するを選択します。このオプションを選択すると、スクリプトを再実行せずにワイヤの値が表示されます。
マリオネット設定ダイアログボックスで実行時間を表示（デバッグモードのみ）を選択している場合は、ネットワークの各ノードの下にあるテキストに、スクリプトの実行時にノードの実行にかかった時間が表示されます。入力専用ノード以外のすべてのノードには、ネットワークの開始から経過した合計実行時間も表示されます。
