照明コントロール#

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

Illumination パラメータ#

Illumination Mode#

BslIlluminationMode パラメータにより、プロジェクターのオン/オフを制御できます。

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

Illumination Strength#

イメージ BslIlluminationStrength パラメータは、プロジェクターの照射強度を制御します。このパラメータは、露光時間とプロジェクターのアクティブ化時間の比率を設定します。最大アクティブ化時間は 5 ms です。露光時間が 5 ms よりも長い場合、露光時間全体を通じてプロジェクターがアクティブになるわけではありません。

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

過露出#

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

Illumination Strength 1.0

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

Illumination Strength 0.6

Resulting Illumination Time#

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

Resulting Illumination Duty Cycle#

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

Resulting Frame Rate#

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

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

最大可能なフレームレートに対するプロジェクターの影響を示す図

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

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

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

Illumination の設定#

Illumination Modeを設定するには、次のようにします。

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