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.

Nilai kembali

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), koordinat klip dengan nilai, jarak koordinat mata, bit yang valid, dan data warna terkait dan koordinat tekstur. 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, mereka tidak menghasilkan perubahan pada status OpenGL).

Fungsi berikut mengambil informasi yang terkait dengan glRasterPos:

glGet dengan argumen GL_CURRENT_RASTER_POSITION
glGet dengan GL_CURRENT_RASTER_POSITION_VALID argumen
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 [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

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex