Test Images#

相机的 Test Images 功能可让您检查相机的基本功能及其传输图像的能力。

测试图像可用于维护目的和故障诊断。它们是由相机本身生成的。因此，相机的光学元件或成像传感器未参与其创建。

该功能的使用#

显示测试图像#

1. 选择测试图像，方法是设置 TestImageSelector 参数设置为以下值：
   • Testimage1
   • Testimage2
   • Testimage3
   • Testimage4
   • Testimage5
   • Testimage6 (if available)
2. Acquire at least one image to display the selected test image. If you want to display the test image in the pylon Viewer, click the single or continuous shot button on the toolbar.

可用测试图像#

根据您的相机型号，可以使用以下测试图像：

测试图像 1 - 固定的对角灰色渐变（8 位）#

• 由固定的对角灰色渐变组成，范围从 0 到 255。
• 最适合将相机配置为单色 8 位输出的情况。

测试图像 2 - 移动的对角灰色渐变（8 位）#

• 参见测试图像 1。
• 差异：包括移动的对角灰色渐变。触发新图像采集时，图像向左移动一个像素。

测试图像 3 - 移动的对角灰色渐变#

• 参见测试图像 1。
• 差异：包括移动的对角灰色渐变。
• 在大多数相机上，这是 12 位模式。在部分相机机型上，这是 10 位模式。

测试图像 4 - 移动的对角灰色渐变功能测试（8 位）#

• 参见测试图像 1。
• 差异：包括移动的对角灰色渐变。此外，它还显示了启用的任何数字处理功能（例如，亮度查找表）的效果。

测试图像 5 - 移动的对角灰色渐变功能测试#

• 参见测试图像 1。
• 差异：包括移动的对角灰色渐变。此外，它还显示了启用的任何数字处理功能（例如，亮度查找表）的效果。
• 在大多数相机上，这是 12 位模式。在部分相机机型上，这是 10 位模式。

测试图像 6 - 移动的对角颜色渐变#

• 如果可用，则此测试图像由移动的对角颜色渐变构成。触发新图像采集时，图像向左移动一个像素。

相机设置对测试图像的影响#

• 相机模拟功能（如 Gain、Black Level 和 Exposure Time）对测试图像没有影响。
• 相机的数字功能（例如，亮度查找表）仅影响测试图像 4 和 5。如果要检查使用数字功能的效果，请使用测试图像 4 或 5。

附加参数#

Depending on your camera model, the TestImageResetAndHold parameter is available:

• 它使您可以将移动的测试图像转变为固定图像。
• 发出命令后，所有渐变将显示在其起始位置。如果触发了新的图像采集，它们将保留在这些位置。
• 它可以应用于固定和移动的测试图像。

详情#

显示所有相机型号

示例代码#

// Select test image 1
camera.TestImageSelector.SetValue(TestImageSelector_Testimage1);
// Acquire images to display the selected test image
// ...
// (Insert your own image grabbing routine here.
// For example, the InstantCamera class provides the StartGrabbing method.)

INodeMap& nodemap = camera.GetNodeMap();
// Select test image 1
CEnumParameter(nodemap, "TestImageSelector").SetValue("Testimage1");
// Acquire images to display the selected test image
// ...
// (Insert your own image grabbing routine here.
// For example, the InstantCamera class provides the StartGrabbing method.)

// Select test image 1
camera.Parameters[PLCamera.TestImageSelector].SetValue(PLCamera.TestImageSelector.Testimage1);
// Acquire images to display the selected test image
// ...
// (Insert your own image grabbing routine here.
// For example, the InstantCamera class provides the StartGrabbing method.)

/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* Select test image 1 */
errRes = PylonDeviceFeatureFromString(hdev, "TestImageSelector", "Testimage1");
CHECK(errRes);
/* Acquire images to display the selected test image */
/* ... */
/* (Insert your own image grabbing routine here. */
/* For example, the InstantCamera class provides the StartGrabbing method.) */

# Select test image 1
camera.TestImageSelector.Value = "Testimage1"
# Acquire images to display the selected test image
# ...
# (Insert your own image grabbing routine here.
# For example, the InstantCamera class provides the StartGrabbing method.)

您也可以使用 pylon Viewer 轻松设置参数。