MSet_Vertex_Colors_By_Value

Functions

 MSet_Specific_Vertex_Colors_By_Value (HC_KEY key, const char *types, int count, const int *offsets, const char *color_space, const HC_RGB *values)
 Sets the color on an arbitrary set of shell, mesh, or polycylinder vertices. More...
 
void MSet_Vertex_Colors_By_Value (HC_KEY key, const char *types, int offset, const char *color_space, int count, const HC_RGB *values)
 Sets the color on a contiguous range of shell, mesh, or polycylinder vertices. More...
 
void MSet_Vertex_Colors_By_Value4 (HC_KEY key, const char *geometry_types, int offset, const char *color_space, int count, const HC_RGBA *values)
 Sets the color on a contiguous range of shell, mesh, or polycylinder vertices. More...
 

Detailed Description

Function Documentation

◆ MSet_Specific_Vertex_Colors_By_Value()

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

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

Parameters
keyThe unique identifier returned by a previous call to Insert_Mesh(), Insert_Shell(), or Insert_PolyCylinder().
typesA list of which color types are to be affected. Currently the legal values for this parameter are "markers (or vertex)". Uppercase versus lowercase is not significant.
countThe number of values contained in offsets.
offsetsOffsets of the points in the surface definition on which to work.
color_spaceSpecial constant: "HLS", "HSV", "HIC", "RGB" or "RGBA". Please note that the constant is a quoted string. Uppercase versus lowercase is not significant.
valuesAn 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

◆ MSet_Vertex_Colors_By_Value()

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

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

Parameters
keyThe unique identifier returned by a previous call to Insert_Mesh(), Insert_Shell(), or Insert_PolyCylinder().
typesA list of which geometry types are to be affected. Currently the legal values for this parameter are "markers (or vertex)". Uppercase versus lowercase is not significant.
offsetNumber of the point in the surface definition at which to start work. "0" is the first offset value.
color_spaceSpecial constant: "HLS", "HSV", "HIC", "RGB" or "RGBA". Please note that the constant is a quoted string. Uppercase versus lowercase is not significant.
countThe number of items contained in values.
valuesAn 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_Vertex_Colors_By_Value4()

void MSet_Vertex_Colors_By_Value4 ( HC_KEY  key,
const char *  geometry_types,
int  offset,
const char *  color_space,
int  count,
const HC_RGBA *  values 
)

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

Parameters
keyThe unique identifier returned by a previous call to Insert_Mesh(), Insert_Shell(), or Insert_PolyCylinder().
geometry_typesA list of which geometry types are to be affected. Currently the legal values for this parameter are "markers (or vertex)". Uppercase versus lowercase is not significant.
offsetNumber of the point in the surface definition at which to start work. "0" is the first offset value.
color_spaceSpecial constant which must be "RGBA". Please note that the constant is a quoted string. Uppercase versus lowercase is not significant.
countThe number of items contained in values.
valuesAn array of quad (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