Syntax: Call object.AcquireMem(Window As Long, BufferCount As Long, Mode As AcquireModeEnum)
Description
Acquires one or more ROIs to memory buffers, displaying the data in a window, if desired.
Parts of Syntax
Name object
Type DTAFGMON
Description The name you assigned to the control.
Range N/A
Name Window
Type Long
Description The handle of the window in which you want to display the acquired data.
Range Any valid window handle. If you specify a value of 0, data is displayed on the surface of the control. If you specify a value of –1, no data is displayed.
Name BufferCount
Type Long
Description The number of buffers that you want to use for the acquisition. Each buffer is equal to the size of the current region of interest (as defined by the ROIWidth property and the ROI Height property).
Range Depends on the size of the current ROI and the amount of available system memory.
Name Mode
Type AcquireModeEnum
Description The acquisition mode.
Range SinglePassSync = As you acquire frames/fields, save ROIs to the number of buffers specified by BufferCount, then stop the operation. This method operates synchronously when SinglePassSync mode is used.
SinglePassAsync - As you acquire frames/fields, save ROIs to the number of buffers specified by BufferCount, then stop the operation. You can also use the StopAcquire method to stop the operation, if required. This method operates asynchronously when SinglePassAsync mode is used.
Note that typically you will not use this mode. It is useful if you expect your acquisition to take a long time and want to process data while the operation is in progress, if you are using an external trigger, or if you are using a variable-scan signal.
ContinuousAsync = As you acquire frames/fields, save ROIs continuously to the number of buffers specified by BufferCount until the StopAcquire method is called. When BufferCount buffers are filled, overwrite the first buffer. This method operates asynchronously when ContinuousAsync mode is used.
Returned Value
None
Remarks
The size of each buffer is based on the ROI size. If you are acquiring frames, one frame is stored in each buffer; if you are acquiring fields, one field is stored in each buffer.
When you call the AcquireMem method, the software allocates BufferCount memory buffers. To access these buffers, use the GetBuffer method before you call AcquireMem again.
For more information about performing single-pass or continuous acquisitions, refer to the example programs on the Imaging OMNI CD.
Example
'acquire 10 ROIs to memory and stop;
'do not display the ROIs
Call DTAFGMON1.AcquireMem(-1, 10, SingleShot)