hakowork/vide
3
0
Fork 0
mirror of https://github.com/centau/vide.git synced 2026-08-20 14:41:37 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
vide/docs/api/animation.md
Aaron Smith 8ef2d0b190 Update spring solver
2023-08-24 18:09:40 +01:00

1.1 KiB
Raw Blame History

Animation API

spring()

Returns a new source with a dynamically animated value of the input source.

  • Type

    function spring<T>(
    source: () -> T & Animatable,
    period: number = 1,
    damping_ratio: number = 1
): () -> T

type Animatable = number | CFrame | Color3 | UDim | UDim2 | Vector2 | Vector3

  • Details

    The output source value is updated every frame based on the input source value.

    The output is physically simulated according to a spring.

    period is the amount of time in seconds it takes for the spring to complete one full oscillation.

    damping_ratio is the amount of resistance applied to the spring.

    • >1 = Overdamped - slowly reaches target without any overshoot.
    • 1 = Critically damped - reaches target without any overshoot.
    • <1 = Underdamped - reaches target with some overshoot.
    • 0 = Undamped - never stabilizes, oscillates forever.

    Velocity is conserved between source updates for smooth animation.