#include <nnsys/g2d/g2d_Renderer.h>
void NNS_G2dBeginRenderingEx
(
NNSG2dRendererInstance* pRendererInstance,
u32 opzHint
);
| pRendererInstance | [IN] Renderer entity |
| opzHint | [IN] Optimization hint |
None.
Performs configurations (preprocessing) before rendering with the renderer. Call this function before calling the renderer rendering method. Do not call this function inside the BeginRendering — EndRendering 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 BeginRendering — EndRendering 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 BeginRendering — EndRendering block of the renderer.
After performing the optimization preprocessing, this function calls the normal NNS_G2dBeginRendering() function.
NNS_G2dBeginRendering, NNS_G2dEndRendering
11/10/2004 Initial version.
CONFIDENTIAL