ArborX

tsaven

Longname: t saven   Open the Documentation Legend
Released: not available 
Created: not available 
See also: tsave tdspref tks tsavea tsavetxt tsavehtm

Summary
 Saves the current document or portions of it to a file. The file name is entered in the Save Document dialogue box.
Example (n/a)
 No example is available for this feature.

Syntax (SVNNA)
tsaven Ø
tsaven  default:n?  [  file:s  options:s?  ]? 
Ø Displays the Save Document dialogue box.
default:n
0  Makes tsaven default to saving the current document as a .3d file, unless a further extension parameter is specified as noted below.
1  Makes tsaven default to saving 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  Saves the file as a normal .3d document. If the file is a 3B2 template file (.3f) the Save document dialogue box will be invoked.
.3c  Saves named colours. Names not truncated on Windows 95/NT.
.3f  Saves the file as a 3B2 template file. This is particularly useful if you make changes to the template files supplied with 3B2, for instance to their default settings and want to carry on listing them when you open a new document.
.3h  Outputs tag header information only. This is useful when integrating 3B2 with an external program. The file contains tag headers plus complete fdb, fdp, fdd, fdpref and fde blocks.
.3o  Saves an object graphic from your document to the specified file name. 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  Saves document preferences (mainly, but not exclusively those set up with the tdpref, tdslevel and tdplevel macros) to a specified file whose file prefix you specify.
.3r  Saves a raster graphic from your document. The file prefix is the tag name of the raster graphic. If this is longer than eight characters the file name is truncated.
.3s  Saves all style tags from your document to a specified file whose file prefix you specify. This can be useful for transferring all of your styles to another document.
.3t  Saves a text stream from your document. The file prefix is the tag name of the text stream. If this is longer than eight characters the file name is truncated.
.3x  Saves any entity from the current file. 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.
options:s
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).

Document created on 08-Feb-2003, last reviewed on 06-Sep-2005 (revision 1)