libreoffice-pure 0.5.6

Pure-Rust LibreOffice-compatible document generation CLI
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

use lo_core::{LoError, Result};

const MIN_RASTER_DPI: u32 = 72;
const MAX_RASTER_DPI: u32 = 300;

fn raster_dpi(dpi: u32) -> Result<u32> {
    if dpi > MAX_RASTER_DPI {
        return Err(LoError::InvalidInput(format!(
            "raster DPI {dpi} exceeds the {MAX_RASTER_DPI} DPI memory-safety limit"
        )));
    }
    Ok(dpi.max(MIN_RASTER_DPI))
}

/// Rasterize a DOCX document directly to PNG pages at the requested DPI.
pub fn docx_to_png_pages(input: &[u8], dpi: u32) -> Result<Vec<Vec<u8>>> {
    let dpi = raster_dpi(dpi)?;
    let doc = lo_writer::from_docx_bytes("document", input)?;
    Ok(lo_writer::render_png_pages(&doc, dpi))
}

/// Rasterize a DOCX document directly to JPEG pages at the requested DPI.
pub fn docx_to_jpeg_pages(input: &[u8], dpi: u32, quality: u8) -> Result<Vec<Vec<u8>>> {
    let dpi = raster_dpi(dpi)?;
    let doc = lo_writer::from_docx_bytes("document", input)?;
    Ok(lo_writer::render_jpeg_pages(&doc, dpi, quality.max(1)))
}

/// Rasterize a PPTX deck directly to PNG slide images at the requested DPI.
pub fn pptx_to_png_pages(input: &[u8], dpi: u32) -> Result<Vec<Vec<u8>>> {
    let dpi = raster_dpi(dpi)?;
    let deck = lo_impress::from_pptx_bytes("presentation", input)?;
    Ok(lo_impress::render_png_pages(&deck, dpi))
}

/// Rasterize a PPTX deck directly to JPEG slide images at the requested DPI.
pub fn pptx_to_jpeg_pages(input: &[u8], dpi: u32, quality: u8) -> Result<Vec<Vec<u8>>> {
    let dpi = raster_dpi(dpi)?;
    let deck = lo_impress::from_pptx_bytes("presentation", input)?;
    Ok(lo_impress::render_jpeg_pages(&deck, dpi, quality.max(1)))
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn normalizes_low_dpi_to_supported_minimum() {
        assert_eq!(raster_dpi(0).unwrap(), MIN_RASTER_DPI);
        assert_eq!(raster_dpi(71).unwrap(), MIN_RASTER_DPI);
        assert_eq!(raster_dpi(150).unwrap(), 150);
    }

    #[test]
    fn rejects_dpi_that_can_exhaust_page_memory_before_parsing() {
        let error = docx_to_png_pages(b"not a docx", MAX_RASTER_DPI + 1).unwrap_err();
        assert!(
            error.to_string().contains("memory-safety limit"),
            "unexpected error: {error}"
        );
    }
}