Supported Browsers Home   
MGL_copyPageCoord Previous   
MGL_copyToBuffer Next   
External Functions Up   

MGL_copyRegion

Create a copy of the specified region.

Declaration

region_t * MGLAPI MGL_copyRegion(
    const region_t *s)

Prototype In

mgraph.h

Parameters

s

Pointer to source region

 

Return Value

Pointer to the copied region, or NULL if out of memory.

Description

Copies the definition for an entire region and returns a pointer to the newly created region. The space for the copied region is allocated from the region memory pool, which MGL uses to maintain a local memory allocation scheme for regions to increase performance.

If there is not enough memory to copy the region, this routine will return NULL.

See Also

MGL_newRegion, MGL_freeRegion, MGL_clearRegion, MGL_copyIntoRegion

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com