Command: save2d

Syntax

save2d <file> {,<elist> ... }

Description

Save graphic entities in 2-D form in a disc file from the current view in a graphic window.

Parameters

• <file>
  The disc file to be created. If it already exists it will be overwritten. The default extension is .e.

• <elist>
  A group/entity list defining which entities are to be saved. If omitted, all entities are saved. Entities are clipped if necessary before being saved.

Switches

• -att
  Save entities with their attributes (entity.att[1:10]). The default behavior is to save entities without attributes. Polygon children (i.e. holes and islands) are saved without attributes irrespective.

• -b
  Add a filled frame to the output. The frame is created as a polygon entity with null edges. The default behavior is not to add such a polygon.

• -c
  If <file> exists request confirmation from the user before it is overwritten.

• -ef=<filter>
  A filter to be applied to all entities within <elist> further qualifying which entities are to be saved. If omitted, the filter current_filter is used.

• -fra
  Add a frame outline to the output. The frame is created as a lines entity. The default behavior is not to add such an entity.

• -iw=<window>
  The window whose contents are to be converted into 2-D and saved. If this is omitted, the current graphic window will be used.

• -t=<message>
  A description associated with the new file. If this is omitted, and <file> exists, then the description already associated with <file> will be retained.

• -wb=<points>
  Two corners of a box in modeling space. The contents of the box thus provide the area whose contents are to be saved. If this is omitted, the whole graphic window is used.

Notes

The origin of the output is set to the mid-point of the bounding frame.

Four tag points are saved with the file, they being the four corners of the bounding frame starting at the bottom left numbered counterclockwise.

Z coordinates of all created entities are given a zero value.

There is necessarily a loss of entity information during the creation of the 2-D entities, and there is no guarantee that entity type and integrity will be maintained during conversion, although the appearance of the 2-D image will be maintained. In addition the number of entities may differ from the original. The 2-D entity file is designed to be used for plot composition.

Examples

Save all entities in view in the current graphic window.

save2d my_view.e

Save all polygon entities in view is a specific window. Create a filled frame with it.

save2d pclipped, polygon_filter, -fra, -b, -iw=mywin

Save the contents of a rectangle defined interactively.

save2d partial, -wb=pbox, -fra

See Also