glRasterPos4iv (Fungsi glRasterPos4iv)
Menentukan posisi raster untuk operasi piksel.
Sintaks
void WINAPI glRasterPos4iv(
const GLint *v
);
Parameter
-
V
-
Penunjuk ke array empat elemen, menentukan koordinat x, y, z, dan w untuk posisi raster saat ini.
Mengembalikan nilai
Fungsi ini tidak mengembalikan nilai.
Keterangan
OpenGL mempertahankan posisi 3-D dalam koordinat jendela. Posisi ini, yang disebut posisi raster, dipertahankan dengan akurasi subpiksel. Ini digunakan untuk memposisikan operasi penulisan piksel dan bitmap. Lihat glBitmap, glDrawPixels, dan glCopyPixels.
Posisi raster saat ini terdiri dari tiga koordinat jendela (x, y, z), nilai koordinat klip w , jarak koordinat mata, bit yang valid, dan koordinat data dan tekstur warna terkait. Koordinat w adalah koordinat klip, karena w tidak diproyeksikan ke koordinat jendela. Fungsi glRasterPos4 menentukan koordinat objek x, y, z, dan w secara eksplisit. Fungsi glRasterPos3 menentukan koordinat objek x, y, dan z secara eksplisit, sementara w secara implisit diatur ke satu. Fungsi glRasterPos2 menggunakan nilai argumen untuk x dan y sambil secara implisit mengatur z dan w ke nol dan satu.
Koordinat objek yang disajikan oleh glRasterPos diperlakukan seperti perintah glVertex . Mereka diubah oleh matriks modelview dan proyeksi saat ini dan diteruskan ke tahap kliping. Jika puncak tidak dimusnahkan, maka diproyeksikan dan diskalakan ke koordinat jendela, yang menjadi posisi raster baru saat ini, dan bendera GL_CURRENT_RASTER_POSITION_VALID diatur. Jika puncak dimusnahkan, maka bit yang valid dibersihkan dan posisi raster saat ini dan koordinat warna dan tekstur terkait tidak terdefinisi.
Posisi raster saat ini juga mencakup beberapa data warna terkait dan koordinat tekstur. Jika pencahayaan diaktifkan, maka GL_CURRENT_RASTER_COLOR, dalam mode RGBA, atau GL_CURRENT_RASTER_INDEX, dalam mode indeks warna, diatur ke warna yang dihasilkan oleh perhitungan pencahayaan (lihat glLight, glLightModel, dan glShadeModel). Jika pencahayaan dinonaktifkan, warna saat ini (dalam mode RGBA, variabel status GL_CURRENT_COLOR) atau indeks warna (dalam mode indeks warna, variabel status GL_CURRENT_INDEX) digunakan untuk memperbarui warna raster saat ini.
Demikian juga, GL_CURRENT_RASTER_TEXTURE_COORDS diperbarui sebagai fungsi GL_CURRENT_TEXTURE_COORDS, berdasarkan matriks tekstur dan fungsi pembuatan tekstur (lihat glTexGen). Akhirnya, jarak dari asal sistem koordinat mata ke puncak, seperti yang diubah hanya oleh matriks modelview, menggantikan GL_CURRENT_RASTER_DISTANCE.
Awalnya, posisi raster saat ini adalah (0,0,0,1), jarak raster saat ini adalah 0, bit yang valid diatur, warna RGBA terkait adalah (1,1,1,1), indeks warna terkait adalah 1, dan koordinat tekstur terkait adalah (0, 0, 0, 1). Dalam mode RGBA, GL_CURRENT_RASTER_INDEX selalu 1; dalam mode indeks warna, warna RGBA raster saat ini selalu mempertahankan nilai awalnya.
Catatan
Posisi raster dimodifikasi baik oleh glRasterPos maupun oleh glBitmap.
Catatan
Ketika koordinat posisi raster tidak valid, perintah gambar yang didasarkan pada posisi raster diabaikan (artinya, koordinat tersebut tidak mengakibatkan perubahan pada status OpenGL).
Fungsi berikut mengambil informasi yang terkait dengan glRasterPos:
glGet dengan argumen GL_CURRENT_RASTER_POSITION
glGet dengan argumen GL_CURRENT_RASTER_POSITION_VALID
glGet dengan argumen GL_CURRENT_RASTER_DISTANCE
glGet dengan argumen GL_CURRENT_RASTER_COLOR
glGet dengan argumen GL_CURRENT_RASTER_INDEX
glGet dengan argumen GL_CURRENT_RASTER_TEXTURE_COORDS
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows 2000 Professional [khusus aplikasi desktop] |
| Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
| Header |
|
| Pustaka |
|
| DLL |
|