fg_3Dzcliprgb()

Win32 DirectX Fastgraph/Light

Prototype

int fg_3Dzcliprgb (double *xyz_source, double *xyz_dest, char *rgb_source, char *rgb_dest, int n);

Function fg_3Dzcliprgb (xyz_source() As Double, xyz_dest() As Double, rgb_source() As Byte, rgb_dest() As Byte, ByVal n As Long) As Long

function fg_3Dzcliprgb (var xyz_source, xyz_dest : double; var rgb_source, rgb_dest : byte; n : integer) : integer;

Description

The fg_3Dzcliprgb() function clips a series of 3D (x,y,z) polygon vertices and corresponding RGB shading values against the z plane clipping values defined by fg_3Dsetzclip(). Near clipping is 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

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

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

rgb_source is the name of the array containing the RGB shading values for each (x,y,z) coordinate triple in xyz_source. The first three rgb_source elements represent the shading values at the first vertex in xyz_source, the next three rgb_source elements are for the second vertex, and so forth.

rgb_dest is the name of the array that receives the clipped RGB shading values. The first three elements of the rgb_dest array will contain the shading values for the first vertex, the next three elements will be for the second vertex, and so on. The rgb_dest array must be at least as large as the rgb_source array.

n is the number of vertices in the xyz_source and rgb_source arrays.

Return value

The resulting number of vertices in the xyz_dest and rgb_dest arrays.

Restrictions

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

See also

fg_3Dtransform(), fg_3Dtransformobject(), fg_3Dzclip(), fg_3Dzcliptm()