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

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

## multmatrix Subroutine

### Purpose

Premultiplies the current transformation matrix.

### Libraries

Graphics Library

C (**libgl.a**)

FORTRAN (**libfgl.a**)

### C Syntax

**void multmatrix(Matrix ***matrix***)**

### FORTRAN Syntax

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

### Description

The **multmatrix** subroutine premultiplies the current top of the transformation stack by the given matrix. If *T* is the current matrix, **multmatrix(M)** replaces *T* with *M***T*. If the system is in projection matrix mode (`mmode(MPROJ);),`
the projection matrix is premultiplied.

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".)

### Parameter

*matrix* |
Specifies the matrix that is to multiply the current top matrix of the
matrix stack. |

### Example

The example C language program **curve3.c** calls the **multmatrix** subroutine with the control point matrix, the Bezier basis matrix, and the precision matrix to set up the transformation matrix to draw a Bezier curve.

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

Loading a transformation matrix with the **loadmatrix** subroutine.

Popping the transformation matrix stack with the **popmatrix** subroutine.

Pushing down the transformation matrix stack with the **pushmatrix** subroutine.

AIX Graphics Library Overview and Working with
Coordinate Systems.

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