|LabVIEW 2016 Help|
|LabVIEW 2017 Help|
|LabVIEW 2018 Help|
|LabVIEW 2019 Help|
|LabVIEW 2020 Help|
Owning Palette: Graphics Formats VIs
Requires: Base Development System
Converts a cluster of image data into a 2D array.
|image data describes the image you want to draw or manipulate. If you wire 32-bit image data to this VI, the VI returns a 24-bit pixmap. |
|top left is a cluster that contains a horizontal (x) and a vertical (y) component. |
|24-bit pixmap returns the 2D array of data to draw as a pixmap. The dimensions of the pixmap match the dimensions of this array.|
|8-bit pixmap returns the 2D array of data to draw as a pixmap. The dimensions of the pixmap match the dimensions of this array. The VI uses the data as indexes in the colors output.|
|4-bit pixmap returns the 2D array of data to draw as a pixmap. The dimensions of the pixmap match the dimensions of this array. The VI uses the data as indexes in the colors output.|
|1-bit pixmap returns the 2D array of data to draw as a bitmap. The dimensions of the bitmap match the dimensions of this array. Elements that are FALSE map to element 0 in the colors output and elements that are TRUE map to element 1.|
|colors is an array of RGB color values that correspond to the values in the pixmap output. For the 24-bit pixmap, LabVIEW ignores this output. For the 8-bit pixmap, the array can have 256 elements. For the 4-bit pixmap, the array can have 16 elements. For the 1-bit pixmap, the array can have 2 elements.|
|mask is an array of bytes in which each bit describes mask information for a pixel. The first byte describes the first eight pixels, the second byte describes the next eight pixels, and so on. If a bit is zero, LabVIEW draws the corresponding pixel as transparent. If the array is empty, LabVIEW draws all pixels without transparency. If the array does not contain a bit for each pixel in the image, LabVIEW draws any pixels missing from the array without transparency.|
When you use a Graphics Formats VI to read a graphics file, the VI returns the image data in a cluster. Use the Draw Unflattened Pixmap VI to display the data directly or use the Unflatten Pixmap VI to convert the data to a more useful 2D representation.
In this VI, only one of the various pixmap outputs (24-bit, 8-bit, 4-bit, or 1-bit) is valid at a time. In other words, this VI will not produce an output of two different pixmap values.