Brief Index      Full Index      I.M. Reference

Set_Priority


Functions

void Set_Priority (HC_KEY key, long priority)
void QSet_Priority (const char *segment, long priority)

Function Documentation

void Set_Priority ( HC_KEY  key,
long  priority 
)

Overrides the default drawing priority automatically assigned by HOOPS.

Parameters:
key - key to items whose priority is being specified
priority - Drawing priority of the item specified

DETAILS

If you set the Set_Rendering_Options("hsra = priority"), then HOOPS will use priority assigned via Set_Priority to decide the drawing order of objects. Objects with the highest priority are drawn last. By default all HOOPS objects have a drawing priority corresponding to the order of insertion, starting at 0. The 'priority' hidden surface removal algorithm is primarily used for creating layers within 2D scenes and can cause undesired results when rendering non-planar objects. Priorities can be set on segments, geometries and include links.

NOTES

The DirectX and OpenGL2 drivers have special code which optimizes the rendering of models which set priorities and use the priority hsra. A current limitation of this code is that priorities are not honored when they are set on include links.

When the 'priority' hsra is set, all tristrips within a single piece of geometry are given the same priority. This results in tristrips being drawn in a random order which can give undesired results. You can reduce these undesired results by turning on backplane culling.

RESTRICTIONS

See also:
Set_Rendering_Options, Show_Priority

void QSet_Priority ( const char *  segment,
long  priority 
)

Main Index
Brief Index      Full Index      I.M. Functions