---
name: "BIS_fnc_objectsGrabber"
type: function
status: ok
groups: ["Object Manipulation"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_objectsGrabber
revid: 330763
updated: 2022-11-01T15:44:49Z
---

# BIS_fnc_objectsGrabber

*Function · Object Manipulation · Arma 3 v0.50 · introduced in Arma 2 v1.00*

## Description

Converts a set of placed objects to an object array (**as a [String](../topics/String.md)**) for the [DynO mapper](../functions/BIS_fnc_objectsMapper.md).

Format is the following. First, the header:

Then, data:

```sqf
[
    ["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:

```sqf
[
    ["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

```sqf
[position, size, objectOrientation] call BIS_fnc_objectsGrabber
```

**Parameters:**

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

**Returns:** [String](../topics/String.md) - arrays are in format [classname, relPos, azimuth, fuel, damage, pitchBankResult, vehicleVarName, initCommands, simulationEnabled, isASL]:
- classname: [String](../topics/String.md)
- relPos: [Array](../topics/Array.md)
- azimuth: [Number](../topics/Number.md)
- fuel: [Number](../topics/Number.md)
- damage: [Number](../topics/Number.md)
- pitchBankResult: [Array](../topics/Array.md) - return from [BIS_fnc_getPitchBank](../functions/BIS_fnc_getPitchBank.md) (only if *objectOrientation* is true)
- vehicleVarName: [String](../topics/String.md)
- initCommands: [String](../topics/String.md)
- simulationEnabled: [Boolean](../topics/Boolean.md)
- isASL: [Boolean](../topics/Boolean.md)

## Examples

### Example 1

```sqf
[getPos player, 20, true] call BIS_fnc_objectsGrabber;
```

## Function header

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

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

## See also

[BIS_fnc_objectsMapper](../functions/BIS_fnc_objectsMapper.md) · [BIS_fnc_getPitchBank](../functions/BIS_fnc_getPitchBank.md) · [BIS_fnc_setPitchBank](../functions/BIS_fnc_setPitchBank.md)

<sub>Source: [BI Community Wiki — BIS fnc objectsGrabber](https://community.bistudio.com/wiki/BIS_fnc_objectsGrabber) (revision 330763).</sub>