D3DXGeneratePMesh 함수

프로그래시브 메쉬를 생성한다.

구문

HRESULT D3DXGeneratePMesh(      

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

파라미터

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

반환값

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

주의

이 함수는, LOD (Level of Detail)를 현재의 값으로부터 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

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

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