Method begin

src/lib.rs:554–868

Starts a new frame, returning a [`Ui`] handle for building the element tree.

(
        &mut self,
    )

    /// Starts a new frame, returning a [`Ui`] handle for building the element tree.
    pub fn begin(
        &mut self,
    ) -> Ui<'_, CustomElementData> {
        jobs::poll_completions();

        if !self.headless {
            self.context.set_layout_dimensions(Dimensions::new(
                macroquad::prelude::screen_width(),
                macroquad::prelude::screen_height(),
            ));

            // Update timing
            self.context.current_time = macroquad::prelude::get_time();
            self.context.frame_delta_time = macroquad::prelude::get_frame_time();
        }

        // Update blink timers for text inputs
        self.context.update_text_input_blink_timers();

        // Auto-update pointer state from macroquad
        if !self.headless {
            let (mx, my) = macroquad::prelude::mouse_position();
            let is_down = macroquad::prelude::is_mouse_button_down(
                macroquad::prelude::MouseButton::Left,
            );

            // Check shift state for text input click-to-cursor
            // Must happen AFTER set_pointer_state, since that's what creates pending_text_click.
            self.context.set_pointer_state(Vector2::new(mx, my), is_down);

            {
                use macroquad::prelude::{is_key_down, KeyCode};
                let shift = is_key_down(KeyCode::LeftShift) || is_key_down(KeyCode::RightShift);
                if shift {
                    // If shift is held and there's a pending text click, update it
                    if let Some(ref mut pending) = self.context.pending_text_click {
                        pending.3 = true;
                    }
                }
            }

            let (scroll_x, scroll_y) = macroquad::prelude::mouse_wheel();
            #[cfg(target_arch = "wasm32")]
            const SCROLL_SPEED: f32 = 1.0;
            #[cfg(not(target_arch = "wasm32"))]
            const SCROLL_SPEED: f32 = 20.0;
            // Shift+scroll wheel swaps vertical to horizontal scrolling
            let scroll_shift = {
                use macroquad::prelude::{is_key_down, KeyCode};
                is_key_down(KeyCode::LeftShift) || is_key_down(KeyCode::RightShift)
            };
            let scroll_delta = if scroll_shift {
                // Shift held: vertical scroll becomes horizontal
                Vector2::new(
                    (scroll_x + scroll_y) * SCROLL_SPEED,
                    0.0,
                )
            } else {