PgSetStrokeDither()

Set the stroke dither pattern

Synopsis:

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

Description:

This function combines two colors according to the pattern defined by pat and applies the pattern to outlines.

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().

Because of speed considerations, some graphics drivers don't dither strokes. If a driver doesn't support dithering, it uses c1 to draw strokes.

This function overrides the color defined by PgSetStrokeColor(). For basic colors, see PgColor_t.

Classification:

Photon

See also:

PgCMY(), PgColor_t, PgGray(), PgHSV(), PgRGB(), PgSetFillColor(), PgSetFillDither(), PgSetFillTransPat(), PgSetStrokeColor(), PgSetStrokeTransPat(), PgSetTextColor(), PgSetTextDither(), PgSetTextTransPat()