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

SCALE 3 (PHOP,*,*,*)

Purpose

Use Scale 3 to calculate a three-dimensional transformation matrix to perform the specified 3D-axis scaling.

If the graPHIGS API can compute the transformation matrix, then the graPHIGS API sets the error indicator to zero and returns the transformation matrix. If the graPHIGS API cannot compute the transformation matrix, then the values of the matrix are unpredictable and the graPHIGS API sets the error indicator to the following error:

2
Function Requires State (PHOP,*,*,*)

Language Bindings

C

pscale3 (scale_vec, err_ind, result_tran)

Input Parameters

const Pvec3 *scale_vec
Scale factor vector.

Output Parameters

Pint *err_ind
Error indicator.

Pmatrix3 result_tran
Transformation matrix. (See Chapter 15. "ISO PHIGS Transformations" for a description of the storage of the transformation matrix).

FORTRAN

PSC3 (fx, fy, fz, errind, xfrmt)

Input Parameters

real fx
x-axis scale factor.

real fy
y-axis scale factor.

real fz
z-axis scale factor.

Output Parameters

integer errind
Error indicator.

real xfrmt(4,4)
Transformation matrix. (See Chapter 15. "ISO PHIGS Transformations" for a description of the storage of the transformation matrix).

Errors

None

Related Subroutines

  • None

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