照明控制#

Illumination 功能允许您控制投影仪（照明）的操作。

照明参数#

Illumination Mode#

通过 BslIlluminationMode 参数，您可以控制投影仪的开启或关闭。

• AlwaysActive：这是默认设置，表示投影仪在每次曝光期间处于活动状态。
  
• AlternateActive：在此模式下，您可以在场景中没有投影图案的情况下获取强度数据。对于每幅图像，会执行两次曝光：一次启用投影仪用于深度计算，另一次用于捕获强度数据。请注意， 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 Time，即投影仪处于活动状态的时间。

Resulting Illumination Duty Cycle#

即： BslIlluminationDutyCycle 参数显示投影仪的最终占空比。最大占空比为 2.5 %。可实现的帧率受此占空比限制。要提高帧率，请缩短曝光时间或降低 Illumination Strength。

Resulting Frame Rate#

即： BslIlluminationFrameRate 显示 Resulting Frame Rate。如果帧率低于预期，则投影仪的占空比限制很可能限制了帧率。在这种情况下，请缩短曝光时间或降低 Illumination Strength。

下图说明了投影仪对最大可能帧率的影响：

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

• 深度计算所需的时间
• 网络传输

这些因素受 depth resolution、intensity resolution、工作范围（通过 Minimum Depth 和 Maximum Depth 参数指定）、GPU 型号、CPU 型号、网络拓扑以及链路速度等的影响。

配置照明#

要设置 Illumination Mode：

1. 设置 BslIlluminationMode 参数设置为以下值：
   1. Off：始终关闭照明。
   2. AlwaysActive：在每帧曝光期间启用照明。
   3. AlternateActive：在每隔一帧的曝光期间启用照明。
2. 设置 BslIlluminationStrength 参数设置为 0.05 到 1.0 之间的所需值。