GPU 스텐실 실패 설정 함수
이 문서는 gpu_set_stencil_fail 함수에 대해 설명합니다. 이 함수는 스텐실 테스트가 실패했을 때 수행할 스텐실 작업을 설정합니다. 기본적으로 스텐실 테스트가 실패할 경우의 작업은 stencilop_keep입니다. 이 작업을 다음 중 하나로 설정할 수 있습니다.
문법
gpu_set_stencil_fail(stencil_op);
인수 설명
| 인수 이름 | 인수 타입 | 설명 |
|---|---|---|
| stencil_op | Stencil Op Constant | 스텐실 테스트가 실패한 픽셀에 대해 수행할 스텐실 작업을 나타내는 상수입니다. |
반환값
- N/A
예제
gpu_set_stencil_fail(stencilop_replace);
위 코드는 스텐실 테스트가 실패한 픽셀에 대해 스텐실 작업을 교체(replace)로 설정합니다. 이 작업은 현재 스텐실 버퍼의 값을 현재 설정된 스텐실 참조 값으로 교체합니다. 이 값은 이전에 gpu_set_stencil_ref로 설정되었습니다.
활용 예제
- 스텐실 테스트 실패 시 색상 변경
gpu_set_stencil_fail(stencilop_replace);
- 스텐실 테스트 실패 시 스텐실 값 증가
gpu_set_stencil_fail(stencilop_incr);
- 스텐실 테스트 실패 시 스텐실 값 감소
gpu_set_stencil_fail(stencilop_decr);
- 스텐실 테스트 실패 시 스텐실 값 유지
gpu_set_stencil_fail(stencilop_keep);
- 스텐실 테스트 실패 시 스텐실 값 비트 반전
gpu_set_stencil_fail(stencilop_invert);
이와 같이 gpu_set_stencil_fail 함수를 활용하여 다양한 스텐실 작업을 설정할 수 있습니다.