#include <nnsys/g2d/g2d_Renderer.h>
void NNS_G2dBeginRenderingEx
(
NNSG2dRendererInstance* pRendererInstance,
u32 opzHint
);
| pRendererInstance | [IN] レンダラ 実体 |
| opzHint | [IN] 最適化ヒント |
なし
レンダラ 描画前の設定を行います。
レンダラ 描画メソッドを呼ぶ前に呼んでください。
Begin End Rendering 内 で 呼び出さないでください。
本関数は、描画最適化のためのヒントフラグを指定可能です。
ヒントは NNSG2dRendererOptimizeHint 列挙子の論理和で作成します。
NNSG2dRendererOptimizeHint の定義は以下のようになっています。
typedef enum NNSG2dRendererOptimizeHint
{
NNS_G2D_RDR_OPZHINT_NONE = 0x0,
NNS_G2D_RDR_OPZHINT_NOT_SR = 0x1, // SR(Scale Rotate) 変換を使用しない
NNS_G2D_RDR_OPZHINT_LOCK_PARAMS = 0x2 // パラメータをロックする。
}NNSG2dRendererOptimizeHint;
NNS_G2D_RDR_OPZHINT_NOT_SR は SR(Scale Rotate) 変換を使用しない事を通知します。
NNS_G2D_RDR_OPZHINT_LOCK_PARAMS は 各種パラメータを固定することを通知します。
具体的には、画像プロクシ、サーフェス種類がレンダラ Begin-End Renderring ブロック内で変更不可能となります。
レンダラに対して、サーフェスが複数毎登録されている場合には、描画関数内でサーフェスを切り替える必要があるため、
本オプションを指定できません。指定した場合はアサートに失敗します。
最適化ヒントフラグはNNS_G2dEndRendering()によってリセットされます。
つまり、最適化ヒントフラグ は レンダラの Begin - End Rendering ブロック内でのみ有効となります。
本関数は、最適化のための前処理を行ったあと、通常のNNS_G2dBeginRendering()を呼び出しています。
NNS_G2dBeginRendering
NNS_G2dEndRendering
2004/11/10 初版