DirectX Graphics 레퍼런스 Direct3D extension (D3DX) C/C++ 레퍼런스 함수 형상 드로잉(Drawing) 함수 D3DXCreateText [목차열람] [주소복사] [슬롯비우기]
|
DirectX Graphics 레퍼런스 Direct3D extension (D3DX) C/C++ 레퍼런스 함수 형상 드로잉(Drawing) 함수 D3DXCreateText [목차열람] [주소복사] [슬롯비우기]
|
| Microsoft DirectX 9.0 |
장치 문맥에 관련지을 수 있는 폰트를 사용해, 지정한 텍스트를 포함한 메쉬를 생성 한다.
구문
HRESULT D3DXCreateText(
LPDIRECT3DDEVICE9 pDevice, HDC hDC, LPCTSTR pText, FLOAT Deviation, FLOAT Extrusion, LPD3DXMESH *ppMesh, LPD3DXBUFFER *ppAdjacency, LPGLYPHMETRICSFLOAT pGlyphMetrics );
파라미터
- pDevice
- [in] 메쉬를 생성 한 장치의 포인터.
- hDC
- [in] 출력용의 폰트를 저장 하고 있는 장치의 문맥. 장치의 문맥에 의해 선택되는 폰트는, TrueType 폰트가 아니면 안된다.
- pText
- [in] 생성하는 텍스트를 지정하는 캐릭터 라인의 포인터. 컴파일러의 설정이 Unicode 를 요구하고 있는 경우, 데이터 타입 LPCTSTR 는 LPCWSTR 가 된다. 그 이외의 경우는, 이 캐릭터 라인의 데이터 타입은 LPCSTR 가 된다. 「주의」를 참조할것.
- Deviation
- [in] TrueType 폰트 아우트라인으로부터의 최대 코드 편차.
- Extrusion
- [in] z 축의 부의 방향으로 밀어 내지는 텍스트의 양.
- ppMesh
- [out] 돌려주어진 메쉬의 포인터.
- ppAdjacency
- [out] 인접 천성보를 포함한 버퍼의 포인터.
- pGlyphMetrics
- [out] 그리후메트릭크데이타를 포함한 LPGLYPHMETRICSFLOAT 구조체의 배열의 포인터. 각 요소는, 캐릭터 라인내의 대응하는 그리후의 위치와 향해에 관한 정보를 포함하고 있다. 배열내의 요소의 수는, 캐릭터 라인의 문자수로 동일해야 한다. 각 구조 체내의 시점은, 캐릭터 라인 전체에 대해서 상대적은 아니고, 그 문자 셀에 대해서 상대적이다. 경계 박스 전체의 연산을 실시하려면 , 캐릭터 라인을 암벽 횡단 하는 각 그리후 마다 증분을 추가한다. 그리후사이즈를 고려할 필요가 없는 경우는, 이 파라미터를 NULL 로 설정한다.
반환값
성공했을 경우는,D3D_OK 를 돌려준다.
실패했을 경우는, 다음의 몇개의 값을 돌려준다.
D3DERR_INVALIDCALL 메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다. D3DXERR_INVALIDDATA 데이터가 무효이다. E_OUTOFMEMORY Microsoft® Direct3D® 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.
주의
컴파일러의 설정에 의해 함수의 버전도 정해진다. Unicode 가 정의되고 있는 경우, 이 함수의 호출은 D3DXCreateTextW 가 된다. 그 이외의 경우는 ANSI 캐릭터 라인을 사용하므로, 이 함수의 호출은 D3DXCreateTextA 가 된다.
LPGLYPHMETRICSFLOAT 구조체의 더 자세한 정보는, Microsoft Platform Software Development Kit (SDK)를 참조할것.
함수의 정보
헤더 d3dx9shape.h 임포트 라이브러리 d3dx9.lib 최저한의 operating system Windows 98