WinBitmapGet Function (ROM Call 0x6)

wingraph.h

short WinBitmapGet (WINDOW *w, const WIN_RECT *rect, void *BitMap);

Gets a bitmap from a window.

WinBitmapGet stores a series of bytes (the size of which is defined by WinBitmapSize) defining a bitmap for a rectangular area (whose boundaries are given using WIN_RECT structure rect) into a buffer pointed to by BitMap. All coordinates are relative to the topleft corner of the window pointed to by w. Actual stored bitmap may be smaller than area defined by rect due to clipping on the boundaries of the clipping area of the window.

The first two words at address BitMap will contain the height and the width (in pixels) of the rectangular area respectively (after eventual clipping), then actual data follows. BitMap is usually a pointer to a BITMAP structure. WinBitmapGet returns FALSE if the region defined by rect is outside of the window, and returns TRUE if it is partially or entirely inside the window.


Uses: WinBitmapSizeExt, WinToScr, BitmapGet, ClientToScr, PortRestore, ScrRectOverlap, ROM Call 0x3EC, ROM Call 0x413
Used by: cmd_newpic, gr_stopic, GT_SaveAs