Struct ImageWidget 

pub struct ImageWidget {
    pub images: Vec<PathBuf>,
    pub visible: bool,
    pub max_width: u32,
    pub max_height: u32,
    pub show_metadata: bool,
    pub use_ascii_placeholder: bool,
}

Image widget for displaying images in the terminal

Provides:

• Single and multiple image display
• Metadata rendering (format, size, dimensions)
• ASCII placeholder fallback
• Automatic resizing to fit terminal bounds
• Vertical organization with separators

Requirements

• Req 5.1: Display images in terminal using ricecoder-images ImageDisplay
• Req 5.2: Show metadata (format, size, dimensions)
• Req 5.3: ASCII placeholder for unsupported terminals
• Req 5.4: Resize to fit terminal bounds (max 80x30)
• Req 5.5: Organize multiple images vertically with separators

Fields

images: Vec<PathBuf>

Image file paths to display

visible: bool

Whether the widget is visible

max_width: u32

Maximum width for display (characters)

max_height: u32

Maximum height for display (characters)

show_metadata: bool

Whether to show metadata

use_ascii_placeholder: bool

Whether to use ASCII placeholder

Implementations

impl ImageWidget

pub fn new() -> Self

Create a new image widget

pub fn with_dimensions(width: u32, height: u32) -> Self

Create a new image widget with specific dimensions

pub fn add_image(&mut self, path: PathBuf)

Add an image to the widget

Arguments

• path - Path to the image file

Requirements

• Req 5.1: Add image to widget for display

pub fn add_images(&mut self, paths: Vec<PathBuf>)

Add multiple images to the widget

Arguments

• paths - Paths to the image files

Requirements

• Req 5.5: Organize multiple images vertically with separators

pub fn remove_image(&mut self, path: &PathBuf) -> bool

Remove an image from the widget

Arguments

• path - Path to the image to remove

Returns

True if image was removed, false if not found

pub fn clear_images(&mut self)

Clear all images from the widget

pub fn image_count(&self) -> usize

Get the number of images in the widget

pub fn has_images(&self) -> bool

Check if the widget has any images

pub fn get_images(&self) -> &[PathBuf]

Get the images in the widget

pub fn show(&mut self)

Show the widget

pub fn hide(&mut self)

Hide the widget

pub fn toggle_visibility(&mut self)

Toggle widget visibility

pub fn set_dimensions(&mut self, width: u32, height: u32)

Set the maximum display dimensions

Arguments

• width - Maximum width in characters
• height - Maximum height in characters

Requirements

• Req 5.4: Resize to fit terminal bounds (max 80x30)

pub fn enable_metadata(&mut self)

Enable metadata display

pub fn disable_metadata(&mut self)

Disable metadata display

pub fn enable_ascii_placeholder(&mut self)

Enable ASCII placeholder

pub fn disable_ascii_placeholder(&mut self)

Disable ASCII placeholder

pub fn render(&self) -> String

Render the widget as a string

Returns

Rendered widget string

Requirements

• Req 5.1: Display images in terminal using ricecoder-images ImageDisplay
• Req 5.2: Show metadata (format, size, dimensions)
• Req 5.3: ASCII placeholder for unsupported terminals
• Req 5.4: Resize to fit terminal bounds (max 80x30)
• Req 5.5: Organize multiple images vertically with separators

Trait Implementations

impl Clone for ImageWidget

fn clone(&self) -> ImageWidget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImageWidget

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

Formats the value using the given formatter.

impl Default for ImageWidget

fn default() -> Self

Returns the “default value” for a type.