FloUI.Scrollable.Acceleration (FloUI v0.1.0-alpha.6) View Source

Module for calculating the scroll speed for Scenic.Scrollable components.

Link to this section Summary

Types

Data structure containing settings that define the behaviour of the Scenic.Scrollable components scroll speed and acceleration. Note that the Scenic.Scrollable content may not be able to move when the acceleration is set too low, or the mass and counter_pressure are set too high.

t()

Data structure with the necessary values to calculate the current scroll speed.

v2()

Shorthand for Scenic.Math.vector_2/0. Consists of a tuple containing the x and y numeric values.

Functions

apply_counter_pressure(state)

Apply counter pressure to the current Scenic.Scrollable comonents movement. The counter pressures strength is calculated based on the Scenic.Scrollable components current speed, the components mass set during initialization, and the counter pressure value set during initialization.

apply_force(state, force)

Apply force in the specified direction to make the Scenic.Scrollable component move.

init(settings)

Initializes a t:Scenic.Scrollable.Acceleration.t state object based on the passed t:Scenic.Scrollable.Acceleration.settings/0. When nil is passed, the default settings will be used.

is_stationary?(arg1)

Find out if the Scenic.Scrollable component is currently stationary.

set_speed(state, speed)

Directly update the speed of the Scenic.Scrollable components scroll movement, to make it move at a certain velocity in the given direction.

translate(map, position)

Calculate the translation of a point based on the current speed.

Link to this section Types

settings()

Specs

settings() :: %{
  optional(:acceleration) => number(),
  optional(:mass) => number(),
  optional(:counter_pressure) => number()
}

Default settings:

acceleration: 20
mass: 1
counter_pressure: 0.1

t()

Specs

t() :: %{
  acceleration: number(),
  mass: number(),
  counter_pressure: number(),
  force: v2(),
  speed: v2()
}

Data structure with the necessary values to calculate the current scroll speed.

v2()

Specs

v2() :: Scenic.Math.vector_2()

Shorthand for Scenic.Math.vector_2/0. Consists of a tuple containing the x and y numeric values.

Link to this section Functions

apply_counter_pressure(state)

Specs

apply_counter_pressure(t()) :: t()

apply_force(state, force)

Specs

apply_force(t(), v2()) :: t()

Apply force in the specified direction to make the Scenic.Scrollable component move.

init(settings)

Specs

init(settings()) :: t()

Initializes a t:Scenic.Scrollable.Acceleration.t state object based on the passed t:Scenic.Scrollable.Acceleration.settings/0. When nil is passed, the default settings will be used.

is_stationary?(arg1)

Specs

is_stationary?(t()) :: boolean()

Find out if the Scenic.Scrollable component is currently stationary.

set_speed(state, speed)

Specs

set_speed(t(), v2()) :: t()

Directly update the speed of the Scenic.Scrollable components scroll movement, to make it move at a certain velocity in the given direction.

translate(map, position)

Specs

translate(t(), v2()) :: v2()

Calculate the translation of a point based on the current speed.