[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

SET LOCAL TRANSFORMATION (PHOP,*,STOP,*)

Purpose

Use Set Local Transformation to insert a two-dimensional Set Local Transformation structure element into the open structure following the element pointer, or replace the element pointed at by the element pointer with a Set Local Transformation structure element, depending on the current edit mode.

When the graPHIGS API encounters this element during traversal, the graPHIGS API expands it into a 4 X 4 matrix as follows:

  -     -           -       -  
  |     |           |       |
  |a b c|           |a b 0 c|
  |d e f|  ----->   |d e 0 f|
  |g h i|           |0 0 1 0|
  |     |           |g h 0 i|
  -     -           |       |
                    -       -
Depending on the composition type, when the graPHIGS API encounters this element during traversal, the specified matrix replaces, is pre-concatenated with, or is post-concatenated with the current local modeling transformation matrix. The resultant matrix, in conjunction with the global modeling transformation, transforms all subsequent primitives from the Modeling Coordinate (MC) system to the World Coordinate (WC) system.

Language Bindings

C

pset_local_tran (local_tran, compose_type)

Input Parameters
Pmatrix local_tran
Local transformation matrix. (See Chapter 15. "ISO PHIGS Transformations" for a description of the storage of the transformation matrix).
Pcompose_type compose_type
Composition type (0=PTYPE_PRECONCAT, 1=PTYPE_POSTCONCAT, 2=PTYPE_REPLACE).

FORTRAN

PSLMT (xfrmt, ctype)

Input Parameters
real xfrmt(3,3)
Local transformation matrix. (See Chapter 15. "ISO PHIGS Transformations" for a description of the storage of the transformation matrix).
integer ctype
Composition type (0=PCPRE, 1=PCPOST, 2=PCREPL).
Errors

5
Function Requires State (PHOP,*,STOP,*)

Related Subroutines

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