gSPForceMatrix.3p
1.71 KB
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
53
54
55
56
57
58
59
60
61
62
63
.TH gSPForceMatrix 3P local "Silicon Graphics, Inc."
.SH NAME
.upperok
gSPForceMatrix, gsSPForceMatrix
\- Load a new matrix without multiplications.
.SH C SPECIFICATION
.nf
\f3#include "gbi.h"
gSPForceMatrix(Gfx *gdl, Mtx *mptr)
gsSPForceMatrix(Mtx *mptr)
\fP
.fi
.SH PARAMETERS
.TP 10
.I *gdl
graphics display list pointer.
.TP
.I mptr
pointer to the matrix to load (see note below about format).
.SH DESCRIPTION
This is an advanced command. A good understanding of how matrices work in
the RSP microcode is suggested before using this command (see
.I gSPMatrix (3P)).
.PP
This command will load a new matrix (pointed to by mptr) into the
top of the RSP's matrix stacks. It bypasses any matrix multiplication
and replaces the concatenated MODELVIEW and PROJECTION matrix with
a single matrix wich is used for the entire transformation. It does not
push or pop any matrices onto or off of the MODELVIEW or PROJECTION matrix
stacks, nor does it modify the top of these stacks. If this command is
followed by a
.I gSPMatrix
(3P) command then the matrix supplied by
.I gSPForceMatrix
will be lost and will not affect the new matrix on the RSP (as if the
.I gSPForceMatrix
command had never been sent).
.SH IMPORTANT NOTE
The
.I gSPForceMatrix
command does not affect lighting. Therefore, if you are using lighting
and you use the
.I gSPForceMatrix
command, the lights will act on a rendered object according to the
RSP's matrix state preceding the
.I gSPForceMatrix
command, but the object's position and orientation will be determined
by the matrix sent by the
.I gSPForceMatrix
command.
.SH MATRIX FORMAT
Please see the note on Matrix Format in the
.I gSPMatrix (3P)
man page.
.SH SEE ALSO
.IR gSPMatrix (3P),
.IR gSPInsertMatrix (3P)