OPARA                                                   Menu: Non-menu command
==============================================================================
Enable entities that have been previously saved with stretched or shrunken
dimensions to be placed.

         1.  (CHAR) name of object (1-8 chars)
         2.  (Y/N) y-save as new object, n-use elementary entity
         3.  (NUM) reference length of original object (Lx)
         4.  (NUM) reference height of original object (Lz)
         5.  (NUM) reference thickness of original object (Ly)
         6.  (NUM) number of stretch points along x axis Nx < 1 >
         7.  (NUM) number of stretch points along z axis Nz < 1 >
         8.  (NUM) number of stretch points along y axis Ny < 1 >
         9.* (Y/N) add attributes (y/n)
      if reply to prompt 9 is `y':
         10.*(CHAR) attribute name=value (3-40 chars.)
      if reply to prompt 9 is `n':
         11. (POINT) positioning point (press <ENTER> to exit)
         12. (POINT) end point along x axis
         13. (POINT) end point along z axis
         14. (NUM) thickness (along y axis)
      if reply to prompt 2 is `y':
         15. (CHAR) file name to create

Description

This command allows you to place entities that have previously been created
and saved in ARC+ with "stretched" or "shrunken" dimensions.

The parameters to be changed are not stretched or shrunken by a simple factor
since this would stretch all parts of the entity equally.  Instead, you
specify the number of "stretch points" per length of the entity.  The system
divides the length into the specified number of equal segments and stretches
the entity at these points equally.

For example, you may wish to stretch a window frame, but maintain the
thickness of the mullions.  You may specify stretch points that fall between
the mullions so that the stretching occurs only in the area of the glass.

If the entity to be placed is to be used repeatedly with the new dimensions,
you may select to create a new entity by saving it under a new name.
Alternatively the entity with the new dimensions may be placed as any other
anonymous ARC+ entity.  The anonymous entity is named by the system as
follows:

         $NWnnnnn.iii
         $NWnnnnn.ddd
where:   $     is the standard prefix
         N     is the first letter of the working file
         W     is the first letter of the source file
         nnnnn is the system time
         iii and ddd are the ARC+ drawing extensions

To use this command you must have created an entity using the ARC+ commands
and saved it in the current directory or in the \ARCALIB directory.

Specify the filename of the entity to be placed.

Specify whether you intend to save the new entity as a named object (for
future use) or as an anonymous entity.

Specify a reference length (x), height (z) and thickness (y).  In most cases
you will find that when creating the original entity in the dimensions (x y
z), 1 1 1 is most convenient although not necessary.  If the dimensions are
not 1 1 1, you must remember the dimensions in order to reply to this prompt.

Specify the number of "stretch points" along each axis.  For example, if you
are stretching a window frame that consists of three panes of glass between
four vertical mullions, and you do not want to stretch the mullions, specify
three stretch points.

Specify whether to add a non-geometric attribute to the entity.  If you enter
`y' to add attributes, enter the attribute name and value.  You may enter a
string of attributes separated by `;', e.g., a=11; b=20.  You will be asked if
you want to add attributes until you enter `n' to specify that you do not want
to add attributes.  (See the ARC+ User's Manual for more information on
attaching attributes to entities).

Specify the insertion point of the entity.  This is the point at which the
origin of the entity will be located.  Then specify the extremes of the entity
along all three axes (xyz).

Specify the new thickness for the entity.

If you selected to save the new entity as a named object (prompt 2), enter a
name for the entity (up to eight characters).

The new entity will be placed at the specified location and will be stretched
proportionally to the specified extremes.
