[ 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 ]