Displays a string at a specified AN.
Note: This function is only used for V3.xx and V4.xx animations, and was superseded in later releases.
DspStr(AN, sFont, sText [, iLength] [, iAlignMode] [, iLengthMode])
The AN where the text will be displayed.
The name of the font that is used to display the text. The Font Name needs to be defined in the Fonts database. If the font is not found, the default font is used.
The text to display.
Length of the Text to display, either in characters or pixels depending on Mode (default -1, no truncation)
The alignment of the text string:
0 - Left Justified (default)
1 - Right Justified.
2 - Center Justified.
The length mode of the text string:
0 - Length as pixels truncated (default)
1 - Length as pixels truncated with ellipsis
2 - Length interpreted as characters.
0 (zero) if successful, otherwise an error is returned.
DspStr(25,"RedFont","Display this text");
/* Displays "Display this text" using "RedFont" at AN25. "RedFont" needs to be defined in the Fonts database. */