NNS_G2dSetRndCoreCurrentMtx2D

Syntax

#include <nnsys/g2d/g2d_RendererCore.h>

    
    void NNS_G2dSetRndCoreCurrentMtx2D
    (
        const MtxFx32*                 pMtx,
        NNSG2dRndCore2DMtxCache*       pCurrentMtxCacheFor2D
    );

Arguments

pMtx [IN] Current transformation matrix
pCurrentMtxCacheFor2D [OUT] Matrix cache that stores affine parameters

Return Values

None.

Description

Sets the affine transformation parameters that will be applied when rendering with the 2D Graphics Engine. When drawing with the 2D Graphics Engine, the affine transformation matrix is used in the CPU for coordinate transformation of the OBJ position. The affine parameters are set using the matrix cache. If NULL is specified for the pointer to the matrix cache, it is understood that affine transformation will not take place. A warning message will be displayed if NULL has been specified for the pointer to the matrix cache but an affine transformation has nevertheless been applied to the pMtx matrix. Use the NNS_G2dSetRndCore2DMtxCacheMtxParams() function to set the matrix cache.

The configured affine parameters are valid inside the BeginRendering — EndRendering block.
The settings are reset when NNS_G2dRndCoreEndRendering() is called, so you will need to use this function to configure the settings again.

This function can only be used when drawing with the 2D Graphics Engine.
A warning message will be output if it is called when the 3D Graphics Engine is drawing.

This function must be called inside the BeginRendering — EndRendering block.

See Also

NNS_G2dSetRndCoreCurrentMtx3D, NNS_G2dSetRndCore2DMtxCacheMtxParams

Revision History

2004/11/10 Initial version.

CONFIDENTIAL