Functions | |
void | MSet_Face_Colors_By_Value (HC_KEY key, const char *type, int offset, const char *color_space, int count, const HC_RGB *values) |
Sets the drawing attributes on a contiguous range of shell or mesh faces speedily. More... | |
void | MSet_Specific_Face_Colors_By_Value (HC_KEY key, int count, const int *indices, const char *color_space, const HC_RGB *values) |
Sets the drawing attributes on an arbitrary set of shell or mesh faces speedily. More... | |
Detailed Description
Function Documentation
◆ MSet_Face_Colors_By_Value()
void MSet_Face_Colors_By_Value | ( | HC_KEY | key, |
const char * | type, | ||
int | offset, | ||
const char * | color_space, | ||
int | count, | ||
const HC_RGB * | values | ||
) |
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 only legal value for this parameter is "faces". Upper case versus lowercase is not significant. offset Number of the point in the original shell or mesh definition at which to start work. "0" is the first offset value. color_space Special constant: "HLS", "HSV", "HIC", or "RGB". count The number of vertex colors contained in values. values An array of triples – the same format as the array in Insert_Polyline() – specifying 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 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.
◆ MSet_Specific_Face_Colors_By_Value()
void MSet_Specific_Face_Colors_By_Value | ( | HC_KEY | key, |
int | count, | ||
const int * | indices, | ||
const char * | color_space, | ||
const HC_RGB * | values | ||
) |
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 contained 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. color_space Special constant: "HLS", "HSV", "HIC", or "RGB". values An array of triples specifying 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 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.