sprite_create_from_surface 함수 설명
sprite_create_from_surface 함수는 이전에 초기화된 서피스에서 스프라이트를 생성하는 데 사용됩니다. 서피스를 생성할 때 surface_create() 함수를 사용하면 서피스 핸들이 반환됩니다. 이 함수에 입력하는 x 및 y 좌표는 서피스의 (0,0) 위치(왼쪽 상단 모서리)에 상대적이어야 하며, 게임 창이나 활성 뷰에 상대적이지 않습니다. 너비와 높이 인자는 픽셀 단위로 서피스에서 사용할 부분의 너비와 높이를 정의합니다.
removeback이 활성화되면 소스 서피스의 알파 채널이 무시되고, GameMaker는 서피스의 왼쪽 하단 픽셀 색상을 "배경 색상"으로 선택합니다. 이 색상과 일치하는 모든 픽셀은 투명하게 처리되고, 다른 모든 픽셀은 불투명하게 유지됩니다. 대부분의 경우 이 기능을 사용할 필요가 없으며, 기본값인 false로 유지할 수 있습니다. removeback 인자를 활성화하면 smooth 인자를 true로 설정하여 스프라이트의 가장자리를 부드럽게 할 수 있습니다. 이는 배경이 제거된 후 스프라이트의 가장자리에 반투명 경계를 생성합니다.
또한 스프라이트의 x 및 y 원점을 지정할 수 있습니다. 원점은 스프라이트가 사용하는 인스턴스에 "고정"되는 지점이며, 항상 하나의 스프라이트 서브 이미지의 (0,0) 왼쪽 상단 모서리에 상대적으로 계산됩니다. 예를 들어, 32 x 32 픽셀 크기의 스프라이트가 (16,16)으로 설정되면 원점은 중앙에 위치하게 됩니다.
기본적으로 모든 새로운 스프라이트는 자동으로 경계 상자가 계산됩니다(정확한 bbox는 스프라이트의 크기와 투명도에 따라 달라짐). 그러나 이를 사용자 정의하고 싶다면 sprite_collision_mask() 함수를 사용해야 합니다.
주의: GameMaker에서 이 방법으로 스프라이트를 생성할 때는 더 이상 필요하지 않을 경우 반드시 sprite_delete()로 제거해야 합니다. 그렇지 않으면 메모리 누수의 위험이 있으며, 이는 게임을 느리게 하거나 결국 충돌을 일으킬 수 있습니다.문법
sprite_create_from_surface(index, x, y, w, h, removeback, smooth, xorig, yorig);
| 인자 | 타입 | 설명 |
|---|---|---|
| index | Surface | 생성할 서피스의 핸들입니다. |
| x | Real | 복사할 x 위치입니다. |
| y | Real | 복사할 y 위치입니다. |
| w | Real | 복사할 영역의 너비입니다 (x 위치에서부터). 0보다 커야 합니다. |
| h | Real | 복사할 영역의 높이입니다 (y 위치에서부터). 0보다 커야 합니다. |
| removeback | Boolean | 배경 색상(왼쪽 하단 픽셀)과 일치하는 모든 픽셀을 투명하게 할지 여부입니다. |
| smooth | Boolean | 가장자리를 부드럽게 할지 여부입니다. |
| xorig | Real | 스프라이트의 원점 x 위치입니다. |
| yorig | Real | 스프라이트의 원점 y 위치입니다. |
반환값
- 스프라이트 자산
예제 코드
var surf;
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, false, false, 16, 16);
surface_reset_target();
surface_free(surf);
위 코드는 서피스를 생성하고 그 인덱스를 지역 변수 "surf"에 저장합니다. 그런 다음 해당 서피스를 대상으로 설정하고, 이를 지우고 여러 스프라이트를 겹쳐서 그립니다. 마지막으로 서피스에 그려진 복합 이미지를 기반으로 새로운 스프라이트를 생성하고 그 인덱스를 "spr_Custom"에 할당한 후 서피스에서 사용된 메모리를 해제합니다.