fg_3Dshadeobject()

Win32 DirectX Fastgraph/Light

Prototype

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

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

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

Description

The fg_3Dshadeobject() function draws a Gouraud-shaded convex polygon defined in 3D object space, with optional z-buffering and 3D clipping. Backface removal is performed unless drawing a z-buffered polygon. The polygon is drawn in 3D world space at the position and orientation specified in the most recent call to fg_3Dmoveobject() or fg_3Dsetobject().

Parameters

xyz_array is an array containing the 3D object space (x,y,z) coordinates for each polygon vertex. The first three xyz_array elements represent the (x,y,z) values at the polygon's first vertex, the next three xyz_array elements are for the second vertex, and so forth.

rgb_array is an array containing the RGB color components for each polygon vertex. The first three rgb_array elements represent the RGB color values at the polygon's first vertex, 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.

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

Return value

none

Restrictions

If you attempt to fill a non-convex polygon with fg_3Dshadeobject(), only a part of it will be filled.

See also

fg_3Dmoveobject(), fg_3Dpolygonobject(), fg_3Drenderstate(), fg_3Drotateobject(), fg_3Dsetobject(), fg_3Dshade(), fg_3Dtexturemapobject(), fg_polyoff()