NNS_G2dEntryOamManExOam

Syntax

#include <nnsys/g2d/g2d_OAMEx.h>

BOOL NNS_G2dEntryOamManExOam( 
                            NNSG2dOamManagerInstanceEx*     pMan, 
                            const GXOamAttr*                pOam, 
                            u8                              priority );

Arguments

`pMan`	[OUT] Extended OAM manager entity.
`pOam`	[IN] OAM attribute.
`priority`	[IN] Display priority (order of registration when rendering).

Return Values

Success or failure of registration.

Description

Specifies the order of registration of OBJs in the extended OAM Manager when rendering, and registers the OBJs. When actually applied to the hardware, this function registers OBJs to the OAM in the designated display priority order.

Note on the Render Order for OAM Groups with the Same Display Priority

OAM groups with the same display priority are managed internally by the manager, with lists. The manager calls and processes registration functions starting from the top of the internal list and then works toward the end. Because the OAM adds registration functions to the the top of the list as they are registered, registration functions are called in the reverse order of the order they were registered. OAMs that have undergone affine transformation are managed on a separate list in the manager, and they are moved to the top of the normal OAM list after the actual affine parameter numbers have been resolved when the NNS_G2dApplyOamManExToBaseModule function is called. Accordingly, OAMs that have undergone affine transformation in OAM groups with the same display priority will be called before OAMs that have not undergone affine transformation. Therefore, registered function calls occurs before OAM that have not undergone affine transformation.

The name of this function has been changed from NNS_G2dEntryNewOamEx. The previous function remains under a different name to maintain compatibility.

Revision History

2005/03/28 Added caution regarding the render order for OAM groups with the same display priority.

2004/08/02 Renamed function.

2004/06/22 Initial version.

CONFIDENTIAL