Enum ClipShape

Source

pub enum ClipShape {
    Rect(Rect),
    RoundRect {
        rect: Rect,
        radius: f32,
    },
}

Expand description

Axis-aligned or rounded clip region in local coordinates.

Possible values are ClipShape::Rect and ClipShape::RoundRect.

§Examples

use ailloli_ui_core::{ClipShape, Rect};
assert!(ClipShape::rect(Rect::new(0.0, 0.0, 10.0, 10.0)).contains_point(5.0, 5.0));

Variants§

§

Rect(Rect)

Axis-aligned rectangle.

§

RoundRect

Rounded rectangle with uniform corner radius.

Fields

§rect: Rect

Axis-aligned outer bounds in local logical pixels.

§radius: f32

Requested uniform radius in logical pixels.

Hit-testing clamps this to a non-negative half-extent, but the stored value itself is not normalized.

Implementations§

Source §

impl ClipShape

Source

pub fn rect(r: Rect) -> Self

Creates a rectangular clip.

§Examples

use ailloli_ui_core::{ClipShape, Rect};
let rect = Rect::new(0.0, 0.0, 10.0, 10.0);
assert_eq!(ClipShape::rect(rect).bounding_rect(), rect);

Source

pub fn round_rect(rect: Rect, radius: f32) -> Self

Creates a rounded-rect clip without normalizing its radius or bounds.

§Examples

use ailloli_ui_core::{ClipShape, Rect};
assert!(matches!(ClipShape::round_rect(Rect::new(0.0, 0.0, 10.0, 10.0), 2.0), ClipShape::RoundRect { .. }));

Source

pub fn bounding_rect(&self) -> Rect

Tight axis-aligned bounds of this clip (ignores corner cut-outs for RoundRect).

§Examples

use ailloli_ui_core::{ClipShape, Rect};
let rect = Rect::new(1.0, 2.0, 3.0, 4.0);
assert_eq!(ClipShape::round_rect(rect, 2.0).bounding_rect(), rect);

Source

pub fn contains_point(&self, px: f32, py: f32) -> bool

Hit-test in local clip space (same coordinate system as rect).

§Examples

use ailloli_ui_core::{ClipShape, Rect};
assert!(!ClipShape::round_rect(Rect::new(0.0, 0.0, 10.0, 10.0), 5.0).contains_point(0.0, 0.0));

Source

pub fn intersect(&self, other: &Self) -> Option<Self>

Returns a conservative rectangular intersection of two clips.

A rounded result keeps the rounded operand’s radius, or the minimum radius when both operands are rounded. This is not an exact geometric intersection of corner arcs; it is a compact clip approximation. Zero- area edge contact returns None through Rect::intersection.

§Examples

use ailloli_ui_core::{ClipShape, Rect};
let a = ClipShape::rect(Rect::new(0.0, 0.0, 10.0, 10.0));
let b = ClipShape::rect(Rect::new(5.0, 5.0, 10.0, 10.0));
assert_eq!(a.intersect(&b).unwrap().bounding_rect(), Rect::new(5.0, 5.0, 5.0, 5.0));