deckmint 0.1.1

Create PowerPoint presentations programmatically in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

use crate::objects::SlideObject;
use crate::types::{Coord, PositionProps};

/// A group of shapes that act as a single unit on a slide.
///
/// Child shapes are positioned relative to the group's child coordinate space
/// defined by `child_offset` and `child_extent`.
#[derive(Debug, Clone)]
pub struct GroupObject {
    /// Internal object name.
    pub object_name: String,
    /// Position and dimensions of the group bounding box.
    pub position: PositionProps,
    /// Child coordinate space origin (x, y) in EMU.
    pub child_offset: (i64, i64),
    /// Child coordinate space extent (cx, cy) in EMU.
    pub child_extent: (i64, i64),
    /// Child shapes within this group.
    pub children: Vec<SlideObject>,
}

/// Options for group shape construction.
#[derive(Debug, Clone)]
pub struct GroupOptions {
    /// Position and dimensions of the group bounding box.
    pub position: PositionProps,
    /// Child coordinate space origin (x, y) in EMU.
    /// Defaults to (0, 0) — children positioned from top-left.
    pub child_offset: (i64, i64),
    /// Child coordinate space extent (cx, cy) in EMU.
    /// Defaults to match group dimensions.
    pub child_extent: Option<(i64, i64)>,
}

impl Default for GroupOptions {
    fn default() -> Self {
        GroupOptions {
            position: PositionProps::default(),
            child_offset: (0, 0),
            child_extent: None,
        }
    }
}

/// Fluent builder for group options.
pub struct GroupOptionsBuilder {
    opts: GroupOptions,
}

impl GroupOptionsBuilder {
    /// Create a new builder with default group options.
    pub fn new() -> Self {
        GroupOptionsBuilder { opts: GroupOptions::default() }
    }

    /// Set the X position in inches.
    pub fn x(mut self, v: f64) -> Self { self.opts.position.x = Some(Coord::Inches(v)); self }
    /// Set the Y position in inches.
    pub fn y(mut self, v: f64) -> Self { self.opts.position.y = Some(Coord::Inches(v)); self }
    /// Set the width in inches.
    pub fn w(mut self, v: f64) -> Self { self.opts.position.w = Some(Coord::Inches(v)); self }
    /// Set the height in inches.
    pub fn h(mut self, v: f64) -> Self { self.opts.position.h = Some(Coord::Inches(v)); self }
    /// Set position (x, y) in inches.
    pub fn pos(self, x: f64, y: f64) -> Self { self.x(x).y(y) }
    /// Set size (width, height) in inches.
    pub fn size(self, w: f64, h: f64) -> Self { self.w(w).h(h) }
    /// Set position and size from a [`CellRect`](crate::layout::CellRect).
    pub fn rect(self, r: crate::layout::CellRect) -> Self {
        self.pos(r.x, r.y).size(r.w, r.h)
    }
    /// Set position (x, y) and size (w, h) in inches in a single call.
    pub fn bounds(self, x: f64, y: f64, w: f64, h: f64) -> Self {
        self.pos(x, y).size(w, h)
    }
    /// Set the child coordinate space origin in EMU.
    pub fn child_offset(mut self, x: i64, y: i64) -> Self {
        self.opts.child_offset = (x, y);
        self
    }
    /// Set the child coordinate space extent in EMU.
    /// If not set, defaults to the group's own dimensions.
    pub fn child_extent(mut self, cx: i64, cy: i64) -> Self {
        self.opts.child_extent = Some((cx, cy));
        self
    }

    /// Consume the builder and return the group options.
    pub fn build(self) -> GroupOptions {
        self.opts
    }
}

impl Default for GroupOptionsBuilder {
    fn default() -> Self {
        Self::new()
    }
}