ACE3/addons/common/functions/fnc_playConfigSound3D.sqf
Dedmen Miller e2ac18a05d [WIP] Fix script errors reporting wrong line numbers (#6407)
* advanced_ballistics

* advanced_fatigue

* advanced_throwing

* ai

* aircraft

* arsenal

* atragmx

* attach

* backpacks

* ballistics

* captives

* cargo

* chemlights

* common

* concertina_wire

* cookoff

* dagr

* disarming

* disposable

* dogtags

* dragging

* explosives

* fastroping

* fcs

* finger

* frag

* gestures

* gforces

* goggles

* grenades

* gunbag

* hearing

* hitreactions

* huntir

* interact_menu

* interaction

* inventory

* kestrel4500

* laser

* laserpointer

* logistics_uavbattery

* logistics_wirecutter

* magazinerepack

* map

* map_gestures

* maptools

* markers

* medical

* medical_ai

* medical_blood

* medical_menu

* microdagr

* minedetector

* missileguidance

* missionmodules

* mk6mortar

* modules

* movement

* nametags

* nightvision

* nlaw

* optics

* optionsmenu

* overheating

* overpressure

* parachute

* pylons

* quickmount

* rangecard

* rearm

* recoil

* refuel

* reload

* reloadlaunchers

* repair

* respawn

* safemode

* sandbag

* scopes

* slideshow

* spectator

* spottingscope

* switchunits

* tacticalladder

* tagging

* trenches

* tripod

* ui

* vector

* vehiclelock

* vehicles

* viewdistance

* weaponselect

* weather

* winddeflection

* yardage450

* zeus

* arsenal defines.hpp

* optionals

* DEBUG_MODE_FULL 1

* DEBUG_MODE_FULL 2

* Manual fixes

* Add SQF Validator check for #include after block comment

* explosives fnc_openTimerUI

* fix uniqueItems
2018-09-17 14:19:29 -05:00

44 lines
1.2 KiB
Plaintext

#include "script_component.hpp"
/*
* Author: esteldunedain
* Plays a sound defined in CfgSounds using playSound3D, with global effect.
*
* Arguments:
* 0: Sound class <STRING>
* 1: Position ASL <ARRAY>
* 2: Volume <NUMBER> (default: from sound config)
* 3: Distance <NUMBER> (default: from sound config)
*
* Return Value:
* None
*
* Example:
* ["hint", getPosASL player, 5, 5] call ace_common_fnc_playConfigSound3D
*
* Public: Yes
*/
params ["_soundClass", "_posASL", "_volume", "_distance"];
private _sound = getArray (configFile >> "CfgSounds" >> _soundClass >> "sound");
if (_sound isEqualTo []) exitWith {
ERROR_1("CfgSounds class [%1] does not exist or contains empty sound array", _soundClass);
};
TRACE_2("sound",_soundClass,_sound);
_sound params ["_fileName", "_cfgVolume", "_pitch", ["_cfgDistance", 0]];
ISNILS(_volume,_cfgVolume);
ISNILS(_distance,_cfgDistance);
// Strip the first \ from the filename
_fileName = _fileName select [1];
// add file extension .wss as default
if !(toLower (_fileName select [count _fileName - 4]) in [".wav", ".ogg", ".wss"]) then {
ADD(_fileName,".wss");
};
TRACE_5("vars",_fileName,_posASL,_volume,_pitch,_distance);
playSound3D [_fileName, objNull, false, _posASL, _volume, _pitch, _distance];