ArborX

tfcont

Longname: tf rame cont ents   Open the Documentation Legend
Released: not available 
Created: not available 
See also: tfo tfraster tftext

Summary
 Allows you to change the contents of the currently selected frame. A dialogue box appears with the current settings, which you may change. The dialogue box contains settings for the text stream name, object graphic name and raster graphic name. You can specify whether the text stream restarts in this frame or not. The dialogue box also allows access to further dialogue boxes that allow you to change origin and margin settings for object and raster graphics, and scaling for raster graphics.
Example extract

The macro below opens the raster scaling dialogue box:

 tfcont "rs"

Syntax (SVNNA)
tfcont  *:L? (  options:s  <type>  )
where
<type> ::= (   parameters...:s*  ) |  [  across:uh down:uv  ]?  |  [  top:uv bottom:uv left:uh right:uh  ]?  |  [  X scale:s size:n Y scale:s size:n  ]?  |  [  X scale:s size:n Y scale:s size:n  ]? 
*:L

Preceding the entire parameter list with an asterisk imports items into the document and not into a specific frame.
options:s

The option that is chosen determines the remaining applicable parameters in the sequence.

t  Parameters are take the same form as tftext macro.
o  Parameters are take the same form as tfo macro.
r  Parameters are take the same form as tfraster macro.
oo  Applicable to Changes the object graphics origin or, if parameters is not present, invokes the dialogue box.
om  Applicable to Changes the object graphics margin or, if parameters is not present, invokes the dialogue box.
ro  Applicable to Changes the raster graphics origin or, if parameters is not present, invokes the dialogue box.
rm  Applicable to Changes the raster graphics margin or, if parameters is not present, invokes the dialogue box.
rh  Invokes the half-tones dialogue box.
rs  Applicable to Changes the raster scaling or, if parameters is not present, invokes the raster graphic scaling dialogue box.
parameters...:s

Depending on the option chosen the parameters take the same form as either the tftext, tfo or tfraster.
across:uh

Object or Raster origins across from left-hand edge of frame.
down:uv
x  Object or Raster origins from top of frame.
top:uv

Object or Raster top margin.
bottom:uv

Object or Raster top margin.
left:uh

Object or Raster left margin.
right:uh

Object or Raster right margin.
X scale:s

The options for are a little unusual in that there are several ways to specify the scaling of a raster. In Arbortext APP's internal structure a scaling option is indicated by a code from 0..5. This code can be specified in the macro either by its number, by a code string, or implicitly:

0, n, r  No Scaling.
1, f  Fit to frame.
2, p  Preserve aspect ratio.
3, d, .  Dot size.
4, a  Absolute size.
5, %  Percentage size.

Only applicable for X scale options 3, 4, 5.

3  Number followed by optional unit of measurement.
4  Number followed by optional unit of measurement.
5  Percentage size.
size:n

Only applicable for X scale options 3, 4, 5.

3  Number followed by optional unit of measurement.
4  Number followed by optional unit of measurement.
5  Percentage size.
Y scale:s

The options for are a little unusual in that there are several ways to specify the scaling of a raster. In Arbortext APP's internal structure a scaling option is indicated by a code from 0..5. This code can be specified in the macro either by its number, by a code string, or implicitly:

0, n, r  No Scaling.
1, f  Fit to frame.
2, p  Preserve aspect ratio.
3, d, .  Dot size.
4, a  Absolute size.
5, %  Percentage size.

Only applicable for X scale options 3, 4, 5.

3  Number followed by optional unit of measurement.
4  Number followed by optional unit of measurement.
5  Percentage size.
size:n

Only applicable for X scale options 3, 4, 5.

3  Number followed by optional unit of measurement.
4  Number followed by optional unit of measurement.
5  Percentage size.
Example

Fit raster to frame in both directions:

 tfcont "rs", "f", "f"
Example

Either of the macros shown below scales a raster to 2 inches wide, preserving its aspect ratio vertically:

 tfcont "rs",4,2in,2 3
 tfcont "rs","a",2in,"p" 5

Document created on 08-Feb-2003 (revision 1)