Raxol.Animation.Gestures (Raxol v2.0.1)

View Source

Refactored gesture-driven interactions with GenServer-based state management.

This module provides the same gesture detection and animation functionality as the original but uses supervised state management instead of Process dictionary.

Migration Notes

Gesture state tracking has been moved to Animation.Gestures.Server, eliminating Process dictionary usage while maintaining full functionality.

Summary

Types

direction()
gesture_type()
handler()
position()

Functions

active?()

Checks if any gestures are currently active.

animation_info()

Gets information about active animations.

clear_handlers()

Clears all gesture handlers.

current_velocity()

Gets the current velocity of active gesture.

direction(arg1, arg2)

Calculates the direction from one position to another.

distance(arg1, arg2)

Calculates the distance between two positions.

get_animation_objects()

Gets all animation objects for rendering.

get_state()

Gets the current gesture state.

init()

Initializes the gesture system.

register_handler(gesture_type, handler)

Registers a handler for a specific gesture type.

register_handlers(handler_map)

Registers multiple handlers at once.

simulate_long_press(position, duration_ms \\ 600)

Simulates a long press gesture for testing.

simulate_swipe(start_pos, end_pos, duration_ms \\ 200)

Simulates a gesture sequence for testing.

simulate_tap(position, duration_ms \\ 50)

Simulates a tap gesture for testing.

touch_down(position, time \\ System.monotonic_time(:millisecond))

Handles a touch/mouse down event.

touch_move(position, time \\ System.monotonic_time(:millisecond))

Handles a touch/mouse move event.

touch_up(position, time \\ System.monotonic_time(:millisecond))

Handles a touch/mouse up event.

update_animations(delta_time \\ nil)

Updates all active animations.

velocity(arg1, arg2, time_diff_ms)

Calculates velocity between two positions over time.

Types

direction()

@type direction() :: :up | :down | :left | :right

gesture_type()

@type gesture_type() :: :swipe | :tap | :long_press | :drag | :pinch | :multi_tap

handler()

@type handler() :: (map() -> any())

position()

@type position() :: {integer(), integer()}

Functions

active?()

Checks if any gestures are currently active.

animation_info()

Gets information about active animations.

clear_handlers()

Clears all gesture handlers.

current_velocity()

Gets the current velocity of active gesture.

direction(arg1, arg2)

Calculates the direction from one position to another.

distance(arg1, arg2)

Calculates the distance between two positions.

get_animation_objects()

Gets all animation objects for rendering.

get_state()

Gets the current gesture state.

init()

Initializes the gesture system.

register_handler(gesture_type, handler)

Registers a handler for a specific gesture type.

Examples

iex> register_handler(:swipe, fn %{direction: :left} -> handle_left_swipe() end)
:ok

register_handlers(handler_map)

Registers multiple handlers at once.

Examples

iex> register_handlers(%{
...>   swipe: fn data -> handle_swipe(data) end,
...>   tap: fn data -> handle_tap(data) end
...> })
:ok

simulate_long_press(position, duration_ms \\ 600)

Simulates a long press gesture for testing.

simulate_swipe(start_pos, end_pos, duration_ms \\ 200)

Simulates a gesture sequence for testing.

Examples

iex> simulate_swipe({10, 10}, {50, 10}, 200)
:ok

simulate_tap(position, duration_ms \\ 50)

Simulates a tap gesture for testing.

touch_down(position, time \\ System.monotonic_time(:millisecond))

Handles a touch/mouse down event.

touch_move(position, time \\ System.monotonic_time(:millisecond))

Handles a touch/mouse move event.

touch_up(position, time \\ System.monotonic_time(:millisecond))

Handles a touch/mouse up event.

update_animations(delta_time \\ nil)

Updates all active animations.

velocity(arg1, arg2, time_diff_ms)

Calculates velocity between two positions over time.