WRead_DIB Function (Windows)

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

Usage

status = WRead_DIB( [window_index] )

Input Parameters

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.

Returned Value

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

< 0 — Indicates an error.

0 — Indicates a successful read.

Keywords

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.

Discussion

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.

This function loads a DIB from a file into a graphics window. To load a DIB directly into a variable, use the function DC_READ_DIB.

Example

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')