{"name":"BIS_fnc_sceneAreaClearance","title":"BIS fnc sceneAreaClearance","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_sceneAreaClearance","revid":379317,"updated":"2026-10-30T23:50:26Z","groups":["Scenes"],"status":"ok","games":{"arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"arma2 1.00","arma3_since":"0.50","description":"Removes object clutter within a set trigger, for use within cutscenes.","syntaxes":[{"syntax":"[trigger, objects, destination] spawn BIS_fnc_sceneAreaClearance","params":[{"name":"trigger","type":"Object","description":"trigger to use as center point","type_expr":"Object"},{"name":"objects","type":"Array","optional":true,"default":"`[]`","description":"list of objects that will be kept during cutscene","type_expr":"Array","text":"objects: Array - (Optional, default `[]`) list of objects that will be kept during cutscene"},{"name":"destination","type":"Array in format Position","optional":true,"default":"[-5000, 10000, 0]","description":"where to move all unwanted objects","type_expr":"Position","types":["Array","Position"],"text":"destination: Array in format Position - (Optional, default [-5000, 10000, 0]) where to move all unwanted objects"}],"returns":{"type":"Nothing","type_expr":"Nothing"}}],"examples":[{"code":["[triggerArea1] spawn BIS_fnc_sceneAreaClearance;"]}],"notes":[{"user":"Tryteyker-","date":"2014-10-02T16:29:00Z","text":"In regards to the 'safe position' where the objects get moved, this is how the function handles it (with default values present):\n\n```sqf\nprivate _savepos = [_unwantedObjectsTempPosition, 0, 100, 20, 0, 60 * (pi / 180), 0] call BIS_fnc_findSafePos;\nif ((_savepos distance (getArray (configFile >> \"CfgWorlds\" >> worldName >> \"centerPosition\"))) == 0) then\n{\n    _savepos = _unwantedObjectsTempPosition;\n};\n_x setPos _savepos;\n```"}]}