Baca dalam bahasa Inggris

Bagikan melalui


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.

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:

xw = xrx?

yw = yry?

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
Gl.h
Pustaka
Opengl32.lib
DLL
Opengl32.dll

Lihat juga

glBegin

glDrawPixels

glEnd

glPixelStore

glPixelTransfer

glRasterPos