glGetString 関数
glGetString 関数は、現在の OpenGL 接続を記述する文字列を返します。
構文
const GLubyte* WINAPI glGetString(
GLenum name
);
パラメーター
-
name
-
次のいずれかのシンボリック定数。
値 説明 - GL_VENDOR
この OpenGL 実装を担当する会社を返します。 この名前はリリースからリリースに変更されません。 - GL_RENDERER
レンダラーの名前を返します。 この名前は、通常、ハードウェア プラットフォームの特定の構成に固有です。 リリースからリリースに変更されることはありません。 - GL_VERSION
バージョンまたはリリース番号を返します。 - GL_EXTENSIONS
OpenGL でサポートされている拡張機能のスペース区切りの一覧を返します。
エラー コード
glGetError 関数では、次のエラー コードを取得できます。
名前 | 意味 |
---|---|
|
name が受け入れられた値ではありません。 |
|
この関数は、 glBegin の呼び出しと glEnd の対応する呼び出しの間で呼び出されました。 |
解説
glGetString 関数は、現在の OpenGL 接続の一部の側面を記述する静的文字列へのポインターを返します。
OpenGL には実装のパフォーマンス特性に関するクエリが含まれていないため、一部のアプリケーションは既知のプラットフォームを認識するように記述され、これらのプラットフォームの既知のパフォーマンス特性に基づいて OpenGL の使用を変更することが期待されます。 文字列GL_VENDORとGL_RENDERER一緒にプラットフォームを一意に指定します。リリースからリリースに変更されることはありません。 プラットフォーム認識アルゴリズムでは、そのように使用する必要があります。
glGetString から返される文字列の形式と内容は、実装によって異なりますが、次の点が異なります。
拡張名にはスペース文字は含まれません。また、GL_EXTENSIONS文字列内のスペース文字で区切られます。
GL_VERSION文字列はバージョン番号で始まります。 バージョン番号では、次のいずれかの形式が使用されます。
major_number。minor_number
major_number。minor_number。release_number
ベンダー固有の情報は、バージョン番号に従う場合があります。 その形式は実装によって異なりますが、スペースは常にバージョン番号とベンダー固有の情報を分離します。
すべての文字列は null で終わる。
エラーが生成された場合、 glGetString は 0 を返します。
必要条件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
ヘッダー |
|
ライブラリ |
|
[DLL] |
|