Brief Index      Full Index      Events Index      I.M. Reference

MSet_Vertex_Colors_By_Findex


Functions

void MSet_Vertex_Colors_By_FIndex (HC_KEY key, const char *types, int offset, int count, const float *findices)
void MSet_Specific_Vertex_Colors_By_FIndex (HC_KEY key, const char *types, int count, const int *offsets, const float *indices)

Function Documentation

void MSet_Vertex_Colors_By_FIndex ( HC_KEY  key,
const char *  types,
int  offset,
int  count,
const float *  findices 
)

Sets the color on a contiguous range of shell, mesh, or polycylinder vertices.

Parameters:
key The unique identifier returned by a previous call to Insert_Mesh(), Insert_Shell(), or Insert_PolyCylinder().
types A list of which geometry types are to be affected. Currently the legal values for this parameter are "markers (or vertex), edges or faces". Uppercase versus lowercase is not significant.
offset Number of the point in the surface definition at which to start work. "0" is the first offset value.
count The number of values contained in findices.
findices Vector (1-D array) of floating-index values. You can use a color map that has RGBA values as well as the usual "HLS", "HSV", "HIC", or "RGB" color spaces. Passed by reference always.

DETAILS

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

RESTRICTIONS

When using polycylinders, only edge and face color attributes apply. Markers, visibility, and normals do not apply to polycylinder vertices. Color values set by this function are 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, MSet_Specific_Vertex_Colors_By_FIndex, MUnSet_Vertex_Colors, MUnSet_Specific_Vertex_Colors

void MSet_Specific_Vertex_Colors_By_FIndex ( HC_KEY  key,
const char *  types,
int  count,
const int *  offsets,
const float *  indices 
)

Sets the color on an arbitrary set of shell, mesh, or polycylinder vertices.

Parameters:
key The unique identifier returned by a previous call to Insert_Mesh(), Insert_Shell(), or Insert_PolyCylinder().
types A list of which color types are to be affected. Currently the legal values for this parameter are "markers, vertex, edges or faces". Uppercase versus lowercase is not significant.
count The number of values contained in offsets.
offsets Offsets of the points in the surface definition on which to work.
findices Vector (1-D array) of floating-index values. You can use a color map that has RGBA values as well as the usual "HLS", "HSV", "HIC", or "RGB" color spaces. Passed by reference always.

DETAILS

This function allows the user to modify the colors on a set of arbitrary vertices, as opposed to a range of adjacent vertices.

See also:
Set_Color, Set_Color_By_Value, Set_Color_By_Index, Set_Rendering_Options, Set_Normal, Define_Texture, Open_Vertex, MSet_Vertex_Colors_By_FIndex, MUnSet_Vertex_Colors, MUnSet_Specific_Vertex_Colors

Brief Index      Full Index      Events Index      I.M. Reference