Introduction

Getting Started

Programming Guides

API Reference

Additional Resources

Show_Normal

Functions

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. More...
 
void Show_Normal (float *x, float *y, float *z)
 Returns the normal for the currently open vertex or face. More...
 

Detailed Description

Function Documentation

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
xX-coordinate of the current normal of a face, edge, or vertex.
yY-coordinate of the current normal of a face, edge, or vertex.
zZ-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.

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

Returns the normal for the currently open vertex or face.

Parameters
xX-coordinate of the current normal of a face, edge, or vertex.
yY-coordinate of the current normal of a face, edge, or vertex.
zZ-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.