layer_sprite_get_xscale 함수 설명
layer_sprite_get_xscale 함수는 스프라이트 요소의 x축에 대한 현재 스케일 배율을 가져오는 데 사용됩니다. 이 함수는 스프라이트 요소 ID를 인자로 받아, 해당 스프라이트의 x 스케일 값을 반환합니다. 반환되는 값은 실수형이며, 1은 스케일이 없음을 의미합니다.
문법
layer_sprite_get_xscale(sprite_element_id);
인자 설명
| 인자 이름 | 타입 | 설명 |
|---|---|---|
| sprite_element_id | Sprite Element ID | 정보를 가져올 스프라이트 요소의 고유 ID 값 |
반환 값
- 실수형 값 (x 스케일)
예제 코드
아래 코드는 "sprite_sky"라는 이름의 레이어에 대한 레이어 핸들을 가져온 후, 해당 레이어의 스프라이트 요소 ID를 얻습니다. 그 ID를 사용하여 x 스케일 값을 확인하고, 만약 값이 1이 아니라면 1로 설정합니다.
var lay_id = layer_get_id("sprite_sky");
var spr_id = layer_sprite_get_id(lay_id, "Clouds");
if (layer_sprite_get_xscale(spr_id) != 1) {
layer_sprite_xscale(spr_id, 1);
}
활용 예제
예제 1: 스프라이트 크기 조정
스프라이트의 x 스케일을 2로 설정하는 코드입니다.
var spr_id = layer_sprite_get_id(layer_get_id("sprite_sky"), "Clouds");
layer_sprite_xscale(spr_id, 2);
예제 2: 스프라이트가 특정 크기인지 확인
스프라이트의 x 스케일이 0.5인지 확인하고, 그렇다면 1로 변경하는 코드입니다.
var spr_id = layer_sprite_get_id(layer_get_id("sprite_sky"), "Clouds");
if (layer_sprite_get_xscale(spr_id) == 0.5) {
layer_sprite_xscale(spr_id, 1);
}
예제 3: 모든 스프라이트의 x 스케일을 초기화
특정 레이어의 모든 스프라이트의 x 스케일을 1로 초기화하는 코드입니다.
var lay_id = layer_get_id("sprite_sky");
var sprite_count = layer_sprite_count(lay_id);
for (var i = 0; i < sprite_count; i++) {
var spr_id = layer_sprite_get_id(lay_id, i);
layer_sprite_xscale(spr_id, 1);
}
이와 같은 방법으로 layer_sprite_get_xscale 함수를 활용하여 스프라이트의 x 스케일을 관리할 수 있습니다.