fungsi glLineStipple

Fungsi glLineStipple menentukan pola stipple garis.

Sintaks

void WINAPI glLineStipple(
   GLint    factor,
   GLushort pattern
);

Parameter

Faktor

Pengali untuk setiap bit dalam pola stipple garis. Jika faktor adalah 3, misalnya, setiap bit dalam pola akan digunakan tiga kali sebelum bit berikutnya dalam pola digunakan. Parameter faktor dijepit ke rentang [1, 256] dan default ke satu.

pola

Bilangan bulat 16-bit yang pola bitnya menentukan fragmen garis mana yang akan digambar ketika garis dirasterisasi. Bit zero digunakan terlebih dahulu, dan pola defaultnya adalah semua.

Nilai kembali

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 glLineStipple menentukan pola stipple garis. Garis stippling masking keluar fragmen tertentu yang diproduksi oleh rasterisasi; fragmen tersebut tidak akan digambar. Masking dicapai dengan menggunakan tiga parameter: pola pola stipple garis 16-bit, faktor jumlah berulang, dan penghitungtiptip bilangan bulat.

Penghitung diatur ulang ke nol setiap kali glBegin dipanggil, dan sebelum setiap segmen baris glBegin (GL_LINES)/urutan glEnd dihasilkan. Ini bertahap setelah setiap fragmen segmen garis alias lebar unit dihasilkan, atau setelah setiap fragmen i dari segmen garis lebar i dihasilkan. Fragmen i yang terkait dengan hitungan ditutupi jika bit pola (faktors / ) mod 16 adalah nol. Jika tidak, fragmen ini dikirim ke framebuffer. Bit nol pola adalah bit yang paling tidak signifikan.

Garis antialisi diperlakukan sebagai urutan persegipanjang lebar 1x untuk tujuan stippling. Persegi panjang diraster atau tidak berdasarkan aturan fragmen yang dijelaskan untuk garis alias; ini menghitung persegi panjang daripada grup fragmen.

Stippling garis diaktifkan atau dinonaktifkan menggunakan glEnable dan glDisable dengan argumen GL_LINE_STIPPLE. Saat diaktifkan, pola stipple garis diterapkan seperti yang dijelaskan di atas. Ketika dinonaktifkan, seolah-olah polanya semuanya. Awalnya, pentipan garis dinonaktifkan.

Fungsi berikut mengambil informasi yang terkait dengan glLineStipple:

glGet dengan argumen GL_LINE_STIPPLE_PATTERN

glGet dengan argumen GL_LINE_STIPPLE_REPEAT

glIsEnabled dengan argumen GL_LINE_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

glEnd

glLineWidth

glPolygonStipple