D3DXCreateFont-Funktion
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 |
|
| Bibliothek |
|
Weitere Informationen