Draw Unflattened Pixmap VI

LabVIEW 2018 Help


Edition Date: March 2018
Part Number: 371361R-01
View Product Info

DOWNLOAD (Windows Only)


LabVIEW 2016 Help
LabVIEW 2017 Help
LabVIEW 2018 Help
LabVIEW 2019 Help
LabVIEW 2020 Help

Owning Palette: Picture Functions VIs

Requires: Base Development System

Converts a pixmap into a picture so you can use other Picture Functions VIs to append drawing instructions to the image. The data type you wire to the data input determines the polymorphic instance to use. If you want to convert a 4-bit or 8-bit pixmap, you must manually select the polymorphic instance you want to use.

Use the pull-down menu to select an instance of this VI.

Draw True-Color Pixmap

picture is the picture to which you want to add the pixmap. The default is an empty picture.
top left point specifies in coordinates where to place the top-left corner of the image in the new picture.
x is the horizontal coordinate that increases to the right.
y is the vertical coordinate that increases to the bottom.
data is a 2D array of 32-bit unsigned integers that describes the color of each pixel in the image in raster order. Each pixel has three bytes to describe its color. The first byte for each pixel describes the red value, the second byte describes the green value, and the third byte describes the blue value.
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.
new picture is the picture that contains the new image. You can wire this output to any other picture input to add more drawing instructions to the picture.

Draw 1-Bit Pixmap

picture is the picture to which you want to add the pixmap. The default is an empty picture.
top left point specifies in coordinates where to place the top-left corner of the image in the new picture.
x is the horizontal coordinate that increases to the right.
y is the vertical coordinate that increases to the bottom.
data is a 2D array of Boolean inputs in which each input represents a single pixel. A value of FALSE in data corresponds to element 0 in color table. A value of TRUE in data corresponds to element 1 in color table.
color table is an array of two colors to which the array of data maps. If data is FALSE, the default is black. If data is TRUE, the default is white.
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.
new picture is the picture that contains the new image. You can wire this output to any other picture input to add more drawing instructions to the picture.

Draw 4-Bit Pixmap

picture is the picture to which you want to add the pixmap. The default is an empty picture.
top left point specifies in coordinates where to place the top-left corner of the image in the new picture.
x is the horizontal coordinate that increases to the right.
y is the vertical coordinate that increases to the bottom.
data is a 2D array of 8-bit unsigned integers that describes the color of each pixel in the image in raster order. Each element in data specifies the index of the corresponding color in color table. Thus, valid values in data are the indices of the color table array, or 0 through 15.
color table is an array of up to 16 colors to which the array of data maps. color table stores 32-bit RGB values where the most-significant byte is zero, followed in order by red, green, and blue values. If unwired, the VI uses the default LabVIEW 16-color palette.
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.
new picture is the picture that contains the new image. You can wire this output to any other picture input to add more drawing instructions to the picture.

Draw 8-Bit Pixmap

picture is the picture to which you want to add the pixmap. The default is an empty picture.
top left point specifies in coordinates where to place the top-left corner of the image in the new picture.
x is the horizontal coordinate that increases to the right.
y is the vertical coordinate that increases to the bottom.
data is a 2D array of 8-bit unsigned integers that describes the color of each pixel in the image in raster order. Each element in data specifies the index of the corresponding color in color table. Thus, valid values in data are the indices of the color table array, or 0 through 255.
color table is an array of up to 256 colors to which the array of data maps. color table stores 32-bit RGB values where the most-significant byte is zero, followed in order by red, green, and blue values. If unwired, the VI uses the default LabVIEW 256-color palette.
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.
new picture is the picture that contains the new image. You can wire this output to any other picture input to add more drawing instructions to the picture.

WAS THIS ARTICLE HELPFUL?

Not Helpful