Host interface 49
Formatting/
converting data
when grabbing into
Host buffers
When you grab into a Host buffer (for example, using the MIL-Lite function
MdigGrab()
), use
MdigControl()
with
M_SOURCE_OFFSET_X/Y
,
M_SOURCE_SIZE_X/Y
, and/or
M_GRAB_SCALE_X/Y
to crop or resize
image data when grabbing.
When grabbing into a Host buffer, the color space converter and pixel formatter
is not used to flip images; the acquisition controller is responsible for this task.
For more information, see the
section section, earlier in this
chapter. To flip image data when grabbing, use
MdigControl()
with
M_GRAB_DIRECTION_X/Y
.
When grabbing into a Host buffer, the color space converter and pixel formatter
automatically converts the bit-depth and color format of the source image to the
bit-depth and color format of the destination buffer. The DCF establishes the
format of the source, while the destination grab buffer establishes the output
format.
Formatting/
converting data
when grabbing into
on-board buffers
When grabbing into an on-board buffer, only acquisition controller formatting
operations are supported; these are horizontal and vertical flipping and, if grabbing
from a line-scan video source, cropping in Y. If you then transfer image data from
an on-board buffer to a Host buffer using the MIL-Lite
MbufCopy()
,
MbufTransfer()
,
MimResize()
, or
MimFlip()
function, any required conversion
or formatting operation will be performed using the color space converter and
pixel formatter if supported.
To flip image data horizontally in hardware, you must do so while the image is
being acquired, using the acquisition controller. When transferring image data
from an on-board buffer to a Host buffer, this operation is not supported in
hardware.
