NNS_G3D_SBC_NODE

Command Format

Offset (bytes) Description
0 NNS_G3D_SBC_NODEMIX
1 Node ID.
2 If the lower order bit is 1, the node will be displayed. If the bit is 0 the node will not be displayed.

Description

The NNS_G3D_SBC_NODE command determines the node to which the materials and shapes sent after this command belong. By default, this command calls the sbc.c function NNSi_G3dFuncSbc_NODE. The following processes are performed inside this function:

  1. Sets the NNSG3dVisAnmResult structure's pointer to the pVisAnmResult member in the NNS_G3dRS structure.
  2. Checks the timing A callback. The callback in this position is convenient when substituting the visibility calculation 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.
  3. Sets the visibility information in *pMatAnmResult when the visibility information is static image / animation
  4. Checks the timing B callback. The callback in this position is convenient when processing the results of the visibility calculation in the callback function.
  5. Sets the NNS_G3dRS in response to the results of *pVisAnmResult. As subsequent commands use this flag, the polygon in the node displays or not, depending on the settings (visibility animation).
  6. Checks the timing C callback. The callback in this position is used when performing some sort of operation after this command finishes.


Timing for Calling a Callback Function Usage
NNS_G3D_SBC_CALLBACK_TIMING_A When you want to use a user callback to override the visibility calculations.
NNS_G3D_SBC_CALLBACK_TIMING_B When you want to extract the visibility calculation results. Or when you want to manipulate the visibility calculation results.
NNS_G3D_SBC_CALLBACK_TIMING_C When you want to enter some process after this command ends.

See Also

Revision History

10/14/2004 Revised description.

08/02/2004 Initial version.