sprite_xoffset 설명서
sprite_xoffset는 인스턴스에 할당된 스프라이트의 로컬 x 오프셋을 반환하는 읽기 전용 변수입니다. 이 값은 스프라이트 편집기에서 정의된 원점의 x 구성 요소를 나타내며, 픽셀 단위로 반환됩니다. 이 x 오프셋은 image_xscale에 따라 달라지므로, 예를 들어 32x32 크기의 스프라이트가 원점이 16으로 정의되어 있을 때, 해당 스프라이트가 2배로 확대되면 이 변수는 32를 반환합니다. 비율이 적용되지 않은 x 오프셋이 필요할 경우 sprite_get_xoffset() 함수를 사용해야 합니다.
문법
sprite_xoffset;
반환값
- 실수형(Real)
활용 예제
아래의 예제는 스프라이트의 왼쪽 가장자리가 방의 경계를 넘어가는지 확인하고, 넘어간 경우 인스턴스를 이동시켜 스프라이트 전체가 보이도록 합니다.
if (x - sprite_xoffset < 0) {
x = sprite_xoffset;
}
추가 활용 예제
- 스프라이트 위치 조정
- 스프라이트의 위치를 조정하여 화면의 중앙에 배치할 수 있습니다.
gml x = room_width / 2 - sprite_xoffset; - 스프라이트 경계 체크
- 스프라이트가 방의 오른쪽 경계를 넘어가지 않도록 제한할 수 있습니다.
gml if (x + sprite_xoffset > room_width) { x = room_width - sprite_xoffset; } - 스프라이트 크기 조정에 따른 위치 조정
- 스프라이트의 크기가 변경될 때, 위치를 자동으로 조정할 수 있습니다.
gml x = some_target_x - sprite_xoffset; - 스프라이트 이동
- 스프라이트를 특정 방향으로 이동시키면서 경계를 체크할 수 있습니다.
gml x += speed; if (x - sprite_xoffset < 0) { x = sprite_xoffset; }
관련 변수
| 변수 이름 | 설명 |
|---|---|
| sprite_yoffset | 스프라이트의 y 오프셋을 반환합니다. |
| image_xscale | 스프라이트의 x 방향 스케일을 나타냅니다. |
| sprite_get_xoffset | 비율이 적용되지 않은 x 오프셋을 반환합니다. |