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

*GL3.2 for AIX: Graphics Library (GL) Technical Reference*

## loadmatrix Subroutine

### Purpose

Loads a transformation matrix.

### Libraries

Graphics Library

C (**libgl.a**)

FORTRAN (**libfgl.a**)

### C Syntax

**void loadmatrix(Matrix ***matrix***)**

### FORTRAN Syntax

**SUBROUTINE LOADMA(***matrix***)**
**REAL ***matrix***(4,4)**

### Description

The **loadmatrix** subroutine loads a 4x4 floating point matrix onto the
transformation stack, replacing the current top matrix. If the system is in projection matrix mode (`mmode(MPROJ);),` the projection matrix is replaced.

Be sure to exit projection matrix mode before performing any drawing because drawing is not enabled while in this mode.

**Note: **The operation of this subroutine for the Supergraphics Processor Subsystem is modified. (See "Hardware Considerations" in* GL3.2 Version 4 for AIX: Programming Concepts*.)

### Parameter

*matrix* |
Specifies the matrix to be loaded onto the
matrix stack. |

### Example

After changing the matrix mode to **MVIEWING** with the **mmode** subroutine, the example C language program **localatten.c** uses the **loadmatrix** subroutine to load the modelling/viewing matrix with the identity matrix.

### 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

Setting the current matrix mode with the **mmode** subroutine.

Getting a copy of the current transformation matrix with the **getmatrix** 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, Working with Coordinate Systems.

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