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

getmatrix Subroutine

Purpose

Returns the current transformation matrix.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void getmatrix(Matrix matrix)

FORTRAN Syntax

SUBROUTINE GETMAT(matrix)
REAL matrix(4,4)

Description

The getmatrix subroutine copies the matrix from the top of the stack to a user-specified array. This routine does not alter the matrix stack. When the system is in projection matrix mode, the matrix stack is not accessible. In projection mode, the matrix array receives a copy of the projection matrix instead.

Note: This subroutine cannot be used to add to a display list.

Parameter

matrix Specifies an array into which to copy a matrix.

Example

The example C language program scrn_rotate.c uses the getmatrix subroutine to get the current transformation matrix after manipulating it.

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

Loading a transformation matrix with the loadmatrix subroutine.

Setting the current matrix mode with the mmode subroutine.

Premultiplying the current transformation matrix with the multmatrix subroutine.

Popping the transformation matrix stack with the popmatrix subroutine.

Pushing down the transformation matrix stack with the pushmatrix subroutine.

AIX Graphics Library Overview, Querying the System, and Working with Coordinate Systems.


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