Syntax
[C/C++:]
void gDrawFacet(int npts, GPOINT3 *points, ...);
[F90:]
subroutine gDrawFacet(npts, points, gNormals, gTextCoords, gColours)
integer, intent(in) :: npts
type (GPOINT3), intent(in) :: points(*)
type (GPOINT3), optional, intent(in) :: gNormals(*), gTextCoords(*)
integer, optional, intent(in) :: gColours(*)
Arguments
npts
Number of vertices in facet
points
Array specifying series of absolute points that define the facet boundary
Optional Args
gNormals
Optional array specifying normal vectors at each vertex
gTextCoords
Optional array specifying texture coordinate values at each vertex
gColours
Optional integer array specifying colours at each vertex
Description
The routine gDrawFacet() displays a single facet (polygon) containing
npts vertices held in the array
points of type GPOINT3. The facet is drawn according to the current modelling and/or viewing transformations subject to the current facet offset as set by gSetFacetOffsetMode(). The facet is drawn either solid or as a boundary according to the current facet filling style as set by gSetFacetFillStyle().
The facet colour is determined by the current material property, which may be set (using gSetMaterialIndex()) to match the current line drawing colour (gSetLineColour()), or according to specific colour attributes that are affected by the current lighting conditions. Alternatively if the optional
gColours array is used, the facet is coloured using graduations of the colours specified at each vertex in this array (these are not affected by any lighting conditions).
The optional arrays
gNormals and
gTextCoords can be used to specify non-planar normals and/or texture coordinates when creating smooth or texture mapped surfaces. Both arrays are of type GPOINT3.
See Also
gDrawFacet UsagegSetFacetFillStylegSetFacetOffsetModegSetLineColourgSetMaterialIndex
