D3DX10CreateFont 函式
建立裝置和字型的字型物件。
注意
建議您不要使用此函式，而是建議您使用DirectWrite和DirectXTK程式庫SpriteFont類別。
語法
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
);
參數
-
pDevice [in]
-
類型： ID3D10Device*
ID3D10Device 介面的指標，裝置要與字型物件相關聯。
-
高度 [in]
-
類型： INT
邏輯單元中字元的高度。
-
寬度 [in]
-
類型： UINT
邏輯單元中字元的寬度。
-
權數 [in]
-
類型： UINT
字樣粗細。 其中一個範例是粗體。
-
MipLevels [in]
-
類型： UINT
mipmap 層級的數目。
-
斜體 [in]
-
類型： BOOL
若為斜體字型，則為 True，否則為 false。
-
CharSet [in]
-
類型： UINT
字型的字元集。
-
OutputPrecision [in]
-
類型： UINT
指定 Windows 應該如何嘗試比對所需的字型大小和特性與實際字型。 例如，使用 OUT_TT_ONLY_PRECIS，以確保您一律會取得 TrueType 字型。
-
品質 [in]
-
類型： UINT
指定 Windows 應該如何比對所需的字型與實際字型。 它僅適用于點陣字型，且不應影響 TrueType 字型。
-
PitchAndFamily [in]
-
類型： UINT
音調和系列索引。
-
pFaceName [in]
-
類型： LPCTSTR
包含字樣名稱的字串。 如果編譯器設定需要 Unicode，則資料類型 LPCTSTR 會解析為 LPCWSTR。 否則，資料類型會解析為 LPCSTR。 請參閱＜備註＞。
-
ppFont [out]
-
類型： LPD3DX10FONT*
傳回 ID3DX10Font 介面的指標，代表建立的字型物件。
傳回值
類型： HRESULT
如果函式成功，傳回值會S_OK。 如果函式失敗，傳回值可以是下列其中一項：D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA E_OUTOFMEMORY。
備註
編譯器設定也會決定函式版本。 如果已定義 Unicode，函式呼叫會解析為 D3DXCreateFontW。 否則，函式呼叫會解析為 D3DXCreateFontA，因為正在使用 ANSI 字串。
如果您想要有關字型參數的詳細資訊，請參閱 邏輯字型。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