Struct tiny_skia::Rect

pub struct Rect { /* private fields */ }

A rectangle defined by left, top, right and bottom edges.

Can have zero width and/or height. But not a negative one.

Guarantees

• All values are finite.
• Left edge is <= right.
• Top edge is <= bottom.
• Width and height are <= f32::MAX.

Implementations

impl Rect

pub fn from_ltrb(left: f32, top: f32, right: f32, bottom: f32) -> Option<Rect>

Creates new Rect.

Examples found in repository

examples/image_on_image.rs (line 52)

fn create_triangle() -> Pixmap {
    let mut paint = Paint::default();
    paint.set_color_rgba8(50, 127, 150, 200);
    paint.anti_alias = true;

    let mut pb = PathBuilder::new();
    pb.move_to(0.0, 200.0);
    pb.line_to(200.0, 200.0);
    pb.line_to(100.0, 0.0);
    pb.close();
    let path = pb.finish().unwrap();

    let mut pixmap = Pixmap::new(200, 200).unwrap();

    pixmap.fill_path(
        &path,
        &paint,
        FillRule::Winding,
        Transform::identity(),
        None,
    );

    let path = PathBuilder::from_rect(Rect::from_ltrb(0.0, 0.0, 200.0, 200.0).unwrap());
    let stroke = Stroke::default();
    paint.set_color_rgba8(200, 0, 0, 220);

    pixmap.stroke_path(&path, &paint, &stroke, Transform::identity(), None); // TODO: stroke_rect

    pixmap
}

pub fn from_xywh(x: f32, y: f32, w: f32, h: f32) -> Option<Rect>

Creates new Rect.

Examples found in repository

examples/mask.rs (line 24)

fn main() {
    let clip_path = {
        let mut pb = PathBuilder::new();
        pb.push_circle(250.0, 250.0, 200.0);
        pb.push_circle(250.0, 250.0, 100.0);
        pb.finish().unwrap()
    };

    let clip_path = clip_path
        .transform(Transform::from_row(1.0, -0.3, 0.0, 1.0, 0.0, 75.0))
        .unwrap();

    let mut mask = Mask::new(500, 500).unwrap();
    mask.fill_path(&clip_path, FillRule::EvenOdd, true, Transform::default());

    let mut paint = Paint::default();
    paint.anti_alias = false;
    paint.set_color_rgba8(50, 127, 150, 200);

    let mut pixmap = Pixmap::new(500, 500).unwrap();
    pixmap.fill_rect(
        Rect::from_xywh(0.0, 0.0, 500.0, 500.0).unwrap(),
        &paint,
        Transform::identity(),
        Some(&mask),
    );
    pixmap.save_png("image.png").unwrap();
}

examples/large_image.rs (line 41)

fn main() {
    let path1 = {
        let mut pb = PathBuilder::new();
        pb.move_to(1200.0, 1200.0);
        pb.line_to(3200.0, 18800.0);
        pb.cubic_to(7600.0, 16800.0, 13200.0, 16000.0, 18800.0, 16000.0);
        pb.cubic_to(14800.0, 9200.0, 8800.0, 3200.0, 1200.0, 1200.0);
        pb.close();
        pb.finish().unwrap()
    };

    let path2 = {
        let mut pb = PathBuilder::new();
        pb.move_to(18800.0, 1200.0);
        pb.line_to(16800.0, 18800.0);
        pb.cubic_to(12400.0, 16800.0, 6800.0, 16000.0, 1200.0, 16000.0);
        pb.cubic_to(5200.0, 9200.0, 11200.0, 3200.0, 18800.0, 1200.0);
        pb.close();
        pb.finish().unwrap()
    };

    let mut pixmap = Pixmap::new(20000, 20000).unwrap();

    let clip_path = {
        let mut pb = PathBuilder::new();
        pb.push_circle(10000.0, 10000.0, 7000.0);
        pb.finish().unwrap()
    };

    let mut mask = Mask::new(20000, 20000).unwrap();
    mask.fill_path(&clip_path, FillRule::Winding, true, Transform::default());

    let mut paint = Paint::default();
    paint.set_color_rgba8(90, 175, 100, 150);
    paint.anti_alias = true;
    let large_rect = Rect::from_xywh(500.0, 500.0, 19000.0, 19000.0).unwrap();
    pixmap.fill_rect(large_rect, &paint, Transform::identity(), None);

    paint.set_color_rgba8(50, 127, 150, 200);
    paint.anti_alias = true;
    pixmap.fill_path(
        &path1,
        &paint,
        FillRule::Winding,
        Transform::default(),
        Some(&mask),
    );

    paint.set_color_rgba8(220, 140, 75, 180);
    paint.anti_alias = false;
    pixmap.fill_path(
        &path2,
        &paint,
        FillRule::Winding,
        Transform::default(),
        None,
    );

    paint.set_color_rgba8(255, 10, 15, 180);
    paint.anti_alias = true;
    let mut stroke = Stroke::default();
    stroke.width = 0.8; // hairline
    pixmap.stroke_path(&path2, &paint, &stroke, Transform::default(), None);

    pixmap.save_png("image.png").unwrap();
}

pub fn left(&self) -> f32

Returns the left edge.

pub fn top(&self) -> f32

Returns the top edge.

pub fn right(&self) -> f32

Returns the right edge.

pub fn bottom(&self) -> f32

Returns the bottom edge.

pub fn x(&self) -> f32

Returns rect’s X position.

pub fn y(&self) -> f32

Returns rect’s Y position.

pub fn width(&self) -> f32

Returns rect’s width.

pub fn height(&self) -> f32

Returns rect’s height.

pub fn round(&self) -> Option<IntRect>

Converts into an IntRect by adding 0.5 and discarding the fractional portion.

Width and height are guarantee to be >= 1.

pub fn round_out(&self) -> Option<IntRect>

Converts into an IntRect rounding outwards.

Width and height are guarantee to be >= 1.

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

Returns an intersection of two rectangles.

Returns None otherwise.

pub fn from_points(points: &[Point]) -> Option<Rect>

Creates a Rect from Point array.

Returns None if count is zero or if Point array contains an infinity or NaN.

pub fn inset(&self, dx: f32, dy: f32) -> Option<Rect>

Insets the rectangle by the specified offset.

pub fn outset(&self, dx: f32, dy: f32) -> Option<Rect>

Outsets the rectangle by the specified offset.

pub fn transform(&self, ts: Transform) -> Option<Rect>

Transforms the rect using the provided Transform.

This method is expensive.

pub fn bbox_transform(&self, bbox: NonZeroRect) -> Rect

Applies a bounding box transform.

pub fn to_non_zero_rect(&self) -> Option<NonZeroRect>

Converts into NonZeroRect.

Trait Implementations

impl Clone for Rect

fn clone(&self) -> Rect

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Rect

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

Formats the value using the given formatter.

impl PartialEq for Rect

fn eq(&self, other: &Rect) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Rect

impl StructuralPartialEq for Rect