# SHAPETEST::START_SHAPE_TEST_CAPSULE

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

## Signature

```c
ScrHandle START_SHAPE_TEST_CAPSULE(float x1, float y1, float z1, float x2, float y2, float z2, float radius, int flags, Entity entityToIgnore, int p9);
```

## Parameters

- `x1` (`float`)
- `y1` (`float`)
- `z1` (`float`)
- `x2` (`float`)
- `y2` (`float`)
- `z2` (`float`)
- `radius` (`float`)
- `flags` (`int`)
- `entityToIgnore` (`Entity`)
- `p9` (`int`)

## Returns

`ScrHandle`

## Usage

### Lua

```lua
local retval = StartShapeTestCapsule(x1, y1, z1, x2, y2, z2, radius, flags, entityToIgnore, p9)

-- always available, by hash
local retval = Citizen.InvokeNative(0x28579D1B8F8AAC80, x1, y1, z1, x2, y2, z2, radius, flags, entityToIgnore, p9, Citizen.ResultAsInteger())
```

### JavaScript

```js
const retval = StartShapeTestCapsule(x1, y1, z1, x2, y2, z2, radius, flags, entityToIgnore, p9);

// by hash
const retval = Citizen.invokeNative('0x28579D1B8F8AAC80', x1 + 0.0000001, y1 + 0.0000001, z1 + 0.0000001, x2 + 0.0000001, y2 + 0.0000001, z2 + 0.0000001, radius + 0.0000001, flags, entityToIgnore, p9, Citizen.returnResultAnyway(), Citizen.resultAsInteger());
```

### C#

```csharp
int retval = Function.Call<int>((Hash)0x28579D1B8F8AAC80, x1, y1, z1, x2, y2, z2, radius, flags, entityToIgnore, p9);
```

- 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.

*Sources: alloc8or RDR3 NativeDB.*