AutoMovie API
    Preparing search index...

    Function rideQuadruped

    • A quadruped going along a course: its root on the path, its trunk rising and falling and its head nodding with the stride, its four limbs stepping in the gait's order, and its gait and lead changing with the speed or as the course's legs name them. Every kind is ridden by this one function, from its species' data (createQuadruped.species).

      The stride's timing is the selected declared table's (QuadrupedGait.timing) at the course's speed and the animal's withers height, shifted by its normalized tempo. The source owner distinguishes observed, derived and authored clocks; absolute clocks stay unscaled, otherwise the table's dynamic-similarity assumption is provisional as QuadrupedGait.scale states. Each foot lands at its phase of the stride, stays planted for the duty factor's share of it while the body passes over, then swings forward, lifted clear of the ground, with its carpus or hock folded. A planted foot stays where it landed on a straight leg at any speed, steady or changing, and across a change of gait; on a turn it is carried along the model's own fore-and-aft line, so it slides sideways by the turn's sagitta over one stance. The ride adds an instant for every landing, leftForeOn, rightHindOn and so on, which a rider's rising trot or a walker's step beside the animal locks to. The tack rides the trunk, so frame("seat", seconds) is the moving support a rider sits on and frame("hitch", seconds) the one a cart is drawn from; the species' nodding parts turn with the head.

      The gait of each stride is the one a course leg names, else the one gait names, else the one the speed calls for at the species' change points (QuadrupedChange), going up above a change point by the species' hysteresis and coming down below it by as much, so a speed hovering at the boundary does not flip the gait every stride. A change is decided at the left fore's landing, the stride's start, and takes the next stride: each foot's landing moves from the old gait's phase to the new one's, so a planted foot stays planted, and the ride names gait:<from>-<to> there. A leg may name a lead for a leaded gait, whose right lead mirrors the left; a change of lead is a flying change, taken the same way and named lead:<from>-<to>.

      Cruise, explicit positive speed marks and named gait requests are admitted before timing is read. Gaps between declared gait domains are refused. Virtual landing clocks use the actual course boundary's state while their spatial samples remain held by the original plan. Already committed legacy Froude/mass/overlap handovers can retain an endpoint clock only with actual adjacent-gait domain support; speed-availability rules do not bridge gaps. Genuine zero-speed ramps retain the minimum clock over vMin²/(2a).

      An optional authoring table is admitted and copied before planning. It supplies only this ride's clocks and pose ranges; the animal's species identity, body data, nodding parts and registered default table remain owned by the producer. The table's producer states which values are measured and which are authored.

      The fixed phase planner permits one stride decision per cell. It refuses nonrepresentable advances and periods shorter than that plan's cell width before enumerating events; this explicit capacity is not a biological limit.

      Limb roots remain fixed in their actual parent's local frame. Four unchanged foot goals and actual cylinder/capsule soles constrain one body-root height; the gait's bob is its soft preference, while the horizontal course is kept. Terminal directions retain their actual neutral carriage and the relative carpus/hock fold is solved without a translated shoulder or stretched bar. The shared generic FK must reproduce every solved origin and endpoint.

      Type Parameters

      • Affordance extends string
      • D extends string

      Parameters

      • animal: Archetype<Affordance, QuadrupedBody.Dimension | D>

        The animal, as createQuadruped or its kind's producer builds it.

      • course: rideQuadruped.ICourse

        The course its root follows; a leg may name the gait and the lead it is taken at.

      • Optionalgait: QuadrupedGait.Gait

        The gait of every stride whose leg names none; absent, the speed chooses it.

      • Optionaltable: QuadrupedGait.ITable

        Optional admitted authoring table, replacing only this ride's gait data. Explicit authored clocks remain separate from the species' measured default; the source species and animal are unchanged.

      Returns IRide<Affordance, QuadrupedBody.Dimension | D>

      The ride.

      When the animal is no quadruped's, a supplied table fails QuadrupedLocomotion.admit, a gait is not in the selected table, a requested speed is outside its domain, the course is malformed, or its phase advance exceeds representability/capacity before stride enumeration.

      For unsupported actual geometry/carriage or foot goals whose four fixed chains and body-floor constraint have no common root height.