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

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

구문

HRESULT SetClipPlane(
  [in] DWORD       Index,
  [in] const float *pPlane
);

매개 변수

[in] Index

형식: DWORD

평면 수식 계수를 설정할 클리핑 평면의 인덱스입니다.

[in] pPlane

형식: const float*

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

반환 값

형식: HRESULT

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

설명

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

고정 함수 파이프라인을 사용하는 경우 평면 수식은 월드 공간에 있는 것으로 간주됩니다. 프로그래밍 가능한 파이프라인을 사용하는 경우 평면 수식은 클리핑 공간(출력 꼭짓점과 동일한 공간)에 있는 것으로 간주됩니다.

이 메서드는 클리핑 평면 수식을 설정할 수 없습니다. 클리핑 평면을 사용하도록 설정하려면 D3DRS_CLIPPLANEENABLE 렌더링 상태에 적용된 DWORD 값에서 해당 비트를 설정합니다.

요구 사항

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

추가 정보

IDirect3DDevice9

IDirect3DDevice9::GetClipPlane