ArborX

tftext

Longname: t f rame t ext   Open the Documentation Legend
Released: not available 
Created: not available 
Alias(es): tft 
See also: tfcont tfo tfraster tsavetxt

Summary
 Assigns a text stream tag to the currently selected frame.
Example extract

The macro shown below automatically creates a new text tag name and assigns it to the selected frame:

 tft "_ _"

Syntax (SVNNA)
tftext  *:L?  link:n?  [  name:t  [  filter:n file:s  [  options:s  style name:t?  ]?   ]?   ]? 
*:L Preceding the entire parameter list with an asterisk allows the tft macro to work on a dummy frame. This can be used to import text without relying on a selected frame to contain it.
link:n
0  Do not link to external file.
1  Link imported tag with external file.
name:t

Tag name of the text, e.g. tx1. If this does not exist, it will be created.

-1  Automatic filter. 3B2 will automatically use the correct file filter option if it can recognise the file type from those listed below.
filter:n
0  ASCII
1  3B2
2  Al-Arabic
3  DIF
4  Displaywrite RTF
5  Multimate II
6  MS WORD (RTF)
7  WORDSTAR
8  WordPerfect
9  TeX
10  LaTeX
11  Write/WordPad
file:s

The name and path of the file to be imported.

Version specific information7.89e  If a specific encoding is to be used this must be specified on the front of this path or file in the form {:encoding}, e.g. {:utf-8}{.}demo.3d. Any encoding conforming to ICU standards (e.g. ISO-8859-1) can be specfied using the syntax above or in the dialogue.

The common encoding menu items are described below.

XML Encoding

Initiates auto XML from the Import types, uses info from file header or BOM 'if it is an XML file'

3B2 Standard

3B2 Modified ASCI

UTF-8

standard

UTF-16

standard

ISO-8859-1

standard

Version specific information7.06a  From 3B2 version 7.06a this parameter can now also take arbitrary URI's. e.g. http://www.mysite.co.uk/myfile.html

options:s

The options are the same as those listed under [load frame text/Options] dialogue box:

8  Ignore 8th bit. Characters which conform to the ASCII standard are 8-bits long. However, the 8th bit is never used for character representation. 3B2 enables you to ignore this 8th bit.
1  Start a new paragraph for each line.
x  Ignore any coding of the file in 3B2 format, e.g. characters in angle brackets or in typical show string sequence.
t  Preserve tab characters from the original file.
n  Treat end of line character as line feed (not carriage return) character.
z  Ignore word processor controls.
u  Preserve multiple spaces.
v2  Convert multiple spaces to tabs.
y  Preserve initial spaces.
e  Preserve exact mark-up.
qe  Convert keyboard quotes to English or Spanish “ ”.
qg  Convert keyboard quotes to German „ ‟
qs  Convert keyboard quotes to Swedish ” ”.
qn  Convert keyboard quotes to Norwegian or Russian « » (guillemets set tight against the word).
qf  Convert keyboard quotes to French or Italian « » (guillemets set with a space against the word).
qd  Convert keyboard quotes to Danish » « (reversed guillemets).
qo  Convert keyboard quotes to ‟ „.
q{"/"}  Convert keyboard quotes to the characters shown either side of the / character. These characters can be edited by the user, e.g. if you wanted quotes to come across as the words 'OPEN' and 'CLOSE', this option would take the form q{OPEN/CLOSE}.
--  A hyphen before one of the character map options toggles inversion of the selected character map on or off before applying it to the incoming text stream.
a  Convert text from Ansi character set.
i  Convert text from IBM character set.
o  Convert text from IBM Danish character set.
g  Convert text from IBM Greek character set.
b  Convert text from SmartFont (TextData) character set.
c  Convert text from Mac character set.
s  Convert text from ISO character set.
[...]  Encloses the name of a character map used to import text.
style name:t The name of the style tag with which you want to tag paragraphs in the imported file are not already tagged.
Example

You must select a frame before using tft. The macro shown below imports a WordPerfect file into the selected frame, attempting to link it to the original file. (Because 3B2 cannot write WordPerfect files, the user will be prompted to save a link to a new file in 3B2 .3t format if any changes are made to the file.) The options simply convert keyboard quotes from the original file to English ` ' form, since 3B2's WordPerfect filter automatically selects correct options to modify the file and character set. Paragraphs will be tagged with the Body style, unless they already have 3B2 style coding for another paragraph style.

 tft 1,"tx2",2,"c:/3d/test.wp5","qe","Body"

Document created on 01-Jan-2001, last reviewed on 29-Sep-2005 (revision 1)