Macro Language Reference > Macros > Frame > tfr
  
tfr
Description
Loads or assigns a raster file to the currently selected frame. Imported PDF pages can be loaded as rasters using this macro.
 
This macro is an alias of the tfraster macro; both being present for purposes of backward compatibility.
 
Example 138. Link a raster not originally loaded as a link
If a raster was not loaded as a link, but you now want to link it, it can be made into a link with the following syntax:
tlink 2, 1:tlsave
Syntax
tfr *:L? link:n ( name:t ( filter:n ( file:s ( options:s )? )? )? )?
tfr
[no parameter]
Invoke the Frame Contents dialog box.
link
0
Do not link to external file
1
Link imported tag with external file
name
The tag name of the raster file, e.g. rg1. 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 raster graphic file: .3r
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
11
PDF
12
U3D
13
Audio (MP3)
14
Video (MP4, FLV)
15
Flash (SWF)
file
Name and path of the raster file to be imported, in double quotes.
If you are importing a PDF file to the frame, you can set two additional values:
Specify the number of a particular page from the PDF to import
Add the suffix #pageno to the filename. For example, tfr 0,"pdf",-1,"Path\PDFFile.pdf#2"
Specify a type of PDF box to be created by the frame definition
Add the suffix :num to the filename.
Where num can have these values:
-1
The default box
0
Art box
1
Bleed box
2
Crop box
3
Media box
4
Trim box
For example, tfr 0,"pdf",-1,"Path\PDFFile.pdf#2:3" will import page 2 of PDFFile.pdf into a media box.
options
0
Load image at its normal resolution.
1,max
Maximum amount of memory to be used by the image: 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 number of horizontal pixels allowed and y the maximum number of vertical pixels.
Additional Information
You must select a frame before using tfr.
Related Links