NAME

glPushName, glPopName - push and pop the name stack

C SPECIFICATION

void ggllPPuusshhNNaammee( GLuint _n_a_m_e )

        

PARAMETERS

_n_a_m_e
Specifies a name that will be pushed onto the name stack.

C SPECIFICATION

void ggllPPooppNNaammee( void )

        

DESCRIPTION

The name stack is used during selection mode to allow sets of rendering commands to be uniquely identified. It consists of an ordered set of unsigned integers and is initially empty.

ggllPPuusshhNNaammee causes _n_a_m_e to be pushed onto the name stack. ggllPPooppNNaammee pops one name off the top of the stack.

The maximum name stack depth is implementation-dependent; call GGLL__MMAAXX__NNAAMMEE__SSTTAACCKK__DDEEPPTTHH to find out the value for a particular implementation. It is an error to push a name onto a full stack, or to pop a name off an empty stack. It is also an error to manipulate the name stack between the execution of ggllBBeeggiinn and the corresponding execution of ggllEEnndd. In any of these cases, the error flag is set and no other change is made to GL state.

The name stack is always empty while the render mode is not GGLL__SSEELLEECCTT. Calls to ggllPPuusshhNNaammee or ggllPPooppNNaammee while the render mode is not GGLL__SSEELLEECCTT are ignored.

ERRORS

GGLL__SSTTAACCKK__OOVVEERRFFLLOOWW is generated if ggllPPuusshhNNaammee is called while the name stack is full.

GGLL__SSTTAACCKK__UUNNDDEERRFFLLOOWW is generated if ggllPPooppNNaammee is called while the name stack is empty.

GGLL__IINNVVAALLIIDD__OOPPEERRAATTIIOONN is generated if ggllPPuusshhNNaammee or ggllPPooppNNaammee is executed between a call to ggllBBeeggiinn and the corresponding call to ggllEEnndd.

ASSOCIATED GETS

ggllGGeett with argument GGLL__NNAAMMEE__SSTTAACCKK__DDEEPPTTHH
ggllGGeett with argument GGLL__MMAAXX__NNAAMMEE__SSTTAACCKK__DDEEPPTTHH

SEE ALSO

ggllIInniittNNaammeess((33GG)), ggllLLooaaddNNaammee((33GG)), ggllRReennddeerrMMooddee((33GG)), ggllSSeelleeccttBBuuffffeerr((33GG))