Brief Index      Full Index      Events Index      I.M. Reference

MShow_Face_Normals

Functions

void MShow_Face_Normals (HC_KEY key, int offset, int count, HC_VECTOR *normals)
 
void MShow_Net_Face_Normals (HC_KEY key, int offset, int count, HC_VECTOR *normals)
 
int MShow_Face_Normals_With_Existence (HC_KEY key, int offset, int count, char *existence, HC_VECTOR *normals)
 
void MShow_Specific_Face_Normals (HC_KEY key, int count, const int *indices, HC_VECTOR *normals)
 
int MShow_Specific_Face_Normals_With_Existence (HC_KEY key, int count, const int *indices, char *existence, HC_VECTOR *normals)
 

Detailed Description

Function Documentation

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.

Parameters
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.
See Also
MSet_Face_Normals, Set_Normal, Show_Normal
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.

Parameters
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.

DETAILS

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.

See Also
MSet_Face_Normals, Set_Normal, Show_Normal
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.

Parameters
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.
Returns
The number of items that have the attribute set.

DETAILS

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:

  • 0 : There was no normal value set.
  • 1 : The normal value is set.
See Also
MSet_Face_Normals, Set_Normal, Show_Normal
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.

Parameters
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.
See Also
MSet_Face_Normals, Set_Normal, Show_Normal
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.

Parameters
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.
Returns
The number of items that have the attribute set.

DETAILS

See MShow_Face_Normals_With_Existence() for more details.

See Also
MSet_Face_Normals, Set_Normal, Show_Normal

Brief Index      Full Index      Events Index      I.M. Reference