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]
-
메시를 만든 디바이스에 대한 포인터입니다.
-
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]
-
문자 모양 메트릭 데이터를 포함하는 GLYPHMETRICSFLOAT 구조체의 배열에 대한 포인터입니다. 각 요소에는 문자열에 있는 해당 문자 모양의 위치 및 방향에 대한 정보가 포함됩니다. 배열의 요소 수는 문자열의 문자 수와 같아야 합니다. 각 구조체의 원점은 전체 문자열을 기준으로 하는 것이 아니라 해당 문자 셀을 기준으로 합니다. 전체 경계 상자를 계산하려면 문자열을 트래버스하는 동안 각 문자 모양에 대한 증분을 추가합니다. 문자 모양 크기에 관심이 없는 경우 이 매개 변수를 NULL로 설정합니다.
반환 값
형식: HRESULT
함수가 성공하면 반환 값이 D3D_OK. 함수가 실패하면 반환 값은 D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY 중 하나일 수 있습니다.
설명
컴파일러 설정은 함수 버전도 결정합니다. 유니코드가 정의되면 함수 호출이 D3DXCreateTextW로 확인됩니다. 그렇지 않으면 ANSI 문자열이 사용되므로 함수 호출이 D3DXCreateTextA로 확인됩니다.
이 함수는 D3DXMESH_MANAGED 만들기 옵션을 사용하여 메시를 만들고 | D3DFVF_XYZ. D3DFVF_NORMAL 유연한 꼭짓점 형식(FVF)입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|
추가 정보