GPU 스텐실 테스트 활성화 함수
이 문서는 GPU의 스텐실 테스트를 활성화하거나 비활성화하는 함수인 gpu_set_stencil_enable에 대해 설명합니다. 스텐실 테스트는 현재 그리기 명령에 영향을 받는 모든 픽셀에 대해 수행되는 테스트입니다. 이 테스트는 스텐실 버퍼의 해당 픽셀 값과 gpu_set_stencil_ref로 설정된 스텐실 참조 값을 비교합니다. 비교는 gpu_set_stencil_func에서 설정된 비교 방법을 사용합니다.
비교 결과에 따라 스텐실 테스트는 통과하거나 실패합니다. 통과할 경우 수행할 작업은 gpu_set_stencil_pass로 설정하고, 실패할 경우 수행할 작업은 gpu_set_stencil_fail로 설정합니다. 작업은 현재 스텐실 값을 유지(stencilop_keep, 기본값), 교체(stencilop_replace) 또는 수학적 연산을 적용하는 것(0으로 설정, 증가/감소, 비트 반전) 중 하나일 수 있습니다.
문법
gpu_set_stencil_enable(enable);
인수 설명
| 인수 | 유형 | 설명 |
|---|---|---|
| enable | Boolean | 후속 그리기 명령에 대해 스텐실 테스트를 활성화할지 여부 |
반환 값
N/A
활용 예제
- 스텐실 테스트 활성화
gpu_set_stencil_enable(true);
- 스텐실 테스트 비활성화
gpu_set_stencil_enable(false);
- 스텐실 테스트와 함께 사용하기
gpu_set_stencil_enable(true);
gpu_set_stencil_ref(1);
gpu_set_stencil_func(0, 1, 0);
gpu_set_stencil_pass(stencilop_replace);
gpu_set_stencil_fail(stencilop_keep);
- 스텐실 테스트 결과에 따른 다양한 작업
gpu_set_stencil_enable(true);
gpu_set_stencil_pass(stencilop_increment);
gpu_set_stencil_fail(stencilop_decrement);
- 스텐실 테스트와 비트 반전
gpu_set_stencil_enable(true);
gpu_set_stencil_pass(stencilop_invert);
이와 같이 gpu_set_stencil_enable 함수를 사용하여 스텐실 테스트를 제어할 수 있습니다. 다양한 인수와 함께 사용하여 원하는 그래픽 효과를 구현할 수 있습니다.