21 lines
1.1 KiB
Markdown
21 lines
1.1 KiB
Markdown
# Motion instrument
|
||
|
||
Instance `components/motion_panel.tscn`. Run `scenes/motion_demo.tscn` with F6 for simulated telemetry; pause the feed to preview stale status.
|
||
|
||
```gdscript
|
||
$MotionPanel.set_telemetry(
|
||
Vector3(roll_degrees, pitch_degrees, heading_degrees),
|
||
Vector3(momentum_x, momentum_y, momentum_z),
|
||
Vector3(accel_x, accel_y, accel_z)
|
||
)
|
||
```
|
||
|
||
- Orientation: positive roll right side down, positive pitch nose up, heading clockwise from north (0–360°).
|
||
- Body axes: X forward, Y right, Z down.
|
||
- Angular momentum: kg·m²/s, distinct from gyroscope angular velocity.
|
||
- Acceleration: m/s², with gravity removed upstream.
|
||
|
||
Missing values show dashes; non-finite samples are rejected. After `stale_after_seconds` (default 2), the banner marks held values STALE. `acceleration_full_scale` sets plot limits; numeric values remain unclamped.
|
||
|
||
Edit layout and Labels in the scene tree. Preserve scene-unique names used by `motion_panel.gd`. The four graphics use `motion_instrument.gd`; `radius_source` keeps the circles and Z scale aligned. Colors inherit the active theme; see [colors.md](colors.md).
|