[Raku PDF Project] / PDF::To::Cairo

PDF::To::Cairo

Example

To burst my.pdf to PNG images my-001.png my-002.png …

Via the shell

bin/pdf2image.raku my.pdf

Via Raku

use PDF::Class;
use PDF::To::Cairo;

my PDF::Class $pdf .= open: "my.pdf";
my $outfile-templ = "my-%03d.png";

PDF::To::Cairo.save-as($pdf, $outfile-templ);

Description

This module is an experimental work-in-progress PDF rendering via Cairo and the Raku PDF Tool-chain. It is able to render from PDF::Class or PDF::API6 objects. Supported output formats are PNG, PDF (round trip) and SVG.

This module can currently render text (most fonts), simple colors, tiling patterns and basic graphics.

At this stage its main purpose is to exercise Raku modules related to PDF, fonts and rendering, including:

• PDF (threading)
• PDF::Content (graphics, images)
• PDF::Font::Loader (font loading, decoding, rendering, threading)
• PDF::Class (objects)
• Font::FreeType (fonts and glyphs)
• Cairo (rendering)

Scripts

pdf2image.raku --page=n --batch=m --trace --password=*** <in>.pdf [out-fmt]

Where

• <in>.pdf is a PDF file

• [out-fmt] is an option output file format specification (default -%03d.png).

pdf2image.raku Options

• --page=n render just the nth page in the PDF file
• --batch=m render to threads in batches of m pages
• --trace trace PDF graphics

pdf-previews.raku <directory> --previews=<directory>

Render all PDF files in a given input directory (default .) and render PNG previews to a given output directory; by default to a .previews subdirectory in the input directory.

Status

Implemented:

• basic text, including fonts, word and character spacing
• most drawing and graphics operators
• form XObjects
• some (mostly PNG like) image XObjects (depends on state of PDF::Class PDF::Image.to-png() method)
• Gray, RGB, CMYK, DeviceN and Separation color-spaces
• Tiling patterns (not shading)

Nyi:

• advanced clipping and graphics settings
• many image types
• shading patterns
• some font types (in particular Type3 synthetic fonts)