pptx 0.1.0

A Rust library for creating and manipulating PowerPoint (.pptx) files
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

mod builders;
mod xml;

#[cfg(test)]
mod tests;
#[cfg(test)]
mod tests_builders;

use crate::shapes::Shape;
use crate::units::{Emu, ShapeId};

/// A group shape (`<p:grpSp>`) that contains other shapes.
///
/// Group shapes have their own coordinate space defined by
/// child offset/extent (`chOff`, `chExt`).
#[derive(Debug, Clone, PartialEq)]
pub struct GroupShape {
    pub shape_id: ShapeId,
    pub name: String,
    pub left: Emu,
    pub top: Emu,
    pub width: Emu,
    pub height: Emu,
    pub rotation: f64,
    /// The child shapes within this group.
    pub shapes: Vec<Shape>,
}

impl GroupShape {
    /// Add a shape to this group.
    pub fn add_shape(&mut self, shape: Shape) {
        self.shapes.push(shape);
    }

    /// Get the number of child shapes.
    #[must_use]
    pub fn len(&self) -> usize {
        self.shapes.len()
    }

    /// Check if the group is empty.
    #[must_use]
    pub fn is_empty(&self) -> bool {
        self.shapes.is_empty()
    }

    /// Iterate over child shapes.
    pub fn iter(&self) -> impl Iterator<Item = &Shape> {
        self.shapes.iter()
    }

    /// Find the maximum shape ID among all child shapes in this group.
    ///
    /// Returns `ShapeId(0)` if the group has no children.
    #[must_use]
    pub fn max_shape_id(&self) -> ShapeId {
        self.shapes
            .iter()
            .map(|s| match s {
                Shape::GroupShape(g) => g.max_shape_id().max(g.shape_id),
                other => other.shape_id(),
            })
            .max()
            .unwrap_or(ShapeId(0))
    }

    /// Return the next available shape ID within this group.
    pub(crate) fn next_shape_id(&self) -> ShapeId {
        let max = self.max_shape_id().max(self.shape_id);
        ShapeId(max.0 + 1)
    }

    /// Count how many existing child shapes have a name starting with the given prefix.
    pub(crate) fn count_shapes_with_prefix(&self, prefix: &str) -> u32 {
        let count = self
            .shapes
            .iter()
            .filter(|s| s.name().starts_with(prefix))
            .count();
        // usizeā†’u32: shape count will never exceed u32::MAX in practice
        u32::try_from(count).unwrap_or(u32::MAX)
    }
}

impl std::fmt::Display for GroupShape {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "GroupShape(\"{}\")", self.name)
    }
}