MGL_saveBitmapFromDC

Save a portion of a device context to bitmap file on disk.

Declaration

ibool MGLAPI MGL_saveBitmapFromDC(
MGLDC *dc,
const char *bitmapName,
int left,
int top,
int right,
int bottom)

Prototype In

mgraph.h

Parameters

dc | Device context to save
bitmapName | Name of bitmap file to save
left | Left coordinate of bitmap to save
top | Top coordinate of bitmap to save
right | Right coordinate of bitmap to save
bottom | Bottom coordinate of bitmap to save

Return Value

True on success, false on error.

Description

This function saves a portion of a device context as a bitmap file to disk. If this function fails for some reason, it will return false and you can get the error code from the MGL_result function.

Note that the source rectangle for the bitmap to be saved is not clipped to the current clipping rectangle for the device context, but it is mapped to the current viewport. If you specify dimensions that are larger than the current device context, you will get garbage in the bitmap file as a result.

See Also

MGL_loadBitmap,MGL_loadBitmapIntoDC

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com