| Home
| Previous
| Next
| Up

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