Macro Language Reference > Macros > Frame > tfo
  
tfo
Description
Loads or assigns an object graphic tag to the currently selected frame.
 
This macro is an alias of the tfobject macro; both being present for purposes of backward compatibility.
 
Example 130. Create a new object graphic tag name
The macro shown below automatically creates a new object graphic tag name and assigns it to the selected frame:
tfo "_"
 
Example 131. Import object graphic, fit to frame and preserve aspect ratio
This example imports a linked file called pic1 from the specified directory, using PTC ALD automatic file filter, fitting to frame whilst preserving the aspect ratio:
tfo 1,"pic1",--1,"c:\imports\pic1.jpg",1,1
Syntax
tfo *:L? link:n? ( name:t ( filter:n file:s ( fit:n ( aspect:n ( t colour mode:n ( g colour mode:n ) )? )? )? )? )?
tfo
[no parameter]
Invoke the Frame Contents dialog box.
*
Allow the tfo macro to work on a dummy frame. This can be used to import object graphics without needing a selected frame in a document to contain it.
* 
The asterisk must precede the entire parameter list to be effective.
link
0
Do not link to external file
1
Link imported tag with external file
name
The tag name of the object graphic, e.g. og1. If this does not exist, it will be created.
filter
-1
Automatic filter: PTC ALD will automatically use the correct file filter option if it can recognize the file type from those listed below.
0
PTC ALD object graphic file: .3o
1
GEM object graphics file
2
HPGL file
3
DXF file
4
Mac PICT file
5
CGM file
6
SVG file
7
SVGPASSTHRU — SVG with no PTC ALD extensions
If the image is linked to the template when imported and printed to PDF, the original SVG file will be included directly in the PDF
file
Name of the object graphics file to be imported.
fit
0
Do not fit to frame
1
Fit to frame
aspect
0
Do not preserve aspect ratio
1
Preserve aspect ratio
t colour mode
0
No text colour translation
1
White to black text colour translation
2
All text black
g colour mode
0
No graphics colour translation
1
White to black graphics colour translation
2
All graphics black
Related Links