次の方法で共有

glAreTexturesResident 関数

  • [アーティクル]

glAreTexturesResident 関数は、指定されたテクスチャ オブジェクトがテクスチャ メモリ内に存在するかどうかを決定します。

構文

GLboolean WINAPI glAreTexturesResident(
         GLsizei   n,
   const GLuint    *textures,
         GLboolean *residences
);

パラメーター

n

クエリを実行するテクスチャの数。

テクスチャ

クエリを実行するテクスチャの名前を含む配列のアドレス。

住宅

テクスチャの常駐状態が返される配列のアドレス。 テクスチャの要素によって名前付けされた テクスチャ のステータスは、対応する レジデンス要素で返されます。

エラー コード

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

名前 意味
GL_INVALID_VALUE
 n は負の値、 テクスチャ 内の要素がゼロ、またはテクスチャ内の要素に テクスチャ 識別子が含まれていませんでした。
GL_INVALID_OPERATION
 この関数は、 glBegin の呼び出しと glEnd の対応する呼び出しの間で呼び出されました。

解説

テクスチャ メモリの量が限られているマシンでは、OpenGL はテクスチャ メモリに存在するテクスチャのワーキング セットを確立します。 これらのテクスチャは、常駐していないテクスチャよりもはるかに効率的にテクスチャ ターゲットにバインドできます。

glAreTexturesResident 関数は、テクスチャの要素によって名前付けされた n 個のテクスチャのテクスチャの状態を照会します。 すべての名前付きテクスチャが常駐である場合、 glAreTexturesResident はGL_TRUEを返し、 レジデンス の内容は乱れはありません。 名前付きテクスチャのいずれかが常駐でない場合、glAreTexturesResident はGL_FALSEを返し、詳細な状態はレジデンスの n 要素で返されます。

レジデンスの要素がGL_TRUE場合、テクスチャの対応する要素によって名前付けされたテクスチャはテクスチャ メモリ内に存在します。

バインドされた 1 つのテクスチャの状態を照会するには、ターゲット パラメーターをターゲットのバインド先のターゲット テクスチャに設定して glGetTexParameter を呼び出し、pname パラメーターをGL_TEXTURE_RESIDENTに設定します。 既定のテクスチャの常駐状態を照会するには、このメソッドを使用する必要があります。

表示リストに glAreTexturesResident を含めることはできません。

glAreTexturesResident 関数は、呼び出し時のテクスチャの常駐状態を返します。 テクスチャが他の時点で常駐する保証はありません。

テクスチャが仮想メモリに存在する場合 (テクスチャ メモリがない場合)、テクスチャは常に常駐と見なされます。

Note

glAreTexturesResident 関数は、OpenGL バージョン 1.1 以降でのみ使用できます。

要件

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

関連項目

glBegin

glBindTexture

glEnd

glGetTexParameter

glPrioritizeTextures

glTexImage1D

glTexImage2D