fungsi glScissor

Fungsi glScissor mendefinisikan kotak gunting.

Sintaks

void WINAPI glScissor(
   GLint   x,
   GLint   y,
   GLsizei width,
   GLsizei height
);

Parameter

x

Koordinat x (sumbu vertikal) untuk sudut kiri bawah kotak gunting.

y

Koordinat y (sumbu horizontal) untuk sudut kiri bawah kotak gunting. Bersama-sama, x dan y menentukan sudut kiri bawah kotak gunting. Awalnya (0,0).

width

Lebar kotak gunting.

height

Tinggi kotak gunting. Saat konteks OpenGL pertama kali dilampirkan ke jendela, lebar dan tinggi diatur ke dimensi jendela tersebut.

Menampilkan nilai

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_VALUE	Lebar atautinggi negatif.
GL_INVALID_OPERATION	Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd.

Keterangan

Fungsi glScissor mendefinisikan persegi panjang, yang disebut kotak gunting, dalam koordinat jendela. Dua parameter pertama, x dan y, menentukan sudut kiri bawah kotak. Parameter lebar dan tinggi menentukan lebar dan tinggi kotak.

Pengujian gunting diaktifkan dan dinonaktifkan menggunakan glEnable dan glDisable dengan argumen GL_SCISSOR_TEST. Saat pengujian gunting diaktifkan, hanya piksel yang terletak di dalam kotak gunting yang dapat dimodifikasi dengan menggambar perintah. Koordinat jendela memiliki nilai bilangan bulat di sudut piksel framebuffer bersama, sehingga glScissor(0,0,1,1) hanya memungkinkan piksel kiri bawah di jendela untuk dimodifikasi, dan glScissor(0,0,0,0) melarang modifikasi ke semua piksel di jendela.

Ketika pengujian gunting dinonaktifkan, seolah-olah kotak gunting menyertakan seluruh jendela.

Fungsi berikut mengambil informasi yang terkait dengan glScissor:

glGet dengan GL_SCISSOR_BOX argumen

glIsEnabled dengan argumen GL_SCISSOR_TEST

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

glEnable

glEnd

glIsEnabled

glViewport