Brief Index      Full Index      I.M. Reference

MSet_Vertex_Colors_By_Value


Functions

void MSet_Vertex_Colors_By_Value (HC_KEY key, const char *types, int offset, const char *color_space, int count, const HC_POINT *values)
 MSet_Specific_Vertex_Colors_By_Value (HC_KEY key, const char *types, int count, int *offsets const char *color_space, const HC_POINT *values)

Function Documentation

void MSet_Vertex_Colors_By_Value ( HC_KEY  key,
const char *  types,
int  offset,
const char *  color_space,
int  count,
const HC_POINT *  values 
)

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

Parameters:
key The unique identifier returned by a previous call to KInsert_Mesh(), KInsert_Shell(), or KInsert_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.
color_space Special constant: "HLS", "HSV", "HIC", "RGB" or "RGBA". Please note that the constant is a quoted string. Uppercase versus lowercase is not significant.
count The number of items contained in values.
values An array of triples (the same format as the array in Insert_Polyline()) or quartets if using the "RGBA" color space that specifies the locations in the selected color space. 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.

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_Value, MUnSet_Specific_Vertex_Colors, MUnSet_Vertex_Colors

MSet_Specific_Vertex_Colors_By_Value ( HC_KEY  key,
const char *  types,
int  count,
int *offsets const char *  color_space,
const HC_POINT *  values 
)

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

Parameters:
key The unique identifier returned by a previous call to KInsert_Mesh(), KInsert_Shell(), or KInsert_PolyCylinder().
types A list of which color 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.
count The number of values contained in offsets.
offsets Offsets of the points in the surface definition on which to work.
color_space Special constant: "HLS", "HSV", "HIC", "RGB" or "RGBA". Please note that the constant is a quoted string. Uppercase versus lowercase is not significant.
values An array of triples (the same format as the array in Insert_Polyline()) or quartets if using the "RGBA" color space that specifies the locations in the selected color space. 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_Value, MUnSet_Specific_Vertex_Colors, MUnSet_Vertex_Colors

Main Index
Brief Index      Full Index      I.M. Functions