NNS_G2dSetRendererSpriteZoffset

C Specification

#include <nnsys/g2d/g2d_Renderer.h>
NNS_G2D_INLINE void NNS_G2dSetRendererSpriteZoffset
( 
       NNSG2dRendererInstance* pRend, 
        fx32                    spriteZoffset 
);

Arguments

pRend [OUT] Renderer entity
spriteZoffset [IN] Value 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. The spriteZoffset value must be less than or equal to zero.
In the NITRO 3D Graphics Engine, if polygons have the same Z value, the overwrite determination is based on a comparison of screen Y values. Therefore, to overwrite in the rendering order, 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. The Z value added to a sprite is reset each time a rendering function call (such as NNS_G2dDrawCell() or NNS_G2dDrawMultiCell()) completes. Therefore, when rendering a cell that consists of N OBJ, the Z axis depth is N * spriteZoffset.

See Also

None.

Revision History

09/01/2004 Initial version.