====== 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