Acquiring Images By Applying A Series Of Software Triggers - Basler Pioneer User Manual

Image Acquisition Control
10.2.3 Acquiring Images by Applying a Series of
Software Triggers
You can set the camera to react to multiple applications of the software trigger and then apply a
series of software triggers to acquire images. To do so, follow this sequence:
1. Access the camera's API and set the exposure time parameter for your desired exposure time.
2. Set the value of the camera's Acquisition Mode parameter to Continuous.
3. Execute an Acquisition Start command. This prepares the camera to react to software triggers.
4. When you are ready to begin an image acquisition, execute a Trigger Software command.
5. Image acquisition will start and exposure will continue for the length of time you specified in
step 1.
6. At the end of the specified exposure time, readout and transmission of the acquired image will
take place.
7. To acquire another image, go to step 4.
8. Execute an Acquisition Stop command. The camera will no longer react to software triggers.
If you are acquiring images using a series of software triggers, you must avoid acquiring images at
a rate that exceeds the maximum allowed with the current camera settings.
You should also be aware that if the Acquisition Frame Rate Abs parameter is enabled, it will
influence the rate at which the Trigger Software command can be applied:
If the Acquisition Frame Rate Abs parameter is set to a value less than the maximum allowed,
you can trigger acquisition at any rate up to the set value.
If the Acquisition Frame Rate Abs parameter is set to a value greater than the maximum
allowed, you can trigger acquisition at any rate up to the maximum allowed image acquisition
rate with the current camera settings.
You can set the exposure time and the Acquisition Mode parameter values from within your
application software by using the pylon API. You can also execute the Acquisition Start and Trigger
Software commands. The following code snippets illustrate using the API to set the parameter
values and execute the commands:
// issuing software trigger commands
Camera.ExposureTimeRaw.SetValue( 200 );
Camera.AcquisitionMode.SetValue( AcquisitionMode_Continuous );
// prepare for image acquisition here
Camera.AcquisitionStart.Execute( );
while ( ! finished )
{
Camera.TriggerSoftware.Execute( );
// retrieve acquired image here
}
Camera.AcquisitionStop.Execute( );
// how to set and test the Acquisition Frame Rate
Camera.AcquisitionFrameRateAbs.SetValue( 60.0 );
118 Basler pioneer