NNS_G2dBeginRenderingEx

C Specification

#include <nnsys/g2d/g2d_Renderer.h>
void NNS_G2dBeginRenderingEx 
    ( 
NNSG2dRendererInstance* pRendererInstance, 
u32                     opzHint 
    );

Arguments

pRendererInstance [IN] Renderer entity
opzHint [IN] Optimization hint

Return Values

None.

Description

Performs configurations (preprocessing) before rendering with the renderer. Call this function before calling the renderer rendering method. Do not call this function inside the BeginRenderingEndRendering block. It is possible to designate a hint flag for rendering optimization with this function.
The hint is created with the logical OR of the NNSG2dRendererOptimizeHint enumerator.

The definition of NNSG2dRendererOptimizeHint is as follows:

typedef enum NNSG2dRendererOptimizeHint
{
NNS_G2D_RDR_OPZHINT_NONE              = 0x0,
NNS_G2D_RDR_OPZHINT_NOT_SR            = 0x1,  // Do not use SR (Scale Rotate) conversion
NNS_G2D_RDR_OPZHINT_LOCK_PARAMS       = 0x2   //  Lock the parameter

}NNSG2dRendererOptimizeHint;

NNS_G2D_RDR_OPZHINT_NOT_SR indicates that SR (Scale Rotate) conversion is not used.

NNS_G2D_RDR_OPZHINT_LOCK_PARAMS indicates that each parameter will be locked.
Specifically, the image proxy and the surface type will not be alterable inside the renderer BeginRenderingEndRendering block. This option cannot be designated for the renderer, since the surface must be switched inside the render function if the surfaces are registered more than once each time. If designated, this option will fail in the assert.
The optimization hint flag is reset via NNS_G2dEndRendering().
In other words, the optimization hint flag will only be valid inside the BeginRenderingEndRendering block of the renderer.

After performing the optimization preprocessing, this function calls the normal NNS_G2dBeginRendering() function.

See Also

NNS_G2dBeginRendering, NNS_G2dEndRendering

Revision History

11/10/2004 Initial version.


CONFIDENTIAL