fungsi glBitmap
Fungsi glBitmap menggambar bitmap.
Sintaks
void WINAPI glBitmap(
GLSizei width,
GLSizei height,
GLfloat xorig,
GLfloat yorig,
GLfloat xmove,
GLfloat ymove,
const GLubyte *bitmap
);
Parameter
-
width
-
Lebar piksel gambar bitmap.
-
height
-
Tinggi piksel gambar bitmap.
-
xorig
-
Lokasi x asal dalam gambar bitmap. Asal diukur dari sudut kiri bawah bitmap, dengan arah kanan dan atas menjadi sumbu positif.
-
yorig
-
Lokasi y asal dalam gambar bitmap. Asal diukur dari sudut kiri bawah bitmap, dengan arah kanan dan atas menjadi sumbu positif.
-
xmove
-
Offset x yang akan ditambahkan ke posisi raster saat ini setelah bitmap digambar.
-
ymove
-
Offset y yang akan ditambahkan ke posisi raster saat ini setelah bitmap digambar.
-
Bitmap
-
Alamat gambar bitmap.
Mengembalikan nilai
Fungsi ini tidak mengembalikan nilai.
Kode kesalahan
Kode kesalahan berikut dapat diambil oleh fungsi glGetError .
| Nama | Makna |
|---|---|
|
lebar atau tinggi negatif. |
|
Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd. |
Keterangan
Bitmap adalah gambar biner. Ketika digambar, bitmap diposisikan relatif terhadap posisi raster saat ini, dan piksel framebuffer yang sesuai dengan 1 di bitmap ditulis menggunakan warna atau indeks raster saat ini. Piksel buffer bingkai yang sesuai dengan nol dalam bitmap tidak dimodifikasi.
Gambar bitmap ditafsirkan seperti data gambar untuk fungsi glDrawPixels , dengan lebar dan tinggi yang sesuai dengan argumen lebar dan tinggi fungsi tersebut, dan dengan jenis diatur ke GL_BITMAP dan format diatur ke GL_COLOR_INDEX. Mode yang Anda tentukan menggunakan glPixelStore memengaruhi interpretasi data gambar bitmap; mode yang Anda tentukan menggunakan glPixelTransfer tidak.
Jika posisi raster saat ini tidak valid, glBitmap diabaikan. Jika tidak, sudut kiri bawah gambar bitmap diposisikan pada koordinat jendela berikut:
xwxrx = ?
ywyry = ?
Dalam koordinat ini, (xr , yr ) adalah posisi raster, dan (x? , y? ) adalah asal bitmap. Fragmen kemudian dihasilkan untuk setiap piksel yang sesuai dengan 1 dalam gambar bitmap. Fragmen ini dihasilkan menggunakan koordinat z raster saat ini, indeks warna atau warna, dan koordinat tekstur raster saat ini. Mereka kemudian diperlakukan seolah-olah telah dihasilkan oleh titik, garis, atau poligon, termasuk pemetaan tekstur, fogging, dan semua operasi per fragmen seperti pengujian alfa dan kedalaman.
Setelah bitmap digambar, koordinat x dan y dari posisi raster saat ini diimbangi oleh xmove dan ymove. Tidak ada perubahan yang dilakukan pada koordinat z dari posisi raster saat ini, atau ke koordinat warna raster, indeks, atau tekstur saat ini.
Fungsi berikut mengambil informasi yang terkait dengan fungsi glBitmap :
glGet dengan argumen GL_CURRENT_RASTER_POSITION
glGet dengan argumen GL_CURRENT_RASTER_COLOR
glGet dengan argumen GL_CURRENT_RASTER_INDEX
glGet dengan argumen GL_CURRENT_RASTER_TEXTURE_COORDS
glGet dengan GL_CURRENT_RASTER_POSITION_VALID argumen
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 |
|