D3DXSimplifyMesh 함수

지정한 MinValue 로 할 수 있을 뿐(만큼) 가까운 중량감을 사용해 메쉬를 단순화 한다.

구문

HRESULT D3DXSimplifyMesh(      

    LPD3DXMESH pMesh,
    CONST DWORD *pAdjacency,
    CONST LPD3DXATTRIBUTEWEIGHTS pVertexAttributeWeights,
    CONST FLOAT *pVertexWeights,
    DWORD MinValue,
    DWORD Options,
    LPD3DXMESH *ppMesh
);

파라미터

pMesh
[in] ID3DXMesh 인터페이스의 포인터. 소스 메쉬를 나타낸다.
pAdjacency
[in] 1 면근처의 3 개의 DWORD 의 배열의 포인터. 단순화 하는 메쉬에 포함되는 각면의 3 개의 인접면을 지정한다.
pVertexAttributeWeights
[in] 각 정점의 성분에 대한 중량감을 저장 하는 D3DXATTRIBUTEWEIGHTS 구조체의 포인터. 이 파라미터를 NULL 로 설정 하면, 디폴트의 구조체가 사용된다. 「주의」를 참조할것.
pVertexWeights
[in] 정점의 중량감의 배열의 포인터. 이 파라미터를 NULL 로 설정 하면, 모든 정점의 중량감은 1.0 으로 설정된다.
MinValue
[in] Options 파라미터로 설정되어 있는 플래그에 응해 소스 메쉬를 단순화 할 경우에 사용하는 정점 또는 면의 수.
Options
[in] 메쉬에 대해서 단순화 옵션을 지정한다. D3DXSimplifyMesh 의 몇개의 플래그를 설정할 수 있다.
ppMesh
[out] 돌려주어진 단순화 메쉬를 나타내는,ID3DXMesh 인터페이스의 포인터 주소.

반환값

성공했을 경우는,D3D_OK 를 돌려준다.
실패했을 경우는, 다음의 몇개의 값을 돌려준다.
D3DERR_INVALIDCALL 메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.
D3DXERR_INVALIDDATA 데이터가 무효이다.
E_OUTOFMEMORY Microsoft® Direct3D® 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.

주의

이 함수는,MinValue 개의 정점 또는 면을 가지는 메쉬를 생성한다.
단순화 프로세스에 의해 메쉬를 MinValue 까지 단순화 할 수 없어도, 이 호출은 성공한 것이 된다. 이것은,MinValue 가 절대적인 최소 값은 아니고, 희망의 최소 값이니까이다.
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

D3DERR_INVALIDCALL	메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.
D3DXERR_INVALIDDATA	데이터가 무효이다.
E_OUTOFMEMORY	Microsoft® Direct3D® 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.

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