NNS_G2dSetOamManagerSpriteZoffsetStep

Syntax

#include <nnsys/g2d/g2d_Oam.h>

NNS_G2D_INLINE void NNS_G2dSetOamManagerSpriteZoffsetStep
( 
    NNSG2dOamManagerInstance*   pMan, 
    fx32                        zStep 
);

Arguments

pMan [OUT] OAM manager entity.
zStep [IN] Value that Z is incremented each time a software sprite is rendered (must be 0 or a negative number).

Return Values

None.

Description

Specifies the Z-value added each time a software sprite is rendered.
This setting is effective only with the manager initialized in software sprite drawing mode. At the time of initialization, specify NNS_G2D_OAMTYPE_SOFTWAREEMULATION for the OAM type to manage (NNSG2dOamType). The spriteZoffset value must be less than or equal to 0.

TWL In the NITRO 3D Graphics Engine, if polygons have the same Z-value, the re-render determination is based on a comparison of screen Y-values. Therefore, for polygons to overwrite each other in the order they were rendered (as with OBJ rendering), in the case of software sprites you must avoid rendering polygons that have the same Z-value by slightly offsetting the polygon Z-values when rendering.

See Also

None.

Revision History

2008/06/20 Added description specific to TWL.
2004/09/01 Initial version.

CONFIDENTIAL