Struct LayoutResult

pub struct LayoutResult {
    pub size: Size,
    pub children: Vec<ChildLayout>,
    pub paint_bounds: Rect,
    pub visual_bounds: Rect,
    pub overlay_hit_bounds: Vec<Rect>,
    pub clip: Option<ClipShape>,
    pub is_window_root_clip: bool,
    pub artifact: Option<LayoutArtifact>,
}

Layout output for one element: geometry, child placement, clipping, and an artifact.

Rectangles use element-local logical pixels unless a field states otherwise. children is positional: entry n describes retained child n. An empty vector means that no direct child was laid out. No constructor validates finite or non-negative geometry.

Examples

use ailloli_ui_core::{Rect, Size};
use ailloli_ui_runtime::layout::LayoutResult;

let mut result = LayoutResult::empty();
result.size = Size::new(80.0, 24.0);
result.paint_bounds = Rect::new(0.0, 0.0, 80.0, 24.0);
assert_eq!(result.children.len(), 0);

Fields

size: Size

Element size in logical pixels.

children: Vec<ChildLayout>

Direct-child geometry, in the same order as the retained children.

paint_bounds: Rect

Element-local region that may receive draw commands.

visual_bounds: Rect

Element-local region containing paint plus visual effects such as shadows.

overlay_hit_bounds: Vec<Rect>

Extra local hit-test regions for top-level overlays owned by this widget.

These rects do not affect layout, paint bounds, visual bounds, or parent clipping. The input router translates them to absolute coordinates and checks them before normal tree hit-testing.

clip: Option<ClipShape>

Optional element-local clip; None means this result introduces no clip.

is_window_root_clip: bool

Window root clip (Window::radius + clip_children on the surface wrapper).

artifact: Option<LayoutArtifact>

Optional reusable layout data; None means paint must not expect an artifact.

Implementations

impl LayoutResult

Provides the operations defined for LayoutResult.

pub fn empty() -> Self

Returns a zero-sized result with no children, clips, overlays, or artifact.

Both bounds are (0, 0, 0, 0) and is_window_root_clip is false.

Examples

use ailloli_ui_core::Size;
use ailloli_ui_runtime::layout::LayoutResult;

let result = LayoutResult::empty();
assert_eq!(result.size, Size::default());
assert!(result.children.is_empty() && result.artifact.is_none());

pub fn zero() -> Self

Alias for Self::empty.

Examples

use ailloli_ui_runtime::layout::LayoutResult;

let result = LayoutResult::zero();
assert_eq!(result.paint_bounds.w, 0.0);

Trait Implementations

impl Clone for LayoutResult

fn clone(&self) -> LayoutResult

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for LayoutResult

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

Formats the value using the given formatter.