ArborX

tfraster

Longname: t f rame raster   Open the Documentation Legend
Released: not available 
Created: not available 
Alias(es): tfr 
See also: tfcont tftext tfo

Summary
 Loads and or assigns a raster graphic to the currently selected frame.
Example extract

If a raster had not been loaded as a link, but we now wanted to link it, it could be made into a link with:

 tlink 2, 1:tlsave

Syntax (SVNNA)
tfraster Ø
tfraster  *:L? link:n  [  name:t  [  filter:n  [  file:s  [  options:s  ]?   ]?   ]?   ]? 
*:L

Preceding the entire parameter list with an asterisk allows the tfr macro to work on a dummy frame. This can be used to import raster graphics without relying on a selected frame to contain them.

0  Do not link to external file.
1  Link imported tag with external file.
name:t The tag name by which the file will be known in 3B2, e.g. rg1. If this does not exist, an empty raster will be created, although at present 3B2 has no effective way of using the empty raster graphic tag.
filter:n
-1  Automatic filter. 3B2 will automatically use the correct file filter option if it can recognise the file type from those listed below.
0  3B2 .3r raster file.
1  GEM
2  TIFF (Tagged Image Format file)
3  PCX/PCC
4  Mac PICT
5  GIF
6  EPS
7  BMP/DIB
8  JPEG
9  OLE
10  PNG
file:s The name of the file to be imported.
options:s
0  Load image at its normal resolution.
1,max  maximum memory to allow the image to use, where 'max' is the memory allowed in kilobytes.
2  Not used.
3,x,y  Size at which to import the low resolution image, where 'x' is the maximum horizontal pixels and 'y' is the maximum vertical pixels allowed.

You must select a frame before using tfr. The macro shown below imports a tiff file into the selected frame, linking it to the original file. The options specify that the imported file will use no more than 2k of memory.
 tfr 1,"rg2",2,"c:/3d/test.tif","1,2"

Document created on 16-Apr-2003 (revision 001)