glAreTexturesResident 函式
glAreTexturesResident函式會決定指定的紋理物件是否位於紋理記憶體中。
語法
GLboolean WINAPI glAreTexturesResident(
GLsizei n,
const GLuint *textures,
GLboolean *residences
);
參數
-
n
-
要查詢的紋理數目。
-
紋理
-
陣列的位址，其中包含要查詢之紋理的名稱。
-
住宅
-
傳回紋理居住狀態的陣列位址。 紋理元素所命名的 紋理 的居住狀態會傳回在對應的 居住元素中。
錯誤碼
glGetError函式可以擷取下列錯誤碼。
| 名稱 | 意義 |
|---|---|
|
n 是負值、 紋理 中的元素是零，或 紋理 中的元素不包含紋理識別碼。 |
|
在 對 glBegin 的呼叫與 glEnd的對應呼叫之間呼叫函式。 |
備註
在具有有限紋理記憶體數量的機器上，OpenGL 會建立一組固定在紋理記憶體中的紋理。 這些紋理可以比非駐留的紋理更有效率地系結至紋理目標。
glAreTexturesResident函式會查詢紋理元素所命名之n紋理的紋理狀態。 如果所有具名紋理都是駐留的， glAreTexturesResident 會傳回GL_TRUE，而且 不會干擾居住 的內容。 如果任一具名紋理都未存在，glAreTexturesResident會傳回GL_FALSE，而且詳細狀態會在居住的n個元素中傳回。
如果 GL_TRUE地 元素，則由對應紋理元素命名的 紋理 會駐留在紋理記憶體中。
若要查詢單一系結紋理的居住狀態，請呼叫 glGetTexParameter ，並將 目標 設定為系結的目標紋理，並將 pname 參數設定為GL_TEXTURE_RESIDENT。 您必須使用這個方法來查詢預設紋理的駐留狀態。
您無法在顯示清單中包含 glAreTexturesResident 。
glAreTexturesResident函式會在叫用時傳回紋理的落地狀態。 它不保證紋理會保留在任何其他時間。
如果紋理位於虛擬記憶體 (沒有紋理記憶體) ，則會被視為一律駐留。
注意
glAreTexturesResident函式僅適用于 OpenGL 1.1 版或更新版本。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|