Set8x8MonoPattern

Download an 8x8 monochrome pattern to the driver.

Declaration

void NAPI GA_2DStateFuncs::Set8x8MonoPattern(
    N_int32 index,
    GA_pattern *pattern)

Prototype In

snap/graphics.h

Parameters

index

Index of the pattern to download

pattern

Pointer to pattern data to download

 

Description

This downloads one of 8, 8x8 monochrome patterns for all subsequent monochrome pattern filled functions. The 8x8 monochrome fill pattern is used for rectangle and scanline filling, where the pattern is X and Y coordinate aligned with the left edge and top edge of the display. In the bitmap pattern, pixel 0 corresponds to bit 7 in byte 0, pixel 1 = bit 6 in byte 0, ... pixel 8 = bit 7 in byte 1 etc. It is the responsibility of the calling application to rotate the pattern before calling this routine if it is desired that the pattern be aligned to a different starting coordinate (such as with Windows Bitmaps and setting the bitmap origin). The bitmap pattern is passed as a packed array of 8 bytes.

Note:    8 cached patterns are supported because some hardware supports caching multiple patterns in offscreen video memory for maximum performance. In cases where the hardware only supports a single hardware pattern, the driver is responsible for caching the pattern data internally and downloading it as efficiently as possible to the display hardware.

See Also

Use8x8MonoPattern, Set8x8ColorPattern, Use8x8ColorPattern, GA_2DRenderFuncs::DrawPattScan, DrawPattScanList, DrawPattRect, DrawPattTrap

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