---
name: "vectorDirVisual"
type: command
status: ok
groups: ["Math - Vectors", "Render Time Scope"]
arma3_since: "1.32"
locality: {"argument": "global", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/vectorDirVisual
revid: 377258
updated: 2026-01-02T06:32:55Z
---

# vectorDirVisual

*Command · Math - Vectors, Render Time Scope · Arma 3 v1.32*

Locality: arguments **global**

## Description

Returns an object's direction vector in world space and render time scope.

> [!IMPORTANT]
> The vector is **not necessarily [normalized](../commands/vectorNormalized.md)**. The [magnitude](../commands/vectorMagnitude.md) of the vector depends on the [object's scale](../commands/getObjectScale.md).

For an object facing one of the cardinal directions on perfectly flat ground (parallel to the XY-plane of the world space), [vectorDirVisual](../commands/vectorDirVisual.md) returns simple values:
- `[0, 1, 0]` if the object is facing directly north
- `[1, 0, 0]` if the object is facing directly east
- `[0, -1, 0]` if the object is facing directly south
- `[-1, 0, 0]` if the object is facing directly west

## Syntax

```sqf
vectorDirVisual object
```

**Parameters:**

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

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

## Examples

### Example 1

```sqf
_vecDirVis = vectorDirVisual MyObject;
```

## See also

[vectorModelToWorldVisual](../commands/vectorModelToWorldVisual.md) · [vectorDir](../commands/vectorDir.md) · [vectorSide](../commands/vectorSide.md) · [vectorSideVisual](../commands/vectorSideVisual.md) · [vectorUpVisual](../commands/vectorUpVisual.md) · [vectorUp](../commands/vectorUp.md) · [setVectorDir](../commands/setVectorDir.md) · [setVectorUp](../commands/setVectorUp.md) · [setVectorDirAndUp](../commands/setVectorDirAndUp.md) · [vectorDiff](../commands/vectorDiff.md) · [vectorAdd](../commands/vectorAdd.md) · [vectorMultiply](../commands/vectorMultiply.md) · [vectorCrossProduct](../commands/vectorCrossProduct.md) · [vectorDistance](../commands/vectorDistance.md) · [vectorMagnitudeSqr](../commands/vectorMagnitudeSqr.md) · [vectorDistanceSqr](../commands/vectorDistanceSqr.md) · [vectorCos](../commands/vectorCos.md) · [vectorMagnitude](../commands/vectorMagnitude.md) · [vectorDotProduct](../commands/vectorDotProduct.md) · [vectorNormalized](../commands/vectorNormalized.md) · [vectorFromTo](../commands/vectorFromTo.md)

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