HANDLE

HANDLE creates a 3D handle in the point (X, Y, Z). With handles, you can move or modify an object.
HANDLE is similar to HANDLE2.

Syntax

HANDLE x, y, z [, unID [, paramReference, flags][, displayParam]]

Parameters

x (decimal): X coordinate of handle

y (decimal): Y coordinate of handle

z (decimal): Z coordinate of handle

unID (integer, > 0): handle's unique identifying number

paramReference: parameter to be edited by current handle, using the method of graphical parameter editing using handles.

Valid arguments:
D, Arr[5], Arr[2*I+3][D+1], etc.

flags: handle type + handle attribute

handle type:
1: length type editing, base handle (always hidden)
2: length type editing, moving handle
3: length type editing, reference handle (always hidden)
4: angle type editing, base handle (always hidden)
5: angle type editing, moving handle
6: angle type editing, center of angle (always hidden)
7: angle type editing, reference handle (always hidden)
8: switch type (steps to the clicked handle)
9: input type
10: switch type (steps to the next handle, no matter which handle is clicked)

handle attribute:
it can be the following value or zero:
512: reverse the angle in 2D (for handle type 6)

Remarks

Length type parameters:

You have to define three handles, one of type 1 (base handle), one of type 2 (moving handle) and one of type 3 (reference handle). The vector from the reference handle to the base handle gives the positive direction of the editing line.
You have to place the moving handle along the editing line at a distance given by the associated parameter's value measured from the base handle.

Angle type parameters:

You have to define four handles, one of type 4 (base handle), one of type 5 (moving handle), one of type 6 (center of angle) and one of type 7 (reference handle).
The angle's plane is perpendicular to the vector going from center handle to reference handle.

Positive direction for measuring an angle is counter-clockwise (default for 2D). With the attribute 512 for the center handle (type 6) you can change the positive direction to clockwise.

To be consistent, the vectors from the center handle to the moving and the base handles must be perpendicular to the vector from the center to the reference handle. The moving handle must be placed at an angle determined by the associated parameter measured from the base handle around the center handle.

If you define several handle sets to modify the same parameter, the handles are grouped together in the order in which the handle commands are executed.

You can combine two or three length type handles in order to change several parameters with only one drag.

If two handles are combined, you can drag the handles within the plane defined by the two lines belonging to each length editing handle. The two lines must not be parallel to each other.
If you combine three sets of length type handles in 3D, then you can position the handle anywhere in space. The three lines must not be on the same plane.

If there are two or three editable handles referring to different parameters at the place where you click a point, you start a combined editing operation.

If parameters are designed for combined editing, the base and reference handles are not fixed in the object's coordinate frame, but must move according to the changes of the other parameters' value.

Usable since script version 1.1 (Allplan 2012-1).