Illumination Control#

「照明」功能可讓您控制投影機的運作（照明）。

照明參數#

Illumination Mode#

透過 BslIlluminationMode 透過此參數，您可以控制投影機的開啟與關閉時機。

• AlwaysActive: 這是預設設定，表示投影機在每次曝光期間皆處於運作狀態。
  
• AlternateActive: 在此模式下，您可以在場景中不顯示投影圖案的情況下擷取強度資料。對於每張影像，系統會進行兩次曝光：一次是開啟投影機以進行深度計算，另一次則是用於擷取強度資料。請注意， AlternateActive 會增加延遲。
  
• Off: 這台投影機完全沒用過。

Illumination Strength#

當 BslIlluminationStrength 此參數用於控制投影機的亮度。此參數設定曝光時間與投影機啟用時間之間的比例。最大啟用時間為 5 毫秒。若曝光時間超過 5 毫秒，投影機將不會在整個曝光期間保持啟用狀態。

的允許範圍為 BslIlluminationStrength 此參數的範圍為 0.05 至 1.0。數值為 1.0 表示投影機處於啟用狀態的時間為最大允許時間（最長 5 毫秒）。數值越低，啟用時間便會相應縮短。請調整此參數，以在場景的充足照明與最大允許的占空比或幀率之間取得良好平衡。

過度曝光#

如果投影機投射出的影像過曝（如下圖所示），請降低照明強度。

在下圖中，照明強度已從 1.0 降低至 0.6。

Resulting Illumination Time#

當 BslIlluminationTime 此參數顯示投影機的最終照明時間，即投影機處於運作狀態的時間。

Resulting Illumination Duty Cycle#

當 BslIlluminationDutyCycle 此參數顯示投影機的最終佔空比。最大佔空比為 2.5%。可達成的幀率受此佔空比所限制。若要提高幀率，請縮短曝光時間或降低照度。

Resulting Frame Rate#

當 BslIlluminationFrameRate 顯示投影機的實際幀率。若幀率低於預期，很可能是投影機的占空比限制了幀率。在此情況下，請縮短曝光時間或降低照度。

下圖說明了投影機對最大幀率可能值的影響：

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

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

這些因素受多種因素影響，包括（但不限於）深度解析度、強度解析度、工作範圍（透過「最小深度」和「最大深度」參數指定）、GPU 模型、CPU 模型、網路拓撲以及鏈路速度。

設定照明#

要設定照明模式：

1. 將相機中的 BslIlluminationMode 參數設定為以下值之一：
   1. Off: 照明總是關閉的。
   2. AlwaysActive: 每幀曝光期間皆會開啟背光。
   3. AlternateActive: 每隔一幀的曝光期間，都會啟用背光功能。
2. 將相機中的 BslIlluminationStrength 將參數設定為 0.05 至 1.0 之間的目標值。