IMAQ Create VI

Owning Palette: Image Management
Requires: NI Vision Development Module

Creates a temporary memory location for an image. Use IMAQ Create in conjunction with the IMAQ Dispose VI to create or dispose of NI Vision images in LabVIEW.

IMAQ Create

/images/reference/en-XX/help/370281AG-01/ci32.gif

Border Size determines the width, in pixels, of the border to create around an image. These pixels are used only for specific VIs. Create a border at the beginning of your application if an image is to be processed later using functions that require a border (for example, labeling and morphology). The default border value is 3. With a border of three pixels, you can use kernels up to 7 × 7 with no change. If you plan to use kernels larger than 7 × 7 in your process, specify a larger border when creating your image.

The following graphic illustrates an 8 × 6 image with a border equal to 0.

In the following 8 × 6 image, the border equals 2, allowing the use of kernels up to 5 × 5.

Note  The border of an image is taken into account only when the image is processed. It is never displayed or stored in a file.
/images/reference/en-XX/help/370281AG-01/cstr.gif

Image Name is the name associated with the created image. Each image created must have a unique name.

/images/reference/en-XX/help/370281AG-01/cerrcodeclst.gif

error in (no error) 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.

/images/reference/en-XX/help/370281AG-01/cbool.gif

status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.

/images/reference/en-XX/help/370281AG-01/ci32.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.

/images/reference/en-XX/help/370281AG-01/cstr.gif

source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.

/images/reference/en-XX/help/370281AG-01/cu32.gif

Image Type specifies the image type. Choose from the following values:

Grayscale (U8) (0)

8 bits per pixel (unsigned, standard monochrome)

Grayscale (16) (1)

16 bits per pixel (signed)

Grayscale (SGL) (2)

32 bits per pixel (floating point)

Complex (CSG) (3)

2 × 32 bits per pixel (floating point)

RGB (U32) (4)

32 bits per pixel (red, green, blue, alpha)

HSL (U32) (5)

32 bits per pixel (hue, saturation, luminance, alpha)

RGB (U64) (6)

64 bits per pixel (red, green, blue, alpha)

Grayscale (U16) (7)

16 bits per pixel (unsigned, standard monochrome)

/images/reference/en-XX/help/370281AG-01/igenclasstagrefflat.gif

New Image is the Image reference that is supplied as input to all subsequent (downstream) functions used by NI Vision. Multiple images can be created in a LabVIEW application.

/images/reference/en-XX/help/370281AG-01/ierrcodeclst.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, it describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.

/images/reference/en-XX/help/370281AG-01/ibool.gif

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

/images/reference/en-XX/help/370281AG-01/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.

/images/reference/en-XX/help/370281AG-01/istr.gif

source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.

WAS THIS ARTICLE HELPFUL?

Not Helpful