NAME

cxGeoColorAdd - add color(s) to the current geometry object

C SPECIFICATION

#include <cx/Geometry.h>

enum cxGeoBindingLevel { CX_GEO_PER_DEFAULT, CX_GEO_PER_OBJECT, CX_GEO_PER_PART, CX_GEO_PER_FACE, CX_GEO_PER_FACE_INDEXED, CX_GEO_PER_VERTEX, CX_GEO_PER_VERTEX_INDEXED };

void cxGeoColorAdd( int n, float *color, cxGeoBindingLevel per )

FORTRAN SPECIFICATION

integer CX_GEO_PER_DEFAULT
integer CX_GEO_PER_OBJECT
integer CX_GEO_PER_PART
integer CX_GEO_PER_FACE
integer CX_GEO_PER_FACE_INDEXED
integer CX_GEO_PER_VERTEX
integer CX_GEO_PER_VERTEX_INDEXED

parameter (CX_GEO_PER_DEFAULT = 0) parameter (CX_GEO_PER_OBJECT = 1) parameter (CX_GEO_PER_PART = 2) parameter (CX_GEO_PER_FACE = 3) parameter (CX_GEO_PER_FACE_INDEXED = 4) parameter (CX_GEO_PER_VERTEX = 5) parameter (CX_GEO_PER_VERTEX_INDEXED = 6)

subroutine cxGeoColorAdd(n,color,per) integer n real color(3, n) integer per

PARAMETERS

n
The number of RGB triples passed in.
color
An array of RGB color values in [0..1].
per
A flag indicating how colors are to be applied.

DESCRIPTION

This function adds colors to the current point set, line set, polygon set, triangle mesh set, sphere set, cylinder set, or grid. The current object is the primitive or pushed transform most recently defined, or it may be explicitly set with cxGeoFocus(3E).

Colors may be applied in different ways, depending on the setting of the per flag:

CX_GEO_PER_OBJECT
a single attribute is used over the entire object
CX_GEO_PER_FACE
a different attribute is applied on each face (valid for polygons, triangles, and grids)
CX_GEO_PER_VERTEX
a different attribute is applied per vertex (valid for points, lines, polygons, triangles, and grids)
CX_GEO_PER_VERTEX_INDEXED
a different attribute is applied on each reference to a vertex (valid for lines, polygons, and triangles)

Colors are interpreted as RGB triples with each component in the range [0..1].

SEE ALSO

cxGeoFocus(3E)
Last modified: Mon Nov 18 13:48:44 GMT 1996
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996