glRenderMode 関数

glRenderMode 関数は、ラスター化モードを設定します。

構文

GLint WINAPI glRenderMode(
   GLenum mode
);

mode

ラスター化モード。次の 3 つの値が受け入れられます。既定値は GL_RENDER です。

値	説明
GL_RENDER	レンダリングモード。プリミティブはラスター化され、フレームバッファーに書き込まれるピクセルフラグメントが生成されます。これは通常モードであり、既定のモードでもあります。
GL_SELECT	選択モード。ピクセルフラグメントは生成されず、フレームバッファーの内容は変更されません。代わりに、レンダリングモードがGL_RENDERされた場合に描画されたプリミティブの名前のレコードが選択バッファーに返されます。選択モードを入力する前に作成する必要があります ( glSelectBuffer を参照)。
GL_FEEDBACK	フィードバックモード。ピクセルフラグメントは生成されず、フレームバッファーの内容は変更されません。代わりに、レンダリングモードがGL_RENDERされていた場合に描画された頂点の座標と属性がフィードバックバッファーに返されます。フィードバックモードを入力する前に作成する必要があります ( glFeedbackBuffer を参照)。

glGetError 関数では、次のエラーコードを取得できます。

名前	意味
GL_INVALID_ENUM	mode は、3 つの受け入れ可能な値の 1 つではなかった。
GL_INVALID_OPERATION	この関数は、 glSelectBuffer が少なくとも 1 回呼び出される前に、引数 GL_SELECTで呼び出されました。
GL_INVALID_OPERATION	この関数は、 glBeedbackBuffer が少なくとも 1 回呼び出される前に、引数 GL_FEEDBACKで呼び出されました。
GL_INVALID_OPERATION	この関数は、 glBegin の呼び出しと glEnd の対応する呼び出しの間で呼び出されました。

glRenderMode 関数は 1 つの引数 mode を受け取ります。これは、上記の 3 つの定義済み値のいずれかを想定できます。

glRenderMode 関数の戻り値は、モードではなく glRenderMode が呼び出されるときにレンダリング モードによって決定されます。 3 つのレンダリングモードで返される値は次のとおりです。

値	説明
GL_RENDER	ゼロ。
GL_SELECT	選択バッファーに転送されたヒットレコードの数。
GL_FEEDBACK	フィードバックバッファーに転送される値 (頂点ではない) の数。

選択とフィードバック操作の詳細については、 glSelectBuffer と glFeedbackBuffer を参照してください。

エラーが生成された場合、 glRenderMode は現在のレンダリングモードに関係なく 0 を返します。

次の関数は、 glRenderMode に関連する情報を取得します。

glGet と引数 GL_RENDER_MODE

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
ヘッダー	Gl.h
ライブラリ	Opengl32.lib
[DLL]	Opengl32.dll