共用方式為


glPrioritizeTextures 函式

glPrioritizeTextures函式會設定紋理的居住優先順序。

語法

void WINAPI glPrioritizeTextures(
         GLsizei  n,
   const GLuint   *textures,
   const GLclampf *priorities
);

參數

n

要排定優先順序的紋理數目。

紋理

陣列中第一個專案的指標,其中包含要排定優先順序的紋理名稱。

優先 級

包含紋理優先順序之陣列第一個專案的指標。 priorities 參數元素中指定的優先順序會套用由 textures參數對應元素所命名的紋理。

傳回值

此函式不會傳回值。

錯誤碼

glGetError函式可以擷取下列錯誤碼。

名稱 意義
GL_INVALID_VALUE
n 是負值。
GL_INVALID_OPERATION
函式是在 對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。

備註

glPrioritizeTextures函式會將priorities參數中指定的n紋理優先順序指派給textures參數中名為 的n紋理。 在具有有限紋理記憶體的電腦上,OpenGL 會建立位於紋理記憶體中的紋理「工作集」。 這些紋理可以比非常駐的紋理更有效率地系結至紋理目標。

藉由指定每個紋理的優先順序, glPrioritizeTextures 函 式可讓您判斷哪些紋理應位於其中。

在指派之前, 優先順序中的紋理 優先順序元素會限制為範圍 [0.0, 1.0]。 零表示最低優先順序;因此,優先順序為零的紋理不太可能是常駐的。 值 1.0 表示最高優先順序;因此,優先順序為 1.0 的紋理最有可能是常駐的。 不過,在系結紋理之前,不保證會持續存在。

glPrioritizeTextures 函式會忽略嘗試設定紋理 0 的優先順序,或任何未對應至現有紋理的紋理名稱。 紋理參數所命名的函式都不需要系結至紋理目標。

如果紋理目前已系結,您也可以使用 glTexParameter 函式來設定其優先順序。 這是設定預設紋理優先順序的唯一方法。

您可以在顯示清單中包含 glPrioritizeTextures

下列函式會擷取與 glPrioritizeTextures相關的目前系結紋理優先順序:

注意

glPrioritizeTextures 函式僅適用于 OpenGL 1.1 版或更新版本。

規格需求

需求
最低支援的用戶端
Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限桌面應用程式]
標頭
Gl.h
程式庫
Opengl32.lib
DLL
Opengl32.dll

另請參閱

glAreTexturesResident

glBegin

glEnd

glGetTexParameter

glTexImage1D

glTexImage2D

glTexParameter