Admin Production ni-theme
Current Publication

SaveBitmapToBMPFile

LabWindows/CVI

SaveBitmapToBMPFile

int SaveBitmapToBMPFile (int bitmapID, char filename[]);

Purpose

Saves a bitmap image to a .bmp file. This function returns an error if you attempt to save a transparent bitmap or a bitmap that originated from a metafile.

Parameters

Input
Name Type Description
bitmapID int ID of the bitmap object that contains the image. You can obtain the ID from functions such as NewBitmap and GetCtrlBitmap.
filename char [] Pathname of the file in which to save the image.

You can use a complete pathname or a simple filename. If the name is a simple filename, the file is saved in the directory that contains the executable.

Return Value

Name Type Description
status int Return value indicating whether the function was successful. A negative number indicates that an error occurred.

Additional Information

Library: User Interface Library

Include file: userint.h

LabWindows/CVI compatibility: LabWindows/CVI 7.1 and later

Example

Refer to userint\ICOViewer.cws for an example of using the SaveBitmapToBMPFile function.