fg_3Dzclip()

Win32 DirectX Fastgraph/Light

Prototype

int fg_3Dzclip (double *source, double *dest, int n);

Function fg_3Dzclip (source() As Double, dest() As Double, ByVal n As Long) As Long

function fg_3Dzclip (var source, dest : double; n : integer) : integer;

Description

The fg_3Dzclip() function clips a series of 3D (x,y,z) polygon vertices against the z plane clipping values defined by fg_3Dsetzclip(). Near clipping uses true clipping, but far clipping occurs only if the entire polygon lies beyond the far clipping plane. This function is called internally by Fastgraph's 3D functions and is not usually called directly by applications.

Parameters

source is the name of the array containing the 3D (x,y,z) vertices to clip. The first three elements of the source array contain the coordinates for the first vertex, the next three elements are for the next vertex, and so on.

dest is the name of the array that receives the clipped 3D (x,y,z) vertices. The first three elements of the dest array will contain the coordinates for the first vertex, the next three elements will contain the next vertex, and so on. The size of dest must be at least as large as the source array.

n is the number of vertices in the source array.

Return value

The resulting number of vertices in the dest array.

Restrictions

3D clipping is not supported for right-handed 3D coordinate systems.

See also

fg_3Dtransform(), fg_3Dtransformobject(), fg_3Dzcliprgb(), fg_3Dzcliptm()