fungsi glBindTexture
Fungsi glBindTexture memungkinkan pembuatan tekstur bernama yang terikat dengan target tekstur.
Sintaks
void WINAPI glBindTexture(
GLenum target,
GLuint texture
);
Parameter
-
target
-
Target yang teksturnya terikat. Harus memiliki nilai GL_TEXTURE_1D atau GL_TEXTURE_2D.
-
Tekstur
-
Nama tekstur; nama tekstur saat ini tidak dapat digunakan.
Mengembalikan nilai
Fungsi ini tidak mengembalikan nilai.
Kode kesalahan
Kode kesalahan berikut dapat diambil oleh fungsi glGetError .
Nama | Makna |
---|---|
|
Target parameter bukan nilai yang diterima. |
|
Tekstur parameter tidak memiliki dimensi yang sama dengan target, atau fungsi dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd. |
Keterangan
Fungsi glBindTexture memungkinkan Anda membuat tekstur bernama. Memanggil glBindTexture dengan target diatur ke GL_TEXTURE_1D atau GL_TEXTURE_2D, dan tekstur diatur ke nama tekstur baru yang telah Anda buat mengikat nama tekstur ke target tekstur yang sesuai. Ketika tekstur terikat ke target, pengikatan sebelumnya untuk target tersebut tidak lagi berlaku.
Nama tekstur adalah bilangan bulat yang tidak ditandatangani dengan nilai nol yang dicadangkan untuk mewakili tekstur default untuk setiap target tekstur. Nama tekstur dan konten tekstur yang sesuai bersifat lokal ke ruang daftar tampilan bersama dari konteks penyajian OpenGL saat ini; dua konteks penyajian berbagi nama tekstur hanya jika mereka juga berbagi daftar tampilan. Anda dapat membuat sekumpulan nama tekstur baru menggunakan glGenTextures.
Ketika tekstur pertama kali terikat, ia mengasumsikan dimensi target teksturnya; tekstur yang terikat ke GL_TEXTURE_1D menjadi satu dimensi dan tekstur yang terikat ke GL_TEXTURE_2D menjadi dua dimensi. Operasi yang Anda lakukan pada target tekstur juga memengaruhi tekstur yang terikat ke target. Saat Anda mengkueri target tekstur, nilai yang dikembalikan adalah status tekstur yang terikat padanya. Target tekstur menjadi alias untuk tekstur yang saat ini terikat dengannya.
Saat Anda mengikat tekstur dengan glBindTexture, pengikatan tetap aktif sampai tekstur yang berbeda terikat ke target yang sama atau Anda menghapus tekstur terikat dengan fungsi glDeleteTextures . Setelah membuat tekstur bernama, Anda dapat mengikatnya ke target tekstur yang memiliki dimensi yang sama sesering yang diperlukan.
Biasanya jauh lebih cepat untuk menggunakan glBindTexture untuk mengikat tekstur bernama yang ada ke salah satu target tekstur daripada memuat ulang gambar tekstur menggunakan glTexImage1D atau glTexImage2D. Untuk kontrol tambahan performa tekstur, gunakan glPrioritizeTextures.
Anda dapat menyertakan panggilan ke glBindTexture dalam daftar tampilan.
Catatan
Fungsi glBindTexture hanya tersedia di OpenGL versi 1.1 atau yang lebih baru.
Fungsi berikut mengambil informasi yang terkait dengan glBindTexture:
- glGet dengan argumen GL_TEXTURE_1D_BINDING
glGet dengan argumen GL_TEXTURE_2D_BINDING
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
Header |
|
Pustaka |
|
DLL |
|