Struct OpcPackage 

pub struct OpcPackage { /* private fields */ }

An OPC (Open Packaging Convention) package.

This is the primary struct for reading and writing .pptx files. An OPC package is a ZIP archive containing XML and binary parts linked by relationships.

The package contains:

• A collection of parts indexed by their PackURI
• Package-level relationships (from _rels/.rels)
• A content type map (from [Content_Types].xml)

Implementations

impl OpcPackage

pub fn or_add_image_part( &mut self, image: &Image, ) -> PptxResult<(PackURI, String)>

Add an image part to the package, deduplicating by SHA1 hash.

If an image with the same SHA1 already exists in /ppt/media/, it is reused. Otherwise a new image part is created.

Returns (partname, content_type) of the image part (new or existing).

Errors

Returns an error if the part cannot be created.

pub fn or_add_media_part( &mut self, video: &Video, ) -> PptxResult<(PackURI, String)>

Add a media (video) part to the package, deduplicating by SHA1 hash.

Returns (partname, content_type) of the media part (new or existing).

Errors

Returns an error if the part cannot be created.

impl OpcPackage

pub fn open(path: impl AsRef<Path>) -> PptxResult<Self>

Open an existing .pptx file from a filesystem path.

Errors

Returns an error if the file cannot be read or is not a valid package.

pub fn from_bytes(data: &[u8]) -> PptxResult<Self>

Open a package from in-memory bytes (a .pptx file loaded into memory).

Errors

Returns an error if the bytes are not a valid OPC package.

pub fn new() -> PptxResult<Self>

Create a new package from the embedded default template.

Errors

Returns an error if the default template cannot be parsed.

pub fn save(&self, path: impl AsRef<Path>) -> PptxResult<()>

Save the package to a filesystem path.

Errors

Returns an error if serialization or file I/O fails.

pub fn to_bytes(&self) -> PptxResult<Vec<u8>>

Serialize the package to in-memory bytes (a valid .pptx file).

Errors

Returns an error if XML serialization or ZIP writing fails.

pub fn part(&self, partname: &PackURI) -> Option<&Part>

Get a part by its partname.

pub fn part_mut(&mut self, partname: &PackURI) -> Option<&mut Part>

Get a mutable reference to a part by its partname.

pub fn put_part(&mut self, part: Part)

Add or replace a part in the package.

pub fn remove_part(&mut self, partname: &PackURI) -> Option<Part>

Remove a part by its partname.

pub fn parts(&self) -> impl Iterator<Item = &Part>

Iterate over all parts in the package.

pub fn parts_mut(&mut self) -> impl Iterator<Item = &mut Part>

Iterate over all parts mutably.

pub fn part_by_reltype(&self, reltype: &str) -> PptxResult<&Part>

Find the part related to the package by relationship type.

Errors

Returns an error if the relationship or part is not found.

pub fn part_by_reltype_mut(&mut self, reltype: &str) -> PptxResult<&mut Part>

Get a mutable reference to the part related to the package by relationship type.

Errors

Returns an error if the relationship or part is not found.

pub fn next_partname(&self, template: &str) -> PptxResult<PackURI>

Get the next available partname matching a pattern template.

The template should contain {} where the number goes. For example, “/ppt/slides/slide{}.xml” might return “/ppt/slides/slide1.xml”.

Errors

Returns an error if no available partname can be found.

pub fn next_image_partname(&self, ext: &str) -> PptxResult<PackURI>

Get the next available image partname with the given extension.

Returns a partname like “/ppt/media/image1.png”, “/ppt/media/image2.jpg”, etc.

Errors

Returns an error if no available partname can be found.

pub fn next_media_partname(&self, ext: &str) -> PptxResult<PackURI>

Get the next available media partname with the given extension.

Returns a partname like “/ppt/media/media1.mp4”, etc.

Errors

Returns an error if no available partname can be found.

Trait Implementations

impl Clone for OpcPackage

fn clone(&self) -> OpcPackage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OpcPackage

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

Formats the value using the given formatter.