DirectX Graphics 레퍼런스 Direct3D extension (D3DX) C/C++ 레퍼런스 함수 형상 드로잉(Drawing) 함수 D3DXCreateTorus [목차열람] [주소복사] [슬롯비우기]
|
DirectX Graphics 레퍼런스 Direct3D extension (D3DX) C/C++ 레퍼런스 함수 형상 드로잉(Drawing) 함수 D3DXCreateTorus [목차열람] [주소복사] [슬롯비우기]
|
| Microsoft DirectX 9.0 |
왼손 좌표 시스템을 사용해, 원환체의 메쉬를 생성 한다.
구문
HRESULT D3DXCreateTorus(
LPDIRECT3DDEVICE9 pDevice, FLOAT InnerRadius, FLOAT OuterRadius, UINT Sides, UINT Rings, LPD3DXMESH *ppMesh, LPD3DXBUFFER *ppAdjacency );
파라미터
- pDevice
- [in] IDirect3DDevice9 인터페이스의 포인터. 생성 되는 원환체 메쉬에 관련지을 수 있는 장치를 나타낸다.
- InnerRadius
- [in] 원환체의 내부의 반경. 값은 0.0f 이상일 필요가 있다.
- OuterRadius
- [in] 원환체의 외부의 반경. 값은 0.0f 이상일 필요가 있다.
- Sides
- [in] 횡단면의 옆의 수. 값은 3 이상일 필요가 있다.
- Rings
- [in] 원환체를 구성하는 환의 수. 값은 3 이상일 필요가 있다.
- ppMesh
- [out] 출력 형상인 ID3DXMesh 인터페이스의 포인터 주소.
- ppAdjacency
- [out] ID3DXBuffer 인터페이스의 포인터 주소. 메서드가 돌아가면 이 파라미터에는, 메쉬에 포함되는 각면의 3 개의 인접면을 지정하는, 1 면근처의 3 개의 DWORD 의 배열이 입력된다. NULL 를 지정할 수 있다.
반환값
성공했을 경우는,D3D_OK 를 돌려준다.
실패했을 경우는, 다음의 몇개의 값을 돌려준다.
D3DERR_INVALIDCALL 메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다. D3DXERR_INVALIDDATA 데이터가 무효이다. E_OUTOFMEMORY Microsoft® Direct3D® 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.
주의
D3DXCreateTorus 함수는, 중심이 (0, 0, 0)로 축이 z 축방향의 도너츠형의 도형 (원환체)을 드로잉(Drawing) 한다. 이 원환체의 내부의 반경은 횡단면의 반경 (작은 (분)편의 반경)에서, 외부의 반경은 중앙의 구멍의 반경이다.
이 함수는, 다음에 애플리케이션에 의해 드로잉(Drawing) 하거나 조작할 경우에 사용할 수 있는 메쉬를 돌려준다.
함수의 정보
헤더 d3dx9shape.h 임포트 라이브러리 d3dx9.lib 최저한의 operating system Windows 98