NNS_G2dEntryOamManExOam

C Specification

#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 for drawing)

Return Values

Success or failure of registration

Description

Registers OBJs in the extended OAM Manager and specifies the order of the entry when it is drawn. When actually applied to the hardware, this will register to the OAM in the designated display priority order.

This following caution applies when the drawing orders for OAM groups have the same display priority.

OAM groups with the same display priority are managed in 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 registration order. 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 NNS_G2dApplyOamManExToBaseModule() is called. Accordingly, OAMs that have undergone affine transformaton in OAM groups with the same display priority will be called before OAMs that have not undergone affine transformaton.  

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

See Also

NNS_G2dEntryNewOamEx
NNS_G2dEntryOamManExOamWithAffineIdx

Revision History

03/28/2005 Added caution regarding the drawing order for OAM groups with the same display priority.
08/02/2004 Renamed function.
06/22/2004 Initial version.


CONFIDENTIAL