fungsi wglUseFontBitmapsA (wingdi.h)

Artikel
03/08/2023

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