|
|
|
|
MGL_setPenPixmapPattern
Downloads a new pixmap pattern into the driver.
Declaration
void MGLAPI MGL_setPenPixmapPattern(
int index,
const pixpattern_t *pat)
Prototype In
mgraph.h
Parameters
index |
Index of the pixmap pattern slot to download into |
pat |
New pixmap pattern to download |
Description
This function downloads a new pixmap pattern into the hardware on the graphics device. The MGL supports 8 patterns cached in the driver, allowing you to select one of them to be active at a time using the MGL_usePenPixmapPattern function. Pixmap patterns are used used when rendering patterned primitives in the MGL_PIXMAP pen style. A pixmap pattern is defined as an 8 x 8 array of color pixels, stored differently depending on the color depth for the pattern. When filling in MGL_PIXMAP mode, the foreground and background color values are not used, and the pixel colors are obtained directly from the pixmap pattern colors.
Note: After calling MGL_setPenPixmapPattern, the pattern will not become active until after you also call MGL_usePenPixmapPattern. This function only downloads the pattern into the pattern cache, and does not actually select the pattern for use (even if the old selected pattern was the same index).
See Also
MGL_usePenPixmapPattern, MGL_getPenPixmapPattern, MGL_setPenBitmapPattern, MGL_setPenStyle
Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com