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