Struct Shape 

pub struct Shape {
    pub shape_type: ShapeType,
    pub x: u32,
    pub y: u32,
    pub width: u32,
    pub height: u32,
    pub fill: Option<ShapeFill>,
    pub gradient: Option<GradientFill>,
    pub line: Option<ShapeLine>,
    pub text: Option<String>,
    pub id: Option<u32>,
    pub rotation: Option<i32>,
    pub hyperlink: Option<Hyperlink>,
}

Shape definition

Fields

shape_type: ShapeType

x: u32

y: u32

width: u32

height: u32

fill: Option<ShapeFill>

gradient: Option<GradientFill>

line: Option<ShapeLine>

text: Option<String>

id: Option<u32>

Optional fixed shape ID for connector anchoring

rotation: Option<i32>

Rotation in degrees (0-360)

hyperlink: Option<Hyperlink>

Optional hyperlink

Implementations

impl Shape

pub fn new( shape_type: ShapeType, x: u32, y: u32, width: u32, height: u32, ) -> Self

Create a new shape

pub fn with_id(self, id: u32) -> Self

Set shape ID for connector anchoring

pub fn with_rotation(self, degrees: i32) -> Self

Set shape rotation in degrees

pub fn with_hyperlink(self, hyperlink: Hyperlink) -> Self

Set shape hyperlink

pub fn with_fill(self, fill: ShapeFill) -> Self

Set shape fill (solid color)

pub fn with_gradient(self, gradient: GradientFill) -> Self

Set gradient fill

pub fn with_line(self, line: ShapeLine) -> Self

Set shape line

pub fn with_text(self, text: &str) -> Self

Set shape text

pub fn from_dimensions( shape_type: ShapeType, x: Dimension, y: Dimension, width: Dimension, height: Dimension, ) -> Self

Create a shape using flexible Dimension units for position and size.

use ppt_rs::core::Dimension;
use ppt_rs::generator::shapes::{Shape, ShapeType};

// Position at 10% from left, 20% from top; size = 80% width, 2 inches height
let shape = Shape::from_dimensions(
    ShapeType::Rectangle,
    Dimension::Ratio(0.1), Dimension::Ratio(0.2),
    Dimension::Ratio(0.8), Dimension::Inches(2.0),
);

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

Set position using flexible Dimension units (fluent).

use ppt_rs::core::Dimension;
use ppt_rs::generator::shapes::{Shape, ShapeType};

let shape = Shape::new(ShapeType::Rectangle, 0, 0, 914400, 914400)
    .at(Dimension::Ratio(0.5), Dimension::Ratio(0.5));

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

Set size using flexible Dimension units (fluent).

use ppt_rs::core::Dimension;
use ppt_rs::generator::shapes::{Shape, ShapeType};

let shape = Shape::new(ShapeType::Rectangle, 0, 0, 0, 0)
    .with_dimensions(Dimension::Inches(3.0), Dimension::Cm(5.0));

Trait Implementations

impl Clone for Shape

fn clone(&self) -> Shape

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Shape

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

Formats the value using the given formatter.

impl Positioned for Shape

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 ShapeExt for Shape

fn fill(self, color: Color) -> Self

Set the fill color (shorter alias for with_fill)

fn stroke(self, color: Color, width_pt: f64) -> Self

Set the stroke/line (shorter alias for with_line)

fn text(self, text: &str) -> Self

Set the text (shorter alias for with_text)

impl Sized for Shape

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