---
name: "visiblePosition"
type: command
status: ok
groups: ["Positions", "Render Time Scope"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/visiblePosition
revid: 363616
updated: 2024-04-08T11:45:05Z
---

# visiblePosition

*Command · Positions, Render Time Scope · Arma 3 v0.50 · introduced in Arma 2: Operation Arrowhead v1.60*

## Description

Returns an object's rendered position (z value above surface underneath) in render time scope. Same as [getPosVisual](../commands/getPosVisual.md).

> [!IMPORTANT]
> This command must **not** be used for actual 3D calculations. See [getPos](../commands/getPos.md) for an explanation.

## Syntax

```sqf
visiblePosition object
```

**Parameters:**

- `object`: [Object](../topics/Object.md) - name of the object

**Returns:** [PositionAGLS](../topics/Position.md#positionagls)

## Examples

### Example 1

```sqf
_playerRenderedPos = visiblePosition player;
```

## See also

[getPosVisual](../commands/getPosVisual.md) · [getPosATLVisual](../commands/getPosATLVisual.md) · [getPosASLVisual](../commands/getPosASLVisual.md) · [getPosWorldVisual](../commands/getPosWorldVisual.md) · [visiblePositionASL](../commands/visiblePositionASL.md) · [position](../commands/position.md) · [getPos](../commands/getPos.md) · [getPosATL](../commands/getPosATL.md) · [getPosASL](../commands/getPosASL.md) · [getPosASLW](../commands/getPosASLW.md)

## Community notes

**Leopard20** — 2022-01-26

Note that this command returns the position in [AGLS](../topics/Position.md#positionagls) format (Z is measured from the nearest surface below). For example the value of Z is 0 even if the object is resting on top of a building.

For use with draw commands, such as [drawIcon3D](../commands/drawIcon3D.md), an [AGL](../topics/Position.md#positionagl) position is needed. The following alternatives can be used, depending on where the icon is intended to be shown:

```sqf
ASLToAGL getPosWorldVisual _object        // object center in model coordinates, i.e [0,0,0]
ASLToAGL getPosASLVisual _object        // object land contact (e.g. floor of a building)
unitAimPositionVisual _object            // object's aiming position, i.e where the AI aim at, such as a soldier's chest
_object modelToWorldVisual _relativePos    // custom position in model coordinates. if _relativePos is [0,0,0], it'll be the same as ASLToAGL getPosWorldVisual _object
```

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