NNS_G2dGetNewOamManagerInstanceAsFastTransferMode

Syntax

#include <nnsys/g2d/g2d_Oam.h>


BOOL NNS_G2dGetNewOamManagerInstanceAsFastTransferMode
( 
    NNSG2dOamManagerInstance*   pMan, 
    u16                         fromOBJ, 
    u16                         numOBJ,
    NNSG2dOamType               type 
);

Arguments

`pMan`	[OUT] OAM manager entity
`fromOBJ`	[IN] OAM management region-start index (must be a multiple of 4)
`numOBJ`	[IN] Number of OAM attributes to use (must be nonzero and a multiple of 4)
`type`	[IN] OAM type

Return Values

Success or failure.

Description

Initializes the OAM Manager entity. This function must be called before making use of the OAM Manager itself. After OAM Manager is initialized by this function, it can use DMA for fast data transfers to the graphics engine. There are restrictions on the region secured with this function. (For example, the OAM management region starting index must be a multiple of 4.)
In addition, the management affine parameter regions are included in the management OAM attribute region, and they are allocated according to the number of parameters. (Example: OAMs 0-32 => affine parameters 0-8.)

The NNS_G2dGetNewOamManagerInstance function, which initializes an OAM manager entity that has a higher degree of freedom, is also provided. However, it is not capable of fast buffer transfer.

The NNS_G2dGetNewOamManagerInstanceAsFastTransferMode function combines the processes that used to be executed by calling the two prior functions NNS_G2dGetNewManagerInstance and NNS_G2dInitManagerInstanceAffine. To maintain compatibility these two other functions still exist, but you should make use of this new function for new applications.

Revision History

2004/08/02 Initial version.