다음을 통해 공유


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에서 원하는 글꼴 크기 및 특성을 실제 글꼴과 일치시키려고 시도하는 방법을 지정합니다. instance OUT_TT_ONLY_PRECIS 사용하여 항상 TrueType 글꼴을 가져올 수 있습니다.

품질 [in]

형식: DWORD

Windows에서 원하는 글꼴과 실제 글꼴을 일치시킬 방법을 지정합니다. 래스터 글꼴에만 적용되며 TrueType 글꼴에는 영향을 미치지 않습니다.

PitchAndFamily [in]

형식: DWORD

피치 및 패밀리 인덱스입니다.

pFacename [in]

형식: LPCTSTR

서체 이름을 포함하는 문자열입니다. 컴파일러 설정에 유니코드가 필요한 경우 데이터 형식 LPCTSTR이 LPCWSTR로 확인됩니다. 그렇지 않으면 문자열 데이터 형식이 LPCSTR로 확인됩니다. 설명 부분을 참조하세요.

ppFont [out]

형식: LPD3DXFONT*

생성된 글꼴 개체를 나타내는 ID3DXFont 인터페이스에 대한 포인터를 반환합니다.

반환 값

형식: HRESULT

함수가 성공하면 반환 값이 S_OK. 함수가 실패하면 반환 값은 D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY 중 하나일 수 있습니다.

설명

ID3DXFont 개체를 만들려면 디바이스에서 32비트 색을 지원해야 합니다.

컴파일러 설정은 함수 버전도 결정합니다. 유니코드가 정의되면 함수 호출이 D3DXCreateFontW로 확인됩니다. 그렇지 않으면 ANSI 문자열이 사용되므로 함수 호출이 D3DXCreateFontA로 확인됩니다.

글꼴 매개 변수에 대한 자세한 내용은 논리 글꼴을 참조하세요.

요구 사항

요구 사항
헤더
D3dx9core.h
라이브러리
D3dx9.lib

추가 정보

범용 함수