Struct pax_runtime::engine::PaxEngine

pub struct PaxEngine {
    pub runtime_context: RuntimeContext,
    pub root_node: Rc<ExpandedNode>,
    pub z_index_node_cache: Vec<Rc<ExpandedNode>>,
}

Singleton struct storing everything related to properties computation & rendering

Fields

runtime_context: RuntimeContext

root_node: Rc<ExpandedNode>

z_index_node_cache: Vec<Rc<ExpandedNode>>

Implementations

impl PaxEngine

Central instance of the PaxEngine and runtime, intended to be created by a particular chassis. Contains all rendering and runtime logic.

pub fn new( main_component_instance: Rc<ComponentInstance>, expression_table: ExpressionTable, logger: PlatformSpecificLogger, viewport_size: (f64, f64) ) -> Self

pub fn tick(&mut self) -> Vec<NativeMessage>

Workhorse methods of every tick. Will be executed up to 240 Hz. Three phases:

1. Expand nodes & compute properties; recurse entire instance tree and evaluate ExpandedNodes, stitching together parent/child relationships between ExpandedNodes along the way.
2. Compute layout (z-index & TransformAndBounds) by visiting ExpandedNode tree in rendering order, writing computed rendering-specific values to ExpandedNodes
3. Render: a. find lowest node (last child of last node) b. start rendering, from lowest node on-up, throughout tree

pub fn render(&mut self, rcs: &mut dyn RenderContext)

pub fn get_topmost_element_beneath_ray( &self, ray: (f64, f64) ) -> Option<Rc<ExpandedNode>>

Simple 2D raycasting: the coordinates of the ray represent a ray running orthogonally to the view plane, intersecting at the specified point ray. Areas outside of clipping bounds will not register a hit, nor will elements that suppress input events.

pub fn get_expanded_node(&self, id: u32) -> Option<&Rc<ExpandedNode>>

pub fn get_focused_element(&self) -> Option<Rc<ExpandedNode>>

pub fn set_viewport_size(&mut self, new_viewport_size: (f64, f64))

Called by chassis when viewport size changes, e.g. with native window resizes