Anchor Constructors

anchor( Origin, Dir1, Dir2, Dir3 )

Returns

<anchor> An anchor object representing the given coordinate frame orientation and position.

Origin

<point> The base position of the coordinate frame.

Dir1, Dir2, Dir3

<vector> The three (mutually perpendicular) vectors describing the coordinate frame orientation.

zAnchorFromPt( Pt )

Returns

<anchor> An anchor object positioned at the given point, with all three vectors aligned with the coordinate axes.

Pt

<point> The base position of the coordinate frame.

negZAnchorFromPt( Pt )

Returns

<anchor> An anchor object positioned at the given point, with the X axis aligned with the X coordinate axis, and the Y and Z axes aligned with the negative Y and Z axes.

Pt

<point> The base position of the coordinate frame.

xAnchorFromPt( Pt )

Returns

<anchor> An anchor positioned at a given point with the z axis of the anchor pointing in the positive x direction.

Pt

<point> The base position of the coordinate frame.

yAnchorFromPt( Pt )

Returns

<anchor> An anchor positioned at a given point with the z axis of the anchor pointing in the positive y direction.

Pt

<point> The base position of the coordinate frame.

negXAnchorFromPt( Pt )

Returns

<anchor> An anchor positioned at the given point, with the z axis of the anchor pointing in the negative x direction.

Pt

<point> The base position of the coordinate frame.

negYAnchorFromPt( Pt )

Returns

<anchor> An anchor positioned at the given point, with the z axis of the anchor pointing in the negative y direction.

Pt

<point> The base position of the coordinate frame.

offsetAnchor( Anch, Xoff, YOff, ZOff )

Returns

<anchor> An anchor object representing the translation of the original anchor by the given values.

Anch

<anchor> The anchor to be moved. The orientation of the new anchor will be the same as that of the original, only the base position will be changed.

XOff, YOff, ZOff

<number> The offset distance to move the anchor base in each coordinate direction (in the global, not local, coordinate space).

offsetAnchorLocally( Anch, Xoff, YOff, ZOff )

Returns

<anchor> An anchor object representing the translation of the original anchor by the given values, relative to the local origin of the anchor.

Anch

<anchor> The anchor to be moved. The orientation of the new anchor will be the same as that of the original, only the base position will be changed.

XOff, YOff, ZOff

<number> The offset distance to move the anchor base in each coordinate direction (in the local coordinate space).

rotateAnchor( Anch, XRot, YRot, ZRot )

Returns

<anchor> An anchor object representing the rotation of the original anchor as indicated.

Anch

<anchor> The anchor to be moved. The base location of the new anchor will be the same as that of the original, only the orientation will be changed.

XRot, YRot, ZRot

<number> Rotation values specifying the new orientation. These will be concatenated as rotations of the anchor about the respective (global) coordinate axes, and the original anchor multiplied through the matrix.

rotateAnchorLocally( Anch, XRot, YRot, ZRot )

Returns

<anchor> An anchor object representing the rotation of the original anchor as indicated, computed relative to its own local coordinate system.

Anch

<anchor> The anchor to be moved. The base location of the new anchor will be the same as that of the original, only the orientation will be changed.

XRot, YRot, ZRot

<number> Rotation values specifying the new orientation. These will be concatenated as rotations of the anchor about the respective (local) coordinate axes, and the original anchor multiplied through the matrix.

alignPosn( Obj, Anchor1, Anchor2 )

Returns

<object> A transformed version of the given object.

Obj

<object> The object to be transformed.

Anchor1

<anchor> The anchor associated with the object. Usually, the results will be most intuitive if the base of the anchor is a point on the object.

Anchor2

<anchor> The new anchor position. The transformation is specified by the relative positions of the two anchors. This routine pays no attention to the orientation vectors of the anchors, but just uses the locations of the two anchors to determine a new position.

alignPosnAndZ( Obj, Anchor1, Anchor2 )

Returns

<object> A transformed version of the given object.

Obj

<object> The object to be transformed.

Anchor1

<anchor> The anchor associated with the object. Usually, the results will be most intuitive if the base of the anchor is a point on the object, and the Z axis of the anchor is aligned with some natural axis of the object.

Anchor2

<anchor> The new anchor position. The transformation is specified by the relative positions of the two anchors. This routine aligns the Z axes and the base points of the two anchors, ignoring the other two orientation vectors.

alignZ( Obj, Anchor1, Anchor2 )

Returns

<object> A transformed version of the given object.

Obj

<object> The object to be transformed.

Anchor1

<anchor> The anchor associated with the object. Usually, the results will be most intuitive if the base of the anchor is a point on the object, and the Z axis of the anchor is aligned with some natural axis of the object.

Anchor2

<anchor> The new anchor position. The transformation is specified by the relative positions of the two anchors. This routine aligns the positive Z axis of one with the positive Z axis of the other.

flipAnchor( Anch )

Returns

<anchor> Return a new anchor that is a flipped ( all vecs myltiplied by -1 ) of the original.

Anch

<anchor> The anchor to be flipped.

negZAnchorPosn( RefAnch, zAngle, Loc, Local )

Returns

<anchor> Positions a negative z anchor.

RefAnch

<anchor> Reference negative z anchor.

zAngle

<number> Z rotation angle.

Loc

<euclidPoint> Location point.

Local

<boolean> Local location flag.