====== SetTextCelCoords ======

Sets x and y coordinates for a cel.

==== Synopsis ====

''%%void SetTextCelCoords (TextCel *tCel, Coord ccbX, Coord ccbY)%%''

==== Description ====

Sets the TextCel CCB coordinates (ccb_XPos and ccb_YPos). Use this call as a convenience so that you don't need to dereference two levels of pointers to update a CCB's on-screen position.

If you prefer, you can manipulate a CCB's position, size, and perspective fields directly; you don't have to use this function to safely modify the on-screen position. Other utility routines for positioning cels, such as ''%%MapCel()%%'', may also be safely used.

The ccbX and ccbY values are interpreted as integer values if, when viewed as a longword, they are in the range of -1024<value<1024. (That is, if interpreting the values as frac16 types would result in a very small fraction almost zero they are assumed to be integers.) In this case, ''%%SetTextCelCoords()%%'' converts the values to frac16 before storing them into the CCB. Values outside that range are considered to be frac16 values already, and are stored into the CCB without conversion.

==== Arguments ====

  * **tCel** Pointer to a TextCel structure.

  * **ccbX** X coordinate for the text cel CCB.

  * **ccbY** Y coordinate for the text cel CCB.

==== Associated Files ====

lib3do.lib, textlib.h