Functions | |
void | MSet_Face_Normals (HC_KEY key, int offset, int count, const HC_VECTOR *normals) |
Speedily sets the drawing attributes on a large number of shell or mesh faces. More... | |
void | MSet_Specific_Face_Normals (HC_KEY key, int count, const int *indices, const HC_VECTOR *normals) |
Speedily sets the normal values for a specific faces on a shell or mesh faces. More... | |
void | MUnSet_Face_Normals (HC_KEY key, int offset, int count) |
Removes the normal values for a range of faces at once. This allows the shell or mesh to inherit segment-level normal value settings. More... | |
void | MUnSet_Specific_Face_Normals (HC_KEY key, int count, int const *indices) |
Removes the normal values for a set of specific faces at once. This allows the shell or mesh to inherit segment-level normal value settings. More... | |
void MSet_Face_Normals | ( | HC_KEY | key, |
int | offset, | ||
int | count, | ||
const HC_VECTOR * | normals | ||
) |
Speedily sets the drawing attributes on a large number of shell or mesh faces.
key | The unique identifier returned by a previous call to Insert_Mesh(), Insert_Shell(), or Insert_PolyCylinder(). |
offset | Number of the face in the surface definition at which to start work. "0" is the first offset value. |
count | The number of normals contained in normals. |
normals | Vector of x-y-z normal values. A simple N x 3 array may also be used. Passed by reference always. |
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" ("Multi-Set") routines are provided as a convenience to speed up that process.
This function cannot be used on polycylinders, even though polycylinders can have explicit face normals (but only on their endcaps).
void MSet_Specific_Face_Normals | ( | HC_KEY | key, |
int | count, | ||
const int * | indices, | ||
const HC_VECTOR * | normals | ||
) |
Speedily sets the normal values for a specific faces on a shell or mesh faces.
key | The unique identifier returned by a previous call to Insert_Mesh(), Insert_Shell(), or Insert_PolyCylinder(). |
count | Number of the faces in which to set the normals values. |
indices | The faces in which to set the normal values. |
normals | Vector of x-y-z normal values. A simple N x 3 array may also be used. Passed by reference always. |
No additional details. See MSet_Face_Normals() for more information.
void MUnSet_Face_Normals | ( | HC_KEY | key, |
int | offset, | ||
int | count | ||
) |
Removes the normal values for a range of faces at once. This allows the shell or mesh to inherit segment-level normal value settings.
key | The unique identifier returned by a previous call to Insert_Mesh(), Insert_Shell(), or Insert_PolyCylinder(). |
offset | The first face number. |
count | Number of the faces in which to set the normals values. |
No additional details. See MSet_Face_Normals() for more information.
void MUnSet_Specific_Face_Normals | ( | HC_KEY | key, |
int | count, | ||
int const * | indices | ||
) |
Removes the normal values for a set of specific faces at once. This allows the shell or mesh to inherit segment-level normal value settings.
key | The unique identifier returned by a previous call to Insert_Mesh(), Insert_Shell(), or Insert_PolyCylinder(). |
count | Number of the faces in which to set the normals values. |
indices | The faces in which to set the normal values. |
No additional details. See MSet_Face_Normals() for more information.