Caution: This version of this document is no longer maintained. For the latest documentation, see

PgSetTextDither(), PgSetTextDitherCx()

Set the dither pattern for text and bitmap


void PgSetTextDither( PgColor_t c1,
                      PgColor_t c0,
                      PgPattern_t pat );

void PgSetTextDitherCx( PhGC_t *gc,
                        PgColor_t c1,
                        PgColor_t c0,
                        PgPattern_t pat );




These functions combine two colors according to the pattern defined by pat and applies the pattern to text and bitmaps.

The c1 argument represents the color used for “on” bits in the dither pattern and c0 represents the color used for “off” bits. The driver always selects the colors closest to c1 and c0.

The dither pattern is an array of 8 bytes, aligned with the upper-left corner of the application's region. This pattern repeats itself every 8 pixels horizontally and every 8 pixels vertically. For a sample of dither patterns, see PgSetFillDither*().

These functions override the color defined by PgSetTextColor*(). For basic colors, see PgColor_t.

PgSetTextDither() works on the current graphics context, while you can specify the graphics context gc for PgSetTextDitherCx().



Interrupt handler No
Signal handler No
Thread No

See also:

PgARGB(), PgColor_t, PgDefaultText*(), PgDrawString*(), PgDrawText*(), PgDrawTextArea*(), PgExtentMultiText*(), PgExtentText*(), PgGray(), PgHSV(), PgRGB(), PgSetDrawMode*(), PgSetFillDither*(), PgSetFont*(), PgSetStrokeDither*(), PgSetTextColor*(), PgSetTextTransPat*(), PgSetTextXORColor*(), PgSetUnderline*()

Drawing attributes and Text in the Raw Drawing and Animation chapter of the Photon Programmer's Guide