BIS_fnc_objectsGrabber

Arma 3 v0.50
First in Arma 2 v1.00

Function · Markdown · JSON · original wiki page

Description

Converts a set of placed objects to an object array (as a String) for the DynO mapper.

Format is the following. First, the header:

Then, data:

[
    ["B_UAV_01_F",[-5.23706,-0.183594,-0.00126648],167.39,1,0,[0.605018,-0.575293],"","",true,false],
    ["C_Offroad_01_F",[-4.25903,4.62158,0.0630951],224.14,1,0,[0.812812,0.190543],"","",true,false]
]

or, if object orientation is not used:

[
    ["B_UAV_01_F",[-5.23706,-0.183594,-0.00126648],167.39,1,0,[],"","",true,false],
    ["C_Offroad_01_F",[-4.25903,4.62158,0.0630951],224.14,1,0,[],"","",true,false]
]

Syntax

[position, size, objectOrientation] call BIS_fnc_objectsGrabber

Parameters:

position: Position - (Optional, default [0,0]) 2D or 3D position, center of the "grabbing" area
size: Number - (Optional, default 50) size (radius) of the "grabbing" area
objectOrientation: Boolean - (Optional, default false) capture object orientation or not. Format BIS_fnc_getPitchBank

Returns: String - 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

Examples

Example 1

[getPos player, 20, true] call BIS_fnc_objectsGrabber;

Function header

The comment at the top of the function's file in the game.

/*
Grab data:
Mission: TheMissionName
World: Stratis
Anchor position: [3781.59, 3289.67]
Area size: 50
Using orientation of objects: yes/no
*/