Facsimile Simulation Library

Note that Text Lists are not supported in VR Graphics versions of ACE; attempting to read a cell file containing a Text List primitive into such a version will result in errors. However, Text Lists are still supported by the Standard Graphics versions.

Since this feature now seems to be deprecated, and since it causes problems for newer versions, it is recommended that you avoid the use of Text Lists; use the Text primitive instead.

Text List cells require the following parameters, which have to be formatted as follows:

NumItems<nl>
[XTranslate<spc>YTranslate<spc>ZTranslate<nl>
Text<nl>
[...]]

where NumItems is an integer containing the number of items in the text list, XTranslate, YTranslate and ZTranslate are the X, Y and Z translations, for each item, applied after the cell's standard geometry, Text is a text string containing the text belonging to each item, <spc> and <nl> is the newline sequence.

Text, which is delimited by the newline sequence following each item's translation parameters and the newline sequence at the end of the text line (i.e. each text field must be on a line by itself), can contain spaces, but no other whitespace or control characters. Furthermore only 7-bit ASCII characters are processed; 8-bit characters have their 8th bit stripped during a read operation. It is not possible to have an empty text string!

There are a number of different types of text (see Text for more information), but all items in a text list are displayed in the same way.