fg_3Dgetmatrix()

Win32 DirectX Fastgraph/Light

Prototype

void fg_3Dgetmatrix (double *matrix, int flag);

Sub fg_3Dgetmatrix (matrix() As Double, ByVal flag As Long)

procedure fg_3Dgetmatrix (var matrix : double; flag : integer);

Description

The fg_3Dgetmatrix() function retrieves the elements from one of Fastgraph's 3D rotation, translation, or transformation matrices. This function is provided for the benefit of experienced 3D programmers who need access to Fastgraph's internal 3D matrices.

Parameters

matrix is the name of the array that will receive the matrix values. It must be large enough to hold 12 eight-byte (double) floating point numbers. The first four elements of matrix will receive the four values from the first row of the specified matrix, the next four elements will receive the values from the second row, and the last four elements will receive the values from the third row.

flag specifies which matrix to retrieve:

FG_OBJECT_ROTATION

object to world rotation

FG_OBJECT_TRANSLATION

object to world translation

FG_OBJECT_TRANSFORM

object to world transformation

FG_WORLD_ROTATION

world to view rotation

FG_WORLD_TRANSLATION

world to view translation

FG_WORLD_TRANSFORM

world to view transformation

FG_COMBINED_TRANSFORM

object to view transformation

If flag is not one of the above values, matrix will be left unchanged.

Return value

none

Restrictions

none

See also

fg_3Dsetmatrix()

Contents
Fastgraph Home Page

 

copyright 2001 Ted Gruber Software, Inc.