跳转到内容

Test Images#

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

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

该功能的使用#

显示测试图像#

  1. 选择测试图像,方法是设置 TestImageSelector 参数设置为以下值:
  2. 至少采集一张图像以显示所选的测试图像。如果要在 pylon Viewer 中显示测试图像,请单击工具栏中的“单拍”或“连拍”按钮。

可用测试图像#

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

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

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

测试图像对角灰色渐变

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

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

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

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

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

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

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

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

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

测试图像对角颜色渐变

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

  • 相机模拟功能(如 GainBlack LevelExposure Time)对测试图像没有影响。
  • 相机的数字功能(例如,亮度查找表)仅影响测试图像 4 和 5。如果要检查使用数字功能的效果,请使用测试图像 4 或 5。

附加参数#

根据您的相机型号,可以使用 TestImageResetAndHold 参数:

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

详情#

显示所有相机型号

相机型号 可用测试图像 附加参数
a2A1920-51gcBAS 无(请参阅 Test Patterns
a2A1920-51gcPRO 无(请参阅 Test Patterns
a2A1920-51gmBAS 无(请参阅 Test Patterns
a2A1920-51gmPRO 无(请参阅 Test Patterns
a2A1920-160ucBAS 无(请参阅 Test Patterns
a2A1920-160ucPRO 无(请参阅 Test Patterns
a2A1920-160umBAS 无(请参阅 Test Patterns
a2A1920-160umPRO 无(请参阅 Test Patterns
a2A2590-22gcBAS 无(请参阅 Test Patterns
a2A2590-22gcPRO 无(请参阅 Test Patterns
a2A2590-22gmBAS 无(请参阅 Test Patterns
a2A2590-22gmPRO 无(请参阅 Test Patterns
a2A2590-60ucBAS 无(请参阅 Test Patterns
a2A2590-60ucPRO 无(请参阅 Test Patterns
a2A2590-60umBAS 无(请参阅 Test Patterns
a2A2590-60umPRO 无(请参阅 Test Patterns
a2A3840-13gcBAS 无(请参阅 Test Patterns
a2A3840-13gcPRO 无(请参阅 Test Patterns
a2A3840-13gmBAS 无(请参阅 Test Patterns
a2A3840-13gmPRO 无(请参阅 Test Patterns
a2A3840-45ucBAS 无(请参阅 Test Patterns
a2A3840-45ucPRO 无(请参阅 Test Patterns
a2A3840-45umBAS 无(请参阅 Test Patterns
a2A3840-45umPRO 无(请参阅 Test Patterns
acA640-90gc 1, 2, 3, 4, 5, 6
acA640-90gm 1, 2, 3, 4, 5
acA640-90uc 1, 2, 3, 4, 5, 6
acA640-90um 1, 2, 3, 4, 5
acA640-120gc 1, 2, 3, 4, 5, 6
acA640-120gm 1, 2, 3, 4, 5
acA640-120uc 1, 2, 3, 4, 5, 6
acA640-120um 1, 2, 3, 4, 5
acA640-121gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA640-300gc 1, 2a, 3b, 4, 5b, 6 TestImageResetAndHold
acA640-300gm 1, 2a, 3b, 4, 5b TestImageResetAndHold
acA640-750uc 1, 2a, 3, 4, 5, 6
acA640-750um 1, 2a, 3, 4, 5
acA720-290gc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA720-290gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA720-520uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA720-520um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA780-75gc 1, 2, 3, 4, 5, 6
acA780-75gm 1, 2, 3, 4, 5
acA800-200gc 1, 2a, 3b, 4, 5b, 6 TestImageResetAndHold
acA800-200gm 1, 2a, 3b, 4, 5b TestImageResetAndHold
acA800-510uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA800-510um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1280-60gc 1, 2, 3, 4, 5, 6
acA1280-60gm 1, 2, 3, 4, 5
acA1300-22gc 1, 2, 3, 4, 5
acA1300-22gm 1, 2, 3, 4, 5
acA1300-30gc 1, 2, 3, 4, 5
acA1300-30gm 1, 2, 3, 4, 5
acA1300-30uc 1, 2, 3, 4, 5, 6
acA1300-30um 1, 2, 3, 4, 5
acA1300-60gc 1, 2, 3, 4, 5
acA1300-60gm 1, 2, 3, 4, 5
acA1300-60gmNIR 1, 2, 3, 4, 5
acA1300-75gc 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1300-75gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1300-200uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA1300-200um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1440-73gc 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1440-73gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1440-220uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA1440-220um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1600-20gc 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1600-20gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1600-20uc 1, 2, 3, 4, 5, 6
acA1600-20um 1, 2, 3, 4, 5
acA1600-60gc 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1600-60gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1920-25gc 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1920-25gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1920-25uc 1, 2, 3, 4, 5, 6
acA1920-25um 1, 2, 3, 4, 5
acA1920-40gc 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1920-40gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1920-40uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA1920-40ucMED 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA1920-40um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1920-40umMED 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1920-48gc 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1920-48gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1920-50gc 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1920-50gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1920-150uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA1920-150um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1920-155uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA1920-155ucMED 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA1920-155um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA1920-155umMED 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2000-50gc 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2000-50gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2000-50gmNIR 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2000-165uc 1, 2, 3, 4, 5, 6
acA2000-165um 1, 2, 3, 4, 5
acA2000-165umNIR 1, 2, 3, 4, 5
acA2040-25gc 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2040-25gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2040-25gmNIR 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2040-35gc 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2040-35gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2040-55uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA2040-55um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2040-90uc 1, 2, 3, 4, 5, 6
acA2040-90um 1, 2, 3, 4, 5
acA2040-90umNIR 1, 2, 3, 4, 5
acA2040-120uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA2040-120um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2440-20gc 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2440-20gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2440-35uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA2440-35ucMED 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA2440-35um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2440-35umMED 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2440-75uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA2440-75ucMED 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA2440-75um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2440-75umMED 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2500-14gc 1, 2, 3, 4, 5, 6
acA2500-14gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2500-14uc 1, 2, 3, 4, 5, 6
acA2500-14um 1, 2, 3, 4, 5
acA2500-20gc 1, 2a, 3b, 4, 5b,6 TestImageResetAndHold
acA2500-20gcMED 1, 2a, 3b, 4, 5b TestImageResetAndHold
acA2500-20gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA2500-20gmMED 1, 2a, 3b, 4, 5b TestImageResetAndHold
acA2500-60uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA2500-60um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA3088-16gc 1, 2, 3, 4, 5, 6 TestImageResetAndHold
acA3088-16gm 1, 2, 3, 4, 5 TestImageResetAndHold
acA3088-57uc 1, 2, 3, 4, 5, 6
acA3088-57um 1, 2, 3, 4, 5
acA3800-10gc 1, 2, 3, 4, 5, 6
acA3800-10gm 1, 2, 3, 4, 5
acA3800-14uc 1, 2, 3, 4, 5, 6
acA3800-14um 1, 2, 3, 4, 5
acA4024-8gc 1, 2, 3, 4, 5, 6 TestImageResetAndHold
acA4024-8gm 1, 2, 3, 4, 5 TestImageResetAndHold
acA4024-29uc 1, 2, 3, 4, 5, 6 TestImageResetAndHold
acA4024-29um 1, 2, 3, 4, 5 TestImageResetAndHold
acA4096-11gc 1, 2, 3, 4, 5, 6 TestImageResetAndHold
acA4096-11gm 1, 2, 3, 4, 5 TestImageResetAndHold
acA4096-30uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA4096-30ucMED 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA4096-30um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA4096-30umMED 1, 2a, 3, 4, 5 TestImageResetAndHold
acA4096-40uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA4096-40ucMED 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA4096-40um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA4096-40umMED 1, 2a, 3, 4, 5 TestImageResetAndHold
acA4112-8gc 1, 2, 3, 4, 5, 6 TestImageResetAndHold
acA4112-8gm 1, 2, 3, 4, 5 TestImageResetAndHold
acA4112-20uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA4112-20ucMED 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA4112-20um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA4112-20umMED 1, 2a, 3, 4, 5 TestImageResetAndHold
acA4112-30uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA4112-30ucMED 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA4112-30um 1, 2a, 3, 4, 5 TestImageResetAndHold
acA4112-30umMED 1, 2a, 3, 4, 5 TestImageResetAndHold
acA4600-7gc 1, 2, 3, 4, 5, 6
acA4600-10uc 1, 2, 3, 4, 5, 6
acA5472-5gc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA5472-5gm 1, 2a, 3, 4, 5 TestImageResetAndHold
acA5472-17uc 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA5472-17ucMED 1, 2a, 3, 4, 5, 6 TestImageResetAndHold
acA5472-17um 1, 2a, 3, 4, 5 TestImageResetAndHold
boA4096-93cc 无(请参阅 Test Patterns
boA4096-93cm 无(请参阅 Test Patterns
boA4112-68cc 无(请参阅 Test Patterns
boA4112-68cm 无(请参阅 Test Patterns
daA1280-54lc 无(请参阅 Test Patterns
daA1280-54lm 无(请参阅 Test Patterns
daA1280-54uc 无(请参阅 Test Patterns
daA1280-54um 无(请参阅 Test Patterns
daA1600-60lc 无(请参阅 Test Patterns
daA1600-60lm 无(请参阅 Test Patterns
daA1600-60uc 无(请参阅 Test Patterns
daA1600-60um 无(请参阅 Test Patterns
daA1920-15um 无(请参阅 Test Patterns
daA1920-30uc 无(请参阅 Test Patterns
daA1920-30um 无(请参阅 Test Patterns
daA2500-14lc 无(请参阅 Test Patterns
daA2500-14lm 无(请参阅 Test Patterns
daA2500-14uc 无(请参阅 Test Patterns
daA2500-14um 无(请参阅 Test Patterns
daA2500-60mc 无(请参阅 Test Patterns
daA2500-60mci 不支持 Test Images 功能 不支持 Test Images 功能
daA4200-30mci 不支持 Test Images 功能 不支持 Test Images 功能
puA1280-54uc 无(请参阅 Test Patterns
puA1280-54um 无(请参阅 Test Patterns
puA1600-60uc 无(请参阅 Test Patterns
puA1600-60um 无(请参阅 Test Patterns
puA1920-30uc 无(请参阅 Test Patterns
puA1920-30um 无(请参阅 Test Patterns
puA2500-14uc 无(请参阅 Test Patterns
puA2500-14um 无(请参阅 Test Patterns

  1. 当 device temperature 达到超温阈值时,它将不再采集图像,而是传递内部生成的测试图像 2。

  2. Test images 3 和 5 是 10 位图像。

示例代码#

// 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
CEnumerationPtr(nodemap.GetNode("TestImageSelector"))->FromString("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.)
// Select test image 1
Pylon.DeviceFeatureFromString(hdev, "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.) */

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