D3DXCreateFont 函式

建立裝置和字型的字型物件。

語法

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
);

參數

pDevice [in]

類型： LPDIRECT3DDEVICE9

IDirect3DDevice9介面的指標，要與字型物件建立關聯的裝置。

高度 [in]

類型： INT

邏輯單元中字元的高度。

寬度 [in]

類型： UINT

邏輯單元中字元的寬度。

權數 [in]

類型： UINT

字樣粗細。 其中一個範例是粗體。

MipLevels [in]

類型： UINT

mipmap 層級的數目。

斜體 [in]

類型： BOOL

若為斜體字型，則為 True，否則為 false。

CharSet [in]

類型： DWORD

字型的字元集。

OutputPrecision [in]

類型： DWORD

指定 Windows 應該如何嘗試比對所需的字型大小和特性與實際字型。 例如，使用 OUT_TT_ONLY_PRECIS，以確保您一律會取得 TrueType 字型。

品質 [in]

類型： DWORD

指定 Windows 應該如何比對所需的字型與實際字型。 它僅適用于點陣字型，且不應影響 TrueType 字型。

PitchAndFamily [in]

類型： DWORD

音調和系列索引。

pFacename [in]

類型： LPCTSTR

包含字樣名稱的字串。 如果編譯器設定需要 Unicode，則資料類型 LPCTSTR 會解析為 LPCWSTR。 否則，字串資料類型會解析為 LPCSTR。 請參閱＜備註＞。

ppFont [out]

類型： LPD3DXFONT*

傳回 ID3DXFont 介面的指標，代表建立的字型物件。

傳回值

類型： HRESULT

如果函式成功，傳回值會S_OK。 如果函式失敗，傳回值可以是下列其中一項：D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA E_OUTOFMEMORY。

備註

建立 ID3DXFont 物件需要裝置支援 32 位色彩。

編譯器設定也會決定函式版本。 如果已定義 Unicode，函式呼叫會解析為 D3DXCreateFontW。 否則，函式呼叫會解析為 D3DXCreateFontA，因為正在使用 ANSI 字串。

如果您想要有關字型參數的詳細資訊，請參閱 邏輯字型。

規格需求

另請參閱

常規用途函式