Basler acA2000-165, User Manual

Page: 237 / 272

AW00123402000 Features
Basler ace USB 3.0 227
You can enable event notification and make the additional settings from within your application
software by using the pylon API. The pylon 4 Camera Software Suite includes a
"Grab_CameraEvents" code sample that illustrates the entire process.
For more detailed information about using the pylon API, refer to the Basler pylon Programmer’s
Guide and API Reference.
8.13 Test Images
All cameras include the ability to generate test images. Test images are used to check the camera’s
basic functionality and its ability to transmit an image to the host PC. Test images can be used for
service purposes and for failure diagnostics. For test images, the image is generated internally by
the camera’s logic and does not use the optics, the imaging sensor, or the ADC. Six test images are
available.
The Effect of Camera Settings on Test Images
When any of the test image is active, the camera’s analog features such as gain, black level, and
exposure time have no effect on the images transmitted by the camera. For test images 1, 2, 3 and
6, the cameras digital features, such as the luminance lookup table, will also have no effect on the
transmitted images. But for test images 4 and 5, the camera’s digital features will affect the images
transmitted by the camera. This makes test images 4 and 5 a good way to check the effect of using
a digital feature such as the luminance lookup table.
Enabling a Test Image
The Test Image Selector is used to set the camera to output a test image. You can set the value of
the Test Image Selector to one of the test images or to "test image off".
You can set the Test Image Selector from within your application software by using the Basler pylon
API. The following code snippets illustrate using the API to set the selector:
// Set for no test image
camera.TestImageSelector.SetValue(TestImageSelector_Off);
// Set for the first test image
camera.TestImageSelector.SetValue(TestImageSelector_Testimage1);
You can also use the Basler pylon Viewer application to easily set the parameters.
For more information about the pylon API and the pylon Viewer, see Section 3.1 on page 37 .