# taCreateTextCel

Creates a text cel from tag args.

### Synopsis

`TextCel * taCreateTextCel (TagArg *tags)`

### Description

Creates a new text cel. Specifying appropriate tags and values during cel creation sets all configurable attributes of the text cel. If you include TCEL_TAG_UPDATE_TEXT_STRING in the tags, the specified text is rendered into the cel after processing all other tags.

The only required tag is TCEL_TAG_FONT. All unspecified attributes are set to default values as per `CreateTextCel()`. If width and/or height tags are not specified, the associated values are set to zero, resulting in an auto size cel.

### Arguments

tags
  Pointer to an array of tags and associated values.

### Return Value

Pointer to the newly created TextCel structure; returns NULL if there isn't enough memory to create the new TextCel, which indicates that invalid tags are present.

### Associated Files

lib3do.lib, textlib.h

### See Also

`CreateTextCel`