---
name: "ctrlMapAnimAdd"
type: command
status: ok
groups: ["GUI Control - Map"]
arma3_since: "0.50"
locality: {"argument": "local", "effect": "local", "server_exec": false}
source: https://community.bistudio.com/wiki/ctrlMapAnimAdd
revid: 377869
updated: 2026-01-04T11:37:23Z
---

# ctrlMapAnimAdd

*Command · GUI Control - Map · Arma 3 v0.50 · introduced in Armed Assault v1.00*

Locality: arguments **local** · effect **local**

## Description

Adds the next frame to the map animation.

## Syntax

```sqf
map ctrlMapAnimAdd [time, zoom, position]
```

**Parameters:**

- `map`: [Control](../topics/Control.md) - CT_MAP control
- `time`: [Number](../topics/Number.md) - duration of the animation in seconds
- `zoom`: [Number](../topics/Number.md) - zoom in range from 0.001 (max) to 1 (min). Custom map scales can be set in map control's config. See also [ctrlMapScale](../commands/ctrlMapScale.md)
- `position`: [Position2D](../topics/Position.md#introduction), [Position3D](../topics/Position.md#introduction), [Object](../topics/Object.md)

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
_map ctrlMapAnimAdd [1, 0.1, getMarkerPos "anim1"];
ctrlMapAnimCommit _map;
```

### Example 2

Center map on player:

```sqf
_ctrl ctrlMapAnimAdd [0, 0.05, player];
ctrlMapAnimCommit _ctrl;
```

### Example 3

```sqf
_map ctrlMapSetPosition [];
_map ctrlMapAnimAdd [1, 0.1, getMarkerPos "anim1"];
ctrlMapAnimCommit _map;
```

## Problems

When used on a CT_MAP that was created dynamically the target position could be offset. Use [ctrlMapSetPosition](../commands/ctrlMapSetPosition.md) before adding animation (Example 3).

## See also

[ctrlMapSetPosition](../commands/ctrlMapSetPosition.md) · [mapAnimAdd](../commands/mapAnimAdd.md) · [mapAnimClear](../commands/mapAnimClear.md) · [mapAnimCommit](../commands/mapAnimCommit.md) · [mapAnimDone](../commands/mapAnimDone.md) · [ctrlMapAnimClear](../commands/ctrlMapAnimClear.md) · [ctrlMapAnimCommit](../commands/ctrlMapAnimCommit.md) · [ctrlMapAnimDone](../commands/ctrlMapAnimDone.md)

<sub>Source: [BI Community Wiki — ctrlMapAnimAdd](https://community.bistudio.com/wiki/ctrlMapAnimAdd) (revision 377869).</sub>