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

callobj Subroutine


Draws an instance of an object (display list).


Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void callobj(Int32 object)


INTEGER*4 object


The callobj subroutine draws an instance of a previously defined display list (object). If the subroutine specifies an undefined object, the system ignores the routine.

Global state attributes are not saved before a call to the callobj subroutine. Thus, if you change a variable within an object, such as color, the change can affect the caller as well.

Use the pushattributes and popattributes subroutines to preserve global state attributes across calls. Also, the object may execute transformations that change the matrix stack. Use the pushmatrix and popmatrix subroutines to restore the state of the matrix stack.

Note: This editing subroutine can be added to a display list.


object Specifies the identifier of the object to be drawn.


The example C language program depthcue.c uses the callobj subroutine, after specifying a rotation transformation, to rotate a graphical object (a cube).

Implementation Specifics

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


/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

Creating an object with the makeobj subroutine.

Popping the attribute stack with the popattributes subroutine.

Popping the transformation matrix stack with the popmatrix subroutine.

Saving the global state attributes with the pushattributes subroutine.

Pushing down the transformation matrix stack with the pushmatrix subroutine.

AIX Graphics Library Overview, Creating Objects (Display Lists), Setting Drawing Attributes, and Working with Coordinate Systems.

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