instance_position 함수 설명 및 활용 예제
함수 개요
instance_position 함수는 특정 위치에서 다른 인스턴스나 객체의 인스턴스와 충돌이 있는지 확인하는 데 사용됩니다. 이 함수는 방(room) 내의 단일 점에서 인스턴스나 타일 맵을 검사하며, 인스턴스의 경계 상자 또는 정확한 충돌이 체크된 경우 인스턴스의 마스크를 기준으로 충돌 여부를 판단합니다.
반환 값
함수는 충돌이 발생한 첫 번째 인스턴스 또는 타일 맵의 ID를 반환합니다. 만약 충돌이 없으면 noone을 반환합니다. 만약 충돌된 인스턴스의 ID가 필요하지 않다면, position_meeting() 함수를 사용하는 것이 더 좋습니다.
문법
instance_position(x, y, obj);
인수 설명
| 인수 | 타입 | 설명 |
|---|---|---|
| x | Real | 인스턴스를 확인할 x 위치 |
| y | Real | 인스턴스를 확인할 y 위치 |
| obj | Object Asset / Object Instance / Tile Map Element ID / Array | 객체, 인스턴스, 타일 맵 ID, 키워드(all/other), 또는 이러한 항목을 포함하는 배열 |
반환값
| 반환값 |
|---|
| Object Instance / Tile Map Element ID or noone |
예제 코드
아래 코드는 마우스 위치에서 obj_Pause_Button 인스턴스와의 충돌을 확인합니다. 만약 충돌이 발생하면, 해당 인스턴스의 image_index를 변경하고 새로운 obj_Menu 인스턴스를 생성합니다.
var inst;
inst = instance_position(mouse_x, mouse_y, obj_Pause_Button);
if (inst != noone) {
with (inst) image_index = 1;
instance_create_layer(room_width / 2, 0, "Controllers", obj_Menu);
}
활용 및 응용 예제
이 instance_position 함수는 다양한 상황에서 유용하게 사용될 수 있습니다. 아래는 몇 가지 응용 예입니다:
1. 적의 충돌 확인
게임에서 적이 플레이어와 충돌하는지 확인할 수 있습니다.
if (instance_position(player.x, player.y, obj_Enemy) != noone) {
// 플레이어가 적과 충돌했을 때의 처리
health -= 10;
}
2. 아이템 수집
플레이어가 특정 아이템과 접촉했는지 확인하고 아이템을 수집하는 코드입니다.
if (instance_position(player.x, player.y, obj_Item) != noone) {
// 아이템을 수집했을 때의 처리
score += 100;
instance_destroy(instance_position(player.x, player.y, obj_Item));
}
3. 타일 맵의 특정 타일 체크
특정 위치에서 타일 맵의 특정 벽 타일과 충돌하는지 확인하는 코드입니다.
var wall = instance_position(x, y, obj_Wall);
if (wall != noone) {
// 벽에 부딪혔을 때의 처리
x -= 5; // 플레이어를 밀어내기
}
이처럼 instance_position 함수는 다양한 게임 로직에서 인스턴스의 충돌을 감지하고 처리하는 데 매우 유용하게 활용됩니다.