Struct PlatformWindow 

pub struct PlatformWindow { /* private fields */ }

A platform window wrapping a winit window, wgpu surface, renderer, and AccessKit adapter for screen reader support.

Implementations

impl PlatformWindow

pub async fn new_with_a11y(window: Window, event_loop: &ActiveEventLoop) -> Self

Create a new platform window from a winit window. The event_loop parameter is needed for the AccessKit adapter.

pub async fn new(window: Window) -> Self

Create a platform window without AccessKit (for contexts without ActiveEventLoop).

pub fn window(&self) -> &Window

pub fn window_arc(&self) -> Arc<Window>

Get a clonable Arc reference to the underlying winit window. Used by teksilo_platform::create_title_bar_host and other components that need shared ownership of the window.

pub fn renderer(&self) -> &Renderer

pub fn renderer_mut(&mut self) -> &mut Renderer

pub fn scale_factor(&self) -> f64

pub fn set_scale_factor(&mut self, factor: f64)

pub fn resize(&mut self, new_size: PhysicalSize<u32>)

Resize the surface.

A resize that arrives once the display server has gone is dropped: there is nothing left to present to.

pub fn surface_size(&self) -> (u32, u32)

Get current surface dimensions.

pub fn reconfigure_surface(&mut self) -> bool

Reconfigure the surface with the current config. Use after a Lost or Outdated surface error.

Answers whether this window can still present. false means the display server is gone, and the caller should wind down rather than ask for another frame: the next one would come back here unchanged.

pub fn display_lost(&self) -> bool

Whether the display server has gone away under this window.

pub fn render_frame( &mut self, frame: &RenderFrame, clear_color: [f32; 4], ) -> FrameOutcome

Render a frame to the surface.

pub fn capture_offscreen( &mut self, frame: &RenderFrame, clear_color: [f32; 4], crop: Option<Rect>, ) -> (Vec<u8>, u32, u32)

Render frame into an offscreen texture and read it back as tightly-packed RGBA8 bytes, returning (rgba, width, height).

Used by the debug-only automation bridge to capture a live window without going through the swapchain — the surface texture is configured RENDER_ATTACHMENT only (no COPY_SRC), so it can’t be read back directly. The offscreen texture uses the window’s own surface format so it matches the renderer’s pipelines; a BGRA readback is swizzled to RGBA here so the output is always RGBA. With crop = Some(rect) (physical pixels, clamped to the surface) only that sub-rectangle is returned. Returns an empty (vec, 0, 0) if the crop is fully outside the surface.

Note: a native WebView subview composites on top of the wgpu surface and is invisible to this readback (a transparent hole).

pub fn request_redraw(&self)

pub fn update_accessibility(&mut self, update: TreeUpdate)

Push an AccessKit TreeUpdate to the adapter (called after layout). Publish a freshly built TreeUpdate to the adapter, and leave a copy where the activation handler can find it.

The copy is what lets an assistive technology that attaches to an idle window see the application instead of an empty window node: the handler runs off the UI thread and cannot build a tree, so the last one the UI thread built is the best answer available synchronously.

pub fn update_accessibility_with( &mut self, build: impl FnOnce() -> Option<TreeUpdate>, previous: impl FnOnce() -> TreeUpdate, )

Push an update the adapter builds only when it is actually going to be delivered, and only when build says there is one worth sending.

The caller decides inside the closure, because that is where the decision belongs: update_if_active runs its closure only when an assistive technology is attached, and on Linux it runs it under the adapter’s own state lock. Deciding outside would build a tree for nobody on every frame, and would make the throttle count frames nothing was listening to.

build returning None means “nothing to deliver”; the previously delivered tree is re-sent, which the consumer treats as a no-op.

pub fn accessibility_needs_full_tree(&self) -> bool

Whether an assistive technology has asked this window for its tree and has not yet been given a full one.

Set by the activation handler, which runs on whichever thread the platform’s accessibility layer calls it from, and cleared by the first delivery after it — so a reader that attaches mid-session gets a complete tree rather than a geometry patch onto a tree it has never seen.

pub fn take_accessibility_needs_full_tree(&self) -> bool

Clear the flag above, reporting what it was.

pub fn accessibility_active(&self) -> bool

Whether an AccessKit client is attached to this window’s adapter.

True from the moment the platform accessibility stack asks for an initial tree until it says it has gone away. Read once per frame by teksilo-app and pushed into the window’s tree; see WidgetTree::set_at_client_attached for why attaching and detaching are read asymmetrically.

Always false for a window built without an adapter (PlatformWindow::new).

pub fn process_accessibility_event(&mut self, event: &WindowEvent)

Forward a winit WindowEvent to the AccessKit adapter.

pub fn drain_accessibility_actions(&self) -> Vec<ActionRequest>

Drain any pending AccessKit action requests from the adapter.