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
GL_INVALID_VALUE	ukurannya kurang dari atau sama dengan nol.
GL_INVALID_OPERATION	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

(x_w + .5, y_w + .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

(x_w + .5, y_w + .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 (x_w , y_w ). 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	Gl.h
Pustaka	Opengl32.lib
DLL	Opengl32.dll

Lihat juga

glBegin

glEnable

glEnd

glIsEnabled