MGL_createCustomDC

Creates a new custom memory device context.

Declaration

MGLDC * MGLAPI MGL_createCustomDC(
int xSize,
int ySize,
int bitsPerPixel,
pixel_format_t *pf,
int bytesPerLine,
void *surface,
MGL_HBITMAP hbm)

Prototype In

mgraph.h

Parameters

xSize | X resolution for the memory context
ySize | Y resolution for the memory context
bitsPerPixel | Pixel depth for the memory context
pf | Pixel format for memory context
bytesPerLine | Buffer pitch for memory context
surface | Pointer to surface memory for context
hbm | Handle to HBITMAP for DIB section

Return Value

Pointer to the allocated memory device context.

Description

This function is useful for creating an MGL device context for a memory block provided by an application. This allows the SciTech MGL to render to memory it does not own (e.g. custom hardware framebuffers, or bitmaps allocated by other runtime libraries).

For Windows if the hbm parameter is not NULL, it is assumed that the original memory was created by a call to CreateDIBSection and the hbm parameter is a handle to the bitmap object for the DIB section. This parameter can be used to blit the memory DC image to a windowed DC using the standard Windows GDI blit functions. The hbm parameter is not necessary for fullscreen modes.

See Also

MGL_createMemoryDC, MGL_destroyDC

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