MGL_getDivotCoord
Saves a divot of video memory into system RAM.
Declaration
void MGLAPI MGL_getDivotCoord(
MGLDC *dc,
int left,
int top,
int right,
int bottom,
void *divot)
Prototype In
mgraph.h
Parameters
dc |
Device context to save divot from |
left |
Left coordinate of area to save |
top |
Top coordinate of area to save |
right |
Right coordinate of area to save |
bottom |
Bottom coordinate of area to save |
divot |
Pointer to area to store the video memory in |
Description
This function copies a block of video memory from the active page of the current device context into a system RAM buffer. A divot is defined as being a rectangular area of video memory that you wish to save, however the bounding rectangle for the divot is expanded slightly to properly aligned boundaries for the absolute maximum performance with the current device context. This function is generally used to store the video memory behind pull down menus and pop up dialog boxes, and the memory can only be restored to exactly the same position that it was saved from.
You must pre-allocate enough space to hold the entire divot in system RAM. Use the MGL_divotSize routine to determine the size of the memory block required to store the divot.
See Also
MGL_getDivot, MGL_putDivot, MGL_divotSize, PM_malloc
Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com