Winbitmapget - Texas Instruments TI-89 Developer's Manual

1156

WinBitmapGet

Declaration: BOOL WinBitmapGet (WINDOW * w , const WIN_RECT * WinRect ,
BITMAP * Bitmap )
Category(ies): Windows
Description: Store a series of bytes (the size of which is defined by WinBitmapSize)
defining a bitmap for a window into Bitmap . Return FALSE if the region
defined by WinRect is outside of the window, TRUE if it is partially or
entirely inside the window.
Inputs: w
WinRect — The region of the WINDOW w to get as a bitmap.
Outputs: Bitmap — Output BITMAP (the first WORD is the number of rows, the
second WORD is the number of columns and then the actual data follows
as a series of bytes). Note that a BITMAP must always have one or more
rows and one or more columns so its size is always at least five bytes long.
Assumptions: Bitmap has enough room to store the retrieved BITMAP.
Side Effects: Note that there is a special case if the upper left x or y coordinate is less
than zero. The region from the negative area to the lower right clip area is
returned (use WinBitmapSizeExt in that case to determine the correct size
of Bitmap ). Otherwise the region returned is based from the Clip region.
Availability: All versions of the TI-89 / TI-92 Plus.
TI-89 / TI-92 Plus
Differences: None
See Also: WinBitmapPut, WinBitmapSize, WinBitmapSizeExt
TI-89 / TI-92 Plus Developer Guide
Appendix A: System Routines — Windows
— WINDOW struct of a previously opened window.
typedef struct {
WORD NumRows;
WORD NumCols;
BYTE Data[1];
} BITMAP;
(continued)
Not for Distribution Beta Version January 26, 2001