READ_XBM Procedure

Reads the contents of an X-bitmap (XBM) file into a PV‑WAVE variable.

Usage

READ_XBM, file, image 

Input Parameters

file—A scalar string indicating the name of the bitmap file.

image—A 2D byte array containing the image from the file.

Keywords

Background—Specifies the background color. (Default: !P.Background)

Color—Specifies the foreground color. (Default: !P.Color)

Order—Determines the y-scan order as follows:

0—Scans down from the top

1—Scans up from the bottom

Discussion

The READ_XBM procedure allows you to use XBM images in PV‑WAVE for analysis and display, or to convert to other formats by using the IMAGE_WRITE function.

Example

; Reads in a file into a 2D byte array.

READ_XBM, !Data_dir + '/sample.xbm', x 

; Displays the image.

WzImage, x

See Also

HTML_IMAGE, IMAGE_CREATE, IMAGE_READ, IMAGE_WRITE, WRITE_XBM