---
name: "BIS_fnc_objectsMapper"
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_objectsMapper
revid: 348023
updated: 2023-11-08T11:22:59Z
---

# BIS_fnc_objectsMapper

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

## Description

Takes an array of data about a dynamic object template and creates the objects.

## Syntax

```sqf
[position, azimuth, objectsArray, badChance] call BIS_fnc_objectsMapper
```

**Parameters:**

- `position`: [Array](../topics/Array.md) - (Optional, default [0,0]) in format [Position2D](../topics/Position.md)
- `azimuth`: [Number](../topics/Number.md) - (Optional, default 0) the template orientation
- `objectsArray`: [Array](../topics/Array.md) - created with [BIS_fnc_objectsGrabber](../functions/BIS_fnc_objectsGrabber.md)
- `badChance`: [Number](../topics/Number.md) - (Optional, default 0) chances of object non-creation for each object, in range 0..1

**Returns:** [Array](../topics/Array.md) of [Object](../topics/Object.md)s

## Examples

### Example 1

```sqf
private _objectsArray = [
    ["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]
];
[getMarkerPos "myBase", 0, _objectsArray, 0.5] call BIS_fnc_objectsMapper;
```

## See also

[BIS_fnc_objectsGrabber](../functions/BIS_fnc_objectsGrabber.md)

<sub>Source: [BI Community Wiki — BIS fnc objectsMapper](https://community.bistudio.com/wiki/BIS_fnc_objectsMapper) (revision 348023).</sub>