Struct FakeDesktop 

pub struct FakeDesktop { /* private fields */ }

Observable, cloneable fake desktop backed by a HashMap.

Implementations

impl FakeDesktop

pub fn real_icons_visible(&self) -> bool

pub fn new() -> Self

pub fn add_icon(&self, snap: IconSnapshot)

Add or replace an icon.

pub fn remove_icon(&self, id: &IconId) -> bool

Remove an icon (simulates the user deleting it while an animation is running).

pub fn icon_count(&self) -> usize

pub fn position_of(&self, id: &IconId) -> Option<Point>

Look up the current position of one icon.

pub fn flags(&self) -> u32

Current folder-view flags.

pub fn commit_log(&self) -> Vec<Vec<(IconId, Point)>>

Take a copy of the commit log so far. Does not clear it.

pub fn flag_ops(&self) -> Vec<(u32, u32)>

Take a copy of the flag-op log so far.

pub fn set_next_list_error(&self, err: DesktopError)

Cause the next list_icons call to fail with this error.

pub fn set_monitors(&self, monitors: Vec<MonitorInfo>)

Replace the simulated monitor layout. Useful for testing multi-monitor placement without needing a real second display.

pub fn set_desktop_info(&self, desktop: DesktopInfo)

pub fn set_next_overlay_error(&self, err: DesktopError)

Cause the next begin_overlay_session call to fail with this error. Used by tests to exercise the engine’s overlay-unavailable fallback path.

pub fn overlay_active(&self) -> bool

Whether an overlay session is currently open.

pub fn last_overlay_plans(&self) -> Vec<IconRenderPlan>

Snapshot of the plans handed to the most recent successful begin_overlay_session call.

pub fn last_overlay_render_options(&self) -> OverlayRenderOptions

Snapshot of the render options handed to the most recent successful begin_overlay_session call. Defaults to all_enabled before any session has opened.

pub fn overlay_frame_log(&self) -> Vec<Vec<(IconId, Point)>>

Snapshot of every commit_overlay_frame call in order.

pub fn visual_frame_log(&self) -> Vec<Vec<IconFrame>>

pub fn overlay_finalize_log(&self) -> Vec<Vec<(IconId, Point)>>

Snapshot of every finalize_overlay_session call in order.

pub fn queue_commit_error(&self, err: DesktopError)

Queue an error to be returned from the next commit_overlay_frame call. Multiple queued errors are consumed in FIFO order.

Useful for exercising the engine’s DesktopError::OverlayCancelled path from tests.

Trait Implementations

impl Clone for FakeDesktop

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FakeDesktop

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FakeDesktop

fn default() -> Self

Returns the “default value” for a type.

impl DesktopBackend for FakeDesktop

fn list_icons(&mut self) -> Result<Vec<IconSnapshot>, DesktopError>

fn get_flags(&mut self) -> Result<u32, DesktopError>

fn apply_flags(&mut self, mask: u32, values: u32) -> Result<(), DesktopError>

fn set_positions( &mut self, moves: &[(IconId, Point)], ) -> Result<Vec<IconId>, DesktopError>

Commit a batch of (id, new_position) moves. Returns the ids the backend could not resolve (i.e. icons that vanished or were never on the desktop).

fn list_monitors(&mut self) -> Result<Vec<MonitorInfo>, DesktopError>

Enumerate every connected display. Bounds are reported in the same virtual-screen coordinate system used by list_icons and set_positions.

fn desktop_info( &mut self, _icons: &[IconSnapshot], ) -> Result<DesktopInfo, DesktopError>

Query live display/grid metrics using the worker’s current icon snapshot. Must not reposition icons or change folder flags.

fn begin_overlay_session( &mut self, plans: &[IconRenderPlan], render_options: OverlayRenderOptions, ) -> Result<(), DesktopError>

Prepare an overlay animation session covering the icons in plans.

fn commit_overlay_frame( &mut self, positions: &[(IconId, Point)], ) -> Result<(), DesktopError>

Update the overlay’s rendered icon positions to positions.

fn discard_overlay_session(&mut self)

Discard a prepared, never-started session without touching Shell positions.

fn commit_visual_frame( &mut self, frame: &[IconFrame], ) -> Result<(), DesktopError>

Commit positions and visual clocks together. Non-GPU backends ignore visuals.

fn poll_overlay_session(&mut self) -> Result<(), DesktopError>

fn set_real_icons_visible(&mut self, visible: bool) -> Result<(), DesktopError>

fn finalize_overlay_session( &mut self, final_positions: &[(IconId, Point)], ) -> Result<FinalCommitOutcome, DesktopError>

End the animation session and commit the final positions to the Shell.

fn validate_prepared_session(&mut self) -> Result<(), DesktopError>

Reject a prepared snapshot invalidated by environment changes, before any Shell writes.

fn prepare_scene_renderer( &mut self, _canvas: Canvas, _plans: &[IconRenderPlan], _options: OverlayRenderOptions, ) -> Result<Box<dyn SceneRenderer>, DesktopError>

fn capture_overlay( &mut self, _seconds: f64, ) -> Result<CapturedFrame, DesktopError>

fn render_overlay_snapshot( &mut self, width_px: u32, height_px: u32, dpi_scale: f32, positions: &[(IconId, Point)], render_options: OverlayRenderOptions, ) -> Result<SnapshotFrame, DesktopError>

Render one frame of the overlay off-screen and return the raw pixels — never touches an HWND, DirectComposition target, or the real desktop. Safe to call at any time, including while a begin_overlay_session is active on another animation.