Brief Index      Full Index      Events Index      I.M. Reference

Show_Normal


Functions

void Show_Normal (float *x, float *y, float *z)
void Show_Net_Normal (float *x, float *y, float *z)

Function Documentation

void Show_Normal ( float *  x,
float *  y,
float *  z 
)

Returns the normal for the currently open vertex or face.

Parameters:
x X-coordinate of the current normal of a face, edge, or vertex.
y Y-coordinate of the current normal of a face, edge, or vertex.
z Z-coordinate of the current normal of a face, edge, or vertex.

DETAILS

Show_Normal can only be called on a currently-open face or vertex. If your program has not explicitly set a normal value, you will get a complaint. Use Show_Net_Normal() rather than Show_Normal to retrieve the internal HOOPS normal calculation.

NOTES

The Show_Normal routines return the actual attribute values stored in the particular segment at hand. The Show_Net_Normal routines return the effective attribute value for the specified segment. The distinction is that there may or may not be an "actual" stored value for an attribute for a given segment, but there is guaranteed always to be an effective value for every attribute for every segment.

The Show_Normal routines will complain if they're called and the attribute is not actually set in the segment. Use Show_Existence() to avoid this, if necessary.

void Show_Net_Normal ( float *  x,
float *  y,
float *  z 
)

Similar to Show_Normal(), but returns the net effective normal rather than the local one.

Parameters:
x X-coordinate of the current normal of a face, edge, or vertex.
y Y-coordinate of the current normal of a face, edge, or vertex.
z Z-coordinate of the current normal of a face, edge, or vertex.

DETAILS

Use Show_Net_Normal() rather than Show_Normal to retrieve the internal HOOPS normal calculation.

Brief Index      Full Index      Events Index      I.M. Reference