PULL - v14


pull                            { p }{ r }{ t|t,L } { d,p=<i>\<i+1> }
{START=<pvar>}{os=<svar>}{sin=<n_array>}

Function

Drag the selected item(s) to a new position interactively. Only items in the partition will be dragged.

Parameters

p

Shift the attach points by corresponding increments.
 

r

Rotate the selected items on the +Z axis about the current control. This option automatically uses the doublebuffer therefore, care should be taken to avoid conflicts the application already uses doublebuffering. (Update: Introduced from 11.6.3 b04)
 

t | t,L

Shift the selected items using vector redraws instead of copying a raster area. This option automatically uses the doublebuffer therefore, care should be taken to avoid conflicts the application already uses doublebuffering. (Update: Introduced from 11.6.3 b04)
The PULL L is no longer valid as a syntax. Using the T,L primer enables the mode for latching PULL.
(Update: Introduced from 12.5.1 and 14.1.0)
 

START=<pvar>

Define starting point for rotational PULL.  In order to enable   PULL R to work using L (for latching) a primer has been made available in the PULL command to allow the definition of a starting point for the rotational PULL as indicated in the following example:

PULL R,L,START=<point>

Where <point> is used to define the starting point, which defines the starting rotation angle (Update: Introduced from 12.5.2)
 

d,p=<i>\<i+1>

Directional PULL with primer  PULL D,P1\2. ( 12.5.1/14.1.0)
 

os=

An output string for keyboard input or LIST line selection.
 

sin=

The name of the array containing the ASCII codes of the keys on the keyboard to be managed as single characters when PULL is interrupted by a key press.  Up to 256 hot-keys can be defined.
It is possible to check the three different cases:

key pressed

shift+key pressed

ctlr+key pressed
 

 

With no parameters drag only the model.

Examples

pull

pull p

pull d,p=1/2

Notes

Only treatable fragments will be dragged.

If the view is a perspective or if dragging facilities are not available at the installation, this command will be executed as "SHIFT J".

 

If the LOCI ON command has been issued, this command also records mouse movements using the LOCI parameters.(11.6.3 b04)

 

Dynamic pan and zoom is available for the PULL command.(12.6.0/14.2.0)

 

(Update 11.6.3 B03) The pull command timeout returns VB=6.  Introduced to accommodate touchscreen technology, The VB is used to check after a PULL if the operation was terminated by the user or by a timeout.

See also

default (p), partition, shift, treat