[Contents] [Index] [Books]

CoCreate OneSpace Designer - Commands Reference Manual


STRETCH_MOVE_2D terminate action

STRETCH_MOVE_2D stretches lines and arcs.

Syntax


                      +-------------------------<------------------------+
                      |                                                  |
->(STRETCH_MOVE_2D)->-+->-(:SELECT)---------|element(s) to stretch|---->-+
                      |                                                  |
                      +->-(:HORIZONTAL)--+--|ref. posn.|--|posn|--+---->-+
                      |                  |                        |      |
                      |                  +--|offset|--------------+      |
                      |                                                  |
                      +->-(:VERTICAL)----+--|ref. posn.|--|posn|--+---->-+
                      |                  |                        |      |
                      |                  +--|offset|--------------+      |
              |                             |
              +->-(:BY_DIMENSION)->-|select|->-|number|-------->-+
                      |                                                  |
                      +->-(:REPEAT_FACTOR)--|number of repetitions|---->-+
                      |                                                  |
                      +->-(:KEEP)--+--(:ON)---+------------------------>-+
                                   |          |                          |
                                   +--(:OFF)--+                          |
                                                                         |
                      -->-(:APPLY)------------------------------------->-+

Options

The following options are available to stretch elements.
Option Description
:SELECT specifies the elements you want to move stretching the adjacent edges and/or the end points you want to move stretching the adjacent edges.
:DIRECTION specifies the direction in which you want to move the current elements.
:HORIZONTAL transforms the elements horizontally only.
:VERTICAL transforms the elements vertically only.
:REPEAT defines the number of times (default = 1) the element will be transformed.
:KEEP chooses whether or not to keep the original element(s).
KeywordAction
:ONkeeps the original element(s)
:OFFdoes not keep the original element(s). (default)
:APPLY Will perform the stretch while keeping the selection for further transformations. This is only possible if you do not create new elements during the operation, i.e. :KEEP :OFF :REPEAT_FACTOR 1
Currently disabled

When to use

Use this action to stretch any 2D elements in your active workplane, retaining their connections.

There are two ways of specifying the elements to be stretched.

  1. First, you can identify end points. Once you have selected a transformation, the end point is moved, and the elements ending there are stretched accordingly.

  2. Second, you can use the select mechanism to indicate two corners of a box. Elements with one vertex inside the box and the other outside, are stretched so that the outside vertex remains fixed. Elements whose vertices are all inside the box, are modified as when using MOVE_2D.

If you request a stretch that would produce an impossible result, for example, a line of length 0 (zero), OneSpace Designer will delete the element. To undo the stretching operation, use the UNDO action.

By their nature, B-splines are very sensitive to the movement of their control or interpolation points. Therefore, because stretching any section of a B-spline would result in an unpredictable output, B-splines can only be modified using the B-spline modification actions.

Example

The following parameter sequence stretches a specified line.

STRETCH_MOVE_2D [specify line] :HORIZONTAL [specify reference position] [specify new position] :REPEAT_FACTOR 2 :KEEP :ON

See also

MOVE_2D terminate action ON_OFF_SA subaction
[Contents] [Index] [Books]