導入
モジュールはAximmetry Composerの基礎となる基本要素です。単純な値の加算から、3Dシーンの深度計算のような複雑な機能まで、幅広い機能を提供します。
モジュールの挿入
新しいモジュールを追加する一般的な方法は、モジュール挿入ウィンドウを使用することです。
フローエディター内の空いている領域を右クリックすると、モジュールを挿入...というオプションを含むリストが表示されます：
NOTE: 代替方法として、モジュールタイプブラウザパネル（ショートカット: F6）を使用してモジュールを挿入することもできます。
「モジュールを挿入...」オプションを選択すると、多くのモジュールから選択できる「モジュールを挿入」ウィンドウが表示されます。
このウィンドウには、検索フィールド、タイプカテゴリブラウザ、選択フィールドが含まれます：
「モジュールを挿入」ウィンドウ内のモジュールの色は、フローエディター内のノードの色を表します。
3D や Audio などの主要なカテゴリを選択すると、モジュールはサブカテゴリごとに分類され、その後アルファベット順に表示されます。
モジュール自動命名
Flow Editor にモジュールを追加すると、そのタイプと同じ名前が自動的に付与されます。同じ名前が既に存在するノードがある場合、モジュールの名前は番号がインクリメントされます。
ここでは、フローに2つの「Copy Transformation」モジュールが追加されました。フローに既に「Copy Transformation」という名前が存在するため、2つ目のモジュールは自動的に「Copy Transformation 2」と命名されました。
この名前は、モジュールのNameフィールドで変更可能です。モジュールのTypeも表示されています：
モジュールタイプの変更
既に追加されたモジュールのタイプを変更するには、モジュールを右クリックし、Change Module Type... オプションを選択します。この方法では、可能な限り接続を維持します：
Module Execution
プロジェクトのハードウェア負荷の最適化は、実現可能なことに大きな影響を与える可能性があります。これは特にライブ制作において重要です。
このような最適化は、フローエディターが使用されていないモジュールを実行しないようにするものです。これはAximmetryによって自動的に行われ、ほとんどのケースではプロジェクトに影響しません。
ただし、混乱を招く場合もあるため、この段落で詳細に説明します。
モジュールが使用されていないとは、モジュールの出力ピンが、最終的に出力に接続されるものとは接続されていない状態を指します。このような場合、モジュールは実行されません。出力は、ビデオ出力、プレビューパネル、レコーダーモジュール、またはCTRLキーを押しながらマウスカーソルを接続上にホバーさせた際に表示される「ピーカー」など、複数のものを含む可能性があります。
ピーカーの実行インジケーター
モジュールが実行されていない場合、ピーカーのウィンドウの上部に赤い線が表示されます：
実行中のモジュールをピーカーで確認した場合、赤い線は表示されません。
Video Player モジュールは、アクティブなビデオ出力に接続されているため実行されています。
2つのモジュール間の接続をピーキングする場合、実行インジケーターはソースモジュールが実行されていないことを示します。ターゲットモジュールのみが実行されていない場合、実行インジケーターは表示されません。
他のノードに接続されていないモジュールの入力ピンには、実行インジケーターは表示されません。
モジュールの実行をプレビューパネルで確認する例
この例では、ビデオプレーヤーモジュールは出力に接続されていないため、実行または再生されていません。これは、ピーカーの実行インジケーターのほかに、ビデオプレーヤーの位置からも確認できます。
ビデオプレーヤーモジュールが出力に接続されている間、動画が再生され、この事実は出力ピンの位置値が継続的に増加することで確認できます。
ビデオプレーヤーモジュールが出力に接続されていない場合、動画は再生されず、その位置は0にリセットされます。これは、マウスが動画の位置をピーカーで確認するたびに、位置が0からカウント開始されることから確認できます。これは、マウスピーカーが位置ピンの値のレンダリングを開始したため、ビデオプレーヤーが再生を開始したためです：
右側に表示されている動画が、アクティブな出力に接続されているとは限りません。
プレビュー1パネルの動画出力インデックスが「-」から「1」に変更されると、ビデオプレーヤーモジュールの実行が停止します：
上記の例は、その動画インデックスに対して他の出力がない場合のみ成立します。
例えば、Video output devicesにそのビデオインデックスの出力がある場合、プレビューパネルにそのビデオインデックスが表示されていなくても、ビデオプレーヤーモジュールは実行されます。
強制実行
一部のモジュールにはForce AllまたはForce Bothピンがあります。これらのピンがオンになっている場合、モジュールに接続されたノードは選択または使用されていない場合でも実行されます。
重要: 強制実行は慎重に使用してください。接続されたすべてのモジュールが実行されるため、適切に管理されない場合、システム性能に重大な影響を与える可能性があります。
Switch Video Miniにはこのようなピンがあります。以下の例では、このピンがDelayerモジュールをオン/オフにする仕組みを確認できます:
Force AllがOffの場合、Switch Videoで選択されたビデオが最初のビデオである間は、Delayerモジュールは実行されません。Switch Videoが2番目の動画を切り替えた場合、遅延期間中は画面が表示されません。
Force Allがオンの場合、選択中の動画が最初の動画であってもDelayerモジュールは実行されます。そのため、Switch Videoが2番目の動画を切り替えた場合、切り替え直後に遅延した動画が表示されます。Delayerモジュールは常に動作し、遅延用の動画のフレームを保存しているためです。
Force ExecutionとForce Execution Ifという2つの特殊なモジュールがあります。Force Executionモジュールがモジュールに接続されている場合、そのモジュールは使用されていない場合でも実行されます。例えば、プレビューとビデオ出力にビデオインデックスが定義されていない場合でも、ビデオが再生されます：
一部のケースでは、モジュールの実行順序も重要です。このような場合、Priorityピン値が最も高いForce Executionモジュールが最初に実行されます。
Show Active Routes
Show Active Routesは、不要に実行されているモジュールを簡単に特定するために使用できます。
注意：このオプションは、パフォーマンスに影響を与える可能性があるため、生産中は有効にしないでください。Show Active Routesはデバッグ目的でのみ使用してください。
有効にするには、フローエディター内の空いている領域を右クリックし、Show Active Routesを選択します:
Show Active Routesは、実行中のノード、モジュール、接続、ピンを表示します。実行されていないものはグレー表示されます。
例えば、If VideoモジュールのIfピンをOnからOffに変更すると、対応するThenとElseピンがグレー表示されます。さらに、これらのピンへの接続線と、その後のモジュールも実行されないためグレー表示されます：
アクティブな出力に接続されているモジュールは、実行されるためグレー表示されません。
例えば、Image 2がアクティブな出力（Out 2）に接続されている場合、モジュールは実行されるためグレー表示されません：
ピンが何も接続されていない場合でも、モジュールがそのピンを使用していない場合はグレー表示されます。
例えば、以下のIf Videoモジュールでは、If論理ピンはグレー表示されません。これは、どのビデオピンを使用するかを決定するため使用されているためです。一方、Elseビデオピンはグレー表示されます。これは、If論理ピンがモジュールがThenビデオピンを使用することを決定したためです：
非常に稀なケースでは、モジュール内で実行ロジックが最初に到達したピンを知る必要がある場合があります。そのため、モジュールの実行をトリガーした出力ピンは、グレーの背景でハイライトされます。
例えば、Imageモジュールでは、Outピンが最初に使用され、その後Metadataピンが使用されました:
ループ
Show Active Routesは、フローエディター内のループも検出します。
Show Active Routes がオンの場合、ループが存在すると、これらのループの正確な位置を示すメッセージが表示されます:
ループはフローエディターでもハイライト表示されます。オレンジの枠線で囲まれた部分が、実行チェーンが現在のフレームで既に実行されたモジュールに到達した際にループが閉じられる位置を示します。したがって、赤の枠線でハイライト表示されたモジュールとそのデータは、前のフレームで実行されました。
例えば、以下の例では、AdjusterモジュールのBrightnessピンは、前のフレームで計算された値を受け取ります。これは必ずしも問題ではありませんが、一部のケースでは重大な問題を引き起こす可能性があります:
上記の例では、Adjusterで処理される前に、Measurerモジュールを動画に適用する必要があります。これは、Brightnessピンが変更されると、Adjusterが動画のLuminanceを変更するためです:
モジュール検索
モジュール検索機能は、プロジェクト内を検索できます。これは、カメラコンパウンドのような大規模なコンパウンドで特に便利です：
ESCキーを押すと検索が閉じます。CTRL + Fのショートカットでもモジュール検索オプションにアクセスできます。
さらに、モジュールをグローバルに検索オプションがあり、ロックされていないすべてのコンパウンドを検索します。ロックされたコンパウンドに関する詳細は、コンパウンドのドキュメントを参照してください。
TAB キーを押すと、検索モードを切り替えることができます：名前、インデックス、タイプ、および ファイル。
注：ノードの名前を変更できるため、特定のモジュールタイプのすべてのインスタンスを検索するには、タイプ検索を使用できます。
