뷰 포트 변수 가져오기 (Get View Variable)
이 문서에서는 주어진 뷰 포트와 관련된 내장 변수를 가져오는 방법에 대해 설명합니다. 뷰 포트란 화면에서 특정 카메라 뷰를 그릴 때 사용되는 영역입니다. 이 문서에서는 사용 가능한 변수와 그 설명을 제공하며, 다양한 활용 예제도 포함합니다.
변수 목록
다음은 뷰 포트에서 가져올 수 있는 변수입니다:
| 변수명 | 설명 |
|---|---|
| Camera | 포트에 할당된 카메라의 고유 ID 값이 반환됩니다. (자세한 내용은 여기를 참조하세요.) |
| Visibility | 뷰 포트가 화면에 표시되고 있는지 여부를 나타냅니다. (true: 표시됨, false: 표시되지 않음) |
| View Port X Coordinate | 게임 창 내에서 뷰 포트의 X 좌표입니다. |
| View Port Y Coordinate | 게임 창 내에서 뷰 포트의 Y 좌표입니다. |
| View Port Width | 뷰 포트의 너비(픽셀 단위)입니다. |
| View Port Height | 뷰 포트의 높이(픽셀 단위)입니다. |
| View Port Surface ID | 뷰 포트에 할당된 서피스의 고유 ID 값입니다. 할당되지 않으면 -1이 반환됩니다. |
사용 예제
기본 구문
아래는 기본 구문입니다:
GetViewVariable(variable, view, target);
여기서 인자는 다음과 같습니다:
- variable: 가져올 내장 뷰 변수
- view: 대상을 지정할 뷰 포트 (0 - 7)
- target: 반환된 값을 저장할 변수 (임시 지역 변수로 플래그를 지정할 수 있음)
예제 1: 카메라 ID 가져오기
다음은 현재 뷰 포트 0에 할당된 카메라 ID를 가져와 글로벌 변수와 비교하는 예제입니다:
var currentCameraID;
GetViewVariable(Camera, 0, currentCameraID);
if (currentCameraID != global.storedCameraID) {
// 새로운 카메라로 설정
global.storedCameraID = currentCameraID;
}
이 코드 블록은 현재 뷰 포트 [0]에 할당된 카메라 ID를 가져와 글로벌 변수와 비교한 다음, 다르면 새로운 카메라로 설정합니다.
예제 2: 뷰 포트 가시성 확인
뷰 포트가 화면에 표시되는지 확인하는 예제는 다음과 같습니다:
var isVisible;
GetViewVariable(Visibility, 0, isVisible);
if (isVisible) {
// 뷰 포트가 보이는 경우 수행할 작업
} else {
// 뷰 포트가 보이지 않는 경우 수행할 작업
}
이 코드는 뷰 포트 0의 가시성을 확인하고, 보이는 경우와 보이지 않는 경우에 따라 다른 작업을 수행합니다.
결론
이 문서는 뷰 포트에서 변수를 가져오는 방법과 이를 활용하는 예제를 다루었습니다. 각 변수의 의미를 이해하고 활용함으로써 게임 개발에 도움이 될 수 있습니다. 추가적인 질문이나 더 많은 예제가 필요하다면 언제든지 문의해 주세요!