NNS_G3D_SBC_BB
Command Format
| Offset (bytes) |
Description for NNS_G3D_SBCFLG_000 |
| 0 |
NNS_G3D_SBC_BB | NNS_G3D_SBCFLG_000 |
| 1 |
The node ID of a node that is targeted for billboard transformation. |
| Offset (bytes) |
Description for NNS_G3D_SBCFLG_001 |
| 0 |
NNS_G3D_SBC_BB | NNS_G3D_SBCFLG_001 |
| 1 |
The node ID of a node that is targeted for billboard transformation. |
| 2 |
The ID of the matrix stack where calculation results are stored. |
| Offset (bytes) |
Description for NNS_G3D_SBCFLG_010 |
| 0 |
NNS_G3D_SBC_BB | NNS_G3D_SBCFLG_010 |
| 1 |
The node ID of a node that is targeted for billboard transformation. |
| 2 |
The ID of the matrix stack from which restoration is done before calculation. |
| Offset (bytes) |
Description for NNS_G3D_SBCFLG_011 |
| 0 |
NNS_G3D_SBC_BB | NNS_G3D_SBCFLG_011 |
| 1 |
The node ID of a node that is targeted for billboard transformation. |
| 2 |
The ID of the matrix stack where calculation results are stored. |
| 3 |
The ID of the matrix stack from which restoration is done before calculation. |
Description
The NNS_G3D_SBC_BB command performs billboard conversion on the position / vector matrix. By default, this command calls the sbc.c NNSi_G3dFuncSbc_BB function. The following processes are performed inside this function:
- Restores the
position / vector matrix to the current matrix stack from the matrix stack (depending on command variations).
- Checks the timing
A callback. The callback in this position is convenient when substituting the billboard conversion calculations in the callback function. You can skip processing until the next callback by setting the NNS_G3D_RSFLAG_SKIP flag in the NNS_G3dRS structure in the callback function.
- Performs the billboard conversion calculation and setting the calculation results in the current matrix of the
position / vector matrix.
- Checks the timing
C callback. The callback in this position is used when performing some sort of operation after this command finishes.
- Stores the
position / vector matrix from the current matrix to the matrix stack (depending on command variations).
| Timing for Calling a Callback Function |
Usage |
NNS_G3D_SBC_CALLBACK_TIMING_A |
When you want a user program to do the material calculation. |
NNS_G3D_SBC_CALLBACK_TIMING_B |
When you want a user program to manipulate material calculation results. |
NNS_G3D_SBC_CALLBACK_TIMING_C |
When you want to enter some process after this command ends. |
| Option Flag |
Operation |
NNS_G3D_SBCFLG_000 |
Billboard-transforms the current matrix. Does not store calculation results in the matrix stack. |
NNS_G3D_SBCFLG_001 |
Billboard-transforms the current matrix. Then stores calculation results in the matrix stack. |
NNS_G3D_SBCFLG_010 |
Restores from a matrix stack and then billboard-transforms. Does not store calculation results in the matrix stack. |
NNS_G3D_SBCFLG_011 |
Restores from a matrix stack and then billboard-transforms. Then stores the calculation results in a matrix stack. |
See Also
Revision History
10/14/2004 Revised description.
08/02/2004 Initial version.