surface_depth_disable 함수 설명 및 활용 예제
함수 설명
surface_depth_disable 함수는 모든 표면에 대해 자동 깊이 및 스텐실 버퍼 생성을 비활성화(true)하거나 다시 활성화(false)하는 기능을 제공합니다. 기본적으로 깊이 및 스텐실 버퍼는 활성화되어 있으며, 이는 surface_create를 사용하여 수동으로 생성한 표면과 application_surface에 적용됩니다. 이 함수를 사용하려면 표면을 생성하기 전에 호출해야 하며, 필요에 따라 나중에 다시 활성화할 수 있습니다.
이 설정이 비활성화된 상태에서 생성된 모든 표면은 깊이 버퍼가 생성되지 않으며, 그로 인해 그려질 때 깊이를 사용할 수 없습니다. 이는 표면에 그려지는 것들이 깊이의 동등성을 가지게 됩니다.
예시 이미지 설명
위의 이미지에서는 3D에서 정점 버퍼를 사용하여 사각형과 삼각형을 그립니다. 빨간 삼각형의 좌표는 녹색 사각형 뒤에 위치하지만, 삼각형을 그리는 코드는 사각형을 그리는 코드 이후에 호출됩니다. 깊이 버퍼가 활성화된 상태에서는 3D 깊이가 존중되기 때문에 삼각형은 여전히 사각형 뒤에 그려집니다. 그러나 표면의 깊이 버퍼를 비활성화하면 코드 순서만 존중되므로 삼각형이 사각형 위에 그려집니다.
메모리 사용
깊이 버퍼를 할당하면 표면에 필요한 메모리 양이 사실상 두 배가 됩니다. 이는 게임이 메모리를 많이 사용하는 경우 과도하고 불필요한 오버헤드가 될 수 있습니다. 3D에서 표면에 그릴 때 깊이를 제대로 유지하려면 깊이 버퍼를 활성화하는 것 외에도 z-쓰기 및 z-테스트를 활성화해야 합니다. 관련 함수인 gpu_set_zwriteenable 및 gpu_set_ztestenable을 참조하세요.
게임이 100% 2D이거나 깊이 버퍼가 필요하지 않다고 확신하는 경우, 게임 시작 시 이 함수를 한 번 호출하여 버퍼를 비활성화하는 것이 좋습니다.
함수 문법
surface_depth_disable(disable);
인수 설명
| 인수 이름 | 타입 | 설명 |
|---|---|---|
| disable | Boolean | true로 설정하면 새로 생성된 표면에 대해 깊이 버퍼가 비활성화됩니다. |
반환 값
- N/A
활용 예제
다음은 surface_depth_disable 함수를 활용한 코드 예제입니다.
var _depth_setting = surface_get_depth_disable();
surface_depth_disable(false);
surface_with_depth_and_stencil = surface_create(room_width, room_height);
surface_depth_disable(true);
surface_without_depth_and_stencil = surface_create(room_width, room_height);
surface_depth_disable(_depth_setting);
위 코드는 현재 깊이 버퍼 설정을 변수에 저장한 후, 깊이 버퍼가 활성화된 표면과 비활성화된 표면 두 개를 생성하고, 원래 설정을 다시 복원합니다.