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
-
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 (or vertex)". 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.
◆ 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
-
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)". 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.
◆ 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
-
key The unique identifier returned by a previous call to Insert_Mesh(), Insert_Shell(), or Insert_PolyCylinder().
geometry_types A 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. offset Number of the point in the surface definition at which to start work. "0" is the first offset value. color_space Special constant which must be "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 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.