instance_find 함수에 대한 설명

instance_find 함수는 게임 내에서 각 인스턴스를 구별할 수 있는 고유 식별자(ID)를 이용해 인스턴스를 수정하고 조작할 수 있도록 돕는 유용한 함수입니다. 특정 인스턴스의 ID를 몰라도 이 함수를 사용하면 모든 인스턴스를 반복하며 원하는 인스턴스를 찾을 수 있습니다.

함수의 사용법

이 함수는 찾고자 하는 객체와 특정 숫자를 인자로 받습니다. 만약 인스턴스 목록에서 해당 위치에 인스턴스가 존재하면 그 인스턴스의 ID를 반환하고, 존재하지 않으면 특별 키워드 noone을 반환합니다.

주요 기능

• keywordall: 현재 방의 모든 인스턴스를 반복합니다.
• 부모 객체를 지정하여 해당 부모/자식 계층에 포함된 모든 인스턴스를 반복할 수 있습니다.
• 특정 인스턴스(ID)를 체크하여 현재 방에 존재하는지 확인할 수 있습니다.

주의: 인스턴스는 임의의 방식으로 정렬되어 있으므로, 이 함수가 체크하는 인스턴스의 순서는 특정되지 않습니다.

함수 구문

instance_find(obj, n);

인자 설명

반환값

• 인스턴스 ID 또는 noone

예제

아래의 코드는 obj_Enemy 객체의 모든 인스턴스를 반복하며, 그 ID를 배열 enemy[]에 저장하는 예제입니다.

for (var i = 0; i < instance_number(obj_Enemy); ++i) {
    enemy[i] = instance_find(obj_Enemy, i);
}

이 코드는 for 루프를 사용하여 obj_Enemy의 모든 인스턴스를 탐색하고, 각 인스턴스의 ID를 배열에 저장합니다.

활용 및 응용 예제

1. 모든 적 인스턴스의 위치 출력

for (var i = 0; i < instance_number(obj_Enemy); ++i) {
    var enemyInstance = instance_find(obj_Enemy, i);
    var posX = enemyInstance.x;
    var posY = enemyInstance.y;
    show_message("Enemy ID: " + string(enemyInstance.id) + " 위치: (" + string(posX) + ", " + string(posY) + ")");
}

이 예제는 모든 적 인스턴스의 ID 및 위치를 출력합니다.

2. 특정 인스턴스 삭제하기

for (var i = 0; i < instance_number(obj_Enemy); ++i) {
    var enemyInstance = instance_find(obj_Enemy, i);
    if (enemyInstance.hp <= 0) {
        instance_destroy(enemyInstance);
    }
}

위 코드는 HP가 0 이하인 모든 적 인스턴스를 삭제합니다.

3. 인스턴스의 상태 확인 및 업데이트

for (var i = 0; i < instance_number(obj_PowerUp); ++i) {
    var powerUpInstance = instance_find(obj_PowerUp, i);
    powerUpInstance.active = true;  // 모든 파워업 인스턴스를 활성화 상태로 설정
}

모든 파워업 인스턴스를 활성화 상태로 업데이트하는 예제입니다.

이와 같이 instance_find 함수를 활용하여 여러 상황에서 인스턴스를 쉽게 관리할 수 있습니다.