mirror of
https://github.com/storytold/pdfcraft.git
synced 2026-10-28 03:58:45 -06:00
aiongg
aedf339fb8
Conflicts: ATTRIBUTION.toml: took main's side (hashes recomputed after the merges). crates/optimize/src/lib.rs, crates/automation/src/lib.rs, tools.rs: Settings and tool schema keep object_streams (#3227) and lzw_to_flate (#4181); doc_optimize description names both options. crates/optimize/tests/optimize.rs: both sides' imports and tests kept.
55 lines
3.7 KiB
Markdown
55 lines
3.7 KiB
Markdown
# pdfcraft-optimize
|
|
|
|
Layer L4: the PDF Optimizer (execution plan M11.1; Acrobat's Reduce File Size and Optimize PDF ▸
|
|
Advanced optimization).
|
|
|
|
```rust
|
|
let report = optimize(&mut doc, &Settings::default())?; // Reduce File Size's choices
|
|
let report = optimize(&mut doc, &Preset::Mobile.settings())?; // smaller, for screens
|
|
// Or with progress: called before each image and the clean-up; `false` cancels.
|
|
let report = optimize_with_progress(&mut doc, &settings, &mut |stage| keep_going)?;
|
|
```
|
|
|
|
- **Presets:** Standard (Reduce File Size's choices: images above 225 ppi to 150 ppi, JPEG
|
|
medium) and Mobile (above 144 ppi to 96 ppi, JPEG high), as in Acrobat's Settings menu.
|
|
- **Merge image fragments** (`fragments`, on by default): some PDF printers draw a page picture
|
|
as thousands of images one pixel row high. Runs of upright 8-bit grey or RGB images in one
|
|
colour space, sharing their left and right edges and stacked edge to edge (at least four,
|
|
drawn with nothing else between them), become one lossless image at their finest resolution,
|
|
which the image settings then resample; the strips are dropped by Clean Up. A real page
|
|
printed this way went from 4.3 MB to 231 KB (Standard) and 161 KB (Mobile). Not merged yet:
|
|
side-by-side tiles, rotated strips, masks. Content arrays use the shared space boundary
|
|
policy, so trailing comments, split operands and graphics state keep their meaning after merging.
|
|
- **Images:** the effective resolution of each image is measured where pages draw it (the CTM
|
|
through form XObjects, up to 12 deep; the smallest over all uses).
|
|
Page-local `/UserUnit` scaling is included, so large-format pages are measured in physical inches.
|
|
If a use can't be
|
|
measured (forms nested deeper, or drawn too many times), no image is resampled. Colour and grayscale images above a
|
|
threshold are resampled with a bicubic (Catmull-Rom) filter to a target resolution and
|
|
stored as JPEG (Acrobat's quality steps) or ZIP; soft masks are resampled with their image.
|
|
An image is replaced only if the result is smaller. Left alone: CMYK and other colour spaces,
|
|
image masks, decode arrays, more than 8 bits, JPEG 2000, JBIG2 and CCITT.
|
|
- **Discard objects:** thumbnails, alternate images, document tags, print settings.
|
|
- **Clean up:** Flate for streams with no filter; for streams with an outer ASCII85 or ASCIIHex
|
|
layer, that layer is removed when the result is smaller (the inner filters keep their encoded
|
|
bytes; streams with `/DecodeParms`, images and object streams keep their ASCII layer. LZW-compressed
|
|
streams, content and images alike, are decoded and stored with Flate instead (Acrobat's "In
|
|
streams that use LZW encoding, use Flate instead"): a predictor carries over to Flate without
|
|
`EarlyChange`, filters applied before the LZW one go with it and those after it keep their
|
|
bytes. A stream whose LZW data doesn't decode cleanly is left as it is. Not yet: inline images.
|
|
|
|
The engine runs Remove Hidden Information (`pdfcraft-redact`) for the user-data categories,
|
|
then this, then merges identical objects and writes a full, compressed save
|
|
(`pdfcraft_engine::optimizer::OptimizeJob`, which the UI runs on a worker thread with a
|
|
progress bar). JPEG decoding and
|
|
encoding and resampling come from the `image` crate.
|
|
|
|
## Target PDF version: partial compatibility
|
|
|
|
The target selects the header version, clears the catalog `/Version`, controls object
|
|
streams (disabled for PDF 1.4), and checks encryption requirements. It does **not**
|
|
detect or convert content newer than the target: optional content, JPEG 2000 images,
|
|
16-bit images, OpenType fonts and PDF 2.0 features can remain. A PDF 1.4 header
|
|
therefore does not guarantee compatibility with PDF 1.4 readers or validators.
|
|
`optimize.compatibility-level` remains partial until content compatibility is checked.
|