Command: restore

Syntax

restore <file>

Description

Load the contents of an entity file. This command is a companion to the save command.

Parameters

• <file>
  The name of the entity file containing the entities to be loaded. The default file extension is .e.

Switches

• -alph=<num>
  An alpha transparency factor between 0 and 1. A value 1 implies fully opaque, 0 means fully transparent (therefore invisible). The default is 1. This transparency will augment not replace the transpency of entities within <file>.

• -ang=<angle>
  The orientation of the entities. This is for changes in plan angle only. The X axis of entities within <file> will be with this angle.

• -ap=<num>
  The curve approximations factor for all curve-type entities within <file>. If omitted, their curve factors are unchanged.

• -br=<num>
  A brightness factor between -1 and +1. A value 0 means normal, -1 means very dark (black), +1 means very bright (white). The default is 1. This brightness will augment not replace the brightness of entities within <file>.

• -ch
  Check for out-of-date external class definitions. If a compound or gstructure definition referenced within the file was created later than the file the restore will be aborted. This is the default behavior. Use -no_ch to ignore such situations, but if the class definition has changed since the entity file was created this can lead to unforeseen errors or even system failures.

• -col=<color>
  The color override for all entities within <file>. If omitted, their Colors are unchanged.

• -fil=<fillstyle | color | tile | hatchstyle>
  The fillstyle override for all facet-type entities within <file>. This can be a fillstyle, color, tile or hatchstyle. If omitted, their fill styles are unchanged.

• -fr=<num>
  Define a fragment override for all entities within <file>. If omitted, their fragments are unchanged.

• -i=<num>
  The input attach tag (See save) within <file>, used for entity positioning. If omitted, a value 0 (the entity file origin) is used.

• -ls=<linestyle | color>
  The linestyle override for all vector-type entities within <file>. This can be a linestyle or a color. If omitted, their linestyles are unchanged.

• -ms=<markerstyle>
  The markerstyle override for all node entities within <file>. If omitted, their marker styles are unchanged.

• -o=<num>
  The output attach tag within <file>, used for positioning graphic control after the entities have been positioned. If omitted, the value of the input attach tag (-i) is used.

• -p=<point>
  Where the input attach tag of the entity file is to be positioned. If omitted, the current graphic control position is used.

• -ra=<num>
  Define a rank override for all entities within <file>. If omitted, their ranks are unchanged.

• -s=<num>
  A uniform scaling factor to be applied to all entities within <file>.

• -su
  Without this switch set, if the modeling units of <file> are not the same as the current modeling units (units), an appropriate scaling factor will be used to convert. If this switch is present no such scaling will be performed.

• -th=<num>
  The thickness override for all vector-type entities within <file>. If omitted, their thicknesses are unchanged.

• -ts=<textstyle>
  The textstyle override for all text-type entities within <file>. If omitted, their text styles are unchanged.

• -xa=<point>

• -ya=<point>

• -za=<point>

One or more of these options will define a rotation to be applied to all entities within <file>.

• -x=<num>

• -y=<num>

• -z=<num>

Stretch factors to be applied to one or more axes. These will be applied to all entities within <file>.

Notes

This command will delete all current entities and graphic primitives before loading the file contents.

Examples

Restore a file with no changes.

restore myfile

Restore a file with change of position and orientation.

restore /usr/models/myfile, -p=(100,200), -ang=45

See Also