Projector Brightness（投影仪亮度）

介绍

投影仪亮度可以通过控制输出功率，从而控制投影仪发出的光子数量。使用投影仪的亮度是最大化信噪比（ SNR ）的最有效方法。 最大化投影仪的亮度将最大化相机的信号幅度，只要来自投影仪的反射光不会使像素过饱和，就可以最大程度地降低噪声的影响。在增加峰值信号幅度的同时，增加的亮度也会影响图像的平均强度。这也意味着投影仪亮度可用于控制曝光（以曝光等级来测量）。

投影仪

投影仪亮度数值基于控制投影仪发出的流明量的相对应的数值。下表显示了 Zivid 相机中可用的投影仪亮度与曝光等级的关系。将投影仪亮度调至 0 将关闭投影仪。

亮度		0.25	0.50	1.00	1.80	2.00	2.50
曝光等级		-2	-1	0	+0.85	+1	+1.32
流明	Zivid 2	90	180	360	650	N/A	N/A
	Zivid 2+	90	180	360	650	720	900

例如，通过将投影仪亮度从0.50增加到1.00，图像的平均强度将增加1个等级。

建议在选择投影仪亮度时牢记 SNR 的概念，尽可能保持较高的亮度。在存在强环境光或在一米以上距离成像的情况下尤其如此。

备注

Zivid 3D相机具备热节流功能，可防止相机过热。

Thermal throttling（热节流）

为了限制投影仪的峰值温度，相机在拍摄时始终强制执行一个占空比上限。这个上限取决于两个因素：

• 投影仪亮度：亮度 1.0 时可达到的最大占空比为 100%，亮度 1.8 时为 50%，亮度 2.5 时为 30%（对于典型温度）。

• 投影仪温度：可实现的最大占空比会因投影仪温度而降低，这取决于占空比、投影仪亮度和环境温度。

热节流功能的表现是相机在拍摄过程中会短暂暂停。这可以让相机在继续拍摄之前先冷却一小段时间。

Zivid 2+ 最大投影仪亮度限制

默认情况下，Zivid 2+ 相机的最大投影仪亮度取决于投影仪所用光线的颜色。对于 3D 捕获，光信号的颜色由 Sampling::Pixel 设置决定。对于 2D 捕获，投影颜色始终为白色。

使用 Zivid::Settings::Sampling::Pixel::blueSubsample2x2 或 Zivid::Settings::Sampling::Pixel::redSubsample2x2

投影仪最大亮度为2.5。

使用 Zivid::Settings::Sampling::Pixel::all 或在 2D 捕获中

最大投影仪亮度上限为 2.2，以将相机运行期间的功耗保持在 100 W 以下。

如果您的应用允许超过 100 W 的功耗，您可以通过配置文件更改此限制，以允许投影仪亮度可设置为 2.5，它将在 Zivid::Settings::Sampling::Pixel::all 时或 2D 捕获中生效。

如何增加 Zivid 2+ 的最大投影仪亮度限制

您可以通过 :download:` Config.yml </../files/projector_brightness_limitation_config/Config.yml>` 文件来增加投影仪亮度限制。如果该文件已存在并且位于 %LOCALAPPDATA%ZividAPI （Windows）或 "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API （Ubuntu），使用以下信息更新它：

__version__:
    serializer: 1
    data: 18
Configuration:
    Camera:
        Power:
            Limit: unlimited

备注

确保 __version__ 部分中的数据编号为 18 或更高。

如果文件不存在：

1. 下载 :download:` Config.yml </../files/projector_brightness_limitation_config/Config.yml>` 文件。

2. 将下载的Config文件放在以下目录中。

   Windows

   mkdir %LOCALAPPDATA%\Zivid\API
   move %HOMEPATH%\Downloads\Config.yml %LOCALAPPDATA%\Zivid\API\
   

   Ubuntu

   mkdir --parents "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API
   mv ~/Downloads/Config.yml "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API/
   

   小心

   任何现有的配置文件都将被覆盖。

小心

Zivid 配置文件必须使用 .yml 文件扩展名（而不是 .yaml）。

版本历史

SDK	变更
2.10.1	使用白光捕获时，Zivid 2+ 的最大投影仪亮度默认受到限制，可以选择使用 Config.yml 更改该限制。
2.10.0	添加了Zivid 2+系列。
2.9.0	改进了热节流功能，可以在预测时间范围内的采集之间进行热节流，而不是暂停完整的捕获。