# Grab API

Quick-reference for {cpp:class}`UMovaIxGrabComponent`. For setup and tuning
narrative, see {doc}`../guides/grab-component`.

## Verbs

```{doxygenfunction} UMovaIxGrabComponent::ToggleGrab
```

```{doxygenfunction} UMovaIxGrabComponent::GrabAimed
```

```{doxygenfunction} UMovaIxGrabComponent::ReleaseHeld
```

```{doxygenfunction} UMovaIxGrabComponent::ThrowHeld
```

## Queries

```{doxygenfunction} UMovaIxGrabComponent::GetHeldComponent
```

```{doxygenfunction} UMovaIxGrabComponent::IsGrabbable
```

```{doxygenfunction} UMovaIxGrabComponent::IsHolding
```

## Events

`OnGrabbed`, `OnReleased`, `OnThrown`: `FMovaIxGrabSignature`, each passing the
affected `UPrimitiveComponent*`.

## Tunables

| Property | Default | Purpose |
|---|---|---|
| `GrabTag` | `Grabbable` (the `#Grab` marker) | required tag on the primitive/actor; `None` = any simulating primitive |
| `ReachDistance` | 400 cm | trace range from the camera |
| `HoldDistance` | 200 cm | distance in front of the camera the held object floats |
| `HoldInterpSpeed` | 15 | snappiness of the chase to the hold point |
| `MaxGrabMass` | 0 (no cap) | heaviest primitive (kg) that may be grabbed |
| `ThrowImpulse` | 60000 | impulse magnitude along the view |
| `bRotateHeldWithView` | false | keep the held object's rotation relative to the view |
| `TraceChannel` | `ECC_Visibility` | trace channel for the aim trace |

## Full class

Full member listing (fields, private members, replication details):
{doc}`runtime-components`.