Back|Forward

DCL:GRPH1:STPACK: Transformation Functions:Explanation of Subroutines: Coordinate Transformation

6.3.4 stfpr3/STIPR3/stspr3

1.

Function

Performs 3-D perspective transformation.

2.

Call

rx, ry = NumRu::DCL.stfpr3(x,y,z)
NumRu::DCL.stspr3(xfc,yfc,zfc,theta,phi,psi,fac,zview,rxoff,ryoff)

3.

Explanation of Arguments

ux,uy,uz	(R)	The coordinates in UC.
rx,ry	(R)	The coordinates in RC.
itr3	(I)	Transformation function number
xfc,yfc,zfc	(R)	The coordinates of the center of focus
theta,phi,psi	(R)	The angle of rotation
fac	(R)	The scaling factor
zview	(R)	The Z coordinate of the eye point
rxoff,ryoff	(R)	The offset

4.

Notes

(a)

These functions perform the following operations.

• Parallel transformation with the center of focus as the origin.
• Rotation of (THETA,PHI,PSI) around the origin..
• Multiplies the coordinate values by a factor of fac.
• With the eye point at (0,0,ZVIEW), projects a point onto the X-Y plane.
• Adds an offset of (RXOFF,RYOFF) to the projected coordinate value.