Struct Presentation 

pub struct Presentation {
    pub document: Document,
}

An OpenDocument presentation.

Fields

document: Document

The package and everything shared with the other two formats.

Implementations

impl Presentation

pub fn read(bytes: &[u8]) -> Result<Self, Error>

Read a .odp package.

Errors

The bytes are not a presentation, or its content.xml cannot be read.

pub fn slides(&self) -> Vec<Slide<'_>>

The slides, in the order they are presented.

pub fn set_geometry( &mut self, slide: usize, shape: usize, x: Length, y: Length, width: Length, height: Length, ) -> Result<(), Refused>

Move and size a shape: svg:x, svg:y, svg:width and svg:height, each written in the unit it was read in, in centimetres where it was absent. The shape is named by its slide’s position among the body’s children and its own among the page’s, as Slide::shapes_indexed gives them.

A shape placed by draw:transform states no corner and is not moved this way; asking is refused rather than answered wrongly.

Errors

There is no such slide or shape, or the shape is placed by a transform.

pub fn page_mut(&mut self, position: usize) -> Option<&mut Element>

The draw:page element at a position among the body’s children, for changing what is on it.

pub fn page_path(&self, position: usize) -> Option<Vec<usize>>

Where the slide at a position among the body’s children is under the content root, as a path of child indices: what an editor addresses its labels’ paragraphs from.

pub fn master(&self, slide: &Slide<'_>) -> Option<&Element>

The master page a slide names.

pub fn background(&self, slide: &Slide<'_>) -> Fill

What fills the ground behind a slide.

The slide’s own drawing-page style first, then its master’s, which is where a template puts the colour or gradient every slide shares. A slide that turns presentation:background-visible off gets neither.

pub fn background_objects(&self, slide: &Slide<'_>) -> Vec<&Element>

The master page’s decorations: what is drawn behind a slide before anything on the slide itself.

A child carrying a presentation:class is left out, because that attribute is what makes a frame a slot rather than a decoration: the slide’s own frame of that class takes its place, and what the master holds is either a prompt or a field. Left in, a slide gains the words Click to edit Master title style and a literal <number>.

The class and not presentation:placeholder, which would be the obvious test and is not written reliably: the title frame on deck.odp’s master carries the prompt text and no such attribute. Measured, not read.

Empty for a slide whose style turns presentation:background-objects-visible off, which is how a template offers a plain slide.

pub fn page_layout(&self, slide: &Slide<'_>) -> PageLayout

The page geometry a slide is drawn in: the size of its master page’s layout.

Every shape’s position is in this space, so a renderer needs it before it can place anything.

impl Presentation

pub fn move_slide( &mut self, position: usize, later: bool, ) -> Result<usize, Refused>

Move a slide one place earlier or later among the slides, and answer where it is now. The slide is named by its position among the body’s children, as Presentation::slides gives it.

Errors

There is no such slide, or no slide on that side of it.

pub fn delete_slide(&mut self, position: usize) -> Result<(), Refused>

Take a slide out of the deck, with its notes, and its name out of the custom shows and the start page that list it.

Errors

There is no such slide, or it is the only one.

pub fn duplicate_slide(&mut self, position: usize) -> Result<usize, Refused>

Put a copy of a slide after it, and answer where the copy is. The copy has a name no slide has, and every xml:id and draw:id in it, the notes included, is new, with the references to them inside the copy following.

Errors

There is no such slide.