照明控制#

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

照明参数#

Illumination Mode#

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

• AlwaysActive：这是默认设置，表示投影仪在每次曝光期间处于激活状态。
  
• AlternateActive：在此模式下，您可以获取场景中没有投影图案的强度数据。对于每幅图像，会执行两次曝光：一次是启用投影仪以计算深度，另一次是捕获强度数据。请注意， AlternateActive 会增加延迟。
  
• Off：完全不使用投影仪。

Illumination Strength#

即： BslIlluminationStrength 参数控制投影仪的照明强度。该参数设置曝光时间与投影仪激活时间之间的比率。最大激活时间为 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 %。可实现的帧率受此占空比限制。要提高帧率，请减少 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：照明始终处于关闭状态。
   2. AlwaysActive：在每一帧的曝光期间启用照明。
   3. AlternateActive：在每隔一帧的曝光期间启用照明。
2. 设置 BslIlluminationStrength 参数设置为 0.05 到 1.0 之间的所需值。