はじめに
このドキュメントでは、LEDWallCamコンパウンドを使用したトラッキング対応カメラインプットの設定方法について説明します。
すべてのLEDWallCamコンパウンドでは、カメラコンパウンドをインポートした後、INPUTSコントロールボード上にINPUT #パネルが表示されます。
以下の例では、次のコンパウンドをインポートしました：
[Common_Studio]:Camera\LEDWallCam\LEDWallCam_3-Cam_4-Wall.xcomp
INPUT # コントロールパネル
パネル上の電源ボタンアイコンで各入力をオン/オフできます。これによりPCリソースを節約可能です。例えば8つのINPUTパネルがあるが、制作で必要なのは6つだけなら、残り2つをオフにできます。
トラッキングカメラの設定
INPUTSコントロールボードでINPUT #コントロールパネルを選択すると、画面右側のPin Valuesタブに入力オプションが表示されます。
注記: LED Wall Productionではライブ映像入力が必要です。
各ピンとその機能については以下で説明します。本セクションでは最も頻繁に使用されるピンを最初に扱い、残りのピンについては追加パラメータセクションで説明します。
カメラデバイス
トラッキングカメラ複合体の場合、INPUT #パネルで最も重要な入力デバイスはカメラデバイスとトラッキングデバイスです。
デフォルトでは、両方のデフォルト入力はMapped #1ですが、これは#1 IDに何らかの入力をマッピングしている場合にのみ機能します。
注：デバイスマッピングの詳細はこちらを参照してください。
注：対応入力デバイスについてはこちらを参照：
カメラモード
Aximmetryが自動的に入力解像度とフレームレートを設定するにはAUTOを選択します。必要に応じて任意の解像度とフレームレートを個別に設定することも可能です。
注：旧式のキャプチャカードモデルではAUTO機能が動作しない場合があります。AUTOモード使用時に映像入力が表示されない場合は、正しい入力解像度とフレームレートを手動で指定してみてください。
トラッキングデバイス
カメラデバイスの設定が完了したら、トラッキングデバイスの設定は次の順序で行ってください：
- トラッキングデバイスを定義する
- 必要に応じて、Aximmetryでキャリブレーションプロファイルを定義する（詳細はこちらトラッキングデバイスの設定）
- トラッキングデバイスのトラッキング遅延を確認・設定する（詳細はこちら遅延の調整）
キャリブレーションプロファイル
Aximmetry Basic CalibratorまたはAximmetry Camera Calibratorを使用してカメラレンズやトラッキングデバイスをキャリブレーションした場合、ここで作成したキャリブレーションプロファイルを選択してください。
プロフェッショナルカメラトラッキングまたはオブジェクトトラッキングシステムがキャリブレーションソリューションを提供しており、それらを使用する場合、キャリブレーションプロファイルパラメータを指定する必要はありません。
ズームデバイス
ズームデバイスは、トラッキングデバイスと組み合わせて追加のトラッキングデータを提供する二次トラッキングデバイスです。このパラメータには3つの使用例があります：
- サードパーティ製ズームエンコーダデバイスを指定して追加レンズデータを受信する、
- 追加トラッキングデバイスでPTZカメラを追跡し位置を特定する際、PTZカメラのトラッキングデータストリームを指定する、
- トラッキングデバイスパラメータで指定した同一のトラッキングデバイスを指定し、そのトラッキング遅延およびズーム遅延パラメータを個別に調整できるようにする。
遅延
各種入力に対する遅延値を指定できます。値はフレーム単位で指定します。
- AR トラッキング遅延：トラッキングデータに対する遅延値を設定します。
- AR ズーム遅延：レンズデータのみに対する遅延値を設定します。注：使用シナリオの詳細については、ドキュメント内の以下の項目を参照してください：ズームデバイス
AR タイムコード同期
タイムコードのソースは2種類あります：
- スタジオデバイスが内部で生成する場合（通常、カメラ本体やプロ用カメラ追跡システムがこれに対応）。
- タイムコードジェネレーターが提供するケース（タイムコードジェネレーターは外部ハードウェアであり、ゲンロックデバイスと同様）。
スタジオデバイス生成タイムコードの使用
スタジオデバイスが独自にタイムコードを生成する場合、それらを相互に同期させることはできません。したがって、同期させるには、まずゲンロックデバイスを追加してゲンロック接続し、その後ARトラッキング遅延を設定する必要があります。
注記：稀なケースとして、トラッキングとビデオが同一デバイスから出力される場合、トラッキングとビデオのタイムコードは外部ジェネレーターなしで同期可能です。これはデバイスが内部で管理できるためであり、Aximmetry Eyeがその例です。
外部タイムコードジェネレータの使用
タイムコードジェネレータは、通常ゲンロック/リファレンス（参照信号の略）信号と共に、各デバイス向けのタイムコードを送信できます。これにより各デバイスが同一のタイムコードを使用するため、共有タイムコードを用いて映像入力とトラッキング入力を同期させることが可能です。
通常、この場合ARトラッキング遅延の設定は不要です。
デフォルトではタイムコード同期が有効です。「タイムコードが一致しません」エラーが発生した場合、デバイスが独自のタイムコードを生成しており、一致しないため同期できません。この場合はARタイムコード同期を無効にしてください。
ARズーム タイムコード同期
ARズームタイムコード同期は、上記のARタイムコード同期がARトラッキング遅延を同期させるのと同様に、ARズームデバイスをタイムコードに基づいて同期させます。
ARトラッキング遅延とARズーム遅延の自動検出
バージョン2023.2より、Aximmetryは新機能を提供します：適切なトラッキング遅延（ARトラッキング遅延の自動検出）とズーム遅延（ARズーム遅延の自動検出）値を自動的に検出する機能です。
これらの機能はINPUT #コントロールパネルのPin Values内にあります：
使用するには、カメラをLEDウォールのいずれかに向ける必要があります。
注：モーションブラーを避けるため、シャッタースピードを高く設定することを推奨します。
注：カメラはLEDウォールから適切な距離（1メートル未満など、近すぎる位置は避ける）に設置することを推奨します。
注：カメラの視野内に1つのターゲットのみが映るように設置することを推奨します。
使用する検出器をオンにします（ARトラッキング遅延検出またはARズーム遅延検出）。
メッセージが表示されます。
Aximmetryがターゲットを検出後、ARトラッキング遅延検出かARズーム遅延検出かによって異なるメッセージが表示されます。
遅延値を検出すると以下のメッセージが表示され、対応するピンの遅延値が自動的に設定されます。
追加パラメータ
トラッキング転送
トラッキングデータ入力を複数のコンピュータ間で共有するには、1台以上のコンピュータに転送します（例：マルチマシン構成）。
トラッキング転送パラメータをオンに設定すると、トラッキングデータを自コンピュータから他コンピュータへ転送できます。
トラッキング転送ポート
Aximmetryコンピュータ間で転送されるトラッキングデータを受信するには、
- すべてのコンピュータが同一のローカルエリアネットワークに接続されていること、
- および本パラメータで指定したUDPポート番号が必要です。
送信側は指定UDPポートでトラッキングデータをブロードキャストし、ローカルエリアネットワークに接続されたすべての受信側で利用可能にします。
注：トラッキングデータを受信・処理するには、データ転送に使用したカメラコンパウンドと同じもの、またはトラッキングデータ入力に対応したカメラコンパウンドの使用を推奨します。
タイムコードマスター
Aximmetryのタイムコードマスターをこの入力に設定する場合は、Onに設定してください。
カラースペース
Aximmetryはカラースペースを自動検出しますが、特定のカラースペースを使用したい場合はここで選択できます。
ガンマカーブ
カラースペースと同様の設定をガンマカーブに対して行います。
クロマオフセット
クロマオフセットは、クロマ（色）チャンネルとルーマ（輝度）チャンネルを再調整し、異なるチャンネルのピクセルが正しく配置されるようにします。クロマチャンネル（UとVまたはCrとCb）はルマチャンネルと異なるフォーマットを持つ場合があり、この差異により画像内で色と輝度がわずかにずれることがあります。クロマオフセットを調整することでこの問題を修正できます。
入力画像なし
デフォルトの入力画像なし状態は次の通りです：
このオプションでPC内の別の画像を選択できます。
レンズパラメータのオーバーライド
- レンズデータのオーバーライド
このパラメータを有効にすると、トラッキングデバイスまたはレンズエンコーダーから受信したレンズデータを手動で上書きできます。手動で上書きされたデータは、Aximmetryで指定されている場合、レンズのキャリブレーションプロファイルに従って処理されます。
注記：手動レンズデータは、LEDWallCamカメラコンパウンドに存在するOverride Lens Data X入力ピンを介して入力されます。
- 生データオーバーライド
このパラメータを調整することで、トラッキングデバイスやレンズエンコーダから受信したレンズデータを手動で上書きできます。手動で上書きされたデータは、Aximmetryでキャリブレーションプロファイルが指定されている場合、それを無視して生入力として使用されます。
- ズームオーバーライド
このパラメータを有効にすると、ズームオーバーライドピンの下のズームピンの値を調整することで、入力レンズデータのズーム値を手動で上書きできます。
レンズデータオーバーライドピン
LEDWallCamコンパウンドの各入力（INPUT）には、1つのレンズデータオーバーライドピンが用意されています：
レンズデータオーバーライドピンは、9つの浮動小数点値を含むベクトルを期待します：
- DescType - 記述タイプ。以下を参照：
- 0 = OpenCV（Aximmetryのデフォルト形式。Aximmetry Camera Calibratorでも使用）
- 1 = Stype
- 2 = Mo-Sys
- 3 = TrackMen
- 4 = Camix
- FOVX - 水平視野角（度単位）
- Aspect - 画像アスペクト比
- CX - 中心シフト X 成分
- CY - 中心シフト Y 成分
- K1 - 放射状歪み係数 1
- K2 - 放射状歪み係数 2
- K3 - 放射状歪み係数 3
- SensorWidth - カメラセンサーの使用領域の幅
注記: ベクトルは統一されたレイアウトを持ちますが、データ要素の正確な解釈は指定された記述タイプによって異なる場合があります。
注記: レンズデータを解析し、このようなベクトルを作成する方法の例は、[Common_Studio]:Compounds\Tools\Lens_Distort_Vanishing.xcomp コンパウンドです。
外部レンズデータ
外部レンズデータは、レンズデータの読み取り元をAximmetryからキャリブレーションプロファイル またはトラッキングシステム（トラッキングシステムがレンズデータを提供する場合のみ）に切り替えます。
すべての可能性を網羅すると、 キャリブレーションプロファイル が指定された場合、レンズデータのソースは以下のように変化します：
キャリブレーションプロファイルが指定されている外部レンズデータはオン
|
キャリブレーションプロファイルが指定されています |
外部レンズデータはオンです |
外部レンズデータはオフです |
|
トラッキングシステムはレンズデータを提供し、ズームデバイスが明示されていない |
トラッキングシステム | キャリブレーションプロファイル |
|
トラッキングシステムはレンズデータを提供しない、またはズーム装置が指定されている |
キャリブレーションプロファイル | キャリブレーションプロファイル |
|
記録された追跡データを再生する |
記録されたデータ | キャリブレーションプロファイル |
外部レンズデータはオフ
|
キャリブレーションプロファイルが指定されています |
外部レンズデータはオンです |
外部レンズデータはオフです |
|
トラッキングシステムはレンズデータを提供し、ズームデバイスが明示されていない |
トラッキングシステム | 固定されたデフォルト値 |
|
トラッキングシステムはレンズデータを提供しない、またはズーム装置が指定されている |
固定されたデフォルト値 | 固定されたデフォルト値 |
|
記録された追跡データを再生する |
記録されたデータ | 固定されたデフォルト値 |
固定デフォルト値は FOVX = 60、アスペクト比 = 16:9、歪みなしです。
トラッキングデジッター
トラッキングデジッターは、カメラが動いていない場合でもトラッキングを安定させることができます。多くのトラッキングシステムでは、トラッカーが静止している場合でも（測定精度の関係で）、トラッキングデータが絶えず変化します。通常、これらの変化はごくわずかで目に見えません。しかし、ズームインすると、これらの変化がはるかに目立つようになります。
トラッキングデジッターを有効にすると、カメラがデジッター位置閾値を超えて移動したり、デジッター回転閾値を超えて回転したりしない限り、カメラを固定位置にロックします。
トラッキングデジッターは、カメラが動き始めた瞬間にトラッキングにわずかな遅延が生じる可能性があるため、絶対に必要な場合のみ有効にしてください。さらに、トラッキングシステムが代替手段を提供していないか確認してください。メーカーは自社システムの測定精度を把握しており、トラッキングデジッターよりも優れた解決策を提供している可能性があります。
注：トラッキングデジッターは、カメラが移動中のジッターを修正するものではありません。
デジッター位置閾値
デジッター位置閾値は位置データの閾値を指定します。閾値未満のデータ変動はAximmetryによって無視/破棄されます。
注：このパラメータがトラッキングデータ入力の処理に影響するには、トラッキングデジッターが有効になっている必要があります。
デジッター回転閾値
デジッター回転閾値は回転データの閾値を指定します。閾値以下のデータ変動はAximmetryによって無視/破棄されます。
注記：このパラメータがトラッキングデータ入力の処理に影響を与えるには、トラッキングデジッターが有効になっている必要があります。
フラスタム
注記：フラスタムの有効化方法については、以下のドキュメントを参照してください：
色付き長方形をクリックして、フラスタムの外枠の色を選択します。
