Trigger

Triggers an image acquisition on one or more cameras.

Note

The Capture command performs a combination of the Trigger and Retrieve commands.

Triggering Cameras

Triggering a camera with the Trigger or Capture command prepares the hardware for acquisition of an image according to the camera’s TriggerMode. A hardware triggered camera will be armed and start exposure with the next hardware trigger signal. A software triggered camera will be sent a message to start exposure as soon as possible.

After exposure has finished, the image will be transferred to a buffer from which it can be retrieved by the Retrieve or Capture command (see below).

After a camera was triggered, its Triggered flag will be set until the image has been retrieved successfully or a command that should have retrieved the image failed.

Note

Software triggering will be delayed until the LED can flash for the full exposure time without leaving its specification. See the Illumination topic for details.

Note

Any errors that occurred during exposure or image transfer will only be reported when trying to retrieve the images with the Retrieve or Capture commands.

Execution

Trigger the subset of cameras specified by the (Subset) parameter.

Camera Order

If the (Cameras) parameter is specified, cameras are triggered in the exact order that was specified.

If no order is specified, trigger operations are executed on hardware triggered cameras (in any order) and then on software triggered cameras (in any order).