collision_rectangle_list 함수 설명

collision_rectangle_list 함수는 collision_rectangle() 함수와 유사하지만, 한 번에 여러 인스턴스나 타일 맵의 충돌을 감지할 수 있습니다. 이 함수를 사용하면 충돌을 확인할 사각형의 좌측 상단과 우측 하단의 x/y 좌표를 제공하고, 확인할 객체나 타일 맵을 지정할 수 있습니다. 또한, 충돌 검사를 정밀하게 수행할지 여부와 호출 인스턴스를 포함할지 여부를 설정할 수 있습니다.

충돌하는 인스턴스의 ID 값은 제공된 DS 리스트에 추가됩니다. 이 리스트는 함수 호출 전에 비워둘 수 있으며, 이 경우 함수 호출 결과만 포함됩니다. 또한, 인스턴스를 사각형 영역의 중심에서 원점까지의 거리 기준으로 정렬할 수 있는 옵션도 있습니다. 이 함수는 충돌이 발견된 인스턴스나 타일 맵의 수를 반환하며, 발견되지 않으면 0을 반환합니다.

문법

collision_rectangle_list(x1, y1, x2, y2, obj, prec, notme, list, ordered);

인수 설명

반환값

• Real: 충돌이 발견된 인스턴스나 타일 맵의 수

활용 예제

예제 1: 적 인스턴스와의 충돌 확인

var _list = ds_list_create();
var _num = collision_rectangle_list(x - 100, y - 100, x + 100, y + 100, obj_Enemy, false, true, _list, false);
if (_num > 0) {
    for (var i = 0; i < _num; ++i) {
||
||
    }
}
ds_list_destroy(_list);

이 코드는 호출 인스턴스 위치에서 100픽셀 떨어진 사각형 영역 내에서 "obj_Enemy" 인스턴스와의 충돌을 확인합니다. 충돌이 발견되면, 미리 생성된 리스트를 통해 충돌한 각 인스턴스를 파괴합니다.

예제 2: 충돌 인스턴스의 거리 정렬

var _list = ds_list_create();
var _num = collision_rectangle_list(x - 50, y - 50, x + 50, y + 50, obj_Enemy, true, false, _list, true);
if (_num > 0) {
    // 거리 정렬된 인스턴스 처리
}
ds_list_destroy(_list);

이 코드는 정밀 충돌 검사를 수행하고, 충돌한 인스턴스를 거리 기준으로 정렬하여 리스트에 저장합니다.

예제 3: 특정 객체 제외하고 충돌 확인

var _list = ds_list_create();
var _num = collision_rectangle_list(x - 200, y - 200, x + 200, y + 200, obj_Enemy, false, true, _list, false);
if (_num > 0) {
    // 충돌한 인스턴스 처리
}
ds_list_destroy(_list);

이 코드는 호출 인스턴스를 제외하고 "obj_Enemy"와의 충돌을 확인합니다.