照明コントロール#

Illumination機能を使用すると、プロジェクター（照明）の動作を制御できます。

Illumination Parameters#

Illumination Mode#

以下のパラメータを使用して、 BslIlluminationMode プロジェクターのオン/オフを制御できます。

• AlwaysActive: デフォルト設定です。プロジェクターがすべての露光中にアクティブになることを意味します。
  
• AlternateActive: このモードでは、シーン内に投影パターンがない状態で強度データを取得できます。各画像に対して2回の露光が実行されます。1回目は深度計算のためにプロジェクターを有効にした露光、2回目は強度データを取得するための露光です。なお、 AlternateActive によりレイテンシーが増加します。
  
• Off: プロジェクターはまったく使用されません。

Illumination Strength#

イメージ BslIlluminationStrength パラメータは、プロジェクターの Illumination Strength を制御します。このパラメータは、露光時間とプロジェクターの有効化時間の比率を設定します。最大有効化時間は 5 ms です。露光時間が 5 ms を超える場合、プロジェクターは露光時間全体を通じてアクティブにはなりません。

許容される範囲の BslIlluminationStrength パラメータは 0.05 ～ 1.0 です。値が 1.0 の場合、プロジェクターが許可されている最大時間（最大 5 ms）アクティブになることを意味します。値を小さくすると、有効化時間が比例して短縮されます。シーンの十分な照明と、最大許容デューティサイクルまたはフレームレートのバランスが適切に保たれるように、このパラメータを調整してください。

過剰露光#

次の画像のようにプロジェクターを使用した画像が過剰露光になる場合は、Illumination Strengthを下げてください。

次の画像では、Illumination Strengthが 1.0 から 0.6 に下げられています。

Resulting Illumination Time#

イメージ BslIlluminationTime パラメータには、プロジェクターの結果としての照明時間（つまり、プロジェクターがアクティブである時間）が表示されます。

Resulting Illumination Duty Cycle#

イメージ BslIlluminationDutyCycle パラメータには、プロジェクターの結果としてのデューティサイクルが表示されます。最大デューティサイクルは 2.5 % です。達成可能なフレームレートはこのデューティサイクルによって制限されます。フレームレートを上げるには、Exposure TimeまたはIllumination Strengthを下げてください。

Resulting Frame Rate#

イメージ BslIlluminationFrameRate には、プロジェクターの Resulting Frame Rateが表示されます。希望するフレームレートよりも低い場合は、プロジェクターのデューティサイクルの制限によってフレームレートが制限されている可能性が高くなります。この場合は、Exposure TimeまたはIllumination Strengthを下げてください。

次の図は、最大可能なフレームレートに対するプロジェクターの影響を示しています。

フレームレートを制限するその他の要因：

• 深度計算に必要な時間
• ネットワーク転送

これらは、深度分解能、輝度分解能、動作範囲（Minimum DepthおよびMaximum Depthパラメータで指定）、GPUモデル、CPUモデル、ネットワークトポロジー、リンク速度などの影響を受けます。

照明の設定#

Illumination Modeを設定するには：

1. パラメーターを BslIlluminationMode パラメーターを次のいずれかの値に設定します。
   1. Off：照明は常にオフになります。
   2. AlwaysActive：各フレームの露光中に照明が有効になります。
   3. AlternateActive：2フレームに1回の露光中に照明が有効になります。
2. パラメーターを BslIlluminationStrength パラメータを0.05～1.0の間の任意の値に設定します。