Introduction

@aeronautic/controls moves an aircraft model's parts from its flight, for React Three Fiber and three.js: the control surfaces with the stick and the pedals, the flaps, the air brakes and the landing gear with their levers, the nozzles with the throttle, and the stick, the pedals and the throttle lever in the cockpit.

<FlightProvider>
  <primitive object={gltf.scene} />
  <ControlSurfaces object={gltf.scene} animations={gltf.animations} />
</FlightProvider>

Write pitch: 1 to the flight and the elevons go trailing edge up, the stick comes back, and the nozzles turn the exhaust up to push the tail down.

What it movesCopy Anchor Link

• Control surfaces: ailerons, elevators, elevons, stabilators, canards and rudders, with the stick and the pedals.
• High lift and drag: trailing-edge flaps, leading-edge flaps that droop with the angle of attack, air brakes, spoilers and split drag rudders.
• Engines: nozzle petals opening with the throttle, and thrust vectoring on the model's own gimbal or on one put in by code, with a round limit as a real nozzle's.
• Landing gear: legs, doors and the lever, or the model's own retraction clip, scrubbed.
• The cockpit: the stick, the pedals, and the throttle lever past its reheat detent.

Like real actuatorsCopy Anchor Link

Every part chases where it should be at the rate a real actuator would: an aileron at 80° a second, a flap at 10°. Slam the stick over and the elevons take a third of a second to follow. See Actuators.

Any modelCopy Anchor Link

A model rigged for it says everything: each part's hinge, its limits, its rest pose and which way is positive, in its glTF extras. A model with no rig is searched by its node names, Elevon_L or rudder.001, and each panel found is given a hinge fitted to its geometry. See Finding the parts.

With the restCopy Anchor Link

It reads the same flight as @aeronautic/afterburner and @aeronautic/wing-vapor, from @aeronautic/core. An afterburner put inside one of its engines sits on that engine's exhaust and turns with its nozzle.

How these docs are laid outCopy Anchor Link