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 インターフェイスへのポインター。

高さ [入力]

型: INT

論理単位での文字の高さ。

幅 [入力]

型: UINT

論理単位での文字の幅。

Weight [in]

型: UINT

書体の太さ。 1 つの例は太字です。

MipLevels [in]

型: UINT

ミップマップ レベルの数。

斜体 [入力]

種類: BOOL

斜体フォントの場合は True、それ以外の場合は false。

CharSet [in]

型: DWORD

フォントの文字セット。

OutputPrecision [in]

型: DWORD

Windows が目的のフォント サイズと特性を実際のフォントと照合する方法を指定します。 たとえば、OUT_TT_ONLY_PRECISを使用して、常に TrueType フォントを取得できるようにします。

品質 [入力]

型: 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 に解決されます。 それ以外の場合、ANSI 文字列が使用されているため、関数呼び出しは D3DXCreateFontA に解決されます。

フォント パラメーターの詳細については、「 論理フォント」を参照してください。

要件

要件	値
ヘッダー	D3dx9core.h
ライブラリ	D3dx9.lib

こちらもご覧ください

General Purpose関数