{"name":"BIS_fnc_objectsGrabber","operator":null,"title":"BIS fnc objectsGrabber","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_objectsGrabber","revid":330763,"updated":"2022-11-01T15:44:49Z","groups":["Object Manipulation"],"status":"ok","replaced_by":[],"games":[{"game":"arma2","name":"Arma 2","version":"1.00"},{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"arma2","name":"Arma 2","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Converts a set of placed objects to an object array (**as a String**) for the DynO mapper.\n\nFormat is the following. First, the header:\n\nThen, data:\n\n```sqf\n[\n    [\"B_UAV_01_F\",[-5.23706,-0.183594,-0.00126648],167.39,1,0,[0.605018,-0.575293],\"\",\"\",true,false], \n    [\"C_Offroad_01_F\",[-4.25903,4.62158,0.0630951],224.14,1,0,[0.812812,0.190543],\"\",\"\",true,false]\n]\n```\n\nor, if object orientation is not used:\n\n```sqf\n[\n    [\"B_UAV_01_F\",[-5.23706,-0.183594,-0.00126648],167.39,1,0,[],\"\",\"\",true,false], \n    [\"C_Offroad_01_F\",[-4.25903,4.62158,0.0630951],224.14,1,0,[],\"\",\"\",true,false]\n]\n```","syntaxes":[{"syntax":"[position, size, objectOrientation] call BIS_fnc_objectsGrabber","since":null,"effect":null,"exec":null,"params":[{"name":"position","type":"Position","optional":true,"default":"[0,0]","description":"2D or 3D position, center of the \"grabbing\" area","types":["Position"],"since":null,"text":"position: Position - (Optional, default [0,0]) 2D or 3D position, center of the \"grabbing\" area"},{"name":"size","type":"Number","optional":true,"default":"50","description":"size (radius) of the \"grabbing\" area","types":["Number"],"since":null,"text":"size: Number - (Optional, default 50) size (radius) of the \"grabbing\" area"},{"name":"objectOrientation","type":"Boolean","optional":true,"default":"false","description":"capture object orientation or not. Format BIS_fnc_getPitchBank","types":["Boolean"],"since":null,"text":"objectOrientation: Boolean - (Optional, default false) capture object orientation or not. Format BIS_fnc_getPitchBank"}],"returns":{"type":"String","types":["String"],"description":"arrays are in format [classname, relPos, azimuth, fuel, damage, pitchBankResult, vehicleVarName, initCommands, simulationEnabled, isASL]: - classname: String - relPos: Array - azimuth: Number - fuel: Number - damage: Number - pitchBankResult: Array - return from BIS_fnc_getPitchBank (only if objectOrientation is true) - vehicleVarName: String - initCommands: String - simulationEnabled: Boolean - isASL: Boolean","text":"String - arrays are in format [classname, relPos, azimuth, fuel, damage, pitchBankResult, vehicleVarName, initCommands, simulationEnabled, isASL]:\n- classname: String\n- relPos: Array\n- azimuth: Number\n- fuel: Number\n- damage: Number\n- pitchBankResult: Array - return from BIS_fnc_getPitchBank (only if *objectOrientation* is true)\n- vehicleVarName: String\n- initCommands: String\n- simulationEnabled: Boolean\n- isASL: Boolean"}}],"examples":[{"text":"```sqf\n[getPos player, 20, true] call BIS_fnc_objectsGrabber;\n```","code":["[getPos player, 20, true] call BIS_fnc_objectsGrabber;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["BIS_fnc_objectsMapper","BIS_fnc_getPitchBank","BIS_fnc_setPitchBank"],"notes":[],"categories":["Arma 2: Functions","Arma 2: New Functions","Arma 2: Operation Arrowhead: Functions","Arma 3: Functions","Function Group: Object Manipulation","Functions","Introduced with Arma 2 version 1.00","Take On Helicopters: Functions"],"docblock":{"author":null,"description":"Grab data: Mission: TheMissionName World: Stratis Anchor position: [3781.59, 3289.67] Area size: 50 Using orientation of objects: yes/no","params":[],"returns":null,"examples":[],"syntax":null,"execution":null,"notes":null,"requirements":null,"meta":{},"text":"Grab data:\nMission: TheMissionName\nWorld: Stratis\nAnchor position: [3781.59, 3289.67]\nArea size: 50\nUsing orientation of objects: yes/no"},"filled_from_docblock":[]}