fungsi glPolygonStipple

Fungsi glPolygonStipple mengatur pola stippling poligon.

Sintaks

void WINAPI glPolygonStipple(
   const GLubyte *mask
);

Parameter

masker

Penunjuk ke pola stipple 32x32 yang akan dibongkar dari memori dengan cara yang sama seperti glDrawPixel membongkar piksel.

Menampilkan nilai

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_OPERATION	Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd.

Keterangan

Fungsi glPolygonStipple mengatur pola stippling poligon. Polygon stippling, seperti line stippling (lihat glLineStipple), menutupi fragmen tertentu yang dihasilkan oleh rasterisasi, menciptakan pola. Stippling independen dari antialias poligon.

Parameter masker adalah penunjuk ke pola stipple 32x32 yang disimpan dalam memori sama seperti data piksel yang disediakan untuk glDrawPixels dengan tinggi dan lebar yang sama dengan 32, format piksel GL_COLOR_INDEX, dan jenis data GL_BITMAP. Artinya, pola stipple direpresentasikan sebagai array 32x32 dari indeks warna 1-bit yang dikemas dalam byte yang tidak ditandatangani. Parameter fungsi glPixelStore , seperti GL_UNPACK_SWAP_BYTES dan GL_UNPACK_LSB_FIRST, memengaruhi perakitan bit menjadi pola stipple. Namun, operasi transfer piksel (pergeseran, offset, dan peta piksel) tidak diterapkan ke gambar tipis.

Stippling poligon diaktifkan dan dinonaktifkan dengan glEnable dan glDisable, menggunakan argumen GL_POLYGON_STIPPLE. Jika diaktifkan, fragmen poligon raster dengan koordinat jendela x_w dan y_w dikirim ke tahap berikutnya OpenGL jika dan hanya jika (x_w mod 32)th bit di baris (y_w mod 32)th dari pola stipple adalah satu. Ketika polygon stippling dinonaktifkan, seolah-olah pola stipple adalah semua yang.

Fungsi berikut mengambil informasi yang terkait dengan glPolygonStipple:

glGetPolygonStipple

glIsEnabled dengan argumen GL_POLYGON_STIPPLE

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

glDrawPixels

glEnd

glLineStipple

glPixelStore

glPixelTransfer