fungsi glPointSize
Fungsi glPointSize menentukan diameter titik raster.
Sintaks
void WINAPI glPointSize(
GLfloat size
);
Parameter
-
ukuran
-
Diameter titik rasterisasi. Defaultnya adalah 1.0.
Nilai kembali
Fungsi ini tidak mengembalikan nilai.
Kode kesalahan
Kode kesalahan berikut dapat diambil oleh fungsi glGetError .
| Nama | Makna |
|---|---|
|
ukurannya kurang dari atau sama dengan nol. |
|
Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd. |
Keterangan
Fungsi glPointSize menentukan diameter raster dari titik alias dan antialisi. Menggunakan ukuran titik selain 1.0 memiliki efek yang berbeda, tergantung pada apakah antialias titik diaktifkan. Antialias titik dikendalikan dengan memanggil glEnable dan glDisable dengan argumen GL_POINT_SMOOTH.
Jika antialias titik dinonaktifkan, ukuran aktual ditentukan dengan membulatkan ukuran yang disediakan ke bilangan bulat terdekat. (Jika pembulatan menghasilkan nilai 0, itu seolah-olah ukuran titik adalah 1.) Jika ukuran bulat ganjil, maka titik tengah (x,y) dari fragmen piksel yang mewakili titik dihitung sebagai
(xw + .5, yw + .5)
di mana w subskrip menunjukkan koordinat jendela. Semua piksel yang terletak di dalam kisi persegi dengan ukuran bulat yang berpusat pada (x,y) membentuk fragmen. Jika ukurannya genap, titik tengah adalah
(xw + .5, yw + .5)
dan pusat fragmen rasterisasi adalah koordinat jendela setengah bilangan bulat dalam persegi dengan ukuran bulat yang berpusat pada (x,y). Semua fragmen piksel yang dihasilkan dalam mem-rasterisasi titik nonantialias diberi data terkait yang sama; puncak yang sesuai dengan titik tersebut.
Jika antialias diaktifkan, maka rasterisasi titik menghasilkan fragmen untuk setiap persegi piksel yang berpotongan wilayah yang terletak di dalam lingkaran yang diameternya sama dengan ukuran titik saat ini dan berpusat pada titik (xw , yw ). Nilai cakupan untuk setiap fragmen adalah area koordinat jendela persimpangan wilayah melingkar dengan persegi piksel yang sesuai. Nilai ini disimpan dan digunakan dalam langkah rasterisasi akhir. Data yang terkait dengan setiap fragmen adalah data yang terkait dengan titik yang dirasterisasi.
Tidak semua ukuran didukung ketika antialisis titik diaktifkan. Jika ukuran yang tidak didukung diminta, ukuran terdekat yang didukung akan digunakan. Hanya ukuran 1.0 yang dijamin didukung; yang lain tergantung pada implementasinya. Rentang ukuran yang didukung dan perbedaan ukuran antara ukuran yang didukung dalam rentang dapat dikueri dengan memanggil glGet dengan argumen GL_POINT_SIZE_RANGE dan GL_POINT_SIZE_GRANULARITY.
Ukuran titik yang ditentukan oleh glPointSize selalu dikembalikan saat GL_POINT_SIZE dikueri. Penjepitan dan pembulatan untuk titik alias dan antialisi tidak berpengaruh pada nilai yang ditentukan.
Ukuran titik yang tidak diantisipasi dapat dijepit ke maksimum yang bergantung pada implementasi. Meskipun maksimum ini tidak dapat dikueri, nilai maksimumnya harus tidak kurang dari nilai maksimum untuk titik yang diantisipasi, dibulatkan ke nilai bilangan bulat terdekat.
Fungsi berikut mengambil informasi yang terkait dengan glPointSize:
glGet dengan argumen GL_POINT_SIZE
glGet dengan argumen GL_POINT_SIZE_RANGE
glGet dengan argumen GL_POINT_SIZE_GRANULARITY
glIsEnabled dengan argumen GL_POINT_SMOOTH
Persyaratan
| 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 |
|