IDirect3DDevice9::GetClipPlane 메서드(d3d9helper.h)

디바이스에 대한 사용자 정의 클리핑 평면의 계수를 검색합니다.

구문

HRESULT GetClipPlane(
  [in]  DWORD Index,
  [out] float *pPlane
);

매개 변수

[in] Index

형식: DWORD

평면 수식 계수가 검색되는 클리핑 평면의 인덱스입니다.

[out] pPlane

형식: float*

일반 평면 수식의 형태로 클리핑 평면의 계수를 나타내는 값의 4개 요소 배열에 대한 포인터입니다. 설명 부분을 참조하세요.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값이 D3DERR_INVALIDCALL. 이 오류는 Index의 값이 디바이스에서 지원하는 최대 클리핑 평면 인덱스를 초과하거나 pPlane의 배열이 4개의 부동 소수점 값을 포함할 만큼 크지 않음을 나타냅니다.

설명

이 메서드는 D3DCREATE_PUREDEVICE 사용하여 만든 디바이스의 디바이스 상태를 반환하지 않습니다. 이 방법을 사용하려면 D3DCREATE의 다른 값을 사용하여 디바이스를 만들어야 합니다."

이 메서드가 보고하는 계수는 일반 평면 수식의 형태를 취합니다. pPlane의 배열에 있는 값이 배열에 표시되는 순서대로 A, B, C 및 D라는 레이블이 지정된 경우 Ax + By + Cz + Dw = 0이 되도록 일반 평면 수식에 맞습니다. Ax + By + Cz + Dw >= 0인 경우 동종 좌표(x, y, z, w)가 있는 점이 평면의 절반 공간에 표시됩니다. 클리핑 평면의 또는 뒤에 있는 점이 장면에서 잘립니다.

이 메서드에서 사용하는 평면 수식은 월드 공간에 존재하며 IDirect3DDevice9::SetClipPlane 메서드에 대한 이전 호출에 의해 설정됩니다.

요구 사항

   
대상 플랫폼 Windows
헤더 d3d9helper.h(D3D9.h 포함)
라이브러리 D3D9.lib

추가 정보

IDirect3DDevice9

IDirect3DDevice9::SetClipPlane