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.


icon

Inputs/Outputs

  • cpict.png picture —

    picture is the picture to which you want to add the pixmap. The default is an empty picture.

  • cnclst.png top left point(0, 0) —

    top left point specifies in coordinates where to place the top-left corner of the image in the new picture.

  • ci16.png x —

    x is the horizontal coordinate that increases to the right.

  • ci16.png y —

    y is the vertical coordinate that increases to the bottom.

  • c2du8.png data —

    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.

  • c1du32.png color table —

    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.

  • c1du8.png mask —

    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.

  • ipict.png new picture —

    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.