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
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

// Macintosh PICT format parser and converter
//
// This module provides functionality to parse PICT data and convert it to
// modern image formats (PNG, JPEG, WebP).
//
// PICT is the native graphics metafile format for Mac OS Classic. There are
// two versions: PICT 1 (original) and PICT 2 (extended).
//
// References:
// - Inside Macintosh: Imaging With QuickDraw
// - Apple Technical Note TN1023: Understanding the PICT Format

pub mod parser;
pub mod converter;

/// Common data types for PICT format
mod types;

/// Data manipulation and compression utilities
mod data;

pub use parser::{PictParser, PictVersion};
pub use converter::{PictConverter, PictToRasterOptions};

use crate::common::error::Result;
use image::ImageFormat;

/// Convert PICT data to a raster image in the specified format
///
/// # Arguments
/// * `pict_data` - Raw PICT file data
/// * `format` - Target image format (PNG, JPEG, WebP)
/// * `width` - Optional output width (maintains aspect ratio if only one dimension specified)
/// * `height` - Optional output height
///
/// # Returns
/// Encoded image bytes in the target format
///
/// # Example
/// ```no_run
/// use litchi::images::pict::convert_pict;
/// use image::ImageFormat;
///
/// let pict_data = std::fs::read("image.pict")?;
/// let png_data = convert_pict(&pict_data, ImageFormat::Png, Some(800), None)?;
/// std::fs::write("output.png", png_data)?;
/// # Ok::<(), Box<dyn std::error::Error>>(())
/// ```
pub fn convert_pict(
    pict_data: &[u8],
    format: ImageFormat,
    width: Option<u32>,
    height: Option<u32>,
) -> Result<Vec<u8>> {
    let parser = PictParser::new(pict_data)?;
    let options = PictToRasterOptions {
        width,
        height,
        background_color: image::Rgba([255, 255, 255, 255]),
    };
    
    let converter = PictConverter::new(parser, options);
    converter.convert_to_format(format)
}

/// Convert PICT data to PNG format
pub fn convert_pict_to_png(
    pict_data: &[u8],
    width: Option<u32>,
    height: Option<u32>,
) -> Result<Vec<u8>> {
    convert_pict(pict_data, ImageFormat::Png, width, height)
}

/// Convert PICT data to JPEG format
pub fn convert_pict_to_jpeg(
    pict_data: &[u8],
    width: Option<u32>,
    height: Option<u32>,
) -> Result<Vec<u8>> {
    convert_pict(pict_data, ImageFormat::Jpeg, width, height)
}

/// Convert PICT data to WebP format
pub fn convert_pict_to_webp(
    pict_data: &[u8],
    width: Option<u32>,
    height: Option<u32>,
) -> Result<Vec<u8>> {
    convert_pict(pict_data, ImageFormat::WebP, width, height)
}