[ Next Article |
Previous Article |
Book Contents |
Library Home |
Legal |
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.

[ Next Article |
Previous Article |
Book Contents |
Library Home |
Legal |
Search ]