| Home
| Previous
| Next
| Up

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