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

loadname Subroutine

Purpose

Loads a name onto the name stack.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void loadname(Int16 name)

FORTRAN Syntax

SUBROUTINE LOADNA(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 loadname subroutine replaces the top name in the name stack with a new 16-bit integer.

If a hit has occurred since the last time the name stack was touched, the system stores the contents of the name stack in a buffer. This enables the user to identify the part of an image that appears near the cursor.

The name stack is used only in picking or selecting mode.

Parameter

name Specifies the name to be loaded onto the name stack.

Example

The example C language program pick1.c calls the loadname subroutine to place a name on the top of the name stack.

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.

Putting the system in picking mode with the pick subroutine.

Popping a name off the name stack with the popname subroutine.

Pushing a new name onto the name stack with the pushname subroutine.

AIX Graphics Library Overview and Picking and Selecting Overview.


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