fungsi glAreTexturesResident

Artikel
06/13/2023

Fungsi glAreTexturesResident menentukan apakah objek tekstur yang ditentukan adalah residen dalam memori tekstur.

Sintaks

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

Parameter

n: Jumlah tekstur yang akan dikueri.
Tekstur: Alamat array yang berisi nama tekstur yang akan dikueri.
Residences: Alamat array tempat status tempat tinggal tekstur dikembalikan. Status tempat tinggal tekstur yang dinamai oleh elemen tekstur dikembalikan dalam elemen tempat tinggal yang sesuai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_VALUE	n adalah nilai negatif, elemen dalam tekstur adalah nol, atau elemen dalam tekstur tidak berisi pengidentifikasi tekstur.
GL_INVALID_OPERATION	Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd.

Keterangan

Pada mesin dengan memori tekstur dalam jumlah terbatas, OpenGL menetapkan sekumpulan tekstur kerja yang merupakan residen dalam memori tekstur. Tekstur ini dapat terikat pada target tekstur jauh lebih efisien daripada tekstur yang tidak residen.

Fungsi glAreTexturesResident meminta status tempat tinggal tekstur dari tekstur n yang dinamai oleh elemen tekstur. Jika semua tekstur bernama adalah residen, glAreTexturesResident mengembalikan GL_TRUE, dan isi tempat tinggal tidak terganggu. Jika salah satu tekstur bernama tidak residen, glAreTexturesResident mengembalikan GL_FALSE, dan status terperinci dikembalikan dalam elemen ntempat tinggal.

Jika elemen tempat tinggal GL_TRUE, maka tekstur yang dinamai oleh elemen tekstur yang sesuai adalah residen dalam memori tekstur.

Untuk mengkueri status tempat tinggal dari tekstur terikat tunggal, panggil glGetTexParameter dengan parameter target yang diatur ke tekstur target tempat target terikat dan atur parameter pname ke GL_TEXTURE_RESIDENT. Anda harus menggunakan metode ini untuk mengkueri status penduduk tekstur default.

Anda tidak dapat menyertakan glAreTexturesResident dalam daftar tampilan.

Fungsi glAreTexturesResident mengembalikan status residensi tekstur pada saat pemanggilan. Ini tidak menjamin bahwa tekstur akan tetap tinggal di lain waktu.

Jika tekstur berada di memori virtual (tidak ada memori tekstur), tekstur dianggap selalu residen.

Catatan

Fungsi glAreTexturesResident 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

glBegin
glBindTexture
glEnd
glGetTexParameter
glPrioritizeTextures
glTexImage1D
glTexImage2D

Bagikan melalui