Class
Accessible
Camera.Acquisition.Capture
Syntax
uEye.Acquisition.Capture()
uEye.Acquisition.Capture(int wait)
uEye.Acquisition.Capture(uEye.Defines.DeviceParameter param)
Description
Activates the camera's live video mode (free run mode). The driver transfers the images to an allocated image memory or, if Direct3D is used, to the graphics card. The image data (DIB mode) is stored in the memory created using Allocate() and designated as active image memory using SetActive(). Using GetActive(), you can query the memory address.
If ring buffering is used, the image capturing function cycles through all image memories used for storing the images of a capture sequence in an endless loop. Sequence memories locked by LockSequenceId() will be skipped. If the last available sequence memory has been filled, the sequence event or message will be triggered. Capturing always starts with the first element of the sequence.
When you call Capture() in trigger mode, the camera is set to continuous trigger standby. An image is recorded on each electrical trigger signal and afterwards the camera is ready to trigger again.
|
Note: uEye.Acquisition.Capture() 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: Function returns when the command is completed. |
uEye.Defines.DeviceParameter.Force: Forces a software-controlled capture of an image while a capturing process triggered by hardware is in progress. This function can only be used if the triggered capturing process was started using the DontWait parameter. |
|
uEye.Defines.DeviceParameter.Wait: Function returns when the 1st image is in memory. |
|
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 while image acquisition continues. |
