D3DXCreateText 함수

디바이스 컨텍스트와 연결된 글꼴을 사용하여 지정된 텍스트가 포함된 메시를 만듭니다.

구문

HRESULT D3DXCreateText(
  _In_  LPDIRECT3DDEVICE9   pDevice,
  _In_  HDC                 hDC,
  _In_  LPCTSTR             pText,
  _In_  FLOAT               Deviation,
  _In_  FLOAT               Extrusion,
  _Out_ LPD3DXMESH          *ppMesh,
  _Out_ LPD3DXBUFFER        *ppAdjacency,
  _Out_ LPGLYPHMETRICSFLOAT pGlyphMetrics
);

매개 변수

pDevice [in]

형식: LPDIRECT3DDEVICE9

메시를 만든 디바이스에 대한 포인터입니다.

hDC [in]

형식: HDC

출력에 대한 글꼴을 포함하는 디바이스 컨텍스트입니다. 디바이스 컨텍스트에서 선택한 글꼴은 TrueType 글꼴이어야 합니다.

pText [in]

형식: LPCTSTR

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

편차 [in]

형식: FLOAT

TrueType 글꼴 윤곽선의 최대 코드 편차입니다.

압출 [in]

형식: FLOAT

음의 z 방향에서 텍스트를 돌출할 크기입니다.

ppMesh [out]

형식: LPD3DXMESH*

반환된 메시에 대한 포인터입니다.

ppAdjacency [out]

형식: LPD3DXBUFFER*

인접 정보를 포함하는 버퍼에 대한 포인터입니다. NULL일 수 있습니다.

pGlyphMetrics [out]

형식: LPGLYPHMETRICSFLOAT

문자 모양 메트릭 데이터를 포함하는 GLYPHMETRICSFLOAT 구조체의 배열에 대한 포인터입니다. 각 요소에는 문자열에 있는 해당 문자 모양의 위치 및 방향에 대한 정보가 포함됩니다. 배열의 요소 수는 문자열의 문자 수와 같아야 합니다. 각 구조체의 원점은 전체 문자열을 기준으로 하는 것이 아니라 해당 문자 셀을 기준으로 합니다. 전체 경계 상자를 계산하려면 문자열을 트래버스하는 동안 각 문자 모양에 대한 증분을 추가합니다. 문자 모양 크기에 관심이 없는 경우 이 매개 변수를 NULL로 설정합니다.

반환 값

형식: HRESULT

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

설명

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

이 함수는 D3DXMESH_MANAGED 만들기 옵션을 사용하여 메시를 만들고 | D3DFVF_XYZ. D3DFVF_NORMAL 유연한 꼭짓점 형식(FVF)입니다.

요구 사항

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

추가 정보

도형 그리기 함수