fungsi wglUseFontBitmapsA (wingdi.h)
Fungsi wglUseFontBitmaps membuat sekumpulan daftar tampilan bitmap untuk digunakan dalam konteks penyajian OpenGL saat ini. Kumpulan daftar tampilan bitmap didasarkan pada glyph dalam font yang saat ini dipilih dalam konteks perangkat. Anda kemudian dapat menggunakan bitmap untuk menggambar karakter dalam gambar OpenGL.
Fungsi wglUseFontBitmaps membuat daftar tampilan jumlah , satu untuk setiap eksekusi hitungan glyph yang dimulai dengan glyph pertama dalam font yang dipilih parameter hdc .
Sintaks
BOOL wglUseFontBitmapsA(
HDC unnamedParam1,
DWORD unnamedParam2,
DWORD unnamedParam3,
DWORD unnamedParam4
);
Parameter
unnamedParam1
Menentukan konteks perangkat yang fontnya saat ini dipilih akan digunakan untuk membentuk daftar tampilan bitmap glyph dalam konteks penyajian OpenGL saat ini.
unnamedParam2
Menentukan glyph pertama dalam eksekusi glyph yang akan digunakan untuk membentuk daftar tampilan bitmap glyph.
unnamedParam3
Menentukan jumlah glyph dalam eksekusi glyph yang akan digunakan untuk membentuk daftar tampilan bitmap glyph. Fungsi ini membuat daftar tampilan hitungan , satu untuk setiap glyph dalam eksekusi.
unnamedParam4
Menentukan daftar tampilan awal.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.
Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Fungsi wglUseFontBitmaps menentukan daftar tampilan jumlah dalam konteks penyajian OpenGL saat ini. Setiap daftar tampilan memiliki nomor identifikasi, dimulai dari listBase. Setiap daftar tampilan terdiri dari satu panggilan ke glBitmap. Definisi bitmap listBase + i diambil dari glyph pertama + i dari font yang saat ini dipilih dalam konteks perangkat yang ditentukan oleh hdc. Jika glyph tidak ditentukan, maka fungsi menentukan daftar tampilan kosong untuk itu.
Fungsi wglUseFontBitmaps membuat teks bitmap di bidang layar. Ini memungkinkan pelabelan objek di OpenGL.
Dalam versi implementasi OpenGL Microsoft saat ini, Anda tidak dapat melakukan panggilan GDI ke konteks perangkat yang memiliki format piksel buffer ganda. Oleh karena itu, Anda tidak dapat menggunakan font GDI dan fungsi teks dengan konteks perangkat tersebut. Anda dapat menggunakan fungsi wglUseFontBitmaps untuk menghindari batasan ini dan menggambar teks dalam konteks perangkat buffer ganda.
Fungsi menentukan parameter setiap panggilan ke glBitmap sebagai berikut.
| Parameter glBitmap | Makna |
|---|---|
| width | Lebar bitmap glyph, seperti yang dikembalikan dalam anggota gmBlackBoxX dari struktur GLYPHMETRICS glyph . |
| height | Tinggi bitmap glyph, seperti yang dikembalikan di anggota gmBlackBoxY dari struktur GLYPHMETRICS glyph . |
| xorig | Offset x dari asal glyph, seperti yang dikembalikan dalam anggota gmptGlyphOrigin.x dari struktur GLYPHMETRICS glyph . |
| yorig | Offset y dari asal glyph, seperti yang dikembalikan dalam anggota gmptGlyphOrigin.y dari struktur GLYPHMETRICS glyph . |
| xmove | Jarak horizontal ke asal sel karakter berikutnya, seperti yang dikembalikan dalam anggota gmCellIncX dari struktur GLYPHMETRICS glyph . |
| ymove | Jarak vertikal ke asal sel karakter berikutnya seperti yang dikembalikan dalam anggota gmCellIncY dari struktur GLYPHMETRICS glyph . |
| Bitmap | Bitmap untuk glyph, seperti yang dikembalikan oleh GetGlyphOutline dengan uFormat sama dengan 1. |
Contoh
Contoh kode berikut menunjukkan cara menggunakan wglUseFontBitmaps untuk menggambar beberapa teks.
HDC hdc;
HGLRC hglrc;
// create a rendering context
hglrc = wglCreateContext (hdc);
// make it the calling thread's current rendering context
wglMakeCurrent (hdc, hglrc);
// now we can call OpenGL API
// make the system font the device context's selected font
SelectObject (hdc, GetStockObject (SYSTEM_FONT));
// create the bitmap display lists
// we're making images of glyphs 0 thru 254
// the display list numbering starts at 1000, an arbitrary choice
wglUseFontBitmaps (hdc, 0, 255, 1000);
// display a string:
// indicate start of glyph display lists
glListBase (1000);
// now draw the characters in a string
glCallLists (24, GL_UNSIGNED_BYTE, "Hello Windows OpenGL World");
Catatan
Header wingdi.h mendefinisikan wglUseFontBitmaps sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | wingdi.h |
| Pustaka | Opengl32.lib |
| DLL | Opengl32.dll |