[ Previous | Next | Contents | Glossary | Home | Search ]
GL3.2 for AIX: Graphics Library (GL) Technical Reference

pushname Subroutine

Purpose

Pushes a new name onto the name stack.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void pushname(Int16 name)

FORTRAN Syntax

SUBROUTINE PUSHNA(name)
INTEGER*4 name
Note: For FORTRAN users, this subroutine accepts long integer parameters (INTEGER*4) when invoked from a FORTRAN program, although it accepts short integers when invoked from a C program. The C and FORTRAN syntax shown here reflect this difference.

Description

The pushname subroutine pushes the name stack down one level and puts a new 16-bit name on top.

The name stack must first have been initialized with the initnames subroutine. At least one name must have been loaded onto the stack with the loadname subroutine. The system stores the contents of the name stack in a buffer if a hit has occurred since the late time that the name stack was touched.

This subroutine is ignored outside of picking or selecting mode.

Parameter

name Specifies the name to add to the name stack.

Example

The example C language program pick1.c calls the pushname subroutine to push the name stack and put a new name on the top.

Implementation Specifics

This subroutine is part of GL in the AIXwindows Environment/6000 Version 1, Release 2 with AIXwindows/3D Feature.

Files

/usr/include/gl/gl.h Contains C language constant and variable type definitions for GL.
/usr/include/gl/fgl.h Contains FORTRAN constant and variable type definitions for GL.

Related Information

Putting the system in selecting mode with the gselect subroutine.

Initializing the name stack with the initnames subroutine.

Loading the name on top of the name stack with the loadname subroutine.

Putting the system in picking mode with the pick subroutine.

Popping a name off name stack with the popname subroutine.

AIX Graphics Library Overview and Picking and Selecting Overview.


[ Previous | Next | Contents | Glossary | Home | Search ]