sprite_save 함수 설명 및 활용 예제

sprite_save 함수는 스프라이트의 서브 이미지를 디스크에 저장하는 데 사용됩니다. 이 함수는 지정된 파일 이름으로 이미지를 저장합니다. 주의할 점은 스프라이트가 런타임 중에 추가되어야 하며, IDE를 통해 추가된 스프라이트는 저장할 수 없다는 것입니다. 저장할 파일은 반드시 .png 확장자를 가져야 합니다.

문법

sprite_save(ind, subimg, fname);

인수 설명

반환값

• N/A

예제 코드

아래의 코드는 스프라이트를 생성하고, 이를 파일로 저장하는 과정을 보여줍니다.

var surf, spr_custom;
surf = surface_create(32, 32);
surface_set_target(surf);
draw_clear_alpha(c_black, 0);
draw_sprite(spr_Body, 0, 0, 0);
draw_sprite(spr_Clothes, 0, 0, 0);
draw_sprite(spr_Hair, 0, 0, 0);
spr_custom = sprite_create_from_surface(surf, 0, 0, 32, 32, true, true, 16, 16);
surface_reset_target();
surface_free(surf);
sprite_save(spr_custom, 0, "Player_Custom_Sprite.png");
sprite_delete(spr_custom);

코드 설명

1. 서피스 생성: surface_create(32, 32)를 사용하여 32x32 크기의 서피스를 생성합니다.
2. 서피스 타겟 설정: surface_set_target(surf)로 그리기 타겟을 서피스로 설정합니다.
3. 서피스 클리어: draw_clear_alpha(c_black, 0)로 서피스를 검은색으로 초기화합니다.
4. 스프라이트 그리기: 여러 스프라이트를 서피스에 겹쳐서 그립니다.
5. 스프라이트 생성: sprite_create_from_surface를 사용하여 서피스에서 새로운 스프라이트를 생성합니다.
6. 서피스 메모리 해제: surface_free(surf)로 서피스를 메모리에서 해제합니다.
7. 스프라이트 저장: sprite_save를 사용하여 생성한 스프라이트를 파일로 저장합니다.
8. 스프라이트 삭제: sprite_delete(spr_custom)로 메모리에서 스프라이트를 삭제합니다.

활용 예제

예제 1: 다양한 스프라이트 저장

여러 개의 스프라이트를 각각 다른 파일로 저장하는 방법입니다.

var surf1, surf2, spr_custom1, spr_custom2;
surf1 = surface_create(32, 32);
surface_set_target(surf1);
draw_clear_alpha(c_black, 0);
draw_sprite(spr_Body, 0, 0, 0);
spr_custom1 = sprite_create_from_surface(surf1, 0, 0, 32, 32, true, true, 16, 16);
surface_reset_target();
surface_free(surf1);
sprite_save(spr_custom1, 0, "Player_Body_Sprite.png");

surf2 = surface_create(32, 32);
surface_set_target(surf2);
draw_clear_alpha(c_black, 0);
draw_sprite(spr_Clothes, 0, 0, 0);
spr_custom2 = sprite_create_from_surface(surf2, 0, 0, 32, 32, true, true, 16, 16);
surface_reset_target();
surface_free(surf2);
sprite_save(spr_custom2, 0, "Player_Clothes_Sprite.png");

예제 2: 사용자 정의 스프라이트 만들기

사용자가 선택한 색상으로 스프라이트를 만들고 저장하는 방법입니다.

var surf, spr_custom;
surf = surface_create(32, 32);
surface_set_target(surf);
draw_clear_alpha(c_white, 0);
draw_set_color(c_red);
draw_rectangle(0, 0, 32, 32, false);
spr_custom = sprite_create_from_surface(surf, 0, 0, 32, 32, true, true, 16, 16);
surface_reset_target();
surface_free(surf);
sprite_save(spr_custom, 0, "Custom_Red_Sprite.png");

예제 3: 애니메이션 프레임 저장

애니메이션의 각 프레임을 개별 파일로 저장하는 방법입니다.

for (var i = 0; i < sprite_get_number(spr_Animation); i++) {
    var surf = surface_create(32, 32);
    surface_set_target(surf);
    draw_clear_alpha(c_black, 0);
    draw_sprite(spr_Animation, i, 0, 0);
    var spr_custom = sprite_create_from_surface(surf, 0, 0, 32, 32, true, true, 16, 16);
    surface_reset_target();
    surface_free(surf);
    sprite_save(spr_custom, 0, "Animation_Frame_" + string(i) + ".png");
    sprite_delete(spr_custom);
}