D3DXCreateSPMesh 함수

단순화 메쉬를 생성 한다.

구문

HRESULT D3DXCreateSPMesh(      

    LPD3DXMESH pMesh,
    CONST DWORD *pAdjacency,
    CONST LPD3DXATTRIBUTEWEIGHTS pVertexAttributeWeights,
    CONST FLOAT *pVertexWeights,
    LPD3DXSPMESH *ppSMesh
);

파라미터

pMesh
[in] ID3DXMesh 인터페이스의 포인터. 단순화 하는 메쉬를 나타낸다.
pAdjacency
[in] 1 면근처의 3 개의 DWORD 의 배열의 포인터. 생성 된 단순화 메쉬에 포함되는 각면의 3 개의 인접면을 지정한다.
pVertexAttributeWeights
[in] 각 정점의 성분에 대한 가중을 저장 하는 D3DXATTRIBUTEWEIGHTS 구조체의 포인터. 이 파라미터를 NULL 로 설정 하면, 디폴트의 구조체가 사용된다. 「주의」를 참조할것.
pVertexWeights
[in] 정점 가중의 배열의 포인터. 이 파라미터를 NULL 로 설정 하면, 모든 정점 가중은 1.0 으로 설정된다. 지정된 정점의 정점 가중이 큰 만큼, 단순화 하기 어려운 것에 주의한다.
ppSMesh
[out] 생성 된 단순화 메쉬를 나타내는 ID3DXSPMesh 인터페이스의 포인터 주소.

반환값

성공했을 경우는,D3D_OK 를 돌려준다.
실패했을 경우는, 다음의 몇개의 값을 돌려준다.
D3DXERR_CANNOTATTRSORT 최적화 테크닉으로서 속성의 소트 (D3DXMESHOPT_ATTRSORT)는 지원하지 않는다.
D3DERR_INVALIDCALL 메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.
E_OUTOFMEMORY Microsoft® Direct3D® 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.

주의

단순화 메쉬는, 메쉬를 단순화 해, 삼각형과 면의 수를 줄이기 위해서(때문에) 사용한다.
pVertexAttributeWeights 를 NULL 로 설정했을 경우, 다음에 나타내는 값이 디폴트의 D3DXATTRIBUTEWEIGHTS 구조체에 할당할 수 있다.
D3DXATTRIBUTEWEIGHTS AttributeWeights;

AttributeWeights.Position  = 1.0;
AttributeWeights.Boundary =  1.0;
AttributeWeights.Normal   =  1.0;
AttributeWeights.Diffuse  =  0.0;
AttributeWeights.Specular =  0.0;
AttributeWeights.Tex[8]   =  {0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0};
보통의 애플리케이션에서는, 이 디폴트의 구조체를 사용해야 한다. 이유는, 이 구조체가 지오메트리와 법선의 조정만을 목적으로 하고 있기 때문이다. 그 외의 멤버 필드를 수정할 필요가 있는 것은, 특별한 경우뿐이다.

함수의 정보

헤더 d3dx9mesh.h
임포트 라이브러리 d3dx9.lib
최저한의 operating system Windows 98

D3DXERR_CANNOTATTRSORT	최적화 테크닉으로서 속성의 소트 (D3DXMESHOPT_ATTRSORT)는 지원하지 않는다.
D3DERR_INVALIDCALL	메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.
E_OUTOFMEMORY	Microsoft® Direct3D® 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.

헤더	d3dx9mesh.h
임포트 라이브러리	d3dx9.lib
최저한의 operating system	Windows 98