fungsi glBindTexture

Artikel
06/13/2023

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
GL_INVALID_ENUM	Target parameter bukan nilai yang diterima.
GL_INVALID_OPERATION	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	Gl.h
Pustaka	Opengl32.lib
DLL	Opengl32.dll

Lihat juga

glAreTexturesResident
glDeleteTextures
glGenTextures
glGet
glGetTexParameter
glIsTexture
glPrioritizeTextures
glTexImage1D
glTexImage2D
glTexParameter

Share via