D3DXCreateFont-Funktion

  • Artikel

Erstellt ein Schriftartobjekt für ein Gerät und eine Schriftart.

Syntax

HRESULT D3DXCreateFont(
  _In_  LPDIRECT3DDEVICE9 pDevice,
  _In_  INT               Height,
  _In_  UINT              Width,
  _In_  UINT              Weight,
  _In_  UINT              MipLevels,
  _In_  BOOL              Italic,
  _In_  DWORD             CharSet,
  _In_  DWORD             OutputPrecision,
  _In_  DWORD             Quality,
  _In_  DWORD             PitchAndFamily,
  _In_  LPCTSTR           pFacename,
  _Out_ LPD3DXFONT        *ppFont
);

Parameter

pDevice [in]

Typ: LPDIRECT3DDEVICE9

Zeiger auf eine IDirect3DDevice9-Schnittstelle , das Gerät, das dem Schriftartobjekt zugeordnet werden soll.

Höhe [in]

Typ: INT

Die Höhe der Zeichen in logischen Einheiten.

Breite [in]

Typ: UINT

Die Breite der Zeichen in logischen Einheiten.

Gewicht [in]

Typ: UINT

Schriftzeichengewichtung. Ein Beispiel ist Fett.

MipLevels [in]

Typ: UINT

Die Anzahl der mipmap-Ebenen.

Kursiv [in]

Typ: BOOL

True für kursiv geschriebene Schriftart, andernfalls false.

CharSet [in]

Typ: DWORD

Der Zeichensatz der Schriftart.

OutputPrecision [in]

Typ: DWORD

Gibt an, wie Windows versuchen soll, die gewünschten Schriftgrößen und Merkmale mit tatsächlichen Schriftarten abzugleichen. Verwenden Sie OUT_TT_ONLY_PRECIS für instance, um sicherzustellen, dass Sie immer eine TrueType-Schriftart erhalten.

Qualität [in]

Typ: DWORD

Gibt an, wie Windows die gewünschte Schriftart mit einer echten Schriftart abgleichen soll. Sie gilt nur für Rasterschriftarten und sollte sich nicht auf TrueType-Schriftarten auswirken.

PitchAndFamily [in]

Typ: DWORD

Pitch- und Familienindex.

pFacename [in]

Typ: LPCTSTR

Zeichenfolge, die den Namen der Schriftart enthält. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der Zeichenfolgendatentyp in LPCSTR aufgelöst. Siehe Hinweise.

ppFont [out]

Typ: LPD3DXFONT*

Gibt einen Zeiger auf eine ID3DXFont-Schnittstelle zurück, die das erstellte Schriftartobjekt darstellt.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Bemerkungen

Die Erstellung eines ID3DXFont-Objekts erfordert, dass das Gerät 32-Bit-Farben unterstützt.

Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXCreateFontW aufgelöst. Andernfalls wird der Funktionsaufruf in D3DXCreateFontA aufgelöst, da ANSI-Zeichenfolgen verwendet werden.

Weitere Informationen zu Schriftartparametern finden Sie unter Die logische Schriftart.

Anforderungen

Anforderung Wert
Header
D3dx9core.h
Bibliothek
D3dx9.lib

Weitere Informationen

Universell-Funktionen