{"name":"BIS_fnc_zoomOnArea","operator":null,"title":"BIS fnc zoomOnArea","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_zoomOnArea","revid":322348,"updated":"2022-05-31T21:47:12Z","groups":["Map and Markers"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.78"}],"since":{"game":"arma3","name":"Arma 3","version":"1.78"},"arma3_since":"1.78","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Map will zoom on the given area. Function always takes the longer side of the area to zoom on.","syntaxes":[{"syntax":"[area, center, time, handler, forceCam] call BIS_fnc_zoomOnArea","since":null,"effect":null,"exec":null,"params":[{"name":"area","type":"Array","optional":false,"default":null,"description":"area to zoom on","types":["Array"],"since":null,"text":"area: Array - area to zoom on"},{"name":"center","type":"Array","optional":false,"default":null,"description":"coordinates of the center","types":["Array"],"since":null,"text":"center: Array - coordinates of the center"},{"name":"time","type":"Number","optional":true,"default":"1","description":"time of the zoom operation","types":["Number"],"since":null,"text":"time: Number - (Optional, default 1) time of the zoom operation"},{"name":"handler","type":"Control","optional":true,"default":"nil","description":"handler to the map display control (you can pass one if already exists, if not, handler is created)","types":["Control"],"since":null,"text":"handler: Control - (Optional, default nil) handler to the map display control (you can pass one if already exists, if not, handler is created)"},{"name":"forceCam","type":"Boolean","optional":true,"default":"false","description":"whether to force the camera in position after the zoom.","types":["Boolean"],"since":null,"text":"forceCam: Boolean - (Optional, default false) whether to force the camera in position after the zoom."}],"returns":{"type":"Number","types":["Number"],"description":"zoom level","text":"Number - zoom level"}}],"examples":[{"text":"```sqf\nopenMap true;\n[markerSize \"BIS_areaMarker\", markerPos \"BIS_areaMarker\", 5] call BIS_fnc_zoomOnArea;\n```","code":["openMap true;\n[markerSize \"BIS_areaMarker\", markerPos \"BIS_areaMarker\", 5] call BIS_fnc_zoomOnArea;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["BIS_fnc_zoomLock","BIS_fnc_zoomUnlock"],"notes":[],"categories":["Arma 3: Functions","Arma 3: New Functions","Function Group: Map and Markers","Functions","Introduced with Arma 3 version 1.78"],"docblock":null,"filled_from_docblock":[]}