SetTextCelPenNumber

Sets pen number for text rendering.

Synopsis

void SetTextCelPenNumber (TextCel *tCel, int32 penNumber)

Description

Sets the pen number used for subsequent text rendering. The pen number, which must be in the range of 0 through 3, indexes to one of the four possible foreground colors.

When you create a text cel, only pen 0 has a default color assigned; other pens are initialized to no color (transparent). Therefore you must use SetTextCelColors() and specify nontransparent colors for pens 1-3 before text you render with those pens will appear.

Arguments

tCel
Pointer to a TextCel structure.
penNumber
Pen number to use for text subsequently rendered into the cel.

Associated Files

lib3do.lib, textlib.h