Brief Index      Full Index      I.M. Reference

MSet_Face_Normals


Functions

void MSet_Face_Normals (HC_KEY key, int offset, int count, const HC_POINT *normals)

Function Documentation

void MSet_Face_Normals ( HC_KEY  key,
int  offset,
int  count,
const HC_POINT *  normals 
)

Speedily sets the drawing attributes on a large number of shell or mesh faces.

Parameters:
key The unique identifier returned by a previous call to KInsert_Mesh(), KInsert_Shell(), or KInsert_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.

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" ("Multi-Set") routines are provided as a convenience to speed up that process.

RESTRICTIONS

This function cannot be used on polycylinders, even though polycylinders can have explicit face normals (but only on their endcaps).

See also:
Set_Color, Set_Color_By_Value, Set_Color_By_Index, Set_Rendering_Options, Set_Normal, Define_Texture, Open_Face

Main Index
Brief Index      Full Index      I.M. Functions