ArborX

tlink

Longname: t ext link   Open the Documentation Legend
Released: not available 
Created: not available 
See also: tlink tlsave tlupdate ttlchk tftext tfraster tfo

Summary
Example extract

The macro shown below links the text stream as a Arbortext APP link to the file strm0.3t. (This is followed by a tlsave macro to save the link which is equivalent to clicking the save-link_en button in the tag linking dialogue box).

 tlink "strm0", "c:/3d/strm0.3t", 2:tlsave

Syntax (SVNNA)
tlink  tags:s?  link file:s?  link type:n?
tags:s

This parameter can take one of the two options below.

tag name  The name of the tag that you want to link.
tag prep  Prepares the current context tag or specific tags for linking using the values detailed below:
Ø  In Page Mode the raster in the currently selected frame is prepared for linking. In Text Mode the text tag in the currently selected frame is prepared for linking. In Graphics Mode the object graphics tag in the currently selected frame is prepared for linking.
0  Prepare the text tag in the currently selected frame for linking.
1  Prepare the object graphic tag in the currently selected frame for linking.
2  Prepare the raster graphic tag in the currently selected frame for linking.
link file:s

The name of the file to which tag is to be linked.
link type:n
0  None. The tag will not be linked to a file: this is useful for breaking existing file links.
1  Original. The tag will be linked to the original file in its native format that was imported into Arbortext APP. If you make changes to a file with this type of link within a document, you will be warned and prompted to re-save the link with a Arbortext APP link type.
2  Arbortext APP. The tag will be linked to a file in the appropriate Arbortext APP format for text, rasters or object graphics.

In order to create or break links from a macro the tag to be linked must be specified as either an entity of the current frame or by tag name, and followed in both cases by the link type. The link type can optionally be preceded by the name of the link file.
Example

If strm0 were in the currently selected frame, and we were in Text Mode, the following would have had the same effect:

 tlink "c:/3d/strm0.3t", 2:tlsave
Example

If we had not been in Text Mode, but still wanted to link the text file in the frame, we would have had to specify the entity explicitly:

 tlink 0, "c:/3d/strm0.3t", 2:tlsave
Example

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
Example

It is often useful to break file links, for instance if you want to send a single file to another person. Before breaking a file link so as to bring the file back into your .3d file you must, however, ensure that the linked file has been called for by 3B2 and brought into your document, otherwise an empty header will be saved. You can use tlupdate to do this. Omitting the link_file and changing link_type to 0 breaks the file links:

 tlink 0, 0:tlsave

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