Struct ImageViewStyle 

pub struct ImageViewStyle<C> {
    pub alignment: ImageAlignment,
    pub insets: EdgeInsets,
    pub background: Option<C>,
    pub border: Option<C>,
    pub border_width: u32,
    pub corner_radius: u32,
}

Visual configuration for an ImageView.

Fields

alignment: ImageAlignment

Image alignment inside the content rect.

insets: EdgeInsets

Inner padding applied before image placement.

background: Option<C>

Optional background fill for the shell.

border: Option<C>

Optional border color for the shell.

border_width: u32

Border width in pixels.

corner_radius: u32

Corner radius for the shell.

Implementations

impl<C> ImageViewStyle<C>

pub const fn new() -> Self

Creates the default image view style.

Examples found in repository

examples/text_and_image.rs (line 29)

fn main() {
    let mut canvas = support::NullCanvas::new(Size::new(320, 240));

    let image_data = [
        0xF8, 0x00, 0x07, 0xE0, //
        0x07, 0xE0, 0xF8, 0x00, //
    ];
    let image: ImageRawBE<Rgb565> = ImageRaw::new(&image_data, 2);

    ImageView::new(
        Rectangle::new(Point::new(16, 16), Size::new(72, 72)),
        &image,
    )
    .with_style(
        ImageViewStyle::new()
            .with_alignment(ImageAlignment::Center)
            .with_insets(EdgeInsets::all(8))
            .with_background(Rgb565::new(28, 58, 28))
            .with_border(Rgb565::new(20, 44, 20), 2)
            .with_corner_radius(12),
    )
    .draw(&mut canvas);

    TextView::new(
        Rectangle::new(Point::new(104, 18), Size::new(192, 28)),
        "Faststep",
        TextRunStyle::title(Rgb565::BLACK),
    )
    .with_view_style(
        TextViewStyle::new()
            .with_alignment(TextAlignment::Leading)
            .with_vertical_alignment(TextVerticalAlignment::Center),
    )
    .draw(&mut canvas);

    let spans = [
        TextSpan::new("UIKit-like ", TextRunStyle::body(Rgb565::BLACK)),
        TextSpan::new("embedded UI", TextRunStyle::body_strong(Rgb565::BLUE)),
        TextSpan::new(
            "\nfor devices and simulators",
            TextRunStyle::caption(Rgb565::GREEN),
        ),
    ];
    RichTextView::new(
        Rectangle::new(Point::new(104, 58), Size::new(192, 72)),
        &spans,
    )
    .with_view_style(
        TextViewStyle::new()
            .with_wrap(TextWrap::Multiline)
            .with_insets(EdgeInsets::all(4)),
    )
    .draw(&mut canvas);
}

src/image_view.rs (line 98)

    fn default() -> Self {
        Self::new()
    }
}

/// Reusable bitmap view similar to UIKit's `UIImageView`.
pub struct ImageView<'a, T, C>
where
    T: ImageDrawable<Color = C> + OriginDimensions,
    C: PixelColor,
{
    /// Outer frame for the view.
    pub frame: Rectangle,
    /// Referenced image content.
    pub image: &'a T,
    /// Shell and alignment style.
    pub style: ImageViewStyle<C>,
}

