guPosition.3p
1009 Bytes
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
.TH guPosition 3P local "Silicon Graphics, Inc."
.SH NAME
.upperok
guPosition, guPositionF \- computes a modeling matrix.
.SH C SPECIFICATION
.nf
\f3#include "gu.h"
void guPosition(Mtx *m, float r, float p, float h, float s,
float x, float y, float z);
void guPositionF(float mf[4][4], float r, float p, float h, float s,
float x, float y, float z);
\fP
.fi
.SH PARAMETERS
.TP 10
.I m
resulting 4x4 matrix.
.TP
.I r, p, h
rotate: r=roll p=pitch h=heading(yaw)
.TP
.I s
scale by factor s
.TP
.I x, y, z
translation value along x, y, and z axis.
.SH DESCRIPTION
.I guPosition
returns a fixed point 4x4 matrix
.B m,
which locates an object at position
.B x,y,z
with an orientation determined by
.B r,p,h.
.PP
For a detailed description of the
fixed-point matrix format, see
.I gSPMatrix (3P).
.PP
.I guPositionF
returns a floating-point 4x4 matrix
.B m.
.SH SEE ALSO
.IR guRotate (3P)
.IR guScale (3P)
.IR guAlign (3P)
.IR gSPMatrix (3P)
.IR guTranslate (3G)