layer_sprite_speed 함수 설명
layer_sprite_speed 함수는 스프라이트 요소에 할당된 애니메이션 이미지의 속도를 설정하는 기능을 제공합니다. 이 함수는 스프라이트 요소 ID와 애니메이션 속도를 인자로 받습니다.
함수 사용법
구문
layer_sprite_speed(sprite_element_id, speed);
인자 설명
| 인자 이름 | 타입 | 설명 |
|---|---|---|
| sprite_element_id | Sprite Element ID | 변경할 스프라이트 요소의 고유 ID 값 |
| speed | Real | 요소에 사용할 속도 배수/값 |
반환값
- N/A (반환값 없음)
애니메이션 속도 설정
- Frames Per Game Frame: IDE가 스프라이트의 애니메이션 속도를 게임 프레임당 프레임으로 계산하도록 설정한 경우, 속도 값은 배수입니다. 기본값은 1이며, 0.5로 설정하면 애니메이션 속도가 절반으로 줄어들고, 2로 설정하면 두 배로 증가합니다.
- Frames Per Second: IDE가 스프라이트의 애니메이션 속도를 초당 프레임으로 계산하도록 설정한 경우, 속도 값은 실제 초당 프레임 수입니다. 예를 들어, 5로 설정하면 게임이 실행되는 동안 초당 5프레임이 재생됩니다.
- 스프라이트에 서브 이미지가 없으면 이 함수는 효과가 없습니다.
활용 예제
예제 1: 애니메이션 속도 절반으로 줄이기
var _lay_id = layer_get_id("Assets_water");
var _spr_id = layer_sprite_get_id(_lay_id, "gfc_water");
layer_sprite_speed(_spr_id, 0.5);
위 코드는 "Assets_water"라는 레이어의 핸들을 가져온 후, 해당 레이어에서 주어진 스프라이트 요소의 ID를 사용하여 이미지 속도를 절반으로 줄입니다.
예제 2: 애니메이션 속도 두 배로 증가시키기
var _lay_id = layer_get_id("Assets_character");
var _spr_id = layer_sprite_get_id(_lay_id, "gfc_character");
layer_sprite_speed(_spr_id, 2);
이 코드는 "Assets_character" 레이어의 스프라이트 속도를 두 배로 증가시킵니다.
예제 3: 초당 5프레임으로 설정하기
var _lay_id = layer_get_id("Assets_enemy");
var _spr_id = layer_sprite_get_id(_lay_id, "gfc_enemy");
layer_sprite_speed(_spr_id, 5);
위 코드는 "Assets_enemy" 레이어의 스프라이트를 초당 5프레임으로 설정합니다.
예제 4: 애니메이션 속도 변경 후 확인하기
var _lay_id = layer_get_id("Assets_background");
var _spr_id = layer_sprite_get_id(_lay_id, "gfc_background");
layer_sprite_speed(_spr_id, 1); // 기본 속도로 설정
이 코드는 "Assets_background" 레이어의 스프라이트 속도를 기본 속도로 설정합니다.