남은 반복 횟수 가져오기 (Get Reps Remaining)

이 문서는 지정된 **시간 소스** (Time Source)에 대해 남은 반복 횟수를 가져오는 방법에 대해 설명합니다. 해당 기능은 특정 동작을 수행할 때 남은 반복 수를 확인하는 데 유용합니다.

## 동작 구문

### 인자 설명

|인자|설명|
|---|---|
|Time Source|남은 반복 수를 가져올 시간 소스 ID|
|Target|반환된 값을 저장할 변수|
|Temp|변수가 임시 변수로 생성되어야 하는지 여부 (true/false)|

## 사용 예제

이 섹션에서는 `Get Reps Remaining` 동작을 활용하는 몇 가지 예제를 소개하겠습니다.

### 예제 1: 객체의 남은 반복 수 확인하기

다음은 특정 시간 소스의 남은 반복 횟수를 확인하고, 이를 화면에 출력하는 간단한 예제입니다.

```gml
// 시간 소스 ID 설정
var time_source_id = some_time_source_id;

// 남은 반복 수 가져오기
var remaining_reps;
Get_Reps_Remaining(time_source_id, remaining_reps, false);

// 남은 반복 수 출력
show_message("남은 반복 수: " + string(remaining_reps));

예제 2: 임시 변수로 남은 반복 수 가져오기

이 예제에서는 임시 변수를 사용하여 남은 반복 수를 가져오고, 그 값을 다른 계산에 활용합니다.

// 시간 소스 ID 설정
var time_source_id = some_time_source_id;

// 임시 변수로 남은 반복 수 가져오기
var temp_reps;
Get_Reps_Remaining(time_source_id, temp_reps, true);

// 임시 변수를 활용한 다른 계산
var total_time = temp_reps * 2; // 남은 반복 수에 2초를 곱함
show_message("총 남은 시간: " + string(total_time) + "초");

예제 3: 반복 횟수 체크 후 동작 실행하기

이 예제에서는 남은 반복 횟수에 따라 다른 행동을 취하는 방법을 보여줍니다.

// 시간 소스 ID 설정
var time_source_id = some_time_source_id;

// 남은 반복 수 가져오기
var remaining_reps;
Get_Reps_Remaining(time_source_id, remaining_reps, false);

// 남은 반복 수에 따라 조건 실행
if (remaining_reps > 0) {
    show_message("아직 남은 작업이 있습니다!");
} else {
    show_message("작업이 완료되었습니다.");
}

결론

Get Reps Remaining 동작은 게임에서 특정 행동이나 이벤트의 반복 수를 관리하는 데 유용합니다. 이상으로 남은 반복 수를 가져오는 방법과 다양한 활용 예제에 대해 알아보았습니다. 이를 통해 코드 작성 시 더 나은 로직을 구현할 수 있습니다. ```