`instance_place_list` 함수 설명

이 문서에서는 instance_place_list 함수에 대해 설명하고, 이 함수를 사용하는 방법과 여러 응용 예제를 포함합니다.

함수 개요

instance_place_list 함수는 코드가 실행되는 인스턴스의 충돌 마스크를 사용하여 특정 위치에서 객체(또는 타일 맵)의 모든 인스턴스와의 충돌을 확인할 수 있습니다. 이 함수를 사용하면 GameMaker에 물체를 새로운 위치로 이동시키고 충돌을 확인한 후 다시 원래 자리로 되돌아가 충돌을 발견한 인스턴스를 알려주도록 요청하게 됩니다. 정밀 충돌 검사 기능이 있으며, 두 인스턴스 모두에 정밀 충돌 마스크가 선택되어 있어야 작동합니다. 그렇지 않을 경우 경계 상자 충돌만 적용됩니다.

충돌하는 모든 인스턴스의 ID값이 포함된 데이터 구조(DS) 리스트를 제공하면, 해당 리스트의 끝에 추가됩니다. 목록을 호출하기 전에 지울 수 있어 결과가 이 호출의 결과만 포함되도록 할 수 있습니다. 또한, 충돌된 인스턴스와 호출 중인 인스턴스의 원점 간 거리 기준으로 목록을 정렬할지를 선택할 수 있습니다.

함수는 발견된 인스턴스 수를 반환하며, 충돌이 없는 경우 0을 반환합니다.

구문

instance_place_list(x, y, obj, list, ordered);

인자 설명

반환 값

• Real: 충돌이 발생한 인스턴스/타일 맵의 수. 충돌이 없으면 0을 반환.

사용 예제

아래의 코드 예제는 호출 인스턴스의 위치에서 충돌을 확인하고, 충돌한 인스턴스를 DS 리스트에 추가한 후 이를 파괴합니다.

var _list = ds_list_create(); // DS 리스트 생성
var _num = instance_place_list(x, y, obj_Enemy, _list, false); // 충돌 확인

if (_num > 0) { // 충돌이 발견되었는지 확인
    for (var i = 0; i < _num; ++i) { // 발견된 인스턴스를 반복
||
||
    }
}
ds_list_destroy(_list); // 생성한 DS 리스트 삭제

위 코드는 호출 인스턴스 위치에서 발견된 모든 충돌 인스턴스를 확인하고, 이를 DS 리스트에 추가하고, 리스트에서 각 인스턴스를 파괴합니다.

활용 및 응용 예제

1. 충돌 체크 후 점수 증가

아래 예제에서는 특정 객체와 충돌했을 때 점수를 증가시키는 방식입니다.

var _list = ds_list_create();
var _num = instance_place_list(x, y, obj_Coin, _list, false);

if (_num > 0) {
    score += _num; // 충돌한 동전 수 만큼 점수 증가
    for (var i = 0; i < _num; ++i) {
||
||
    }
}
ds_list_destroy(_list);

2. 특정 객체와 충돌 시 게임 오버

다음 예제는 플레이어가 적과 충돌했을 때 게임 오버를 처리하는 것입니다.

var _list = ds_list_create();
var _num = instance_place_list(x, y, obj_Enemy, _list, false);

if (_num > 0) {
    game_over(); // 게임 오버 함수 호출
}
ds_list_destroy(_list);

다양한 경우에 따라 이 instance_place_list 함수를 활용하여 게임 로직을 구현할 수 있습니다. 필요한 요구사항에 맞게 코드를 수정하여 활용해보세요!

© Copyright YoYo Games Ltd. 2023 All Rights Reserved