glTexEnvi (Fungsi glTexEnvi)
Fungsi glTexEnvi menetapkan parameter lingkungan tekstur.
void WINAPI glTexEnvi(
GLenum target,
GLenum pname,
GLint param
);
-
target
-
Lingkungan tekstur. Pasti GL_TEXTURE_ENV.
-
pname
-
Nama simbolis parameter lingkungan tekstur bernilai tunggal. Pasti GL_TEXTURE_ENV_MODE.
-
Param
-
Konstanta simbolis tunggal, salah satu GL_MODULATE, GL_DECAL, GL_BLEND, atau GL_REPLACE.
Fungsi ini tidak mengembalikan nilai.
Kode kesalahan berikut dapat diambil oleh fungsi glGetError .
Nama | Makna |
---|---|
|
target atau pname bukan salah satu nilai yang ditentukan yang diterima, atau ketika param harus memiliki nilai konstanta yang ditentukan (berdasarkan nilai pname) dan tidak. |
|
Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd. |
Lingkungan tekstur menentukan bagaimana nilai tekstur ditafsirkan saat fragmen diteksur. Parameter target harus GL_TEXTURE_ENV. Parameter pname GL_TEXTURE_ENV_MODE. Tiga fungsi tekstur didefinisikan: GL_MODULATE, GL_DECAL, dan GL_BLEND.
Fungsi tekstur bertindak pada fragmen yang akan diteksur menggunakan nilai gambar tekstur yang berlaku untuk fragmen (lihat glTexParameter) dan menghasilkan warna RGBA untuk fragmen tersebut. Tabel berikut menunjukkan bagaimana warna RGBA diproduksi untuk masing-masing dari tiga fungsi tekstur yang dapat dipilih. C adalah tiga nilai warna (RGB) dan A adalah nilai alfa terkait. Nilai RGBA yang diekstrak dari gambar tekstur berada dalam rentang [0, 1]. Subskrip f mengacu pada fragmen masuk, subskrip t ke gambar tekstur, subskrip c ke warna lingkungan tekstur, dan subskrip v menunjukkan nilai yang dihasilkan oleh fungsi tekstur.
Gambar tekstur dapat memiliki hingga empat komponen per elemen tekstur (lihat glTexImage1D dan glTexImage2D). Dalam gambar satu komponen, Lt menunjukkan bahwa komponen tunggal. Gambar dua komponen menggunakan L? dan A? . Gambar tiga komponen hanya memiliki nilai warna, C? . Gambar empat komponen memiliki nilai warna C? dan nilai alfa A? .
Jumlah komponen | GL_MODULATE | GL_DECAL | GL_BLEND |
---|---|---|---|
1${REMOVE}$ |
Cv = L?Cf | undefined${REMOVE}$ |
Cv = (1 - L?Cf + L?Cc |
A v = A f | A v = A f | ||
2${REMOVE}$ |
Cv = L?Cf | undefined${REMOVE}$ |
Cv = (1 - L?Cf + L?Cc |
A v = A f | A v = A f | ||
3${REMOVE}$ |
Cv = C?Cf | Cv = C? | undefined${REMOVE}$ |
A v = A f | A v = A f | ||
4${REMOVE}$ |
Cv = C?Cf | Cv = (1 - A?)Cf + A?C? | undefined${REMOVE}$ |
A v = J?A f | A v = A f |
GL_TEXTURE_ENV_MODE default ke GL_MODULATE.
Fungsi berikut mengambil informasi yang terkait dengan glTexEnvi:
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 |
|