WWrite_DIB Function (Windows)
Saves the contents of a graphics window to a file as a Device Independent Bitmap (DIB).
Usage
status = WWrite_DIB( [window_index] )
Input Parameters
window_index — (optional) The index of the window from which the image is to be saved. If not specified, the current window is assumed.
Returned Value
status — A value indicating success or failure of the write; expected values are:
*< 0 — Indicates an error.
*0 — Indicates a successful write.
Keywords
Filename — A string containing the name of the output DIB file. If not specified, a file named wave.bmp is created in the current directory.
Interactive — If present and nonzero, open the Import Graphics dialog box. This dialog box lets you interactively create or select an export file.
Discussion
This function saves the contents of a graphics window to a DIB format file. To export the contents of a variable to a DIB file, use the DC_WRITE_DIB function.
Example
The following commands demonstrate how to export the contents of graphics window 2 to a DIB file:
; Create a window and display graphics in it.
WINDOW, 2
SHADE_SURF, DIST(40)
; Save the contents of the window directly in a DIB format file.
status = WWRITE_DIB(2, Filename='image.bmp')
See Also
The graphics window Control menu includes a command that exports DIB graphics to a file. For information on the Control menu, see the PV‑WAVE User’s Guide.