litchi 0.0.1

High-performance parser for Microsoft Office, OpenDocument, and Apple iWork file formats with unified API
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

/// Shape and placeholder parsing for PowerPoint presentations.
///
/// This module provides functionality to parse shapes and placeholders
/// from PPT binary format, following the Apache POI HSLF structure.
///
/// # Architecture
///
/// The module is organized around these key types:
/// - `Shape`: Base trait for all shape types
/// - `TextBox`: Text box shapes
/// - `Placeholder`: Placeholder shapes for titles, content, etc.
/// - `AutoShape`: Auto shapes (rectangles, ovals, etc.)
/// - `EscherRecord`: Parser for Escher binary records
///
/// # PPT Shape Structure
///
/// Shapes in PPT are stored in Escher format within the slide data.
/// Each shape has properties like position, size, text content, and formatting.
///
/// # Example
///
/// ```rust,no_run
/// use litchi::ppt::Package;
///
/// let mut pkg = Package::open("presentation.ppt")?;
/// let pres = pkg.presentation()?;
///
/// for slide in pres.slides()? {
///     for shape in slide.shapes()? {
///         match shape {
///             Shape::TextBox(textbox) => {
///                 println!("Text box: {}", textbox.text()?);
///             }
///             Shape::Placeholder(placeholder) => {
///                 println!("Placeholder type: {:?}", placeholder.placeholder_type());
///             }
///             _ => {}
///         }
///     }
/// }
/// # Ok::<(), Box<dyn std::error::Error>>(())
/// ```
pub mod escher;
pub mod shape;
pub mod shape_enum;
pub mod textbox;
pub mod placeholder;
pub mod autoshape;

// Re-export the trait and type
pub use shape::{Shape, ShapeType};

// Re-export the high-performance enum
pub use shape_enum::ShapeEnum;

// Re-export concrete shape types
pub use textbox::TextBox;
pub use placeholder::{Placeholder, PlaceholderType, PlaceholderSize};
pub use autoshape::AutoShape;