# PATH::GET_NTH_CLOSEST_VEHICLE_NODE_WITH_HEADING

- **Hash:** `0x591B40D4390DB54A`
- **Namespace:** PATH
- **Runtime name (Lua/JS):** `GetNthClosestVehicleNodeWithHeading`
- **Side:** client (game native)
- **Name status:** official
- **Documentation:** named only
- **Since game build:** 1207
- **URL:** https://natives.borderlinerp.com/natives/PATH/GET_NTH_CLOSEST_VEHICLE_NODE_WITH_HEADING

## Signature

```c
BOOL GET_NTH_CLOSEST_VEHICLE_NODE_WITH_HEADING(float x, float y, float z, int nthClosest, Vector3* outPosition, float* heading, Any* unknown1, int unknown2, float unknown3, float unknown4);
```

## Parameters

- `x` (`float`)
- `y` (`float`)
- `z` (`float`)
- `nthClosest` (`int`)
- `outPosition` (`Vector3*`)
- `heading` (`float*`)
- `unknown1` (`Any*`)
- `unknown2` (`int`)
- `unknown3` (`float`)
- `unknown4` (`float`)

## Returns

`BOOL`

## Usage

### Lua

```lua
local retval, outPosition, heading, unknown1 = GetNthClosestVehicleNodeWithHeading(x, y, z, nthClosest, unknown2, unknown3, unknown4)

-- always available, by hash
local retval, outPosition, heading, unknown1 = Citizen.InvokeNative(0x591B40D4390DB54A, x, y, z, nthClosest, Citizen.PointerValueVector(), Citizen.PointerValueFloat(), Citizen.PointerValueInt(), unknown2, unknown3, unknown4, Citizen.ReturnResultAnyway())
```

### JavaScript

```js
const [retval, outPosition, heading, unknown1] = GetNthClosestVehicleNodeWithHeading(x, y, z, nthClosest, unknown2, unknown3, unknown4);

// by hash
const [retval, outPosition, heading, unknown1] = Citizen.invokeNative('0x591B40D4390DB54A', x + 0.0000001, y + 0.0000001, z + 0.0000001, nthClosest, Citizen.pointerValueVector(), Citizen.pointerValueFloat(), Citizen.pointerValueInt(), unknown2, unknown3 + 0.0000001, unknown4 + 0.0000001, Citizen.returnResultAnyway());
```

### C#

```csharp
var outPosition = new OutputArgument();
var heading = new OutputArgument();
var unknown1 = new OutputArgument();
bool retval = Function.Call<bool>((Hash)0x591B40D4390DB54A, x, y, z, nthClosest, outPosition, heading, unknown1, unknown2, unknown3, unknown4);
// outPosition.GetResult<Vector3>()
// heading.GetResult<float>()
// unknown1.GetResult<int>()
```

- Float parameters: Lua integers (`10`, or whole numbers decoded from NUI/JSON) are sent as ints and read as garbage. Write `10.0` or `value + 0.0`. The generated JS wrappers add `0.0000001` to non-zero floats for the same reason.
- Pointer (out) arguments are not passed in Lua/JS: their values are returned after the result, in order.
- `Any*` arguments are often structs. Build them with a DataView buffer and pass it with `:Buffer()` — see the examples and notes below.

*Sources: alloc8or RDR3 NativeDB.*