Class
Accessible
Camera.Acquisition.Freeze
Syntax
uEye.Acquisition.Freeze()
uEye.Acquisition.Freeze(int wait)
uEye.Acquisition.Freeze(uEye.Defines.DeviceParameter param)
Description
Acquires a single image from the camera. In DIB mode, the image is stored in the active image memory. If ring buffering is used in DIB mode, the captured image is transferred to the next available image memory of the sequence. Once the last available sequence memory has been filled, the sequence event or message will be triggered.
|
Note: The Freeze() method is not recommended for multiple or continuous capturing. Use the Capture() method instead. |
In Direct3D mode, the image is directly copied to the graphics card buffer and then displayed.
Image capture will be started by a trigger if you previously enabled the trigger mode using Set(). A hardware triggered image acquisition can be canceled using Stop() if exposure has not started yet. If you call Freeze() with the wait parameter, you have to simulate a trigger signal using Force() to cancel the acquisition.
|
Note: uEye.Acquisition.Freeze() uses the default setting "do not wait". |
For further information on the image capture modes, see the "How to proceed: Image capture" section in the uEye manual.
Parameter
none |
Default: do not wait |
param/wait |
uEye.Defines.DeviceParameter.DontWait (asynchronous image capture) |
uEye.Defines.DeviceParameter.Wait (synchronous image capture) |
|
Time t (Value range: 4...429496729 ms): Timeout value for image acquisition Note: If a timeout value t is passed and the camera does not return after t + 10 ms, the function returns with IS_TIMED_OUT and image acquisition is aborted. |
