fungsi glLineWidth

Fungsi glLineWidth menentukan lebar garis yang dirasterisasi.

Sintaks

void WINAPI glLineWidth(
   GLfloat width
);

Parameter

width

Lebar garis yang dirasterisasi. Defaultnya adalah 1.0.

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Keterangan

Fungsi glLineWidth menentukan lebar raster dari garis alias dan antialisis. Menggunakan lebar garis selain 1.0 memiliki efek yang berbeda, tergantung pada apakah antialias garis diaktifkan. Antialias garis dikontrol dengan memanggil glEnable dan glDisable dengan argumen GL_LINE_SMOOTH.

Jika antialias garis dinonaktifkan, lebar aktual ditentukan dengan membulatkan lebar yang disediakan ke bilangan bulat terdekat. (Jika pembulatan menghasilkan nilai 0,0, seolah-olah lebar garis adalah 1,0) Jika | ? x | = | ? y |, i piksel diisi di setiap kolom yang dirasterisasi, di mana saya adalah nilai lebar yang dibulatkan. Jika tidak, piksel i diisi di setiap baris yang dirasterisasi.

Jika antialisi diaktifkan, rasterisasi garis menghasilkan fragmen untuk setiap persegi piksel yang berpotongan dengan wilayah yang terbaring di dalam persegi panjang memiliki lebar yang sama dengan lebar garis saat ini, panjangnya sama dengan panjang garis aktual, dan berpusat pada segmen garis matematika. Nilai cakupan untuk setiap fragmen adalah area koordinat jendela persimpangan wilayah persegi panjang dengan persegi piksel yang sesuai. Nilai ini disimpan dan digunakan dalam langkah rasterisasi akhir.

Tidak semua lebar dapat didukung ketika antialias baris diaktifkan. Jika lebar yang tidak didukung diminta, lebar terdekat yang didukung akan digunakan. Hanya lebar 1.0 yang dijamin didukung; yang lain tergantung pada implementasinya. Rentang lebar yang didukung dan perbedaan ukuran antara lebar yang didukung dalam rentang dapat dikueri dengan memanggil glGet dengan argumen GL_LINE_WIDTH_RANGE dan GL_LINE_WIDTH_GRANULARITY.

Lebar garis yang ditentukan oleh glLineWidth selalu dikembalikan saat GL_LINE_WIDTH dikueri. Penjepitan dan pembulatan untuk garis alias dan antialisi tidak berpengaruh pada nilai yang ditentukan.

Lebar garis yang tidak diantisipasi dapat dijepit ke maksimum yang bergantung pada implementasi. Meskipun maksimum ini tidak dapat dikueri, nilainya harus tidak kurang dari nilai maksimum untuk baris yang diantisipasi, dibulatkan ke nilai bilangan bulat terdekat.

Fungsi berikut mengambil informasi yang terkait dengan glLineWidth:

glGet dengan argumen GL_LINE_WIDTH

glGet dengan GL_LINE_WIDTH_RANGE argumen

glGet dengan argumen GL_LINE_WIDTH_GRANULARITY

glIsEnabled dengan argumen GL_LINE_SMOOTH

Persyaratan

Lihat juga

glBegin

glEnable

glEnd

glIsEnabled