Retrieve

Retrieves a previously triggered image from one or more cameras. If a camera is in hardware trigger mode the command can wait for the trigger signal with a user defined timeout .Captures an image on one or more cameras.

Note

Please also have a look at the Capture command which performs Trigger and Retrieve operations together.

Error Symbols

errCaptureTimeout

Cause: The camera did not return an image pair within the specified timeout.

Solution: Increase the timeout or investigate the correctness of the trigger signal when using a hardware trigger.

errImageTransferFailed

Cause: The image could not be transferred over the bus and is lost.

Solution: Decrease the camera’s PixelClock or disconnect other devices from the bus, if any. When using USB cameras you might also want to choose a different USB port on your computer and verify that the camera is connected as the only device to one of your system’s USB root hubs.

Note

In Windows the USB device tree can be checked via the Device Manger’s option “View Devices by Connection” or by using the Microsoft USBView utility. For optimal performance please ensure that the stereo camera is connected directly and without any other devices to one of the USB root hubs. In the Device Manager a root hub is usually listed as “USB Root Hub”, whereas an N10 camera will be shown as “Generic USB Hub” (which is the camera’s internal hub), with two USB cameras connected to it. Each single camera below the internal hub is listed as “uEye UI-122xLE Series”.

Note

During the time the command waits for an image it can be interrupted by the Break command (e.g. to stop waiting for a hardware trigger signal).

Note

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