fg_rotate3d() (legacy function)

Win32 DirectX Fastgraph/Light

Prototype

void fg_rotate3d (long *transform, int pitch, int yaw, int roll, int flag);

Sub fg_rotate3d (transform() As Long, ByVal pitch As Long, ByVal yaw As Long, ByVal roll As Long, ByVal flag As Long)

procedure fg_rotate3d (var transform : longint; pitch, yaw, roll, flag : integer);

Description

The fg_rotate3d() legacy function builds a 3D transformation matrix representing an absolute or relative rotation by the specified 3D coordinates.

Parameters

transform is the name of the 12-element transformation matrix containing fixed point 3D rotation and 3D translation values.

pitch is the counterclockwise rotation about the x axis, expressed in tenths of degrees.

yaw is the counterclockwise rotation about the y axis, expressed in tenths of degrees.

roll is the counterclockwise rotation about the z axis, expressed in tenths of degrees.

flag controls if the rotation is absolute or relative. If flag is zero, the rotation is absolute and the specified rotations become the new rotation values in the transformation matrix. If flag is not zero, the rotation is relative and the rotation angles are added to the rotation values in the transformation matrix.

Return value

none

Restrictions

none

Replaced by

Floating point 3D geometry system