사운드 이뮤터 최대 볼륨 설정 - audio_emitter_gain
이 문서에서는 `audio_emitter_gain` 함수의 기능과 사용 방법에 대해 설명합니다. 이 함수는 사운드의 최대 볼륨을 설정하는 데 사용됩니다.
## 개요
`audio_emitter_gain` 함수는 사운드의 최대 이득(볼륨)을 설정합니다. 사운드는 감쇠 값과 청취자와의 상대적인 위치에 따라 인식되는 볼륨이 달라질 수 있으나, 이 함수를 사용하여 이득을 설정하면 전체 볼륨이 지정된 이득 값을 초과하지 않습니다.
아래 이미지는 감쇠 값이 0보다 클 때 이득이 이뮤터의 볼륨에 미치는 영향을 설명합니다.
- 이 함수는 사운드가 재생되는 동안 볼륨을 변경하며, 주어진 이뮤터를 통해 재생되는 모든 후속 사운드에도 영향을 미칩니다.
- 일부 플랫폼에서는 이득 값이 1을 초과할 수 있지만, 1의 값은 "최대 볼륨"으로 간주되며 그 이상의 값은 오디오 클리핑이나 왜곡을 유발할 수 있습니다.
최종 볼륨은 `audio_master_gain` 함수로 설정된 전역 오디오 이득에 의해서도 영향을 받습니다.
## 구문
```gml
audio_emitter_gain(emitter, gain);
인자 설명
| 인자 | 타입 | 설명 |
|---|---|---|
| emitter | Audio Emitter ID | 변경할 이뮤터의 인덱스 |
| gain | Real | 최대 이득(기본값 1) |
반환값
- N/A
사용 예제
아래 코드는 gain 변수를 다양한 값으로 설정한 후 해당 변수를 사용하여 s_emit 변수에 인덱스가 있는 이뮤터의 이득을 설정합니다.
if (up){
gain += 0.05;
if (gain >= 1) up = false;
} else {
gain += 0.05;
if (gain <= 0) up = true;
}
audio_emitter_gain(s_emit, gain);
이 코드에서는 gain 변수가 증가하거나 감소하면서 이뮤터의 볼륨이 변경됩니다.
다양한 활용 및 응용 예제
- 사용자 입력에 따른 볼륨 조정
- 사용자가 특정 키를 눌렀을 때 볼륨을 증가 또는 감소시키는 방법.
if (keyboard_check(vk_up)) {
gain += 0.1;
if (gain > 1) gain = 1;
}
if (keyboard_check(vk_down)) {
gain -= 0.1;
if (gain < 0) gain = 0;
}
audio_emitter_gain(s_emit, gain);
- 게임 내 상황에 따른 볼륨 변화
- 게임 내 분위기가 변경될 때 자동으로 볼륨을 조정하는 예제.
if (in_combat) {
gain = 0.8; // 전투 중 볼륨을 높임
} else {
gain = 0.5; // 일반 상태로 돌아갈 때 볼륨을 낮춤
}
audio_emitter_gain(s_emit, gain);
- 시간에 따른 볼륨 변화
- 특정 시간에 따라 볼륨을 조정하는 예제.
var current_time = current_time / 1000; // 초 단위로 변환
gain = sin(current_time); // 사인파를 이용해 볼륨 변화를 만듭니다.
audio_emitter_gain(s_emit, abs(gain)); // 절대값을 취하여 항상 양수로 유지
이러한 예제들은 다양한 게임 시나리오에서 이뮤터의 볼륨을 유연하게 조정하는 데 도움이 될 것입니다. ```