Image Management

LabView NI Vision

Image Management

Owning Palette: Vision UtilitiesInstalled With: NI Vision Development Module

Use the Image Management VIs to create and dispose of images, set and read attributes of an image, and copy one image to another.

Palette Object Description
IMAQ Create

Creates a temporary memory location for an image.

IMAQ Dispose

Destroys an image and frees the space it occupied in memory. This VI is required for each image created in an application to free the memory allocated to the IMAQ Create VI. Execute IMAQ Dispose only when the image is no longer needed in your application. You can use IMAQ Dispose for each call to IMAQ Create or just once for all images created with IMAQ Create.

IMAQ Image Bit Depth

Gives information regarding the bit depth of an image or modifies the bit depth of an image. The bit depth of an image determines how NI Vision displays the image, casts the image to another image type, and writes the image to a PNG file. Refer to the IMAQ WindDraw VI, the IMAQ Cast Image VI, and the IMAQ Write PNG File 2 VI for more information.

IMAQ GetImageSize

Gives information regarding the size (resolution) of the image.

IMAQ SetImageSize

Modifies the resolution of an image.

IMAQ GetImageInfo

Gives different characteristics of the image.

IMAQ Copy

Copies the specifications and pixels of one image into another image of the same type. You can use this function to keep an original copy of an image (for example, before processing an image). The full definition of the source image as well as the pixel data are copied to the destination image. The border size of the destination image also is modified to be equal to that of the source image. If the source image contains additional information, such as calibration information, overlay information, or information for pattern matching, this information is also copied to the destination image.

IMAQ ImageToImage 2

Copies a small image into part of another larger image. This VI is useful for replacing a portion of an image with another image.

IMAQ GetOffset

Returns the position of an image mask in relation to the origin of the coordinate system (0, 0). The default offset value [0, 0] is established when the image is initially created by the IMAQ Create VI. The offset is used only for mask images. By setting different offset values with the IMAQ SetOffset VI, you can move the mask to any location in the image without having to create a new image for each mask.

IMAQ SetOffset

Defines the position of an image mask in relation to the origin of the coordinate system (0, 0).

IMAQ Cast Image

Converts the current image type to the image type specified by Image Type. If you specify a lookup table, the IMAQ Cast Image VI converts the image using a lookup table. If converting from a 16-bit image to an 8-bit image, the VI executes this conversion by shifting the 16-bit pixel values to the right by the specified number of shift operations and then truncating to get an 8-bit value.

IMAQ Is Vision Info Present 2

Checks for the presence of extra vision information associated with the image. Extra vision information can include overlay information, color and grayscale pattern matching templates, calibration information, and custom data.

IMAQ Remove Vision Info 2

Removes specified extra vision information associated with the image. Extra vision information can include overlay information, color and grayscale pattern matching templates, calibration information, and custom data.

IMAQ Read Custom Data

Reads the data associated with a key from an image.

IMAQ Write Custom Data

Associates data with a key in an image. If the key does not exist, it is created. If it does exist, its current value is overwritten.

IMAQ Get Custom Keys

Retrieves all the keys from an image that have data associated with them.

IMAQ Remove Custom Data

Removes a key and its data from an image.

IMAQ Remote Display Options

Sets or gets the image compression options for remote display. These compression options affect remotely acquired images that are transferred and displayed on a host machine.

IMAQ Flatten Image Options

Sets or gets the image compression options for flattening an image to string. These compression options affect images flattened using the LabVIEW Flatten To String primitive.

IMAQ Flatten Image to String

Returns the string representation of an image using the provided options.

IMAQ Multi-Core Options

Sets the number of available processor cores to use for NI Vision applications.



Subpalette Description
External Library Support

Use the External Library Support VIs for additional external library functionality that is not provided by LabVIEW.

Caution  These functions are intended for advanced users. Improper use may result in hanging your application.