Struct Simulation 

pub struct Simulation { /* private fields */ }

A cloneable in-process controller for one Incular application window.

Calls block until the application’s UI thread services the command. Use this handle from a test/automation thread, not from an application build or event callback, because those already run on the UI thread.

Implementations

impl Simulation

pub fn window(&self, handle: &WindowHandle) -> Self

Returns a controller targeting the window represented by handle.

pub fn for_window(&self, window_id: WindowId) -> Self

Returns a controller targeting a known Incular window ID.

pub const fn window_id(&self) -> WindowId

pub fn mouse(&self) -> SimulationMouse

Returns the mouse command group for this window.

pub fn keyboard(&self) -> SimulationKeyboard

Returns the keyboard command group for this window.

pub fn click(&self, label: impl Into<String>) -> Result<(), SimulationError>

Clicks the first enabled semantic node whose label exactly matches label, using move → down → up through the ordinary pointer pipeline.

pub fn click_at(&self, position: Offset) -> Result<(), SimulationError>

Clicks at position in logical pixels; the same as Self::click_logical. Use Self::click_physical for a point read off a Self::capture screenshot.

pub fn click_logical(&self, position: Offset) -> Result<(), SimulationError>

Clicks at position in logical pixels, the space layout bounds and widget sizes use.

pub fn click_physical(&self, position: Offset) -> Result<(), SimulationError>

Clicks at position in physical pixels, the space of Self::capture screenshots. The runtime divides it by the window’s current scale factor before dispatch.

pub fn click_in( &self, position: Offset, space: PointSpace, ) -> Result<(), SimulationError>

Clicks at position in the given coordinate space.

pub fn scale_factor(&self) -> Result<f64, SimulationError>

The window’s current scale factor: physical pixels per logical pixel. Divide a screenshot point by it to get the logical point.

pub fn focus(&self, label: impl Into<String>) -> Result<(), SimulationError>

Gives keyboard focus to the first enabled semantic node whose label exactly matches label; a text field also matches by its placeholder. Focusable nodes take focus through their semantic focus action (no pointer event, so no tap side effects); anything else is clicked at its center, as a user would to focus it.

pub fn type_into( &self, label: impl Into<String>, text: impl Into<String>, ) -> Result<(), SimulationError>

Focuses the field labeled label (see Self::focus) and types text into it at the caret. Self::type_text alone delivers text only to an already focused field.

pub fn move_mouse_to(&self, position: Offset) -> Result<(), SimulationError>

pub fn scroll(&self, delta: Offset) -> Result<(), SimulationError>

pub fn key_down(&self, code: Code) -> Result<(), SimulationError>

pub fn key_up(&self, code: Code) -> Result<(), SimulationError>

pub fn press(&self, code: Code) -> Result<(), SimulationError>

pub fn press_key( &self, key: KeyboardKey, code: Code, ) -> Result<(), SimulationError>

pub fn type_text(&self, text: impl Into<String>) -> Result<(), SimulationError>

pub fn wait_for_frame(&self) -> Result<(), SimulationError>

Waits until the next frame for this window has been presented.

pub fn capture(&self) -> Result<Screenshot, SimulationError>

Requests and returns the next rendered frame for this window.

The screenshot is in physical pixels. Click a point read off it with Self::click_physical, or convert it with Self::scale_factor.

pub fn query_gpu_resources(&self) -> Result<GpuResourceSummary, SimulationError>

Reads the current GPU residency snapshot for this window’s device without presenting a frame. Resolves once the native adapter’s maintenance path fulfills it from current state.

pub fn release_all_keys(&self) -> Result<(), SimulationError>

Releases every modifier/key held by this simulation keyboard.

Trait Implementations

impl Clone for Simulation

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.