Test Images#

利用 Test Images camera feature，您可以檢查相機的基本功能及其傳輸影像的能力。

Test images 可用於維護目的與故障診斷。它們是由相機本身產生的，因此相機的光學元件或影像感測器並未參與其建立過程。

使用此功能#

顯示 Test Images#

1. 透過設定以下項目來選擇 test image： TestImageSelector 參數設為下列其中一個值：
   • Testimage1
   • Testimage2
   • Testimage3
   • Testimage4
   • Testimage5
   • Testimage6 (（如果可用)
2. 擷取至少一張影像以顯示所選的 test image。如果您想在 pylon Viewer 中顯示 test image，請點擊工具列上的單張或連續拍攝按鈕。

可用的 Test Images#

根據您的相機型號，可提供以下 test images：

Test Image 1 - 固定對角線灰階漸層 (8 bit)#

• 由 0 到 255 的固定對角線灰階漸層組成。
• 最適合相機設定為單色 8-bit 輸出時使用。

Test Image 2 - 移動對角線灰階漸層 (8 bit)#

• 請參閱 test image 1。
• 差異：由移動對角線灰階漸層組成。當觸發新的影像擷取時，影像會向左移動一個像素。

Test Image 3 - 移動對角線灰階漸層#

• 請參閱 test image 1。
• 差異：由移動對角線灰階漸層組成。
• 在大多數相機上，這是 12-bit 圖樣。在部分相機型號上，這是 10-bit 圖樣。

Test Image 4 - 移動對角線灰階漸層功能測試 (8 bit)#

• 請參閱 test image 1。
• 差異：由移動對角線灰階漸層組成。此外，它會顯示已啟用的任何數位處理功能的效果（例如亮度查找表）。

Test Image 5 - 移動對角線灰階漸層功能測試#

• 請參閱 test image 1。
• 差異：由移動對角線灰階漸層組成。此外，它會顯示已啟用的任何數位處理功能的效果（例如亮度查找表）。
• 在大多數相機上，這是 12-bit 圖樣。在部分相機型號上，這是 10-bit 圖樣。

Test Image 6 - 移動對角線彩色漸層#

• 若可用，此 test image 由移動對角線彩色漸層組成。當觸發新的影像擷取時，影像會向左移動一個像素。

相機設定對 Test Images 的影響#

• 相機的類比功能（例如 Gain、Black Level 和 Exposure Time）對 test images 沒有影響。
• 相機的數位功能（例如 Luminance Lookup Table）僅對 Test Images 4 和 5 生效。如果您想檢查使用數位功能的效果，請使用 Test Images 4 或 5。

其他參數#

根據 您的相機型號上， TestImageResetAndHold 參數可用：

• 它允許您將移動的 Test Images 轉換為固定的 Test Images。
• 當發出此指令時，所有漸層都會顯示在其起始位置。如果觸發了新的影像擷取，它們將保持在這些位置。
• 它適用於固定和移動的 Test Images。

詳細資料#

顯示所有相機型號

範例程式碼#

// 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 來輕鬆設定參數。