impl<'a, T, C> ImageView<'a, T, C>
where
    T: ImageDrawable<Color = C> + OriginDimensions,
    C: PixelColor,
{
    /// Creates a new image view with default styling.
    pub const fn new(frame: Rectangle, image: &'a T) -> Self {
        Self {
            frame,
            image,
            style: ImageViewStyle::new(),
        }
    }

pub fn with_alignment(self, alignment: ImageAlignment) -> Self

Sets image alignment.

Examples found in repository

examples/text_and_image.rs (line 30)

fn main() {
    let mut canvas = support::NullCanvas::new(Size::new(320, 240));

    let image_data = [
        0xF8, 0x00, 0x07, 0xE0, //
        0x07, 0xE0, 0xF8, 0x00, //
    ];
    let image: ImageRawBE<Rgb565> = ImageRaw::new(&image_data, 2);

    ImageView::new(
        Rectangle::new(Point::new(16, 16), Size::new(72, 72)),
        &image,
    )
    .with_style(
        ImageViewStyle::new()
            .with_alignment(ImageAlignment::Center)
            .with_insets(EdgeInsets::all(8))
            .with_background(Rgb565::new(28, 58, 28))
            .with_border(Rgb565::new(20, 44, 20), 2)
            .with_corner_radius(12),
    )
    .draw(&mut canvas);

    TextView::new(
        Rectangle::new(Point::new(104, 18), Size::new(192, 28)),
        "Faststep",
        TextRunStyle::title(Rgb565::BLACK),
    )
    .with_view_style(
        TextViewStyle::new()
            .with_alignment(TextAlignment::Leading)
            .with_vertical_alignment(TextVerticalAlignment::Center),
    )
    .draw(&mut canvas);

    let spans = [
        TextSpan::new("UIKit-like ", TextRunStyle::body(Rgb565::BLACK)),
        TextSpan::new("embedded UI", TextRunStyle::body_strong(Rgb565::BLUE)),
        TextSpan::new(
            "\nfor devices and simulators",
            TextRunStyle::caption(Rgb565::GREEN),
        ),
    ];
    RichTextView::new(
        Rectangle::new(Point::new(104, 58), Size::new(192, 72)),
        &spans,
    )
    .with_view_style(
        TextViewStyle::new()
            .with_wrap(TextWrap::Multiline)
            .with_insets(EdgeInsets::all(4)),
    )
    .draw(&mut canvas);
}

pub fn with_insets(self, insets: EdgeInsets) -> Self

Sets content insets.

Examples found in repository

examples/text_and_image.rs (line 31)

fn main() {
    let mut canvas = support::NullCanvas::new(Size::new(320, 240));

    let image_data = [
        0xF8, 0x00, 0x07, 0xE0, //
        0x07, 0xE0, 0xF8, 0x00, //
    ];
    let image: ImageRawBE<Rgb565> = ImageRaw::new(&image_data, 2);

    ImageView::new(
        Rectangle::new(Point::new(16, 16), Size::new(72, 72)),
        &image,
    )
    .with_style(
        ImageViewStyle::new()
            .with_alignment(ImageAlignment::Center)
            .with_insets(EdgeInsets::all(8))
            .with_background(Rgb565::new(28, 58, 28))
            .with_border(Rgb565::new(20, 44, 20), 2)
            .with_corner_radius(12),
    )
    .draw(&mut canvas);

    TextView::new(
        Rectangle::new(Point::new(104, 18), Size::new(192, 28)),
        "Faststep",
        TextRunStyle::title(Rgb565::BLACK),
    )
    .with_view_style(
        TextViewStyle::new()
            .with_alignment(TextAlignment::Leading)
            .with_vertical_alignment(TextVerticalAlignment::Center),
    )
    .draw(&mut canvas);

    let spans = [
        TextSpan::new("UIKit-like ", TextRunStyle::body(Rgb565::BLACK)),
        TextSpan::new("embedded UI", TextRunStyle::body_strong(Rgb565::BLUE)),
        TextSpan::new(
            "\nfor devices and simulators",
            TextRunStyle::caption(Rgb565::GREEN),
        ),
    ];
    RichTextView::new(
        Rectangle::new(Point::new(104, 58), Size::new(192, 72)),
        &spans,
    )
    .with_view_style(
        TextViewStyle::new()
            .with_wrap(TextWrap::Multiline)
            .with_insets(EdgeInsets::all(4)),
    )
    .draw(&mut canvas);
}

pub fn with_background(self, background: C) -> Self

Sets the shell background color.

Examples found in repository

examples/text_and_image.rs (line 32)

fn main() {
    let mut canvas = support::NullCanvas::new(Size::new(320, 240));

    let image_data = [
        0xF8, 0x00, 0x07, 0xE0, //
        0x07, 0xE0, 0xF8, 0x00, //
    ];
    let image: ImageRawBE<Rgb565> = ImageRaw::new(&image_data, 2);

    ImageView::new(
        Rectangle::new(Point::new(16, 16), Size::new(72, 72)),
        &image,
    )
    .with_style(
        ImageViewStyle::new()
            .with_alignment(ImageAlignment::Center)
            .with_insets(EdgeInsets::all(8))
            .with_background(Rgb565::new(28, 58, 28))
            .with_border(Rgb565::new(20, 44, 20), 2)
            .with_corner_radius(12),
    )
    .draw(&mut canvas);

    TextView::new(
        Rectangle::new(Point::new(104, 18), Size::new(192, 28)),
        "Faststep",
        TextRunStyle::title(Rgb565::BLACK),
    )
    .with_view_style(
        TextViewStyle::new()
            .with_alignment(TextAlignment::Leading)
            .with_vertical_alignment(TextVerticalAlignment::Center),
    )
    .draw(&mut canvas);

    let spans = [
        TextSpan::new("UIKit-like ", TextRunStyle::body(Rgb565::BLACK)),
        TextSpan::new("embedded UI", TextRunStyle::body_strong(Rgb565::BLUE)),
        TextSpan::new(
            "\nfor devices and simulators",
            TextRunStyle::caption(Rgb565::GREEN),
        ),
    ];
    RichTextView::new(
        Rectangle::new(Point::new(104, 58), Size::new(192, 72)),
        &spans,
    )
    .with_view_style(
        TextViewStyle::new()
            .with_wrap(TextWrap::Multiline)
            .with_insets(EdgeInsets::all(4)),
    )
    .draw(&mut canvas);
}

pub fn with_border(self, border: C, border_width: u32) -> Self

Sets border color and width.

Examples found in repository

examples/text_and_image.rs (line 33)

fn main() {
    let mut canvas = support::NullCanvas::new(Size::new(320, 240));

    let image_data = [
        0xF8, 0x00, 0x07, 0xE0, //
        0x07, 0xE0, 0xF8, 0x00, //
    ];
    let image: ImageRawBE<Rgb565> = ImageRaw::new(&image_data, 2);

    ImageView::new(
        Rectangle::new(Point::new(16, 16), Size::new(72, 72)),
        &image,
    )
    .with_style(
        ImageViewStyle::new()
            .with_alignment(ImageAlignment::Center)
            .with_insets(EdgeInsets::all(8))
            .with_background(Rgb565::new(28, 58, 28))
            .with_border(Rgb565::new(20, 44, 20), 2)
            .with_corner_radius(12),
    )
    .draw(&mut canvas);

    TextView::new(
        Rectangle::new(Point::new(104, 18), Size::new(192, 28)),
        "Faststep",
        TextRunStyle::title(Rgb565::BLACK),
    )
    .with_view_style(
        TextViewStyle::new()
            .with_alignment(TextAlignment::Leading)
            .with_vertical_alignment(TextVerticalAlignment::Center),
    )
    .draw(&mut canvas);

    let spans = [
        TextSpan::new("UIKit-like ", TextRunStyle::body(Rgb565::BLACK)),
        TextSpan::new("embedded UI", TextRunStyle::body_strong(Rgb565::BLUE)),
        TextSpan::new(
            "\nfor devices and simulators",
            TextRunStyle::caption(Rgb565::GREEN),
        ),
    ];
    RichTextView::new(
        Rectangle::new(Point::new(104, 58), Size::new(192, 72)),
        &spans,
    )
    .with_view_style(
        TextViewStyle::new()
            .with_wrap(TextWrap::Multiline)
            .with_insets(EdgeInsets::all(4)),
    )
    .draw(&mut canvas);
}

pub fn with_corner_radius(self, corner_radius: u32) -> Self

Sets the shell corner radius.

Examples found in repository

examples/text_and_image.rs (line 34)

fn main() {
    let mut canvas = support::NullCanvas::new(Size::new(320, 240));

    let image_data = [
        0xF8, 0x00, 0x07, 0xE0, //
        0x07, 0xE0, 0xF8, 0x00, //
    ];
    let image: ImageRawBE<Rgb565> = ImageRaw::new(&image_data, 2);

    ImageView::new(
        Rectangle::new(Point::new(16, 16), Size::new(72, 72)),
        &image,
    )
    .with_style(
        ImageViewStyle::new()
            .with_alignment(ImageAlignment::Center)
            .with_insets(EdgeInsets::all(8))
            .with_background(Rgb565::new(28, 58, 28))
            .with_border(Rgb565::new(20, 44, 20), 2)
            .with_corner_radius(12),
    )
    .draw(&mut canvas);

    TextView::new(
        Rectangle::new(Point::new(104, 18), Size::new(192, 28)),
        "Faststep",
        TextRunStyle::title(Rgb565::BLACK),
    )
    .with_view_style(
        TextViewStyle::new()
            .with_alignment(TextAlignment::Leading)
            .with_vertical_alignment(TextVerticalAlignment::Center),
    )
    .draw(&mut canvas);

    let spans = [
        TextSpan::new("UIKit-like ", TextRunStyle::body(Rgb565::BLACK)),
        TextSpan::new("embedded UI", TextRunStyle::body_strong(Rgb565::BLUE)),
        TextSpan::new(
            "\nfor devices and simulators",
            TextRunStyle::caption(Rgb565::GREEN),
        ),
    ];
    RichTextView::new(
        Rectangle::new(Point::new(104, 58), Size::new(192, 72)),
        &spans,
    )
    .with_view_style(
        TextViewStyle::new()
            .with_wrap(TextWrap::Multiline)
            .with_insets(EdgeInsets::all(4)),
    )
    .draw(&mut canvas);
}

Trait Implementations

impl<C: Clone> Clone for ImageViewStyle<C>

fn clone(&self) -> ImageViewStyle<C>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C: Debug> Debug for ImageViewStyle<C>

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

Formats the value using the given formatter.

impl<C> Default for ImageViewStyle<C>

fn default() -> Self

Returns the “default value” for a type.

impl<C: PartialEq> PartialEq for ImageViewStyle<C>

fn eq(&self, other: &ImageViewStyle<C>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<C: Copy> Copy for ImageViewStyle<C>

impl<C: Eq> Eq for ImageViewStyle<C>

impl<C> StructuralPartialEq for ImageViewStyle<C>