glGetString 関数

  • [アーティクル]

glGetString 関数は、現在の OpenGL 接続を記述する文字列を返します。

構文

const GLubyte* WINAPI glGetString(
   GLenum name
);

パラメーター

name

次のいずれかのシンボリック定数。

値 説明
GL_VENDOR
 この OpenGL 実装を担当する会社を返します。 この名前はリリースからリリースに変更されません。
GL_RENDERER
 レンダラーの名前を返します。 この名前は、通常、ハードウェア プラットフォームの特定の構成に固有です。 リリースからリリースに変更されることはありません。
GL_VERSION
 バージョンまたはリリース番号を返します。
GL_EXTENSIONS
 OpenGL でサポートされている拡張機能のスペース区切りの一覧を返します。

エラー コード

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

名前 意味
GL_INVALID_ENUM
 name が受け入れられた値ではありません。
GL_INVALID_OPERATION
 この関数は、 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 [デスクトップ アプリのみ]
ヘッダー
Gl.h
ライブラリ
Opengl32.lib
[DLL]
Opengl32.dll

関連項目

glBegin

glEnd