IDirect3DDevice9::SetClipPlane 메서드(d3d9.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)가 있는 점이 평면의 절반 공간에 표시됩니다. 클리핑 평면 뒤에 있는 점이 장면에서 잘립니다.
고정 함수 파이프라인을 사용하는 경우 평면 수식은 월드 공간에 있는 것으로 간주됩니다. 프로그래밍 가능한 파이프라인을 사용하는 경우 평면 수식은 클리핑 공간(출력 꼭짓점과 동일한 공간)에 있는 것으로 간주됩니다.
이 메서드는 설정되는 클리핑 평면 수식을 사용하도록 설정하지 않습니다. 클리핑 평면을 사용하도록 설정하려면 DWORD 값의 해당 비트를 D3DRS_CLIPPLANEENABLE 렌더링 상태로 설정합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | d3d9.h(D3D9.h 포함) |
| 라이브러리 | D3D9.lib |