Coordinate System Class

Realsoft 3D Coordinate System.

Coordinate system is analogous to Matrices in that it can be used for representing transformations and spaces.

origin - vector defining origin hor, vert, norm - three axes For example:
o = new r3Vect(0.2, 0, 0);
x = new r3Vect(0.1, 0, 0);
y = new r3Vect(0, 0.1, 0);
z = new r3Vect(0, 0, 0.1);
cs = new r3Coordsys(o, x, y, z);
Methods
Method:

r3Coordsys - constructor

Syntax:

v = new r3Coordsys()

Parameters:

vOrigin, vHor, vVert, vNorm - four vectors specifying origin and axes for the coordinate system.

Returns:

cs - new coordinate system object

Description:

Creates a new coordinate system object. If you don't pass any parameters to the constructor, an indentity coordinate system is created. If the number of parameters is four, then the constructor assumes that the parameters are vectors defining oordinate system's origin, horizontal, vertical and normal axes.

Example:

// create an identity cs ;

Method:

identity - identity

Syntax:

cs.identity();

Parameters:

-

Returns:

-

Description:

Reset coordinate system to identity state. This corresponds to the following code: cs.origin.set(0, 0, 0); cs.hor.set(1, 0, 0); cs.vert.set(0, 1, 0); cs.norm.set(0, 0, 1);

Example:

cs.identity();

Method:

normalize - normalize coordinate system axes

Syntax:

cs.normalize();

Parameters:

-

Returns:

-

Description:

Normalize coordinate system axes to unit vectors.

Example:

cs.normalize();

Method:

print - dump current coordinate system values

Syntax:

cs.print();

Parameters:

-

Returns:

-

Description:

Print current values of the coordinate system object. Useful for debugging purposes.

Example:

cs.print();