fungsi glPrioritizeTextures

Artikel
06/13/2023

Fungsi glPrioritizeTextures menetapkan prioritas tempat tinggal tekstur.

Sintaks

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

Parameter

n: Jumlah tekstur yang akan diprioritaskan.
Tekstur: Penunjuk ke elemen pertama array yang berisi nama tekstur yang akan diprioritaskan.
Prioritas: Penunjuk ke elemen pertama dari array yang berisi prioritas tekstur. Prioritas yang diberikan dalam elemen parameter prioritas berlaku untuk tekstur yang dinamai oleh elemen parameter tekstur yang sesuai.

Menampilkan nilai

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_VALUE	n adalah nilai negatif.
GL_INVALID_OPERATION	Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd.

Keterangan

Fungsi glPrioritizeTextures menetapkan prioritas tekstur n yang ditentukan dalam parameter prioritas untuk tekstur n yang dinamai dalam parameter tekstur . Pada komputer dengan memori tekstur dalam jumlah terbatas, OpenGL menetapkan "set kerja" tekstur yang tinggal dalam memori tekstur. Tekstur ini dapat terikat pada target tekstur jauh lebih efisien daripada tekstur yang bukan penduduk.

Dengan menentukan prioritas untuk setiap tekstur, fungsi glPrioritizeTextures memungkinkan Anda menentukan tekstur mana yang harus menjadi residen.

Elemen prioritas tekstur dalam prioritas dijepit ke rentang [0.0, 1.0] sebelum ditetapkan. Nol menunjukkan prioritas terendah; dengan demikian tekstur dengan prioritas nol kemungkinan besar adalah residen. Nilai 1.0 menunjukkan prioritas tertinggi; dengan demikian tekstur dengan prioritas 1.0 kemungkinan besar adalah penduduk. Namun, tekstur tidak dijamin residen sampai terikat.

Fungsi glPrioritizeTextures mengabaikan upaya untuk memprioritaskan tekstur 0, atau nama tekstur apa pun yang tidak sesuai dengan tekstur yang ada. Tidak ada fungsi yang dinamai oleh parameter tekstur harus terikat ke target tekstur.

Jika tekstur saat ini terikat, Anda juga dapat menggunakan fungsi glTexParameter untuk mengatur prioritasnya. Ini adalah satu-satunya cara untuk mengatur prioritas tekstur default.

Anda dapat menyertakan glPrioritizeTextures dalam daftar tampilan.

Fungsi berikut mengambil prioritas tekstur yang saat ini terikat yang terkait dengan glPrioritizeTextures:

glGetTexParameter dengan nama parameter GL_TEXTURE_PRIORITY

Catatan

Fungsi glPrioritizeTextures hanya tersedia di OpenGL versi 1.1 atau yang lebih baru.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Gl.h
Pustaka	Opengl32.lib
DLL	Opengl32.dll

Lihat juga

glAreTexturesResident
glBegin
glEnd
glGetTexParameter
glTexImage1D
glTexImage2D
glTexParameter

Bagikan melalui