fg_gouraudz()

Win32 DirectX Fastgraph/Light

Prototype

void fg_gouraudz (int *vertex_array, char *rgb_array, double *xyz_array, int n);

Sub fg_gouraudz (vertex_array() As Long, rgb_array() As Byte, xyz_array() As Double, ByVal n As Long)

procedure fg_gouraudz (var vertex_array : integer; var rgb_array : byte; var xyz_array : double; n : integer);

Description

The fg_gouraudz() function draws a projected z-buffered Gouraud-shaded convex polygon in screen space, with 2D clipping. This function is called internally by Fastgraph's 3D functions and is not usually called directly by applications.

Parameters

vertex_array is the name of the array containing the (x,y) coordinate pairs of each polygon vertex. The first array element is the x component of the first vertex, the second element is the y component of the first vertex, the third element is the x component of the second vertex, and so forth.

rgb_array is the name of the array containing the RGB color components for each (x,y) coordinate pair in vertex_array. The first three rgb_array elements represent the RGB color values at the first vertex in vertex_array, the next three rgb_array elements are for the second vertex, and so forth. Each RGB color component is a value between 0 and 255.

xyz_array is the name of the array containing the 3D (x,y,z) coordinates for each (x,y) coordinate pair in vertex_array. The first three xyz_array elements represent the (x,y,z) values at the first vertex in vertex_array, the next three xyz_array elements are for the second vertex, and so forth. Only the z coordinates are meaningful in this function.

n is the number of vertices in each of the above arrays.

Return value

none

Restrictions

This function is meaningful only with direct color virtual buffers.

If you attempt to fill a non-convex polygon with fg_gouraudz(), only a portion of the polygon will be filled.

See also

fg_3Dshade(), fg_3Dshadeobject(), fg_gouraud(), fg_inside(), fg_polyoff(), fg_zbopen()