fungsi glBitmap

Artikel
06/13/2023

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.

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_VALUE	lebar atau tinggi negatif.
GL_INVALID_OPERATION	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 1s dalam 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:

x_w = x_rx?

y_w = y_ry?

Dalam koordinat ini, (x_r , y_r ) 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	Gl.h
Pustaka	Opengl32.lib
DLL	Opengl32.dll

Lihat juga

glBegin
glDrawPixels
glEnd
glPixelStore
glPixelTransfer
glRasterPos