光源控制#

Illumination 功能可讓您控制投影機（照明）的操作。

Illumination Parameters#

Illumination Mode#

透過 BslIlluminationMode Property，您可以控制投影機何時開啟或關閉。

• AlwaysActive：這是預設值，表示投影機在每次曝光期間皆處於活動狀態。
  
• AlternateActive：在此模式下，您可以在場景中沒有投影圖案的情況下擷取強度資料。對於每個影像，會執行兩次曝光：一次啟用投影機以計算深度，另一次則用於擷取強度資料。請注意， AlternateActive 會增加延遲。
  
• Off：完全不使用投影機。

Illumination Strength#

影像 BslIlluminationStrength Property 可控制投影機照明的強度。此 Property 會設定曝光時間與投影機啟用時間之間的比例。最大啟用時間為 5 ms。如果曝光時間長於 5 ms，投影機將不會在整個曝光期間保持活動狀態。

允許的範圍 BslIlluminationStrength Property 介於 0.05 到 1.0 之間。值為 1.0 表示投影機在允許的最大時間（最長 5 ms）內保持活動狀態。較低的值會按比例縮短啟用時間。調整此 Property 可在場景的充足照明與允許的最大工作週期或幀率之間取得良好的平衡。

過度曝光#

如果帶有投影機的影像過度曝光（如下圖所示），請降低 Illumination Strength。

在下圖中，Illumination Strength 已從 1.0 降低至 0.6。

Resulting Illumination Time#

影像 BslIlluminationTime Property 會顯示投影機的 Resulting Illumination Time，即投影機處於活動狀態的時間。

Resulting Illumination Duty Cycle#

影像 BslIlluminationDutyCycle Property 會顯示投影機的結果工作週期。最大工作週期為 2.5 %。可達到的幀率受此工作週期的限制。若要提高幀率，請縮短 Exposure Time 或降低 Illumination Strength。

Resulting Frame Rate#

影像 BslIlluminationFrameRate 會顯示投影機的 Resulting Frame Rate。如果幀率低於預期，則投影機的工作週期限制很可能是限制幀率的原因。在這種情況下，請縮短 Exposure Time 或降低 Illumination Strength。

以下圖表說明瞭投影機對最大可能幀率的影響：

可能限制幀率的其他因素：

• 深度計算所需的時間
• 網路傳輸

這些因素受 depth resolution、intensity resolution、工作範圍（透過 Minimum Depth 與 Maximum Depth 參數指定）、GPU 型號、CPU 型號、網路拓撲以及連線速度等影響。

配置照明#

若要設定 Illumination Mode：

1. 將 BslIlluminationMode 參數設為下列其中一個值：
   1. Off：Illumination 隨時保持關閉。
   2. AlwaysActive：在每個影格的曝光期間啟用 Illumination。
   3. AlternateActive：在每隔一個影格的曝光期間啟用 Illumination。
2. 將 BslIlluminationStrength 參數設定為 0.05 到 1.0 之間的所需數值。