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.

Sintaksis

BOOL wglUseFontBitmapsA(
  HDC   unnamedParam1,
  DWORD unnamedParam2,
  DWORD unnamedParam3,
  DWORD unnamedParam4
);

Parameter

unnamedParam1

Menentukan konteks perangkat yang fontnya dipilih saat ini 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 jumlah daftar tampilan, satu untuk setiap glyph dalam eksekusi.

unnamedParam4

Menentukan daftar tampilan awal.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian TRUE.

Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

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 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	Arti
lebar	Lebar bitmap glyph, seperti yang dikembalikan dalam gmBlackBoxX anggota GLYPHMETRICS GLYPHMETRICS struktur.
tinggi	Tinggi bitmap glyph, seperti yang dikembalikan dalam gmBlackBoxY anggota GLYPHMETRICS glyphmetrics.
xorig	Offset x dari asal glyph, seperti yang dikembalikan dalam gmptGlyphOrigin.x anggota GLYPHMETRICS struktur glyph.
yorig	Offset y dari asal glyph, seperti yang dikembalikan dalam gmptGlyphOrigin.y anggota GLYPH GLYPHMETRICS struktur.
xmove	Jarak horizontal ke asal sel karakter berikutnya, seperti yang dikembalikan dalam gmCellIncX anggota glyph GLYPHMETRICS struktur.
	Jarak vertikal ke asal sel karakter berikutnya seperti yang dikembalikan dalam gmCellIncY anggota GLYPHMETRICS GLYPHMETRICS struktur.
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");

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	wingdi.h
Pustaka	Opengl32.lib
DLL	Opengl32.dll

Lihat juga

GLYPHMETRICS

GetGlyphOutline

OpenGL di Windows

Fungsi WGL

glBitmap

glCallLists

glListBase

wglUseFontOutlines