Specify text of variable item
$text "string"
Commands in these files are normally generated and maintained by FFVIEWER, and for most Graphical Customization applications it is not necessary to view or edit the GCT/GPT file.
This command is used to specify a text string to be used in an annotation. Multiple $text commands may be used in a sequence but a $textend command must be the last command in the set. Text from all these commands is concatenated, up to a limit (currently) of 64kb for each annotation. The length of the string on each command is limited by CopiaFacts command-string size of 8kb characters. This represents the maximum total length, including the command name.
The text string may contain CopiaFacts variable names, preceded by @, which will be expanded at run-time by CF9IMAGE when the template is used to generate a custom cover sheet. To force newlines in the annotation, the sequence \n should appear in the text string.
When a GCT/GTT file is saved by FFVIEWER, all double-quote characters on this command are changed to single quote characters. You should not use embedded double-quote characters in the content of this command if you create a GCT file in your own applications. All single-quote characters found inside an HTML tag in an HTML annotation are changed back to double-quote characters before the HTML is rendered to TIF, and when the GCT is opened in FFVIEWER; otherwise the single-quote characters remain in the text.
If the concatenated text, after variable expansion, forms a filename with file extension .BMP, or if the letter G is included in the preceding $style command, then the text is taken to be the filename of a bitmap which is loaded into the annotation rectangle without scaling or stretching. An image file can also be included in an HTML attachment using the <img> tag described in the $style topic
At the end of the annotation text you may use the sequence @!filename to insert the complete contents of an ASCII file into the item. Variable expansion is performed on the filename, which should resolve to a full pathname. Variable expansion is also performed on the contents of the file, which are truncated if the resulting text would exceed the 64kb limit mentioned above. The filename is terminated by the first blank space encountered (or by the end of the annotation text), and any following text in the annotation is ignored.
If the annotation text consists of an alternate special sequence @!!filename on the last watermark page, then the expansion process causes the whole page to be repeated as many times as are required to contain the whole included file. The included file is flowed from page to page. In this case no word-wrapping is performed and it is therefore recommended that the annotation should specify a fixed-pitch font. This feature is used in the automatic conversion of ASCII files to TIFF as described in the Features section. The file expansion in this way is not constrained to the 64kb size limit (although each page's annotation is).
If the annotation text (after variable expansion) starts with !HTML! these six characters are removed and the annotation is treated HTML (as if the H $style was present).
Positional Requirements: Must be followed by zero or more additional $text commands and then by a $textend command.
Examples:
$text "This fax contains @TPAGES pages"
$textend
$textend "From: @sender\nCompany: @coname"
$text "This is a long line of text which can be brok"
$textend "en at any point\nor continued on a new line."
$text "stevesig.bmp"
$textend
