Struct Image 

pub struct Image {
    pub filename: String,
    pub width: u32,
    pub height: u32,
    pub x: u32,
    pub y: u32,
    pub format: String,
    pub source: Option<ImageSource>,
    pub crop: Option<Crop>,
    pub effects: Vec<ImageEffect>,
    pub alt_text: Option<String>,
}

Image metadata and properties

Fields

filename: String

width: u32

height: u32

x: u32

y: u32

format: String

source: Option<ImageSource>

Image data source (file path, base64, or bytes)

crop: Option<Crop>

Image cropping

effects: Vec<ImageEffect>

Image effects

alt_text: Option<String>

Accessibility alt text (description)

Implementations

impl Image

pub fn new(filename: &str, width: u32, height: u32, format: &str) -> Self

Create a new image

pub fn from_path<P: AsRef<Path>>(path: P) -> Result<Self, String>

Create an image from a file path, automatically detecting dimensions

pub fn from_base64(data: &str, width: u32, height: u32, format: &str) -> Self

Create an image from base64 encoded data

Example

use ppt_rs::generator::Image;

let base64_data = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==";
let img = Image::from_base64(base64_data, 100, 100, "PNG")
    .position(1000000, 1000000);

assert_eq!(img.width, 100);
assert_eq!(img.height, 100);
assert_eq!(img.format, "PNG");

pub fn from_bytes(data: Vec<u8>, width: u32, height: u32, format: &str) -> Self

Create an image from raw bytes

pub fn with_alt_text(self, alt: &str) -> Self

Set accessibility alt text for the image.

pub fn get_bytes(&self) -> Option<Vec<u8>>

Get the image data as bytes (decodes base64 if needed)

pub fn position(self, x: u32, y: u32) -> Self

Set image position

pub fn with_crop(self, left: f64, top: f64, right: f64, bottom: f64) -> Self

Set image cropping

pub fn with_effect(self, effect: ImageEffect) -> Self

Add an image effect

pub fn aspect_ratio(&self) -> f64

Get aspect ratio

pub fn scale_to_width(self, width: u32) -> Self

Scale image to width while maintaining aspect ratio

pub fn scale_to_height(self, height: u32) -> Self

Scale image to height while maintaining aspect ratio

pub fn extension(&self) -> String

Get file extension from filename

pub fn mime_type(&self) -> String

Get MIME type for the image format

pub fn at(self, x: Dimension, y: Dimension) -> Self

Set position using flexible Dimension units (fluent).

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

Set size using flexible Dimension units (fluent).

Trait Implementations

impl Clone for Image

fn clone(&self) -> Image

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Image

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

Formats the value using the given formatter.

impl Positioned for Image

fn x(&self) -> u32

Get X position in EMU

fn y(&self) -> u32

Get Y position in EMU

fn set_position(&mut self, x: u32, y: u32)

Set position

impl Sized for Image

fn width(&self) -> u32

Get width in EMU

fn height(&self) -> u32

Get height in EMU

fn set_size(&mut self, width: u32, height: u32)

Set size