tsaven
Description
Saves the current document, or portions of it, to a file. The target file name is entered in the Save Document dialog box. The only difference between the tsave and tsaven macros is how they behave when the parameters are omitted. The tsave macro will automatically save the whole document under its current file name, unless its extension is .3f (used for PTC ALD template files), in which case it will behave like tsaven and invoke a dialog box into which you may type a file name.
Syntax
tsaven default:n? ( file:s options:s? )?
tsaven
|
[no parameter]
|
Invoke the Save Document dialog box.
|
|
default
|
|
0
|
tsaven will save the current document as a .3d file, unless another extension is specified in the file parameter
|
|
1
|
tsaven will save the current document as a .3f file unless another extension is specified in the file parameter
|
|
|
file
|
The file name under which you want to save the current document or a portion of it. The first part of file is either an optional prefix which you can specify, or the name of the entity within the file that you want to save. The second part of file is an extension, either .3d or .3f, or one of the special file suffixes listed below. Any entity saved with the special extensions can be loaded into any other document with the tload macro.
|
.3d
|
Save the file as a normal .3d document. If the file is an PTC ALD template file (.3f) the Save Document dialog box will be invoked.
|
|
.3c
|
Save named colours only. Names not truncated on Windows 95/NT.
|
|
.3f
|
Save the file as an PTC ALD template file. This is particularly useful if you make changes to the template files supplied with PTC ALD and want to carry on listing them as an option for selection when you open a new document.
|
|
.3h
|
Save tag header information only. This is useful when integrating PTC ALD with an external program. The file contains tag headers plus complete fdb, fdp, fdd, fdpref and fde blocks.
|
|
.3o
|
Save an object graphic. The file prefix comes from the tag name of the object graphic. If this is longer than eight characters the file name is truncated.
|
|
.3p
|
Save document preferences (exception: those set up with the tdpref, tdslevel and tdplevel macros will not be included) to a specified file whose file prefix you specify.
|
|
|
|
.3r
|
Save a raster graphic. The file prefix is the tag name of the raster graphic. If this is longer than eight characters the file name is truncated.
|
|
.3s
|
Save all style tags to a specified file whose file prefix you specify. This can be useful for transferring all of your styles to another document.
|
|
.3t
|
Save a text stream. The file prefix is the tag name of the text stream. If this is longer than eight characters the file name is truncated.
|
|
.3x
|
Save any entity. The type of the entity is not important (as it is with the .3t, .3o and .3r extensions). This extension can also be used to save page over/underlay layouts. The file prefix is the tag name of the entity you want to save. If this is longer than eight characters the file name is truncated.
|
|
.3z
|
Save the file as an application bundle (from version 9.1 onwards).
|
|
|
options
|
|
a
|
Save all (normal save)
|
|
o
|
Overwrite an existing file without prompting: should be used together with the a option. (Added in version 8.13v)
|
|
Related Links