IMAQdx Get Image Data VI

NI-IMAQdx VI

IMAQdx Get Image Data VI

Installed With: NI Vision Acquisition Software

Copies the raw data of the specified frame into Image Data Array. Call this VI only after calling the IMAQdx Configure Acquisition VI.

IMAQdx Get Image Data

cenum.gif

Buffer Number Mode (Next) specifies the buffer number mode. The default value is Next, which specifies that the driver will wait for the next acquired buffer. Other possible values are Last, which specifies that the driver will not wait for the next buffer but will instead return the last acquired buffer, and Buffer Number, which specifies an exact buffer number to wait for. Use Buffer Number Mode in conjunction with Buffer Number In.

cio.gif

Session In specifies the name of the camera you wish to reset. The default value is cam0.

cu32.gif

Buffer Number In is the cumulative image number to get.

ccclst.gif

error in describes the error status before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. Explain Error (or Explain Warning) gives more information about the error displayed.

cbool.gif

status boolean is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

ci32.gif

code input identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

cstr.gif

source string describes the origin of the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

iio.gif

Session Out is a unique reference to the camera. Session Out is the same as Session In.

i1du8.gif

Image Data Array is an array of unsigned bytes that represent the raw image data as transferred from the camera.

iu32.gif

Buffer Number Out is the actual acquired buffer number returned.

icclst.gif

error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, error out describes the error status that this VI produces. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

ii32.gif

code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.

istr.gif

source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.