Struct TimerCallbackInfo 

#[repr(C)]
pub struct TimerCallbackInfo {
    pub callback_info: CallbackInfo,
    pub node_id: OptionDomNodeId,
    pub frame_start: Instant,
    pub call_count: usize,
    pub is_about_to_finish: bool,
    pub _abi_ref: *const c_void,
    pub _abi_mut: *mut c_void,
}

Information passed to timer callbacks.

This wraps CallbackInfo and adds timer-specific fields like call_count and frame_start. CallbackInfo methods are available via explicit delegation methods below.

Fields

callback_info: CallbackInfo

node_id: OptionDomNodeId

frame_start: Instant

call_count: usize

is_about_to_finish: bool

_abi_ref: *const c_void

_abi_mut: *mut c_void

Implementations

impl TimerCallbackInfo

pub fn create( callback_info: CallbackInfo, node_id: OptionDomNodeId, frame_start: Instant, call_count: usize, is_about_to_finish: bool, ) -> Self

pub fn get_attached_node_size(&self) -> Option<LogicalSize>

pub fn get_attached_node_position(&self) -> Option<LogicalPosition>

pub fn get_callback_info(&self) -> &CallbackInfo

pub fn get_callback_info_mut(&mut self) -> &mut CallbackInfo

pub fn get_ctx(&self) -> OptionRefAny

Get the callable for FFI language bindings (Python, etc.)

pub fn add_timer(&mut self, timer_id: TimerId, timer: Timer)

Add a timer to this window (applied after callback returns)

pub fn remove_timer(&mut self, timer_id: TimerId)

Remove a timer from this window (applied after callback returns)

pub fn add_thread(&mut self, thread_id: ThreadId, thread: Thread)

Add a thread to this window (applied after callback returns)

pub fn remove_thread(&mut self, thread_id: ThreadId)

Remove a thread from this window (applied after callback returns)

pub fn stop_propagation(&mut self)

Stop event propagation (applied after callback returns)

pub fn create_window(&mut self, options: WindowCreateOptions)

Create a new window (applied after callback returns)

pub fn close_window(&mut self)

Close the current window (applied after callback returns)

pub fn modify_window_state(&mut self, state: FullWindowState)

Modify the window state (applied after callback returns)

pub fn add_image_to_cache(&mut self, id: AzString, image: ImageRef)

Add an image to the image cache (applied after callback returns)

pub fn remove_image_from_cache(&mut self, id: AzString)

Remove an image from the image cache (applied after callback returns)

pub fn update_all_image_callbacks(&mut self)

Re-render ALL image callbacks across all DOMs (applied after callback returns)

This is the most efficient way to update animated GL textures from a timer. Triggers only texture re-rendering - no DOM rebuild or display list resubmission.

pub fn trigger_virtual_view_rerender(&mut self, dom_id: DomId, node_id: NodeId)

Trigger re-rendering of a VirtualView (applied after callback returns)

pub fn reload_system_fonts(&mut self)

Reload system fonts (applied after callback returns)

pub fn prevent_default(&mut self)

Prevent the default action

pub fn open_menu(&mut self, menu: Menu)

Open a menu

pub fn open_menu_at(&mut self, menu: Menu, position: LogicalPosition)

Open a menu at a specific position

pub fn show_tooltip(&mut self, text: AzString)

Show a tooltip at the current cursor position

pub fn show_tooltip_at(&mut self, text: AzString, position: LogicalPosition)

Show a tooltip at a specific position

pub fn hide_tooltip(&mut self)

Hide the currently displayed tooltip

pub fn open_menu_for_hit_node(&mut self, menu: Menu) -> bool

Open a menu positioned relative to the currently hit node

pub fn get_current_window_flags(&self) -> WindowFlags

Get current window flags

pub fn get_current_keyboard_state(&self) -> KeyboardState

Get current keyboard state

pub fn get_current_mouse_state(&self) -> MouseState

Get current mouse state

pub fn get_cursor_relative_to_node(&self) -> OptionCursorNodePosition

Get the cursor position relative to the hit node

pub fn get_cursor_relative_to_viewport(&self) -> OptionLogicalPosition

Get the cursor position relative to the viewport

pub fn get_cursor_position(&self) -> Option<LogicalPosition>

Get the current cursor position

pub fn get_current_time(&self) -> Instant

Get the current time (when the timer callback started)

pub fn is_dom_focused(&self) -> bool

Check if the DOM is focused

pub fn is_pen_in_contact(&self) -> bool

Check if pen is in contact

pub fn is_pen_eraser(&self) -> bool

Check if pen eraser is active

pub fn is_pen_barrel_button_pressed(&self) -> bool

Check if pen barrel button is pressed

pub fn is_dragging(&self) -> bool

Check if dragging is active

pub fn is_drag_active(&self) -> bool

Check if drag is active

pub fn is_node_drag_active(&self) -> bool

Check if node drag is active

pub fn is_file_drag_active(&self) -> bool

Check if file drag is active

pub fn has_sufficient_history_for_gestures(&self) -> bool

Check if there’s sufficient history for gestures

pub fn get_scroll_node_info( &self, dom_id: DomId, node_id: NodeId, ) -> Option<ScrollNodeInfo>

Get a read-only snapshot of a scroll node’s bounds and position.

Timer callbacks use this to read current scroll state for physics calculation.

pub fn find_scroll_parent( &self, dom_id: DomId, node_id: NodeId, ) -> Option<NodeId>

Find the closest scrollable ancestor of a node.

Used by auto-scroll timer to find which container to scroll when the user drags beyond the container edge.

pub fn get_scroll_input_queue(&self) -> ScrollInputQueue

Get the scroll input queue for consuming pending scroll inputs.

The physics timer calls take_all() each tick to drain inputs recorded by platform event handlers.

pub fn scroll_to( &mut self, dom_id: DomId, node_id: NodeHierarchyItemId, position: LogicalPosition, )

Scroll a node to a specific position (via transactional CallbackChange).

This is the primary way for timer callbacks to update scroll positions. The change is applied after the callback returns.

pub fn scroll_to_unclamped( &mut self, dom_id: DomId, node_id: NodeHierarchyItemId, position: LogicalPosition, )

Scroll to position without clamping (for rubber-banding/overscroll).

pub fn set_cursor_visibility(&mut self, visible: bool)

Set cursor visibility state (for cursor blink timer)

pub fn set_cursor_visibility_toggle(&mut self)

Toggle cursor visibility (for cursor blink timer).

NOTE: Currently always sets visibility to true — proper toggle logic requires a CallbackChange::ToggleCursorVisibility variant or reading current state, which is not yet implemented.

pub fn reset_cursor_blink(&mut self)

Reset cursor blink state on user input

Trait Implementations

impl Clone for TimerCallbackInfo

fn clone(&self) -> TimerCallbackInfo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.