Loads a Device Independent Bitmap (DIB) from a file into a graphics window.

window_index — (optional) The index of the window to receive the image. If not specified, the current window is assumed. If no window is currently open, an error results.

status — A value indicating success or failure; expected values are:

Filename — A string containing the name of the DIB (Device Independent Bitmap) file. If not specified, a file named wave.bmp is assumed to be in the current directory.

Interactive — If present and nonzero, open the Import Graphics dialog box. This dialog box lets you interactively select a file to import.

Device Independent Bitmap (DIB) is a bitmap format that is useful for transporting graphics and color table information between different devices and applications. DIB files can be produced by graphics applications such as Microsoft Image Editor, Microsoft Paintbrush, and PV‑WAVE.

Assume that the file map.bmp is a DIB file that was exported from a graphics application. The following command reads the contents of that file directly into the graphics window with index number 2.

status = WREAD_DIB(2, Filename='map.bmp')

DC_READ_DIB, DC_WRITE_DIB, WWRITE_DIB

The graphics window Control menu includes a command that imports DIB data from a file. For information on the Control menu, see Chapter 3, Getting Started: Windows, in the PV‑WAVE User’s Guide.