Brief Index      Full Index      Events Index      I.M. Reference

MSet_Face_Colors_By_FIndex


Functions

void MSet_Face_Colors_By_FIndex (HC_KEY key, const char *type, int offset, int count, const float *findices)
void MSet_Specific_Face_Colors_By_FIndex (HC_KEY key, int count, const int *indices, const float *findices)

Function Documentation

void MSet_Face_Colors_By_FIndex ( HC_KEY  key,
const char *  type,
int  offset,
int  count,
const float *  findices 
)

Sets the drawing attributes on a contiguous range of shell or mesh faces speedily.

Parameters:
key The unique identifier returned by a previous call to Insert_Mesh or Insert_Shell.
type A list of which geometry types are to be affected. Currently the legal values for this parameter are "faces". In effect this is a dummy parameter. Uppercase versus lowercase is not significant.
offset Offset in the face identifier list of the original shell or mesh definition at which to start work. "0" is the first offset value. This is NOT an index into the face_list of Insert_Shell().
count The number of vertex colors contained in findices .
findices Vector (1-D array) of floating-index values. Passed by reference always.

DETAILS

The "normal" mode of setting an attribute value on a single shell or mesh face is to open the geometry, open the face, set the attribute, close the face, open the next face, set the next attribute, close the face, etc. This can be tedious if a large number of faces need to be set up. The "MSet_Face" ("Multi-Set") routines are provided as a convenience to speed up the process.

RESTRICTIONS

Color values set by this function are not valid in LOD mode.

See also:
Set_Color, Set_Color_By_Value, Set_Color_By_Index, Set_Rendering_Options, Set_Normal, Define_Texture, Open_Vertex

void MSet_Specific_Face_Colors_By_FIndex ( HC_KEY  key,
int  count,
const int *  indices,
const float *  findices 
)

Sets the drawing attributes on an arbitrary set of shell or mesh faces speedily.

Parameters:
key The unique identifier returned by a previous call to Insert_Mesh or Insert_Shell.
count The number of face identifiers in faces.
indices List of face identifiers from the original shell or mesh definition on which to set the attribute. "0" is the first offset value.
findices Vector (1-D array) of floating-index values. Passed by reference always.

DETAILS

The "normal" mode of setting an attribute value on a single shell or mesh face is to open the geometry, open the face, set the attribute, close the face, open the next face, set the next attribute, close the face, etc. This can be tedious if a large number of faces need to be set up. The "MSet_Face" ("Multi-Set") routines are provided as a convenience to speed up the process.

See also:
Set_Color, Set_Color_By_Value, Set_Color_By_Index, Set_Rendering_Options, Set_Normal, Define_Texture, Open_Vertex

Brief Index      Full Index      Events Index      I.M. Reference