Fungsi D3DX10CreateFont

Membuat objek font untuk perangkat dan font.

Catatan

Alih-alih menggunakan fungsi ini, kami sarankan Anda menggunakan DirectWrite dan pustaka DirectXTK, kelas SpriteFont.

 

Sintaks

HRESULT D3DX10CreateFont(
  _In_  ID3D10Device *pDevice,
  _In_  INT          Height,
  _In_  UINT         Width,
  _In_  UINT         Weight,
  _In_  UINT         MipLevels,
  _In_  BOOL         Italic,
  _In_  UINT         CharSet,
  _In_  UINT         OutputPrecision,
  _In_  UINT         Quality,
  _In_  UINT         PitchAndFamily,
  _In_  LPCTSTR      pFaceName,
  _Out_ LPD3DX10FONT *ppFont
);

Parameter

pDevice [in]

Jenis: ID3D10Device*

Penunjuk ke antarmuka ID3D10Device, perangkat yang akan dikaitkan dengan objek font.

Tinggi [in]

Jenis: INT

Tinggi karakter dalam unit logis.

Lebar [in]

Jenis: UINT

Lebar karakter dalam unit logis.

Berat [in]

Jenis: UINT

Bobot typeface. Salah satu contohnya adalah tebal.

MipLevels [in]

Jenis: UINT

Jumlah tingkat mipmap.

Miring [in]

Jenis: BOOL

Benar untuk font miring, salah jika tidak.

CharSet [in]

Jenis: UINT

Kumpulan karakter font.

OutputPrecision [in]

Jenis: UINT

Menentukan bagaimana Windows harus mencoba mencocokkan ukuran dan karakteristik font yang diinginkan dengan font aktual. Gunakan OUT_TT_ONLY_PRECIS misalnya, untuk memastikan bahwa Anda selalu mendapatkan font TrueType.

Kualitas [in]

Jenis: UINT

Menentukan bagaimana Windows harus cocok dengan font yang diinginkan dengan font nyata. Ini hanya berlaku untuk font raster dan tidak boleh memengaruhi font TrueType.

PitchAndFamily [in]

Jenis: UINT

Indeks pitch dan keluarga.

pFaceName [in]

Jenis: LPCTSTR

String yang berisi nama typeface. Jika pengaturan pengkompilasi memerlukan Unicode, jenis data LPCTSTR diselesaikan ke LPCWSTR. Jika tidak, jenis data diselesaikan ke LPCSTR. Lihat Keterangan.

ppFont [out]

Jenis: LPD3DX10FONT*

Mengembalikan penunjuk ke antarmuka ID3DX10Font, yang mewakili objek font yang dibuat.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi berhasil, nilai yang dikembalikan adalah S_OK. Jika fungsi gagal, nilai yang dikembalikan bisa menjadi salah satu dari yang berikut: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Keterangan

Pengaturan pengkompilasi juga menentukan versi fungsi. Jika Unicode ditentukan, panggilan fungsi diselesaikan ke D3DXCreateFontW. Jika tidak, panggilan fungsi menyelesaikan ke D3DXCreateFontA karena string ANSI sedang digunakan.

Jika Anda ingin informasi selengkapnya tentang parameter font, lihat Font Logis.

Persyaratan

Persyaratan	Nilai
Header	D3DX10Core.h
Pustaka	D3DX10.lib

Lihat juga

Fungsi Tujuan Umum