NNS_G2dMakeSimpleMultiCellToOams

C Specification

#include <nnsys/g2d/g2d_MultiCellAnimation.h>
u16 NNS_G2dMakeSimpleMultiCellToOams
( 
    GXOamAttr*              pDstOams,
    u16                             numDstOams,
    const NNSG2dMultiCellInstance*  pMCellInst, 
    const MtxFx22*          pMtxSR, 
    const NNSG2dFVec2*      pBaseTrans,
    u16                     affineIndex,
    BOOL                    bDoubleAffine 
)

Arguments

pDstOams [OUT] Points to the start of the buffer that stores the conversion result
numDstOams [IN] Length of the buffer that stores the conversion result
pMCellInst [IN] Multicell entity
pMtxSR [IN] Affine transformation (optional)
affineIdx [IN] Affine index (optional)
pBaseTrans [IN] Translation value (optional)
bDoubleAffine [IN] Whether or not to use the double-size affine mode

Return Values

The number of OBJ used.

Description

Writes out the OBJ array that draws the multicell. It ensures that there is sufficient space in the buffer. It also passes a NULL value to pMtxSR and pBaseTrans when there are no affine conversions and translation values. Designate an affine index when performing an affine conversion. NNS_G2dMakeCellToOams is executed internally using this function's own component cell animation as an argument. The affine conversion matrix that is taken in by this function must be a standard-format matrix. Be aware that matrices that have reciprocals for the scale values used as the affine parameters of the 2D graphics engine are not allowed. Note that the flip effect for the OBJ cannot be achieved when the affine transformation is applied.

This function can process only a multicell consisting of the cell animations to which the SR (scale and rotate) transformation has not been applied.
If rendering a multicell composed of SR-transformed cell animations, consider using the renderer module, etc.

See Also

NNS_G2dMakeCellToOams

Revision History

09/01/2004 Added a description of a multicell consisting of cell animations.

08/02/2004 Added description of the limitation for applying an affine transformation.

05/28/2004 Initial version.


CONFIDENTIAL