Functions | |
void | MShow_Face_Normals (HC_KEY key, int offset, int count, HC_VECTOR *normals) |
Returns the normals set on the faces of some geometry without having to open each face. More... | |
void | MShow_Net_Face_Normals (HC_KEY key, int offset, int count, HC_VECTOR *normals) |
Similar to MShow_Face_Normals(), but returns the net effective normals set on the faces of some geometry. More... | |
int | MShow_Face_Normals_With_Existence (HC_KEY key, int offset, int count, char *existence, HC_VECTOR *normals) |
Returns the normal settings for a range of faces without having to open each face. More... | |
void | MShow_Specific_Face_Normals (HC_KEY key, int count, const int *indices, HC_VECTOR *normals) |
Shows the normal values for a list of faces. More... | |
int | MShow_Specific_Face_Normals_With_Existence (HC_KEY key, int count, const int *indices, char *existence, HC_VECTOR *normals) |
Returns the normal settings from an arbitrary set of faces without having to open each face. More... | |
void MShow_Face_Normals | ( | HC_KEY | key, |
int | offset, | ||
int | count, | ||
HC_VECTOR * | normals | ||
) |
Returns the normals set on the faces of some geometry without having to open each face.
key | - Key to the piece of geometry to query. |
offset | - Index of the key's face list on which to start querying values. |
count | - Number of faces from offset to query |
normals | - Array of (x,y, z) triplets. Passed by reference. Returned to user. |
int MShow_Face_Normals_With_Existence | ( | HC_KEY | key, |
int | offset, | ||
int | count, | ||
char * | existence, | ||
HC_VECTOR * | normals | ||
) |
Returns the normal settings for a range of faces without having to open each face.
key | - Key to the piece of geometry to query. |
offset | - Index of the key's face list on which to start querying values. |
count | - Number of faces from offset to query. |
existence | - An array of size count whose values would be populated with either 0 (does not exist) or 1 (exists). Passed by reference. Returned to user. |
normals | - Array of (x,y, z) triplets. Passed by reference. Returned to user. |
Use MShow_Face_Normals_With_Existence to query face normal values efficiently. Since normal values may or may not exist, the return values gives you the total number of normals that have been set. The existence array gives you further information about each face's normal setting. For a given face, the existence value may be one of the following:
void MShow_Net_Face_Normals | ( | HC_KEY | key, |
int | offset, | ||
int | count, | ||
HC_VECTOR * | normals | ||
) |
Similar to MShow_Face_Normals(), but returns the net effective normals set on the faces of some geometry.
key | - Key to the piece of geometry to query. |
offset | - Index of the key's face list on which to start querying values. |
count | - Number of faces from offset to query |
normals | - Array of (x,y, z) triplets. Passed by reference. Returned to user. |
MShow_Net_Face_Normals differs from the regular MShow_Face_Normals in that it can return the normals that HOOPS calculates automatically, in cases where the normals are not explicitly set. This is particularly useful when dealing with NURBS surfaces, as it is the only way to query the normals associated with the HOOPS-specific tesselation of a NURBS Surface.
void MShow_Specific_Face_Normals | ( | HC_KEY | key, |
int | count, | ||
const int * | indices, | ||
HC_VECTOR * | normals | ||
) |
Shows the normal values for a list of faces.
key | - Key to the piece of geometry to query. |
indices | - The list of faces to show the normal values. |
count | - Number of faces. |
normals | - Array of (x,y, z) triplets. Passed by reference. Returned to user. |
int MShow_Specific_Face_Normals_With_Existence | ( | HC_KEY | key, |
int | count, | ||
const int * | indices, | ||
char * | existence, | ||
HC_VECTOR * | normals | ||
) |
Returns the normal settings from an arbitrary set of faces without having to open each face.
key | - Key to the piece of geometry to query. |
count | - Number of faces to query. |
indices | - The list of faces. |
existence | - An array of size count whose values would be populated with either 0 (does not exist) or 1 (exists). Passed by reference. Returned to user. |
normals | - Array of (x,y, z) triplets. Passed by reference. Returned to user. |
See MShow_Face_Normals_With_Existence() for more details.