ppt-rs 0.2.37

Create, read, and update PowerPoint 2007+ (.pptx) files with rich formatting, bullet styles, themes, and templates.
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

//! Common XML templates and utilities for slide generation

use crate::generator::theme_xml::layout_rel_target;

/// Standard slide header with background
pub const SLIDE_HEADER: &str = r#"<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<p:sld xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">
<p:cSld>
<p:bg>
<p:bgRef idx="1001">
<a:schemeClr val="bg1"/>
</p:bgRef>
</p:bg>
<p:spTree>
<p:nvGrpSpPr>
<p:cNvPr id="1" name=""/>
<p:cNvGrpSpPr/>
<p:nvPr/>
</p:nvGrpSpPr>
<p:grpSpPr>
<a:xfrm>
<a:off x="0" y="0"/>
<a:ext cx="9144000" cy="6858000"/>
<a:chOff x="0" y="0"/>
<a:chExt cx="9144000" cy="6858000"/>
</a:xfrm>
</p:grpSpPr>"#;

/// Standard slide footer
pub const SLIDE_FOOTER: &str = r#"
</p:spTree>
</p:cSld>
<p:clrMapOvr>
<a:masterClrMapping/>
</p:clrMapOvr>
</p:sld>"#;

/// Create slide relationships XML (default layout 2 = Title and Content)
pub fn create_slide_rels_xml() -> String {
    create_slide_rels_xml_for_layout(2)
}

/// Create slide relationships XML for a specific layout part.
pub fn create_slide_rels_xml_for_layout(layout_number: usize) -> String {
    let layout_target = layout_rel_target(layout_number);
    format!(
        r#"<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout" Target="{layout_target}"/>
</Relationships>"#
    )
}

/// Plain-text + style payload for the title shape.
#[derive(Clone, Copy)]
pub struct TitleContent<'a> {
    pub text: &'a str,
    pub props: &'a str,
}

impl<'a> TitleContent<'a> {
    pub fn new(text: &'a str, props: &'a str) -> Self {
        Self { text, props }
    }
}

/// Title shape placement (EMU coordinates).
#[derive(Clone, Copy)]
pub struct TitlePlacement {
    pub x: u32,
    pub y: u32,
    pub width: u32,
    pub height: u32,
}

impl TitlePlacement {
    pub fn new(x: u32, y: u32, width: u32, height: u32) -> Self {
        Self { x, y, width, height }
    }
}

/// Generate title shape XML.
///
/// `ph_type` is the OOXML placeholder type (`"title"`, `"ctrTitle"`, `"subTitle"`,
/// or any other layout-defined value). Emitting `<p:ph type="..."/>` is what
/// tells PowerPoint this shape fills the layout's intended title slot — without
/// it, the slide opens with an empty title placeholder in the master.
pub fn generate_title_shape(
    content: TitleContent<'_>,
    placement: TitlePlacement,
    align: &str,
    ph_type: &str,
) -> String {
    let TitleContent { text: title_text, props: title_props } = content;
    let TitlePlacement { x, y, width, height } = placement;
    format!(
        r#"<p:sp>
<p:nvSpPr>
<p:cNvPr id="2" name="Title"/>
<p:cNvSpPr txBox="1"/>
<p:nvPr><p:ph type="{ph_type}"/></p:nvPr>
</p:nvSpPr>
<p:spPr>
<a:xfrm>
<a:off x="{x}" y="{y}"/>
<a:ext cx="{width}" cy="{height}"/>
</a:xfrm>
<a:prstGeom prst="rect"><a:avLst/></a:prstGeom>
<a:noFill/>
</p:spPr>
<p:txBody>
<a:bodyPr wrap="square" rtlCol="0" anchor="ctr"/>
<a:lstStyle/>
<a:p>
<a:pPr algn="{align}"/>
<a:r>
{title_props}
<a:t>{title_text}</a:t>
</a:r>
</a:p>
</p:txBody>
</p:sp>"#
    )
}