PDF-Builder

Changes for version 3.017 - 2019-12-31

examples/RMtutorial.pl, examples/Boxes.pl, examples/README, examples/examples.output, MANIFEST, tools/3_examples.pl, INFO/old/examples.bat Rich Measham's tutorial on using PDF::API2, adapted for PDF::Builder. Also a demonstration of the interaction of PDF boxes (media, crop, bleed, trim, art).
lib/PDF/Builder/Basic/PDF/File-Pages.pm [RT 131147] fix problem with Null object bubbling up and forcing an improper method invocation. Fix used (by Vadim Repin) is in File.pm, while a narrower scope (and presumably a bit safer) fix (by Klaus Ethgen) is on standby in Pages.pm.
examples/Rotated.pl, examples/ShowFont.pl minor cleanup
examples/Rotated.pl, examples/README, examples/examples.output, examples/ContentText.pl, MANIFEST, tools/3_examples.pl, INFO/old/examples.bat Demonstrate how to embed rotated pages within a document.
CONTRIBUTING, README minor updates
INFO/KNOWN_INCOMP general statement about large batch of removals INFO/DEPRECATED, t/content.t, lib/PDF/Builder/Content.pm, lib/PDF/Builder/Resource/ExtGState.pm Remove deprecated method meterlimit() (use correct spelling miterlimit). INFO/DEPRECATED, t/content.t, lib/PDF/Builder/Content.pm Remove deprecated method hspace() (use corrected name hscale). INFO/DEPRECATED, lib/PDF/Builder/Content.pm Remove deprecated dash pattern options -full and -clear (replaced by -pattern option). INFO/DEPRECATED, t/deprecations.t, lib/PDF/Builder/NamedDestination.pm, lib/PDF/Builder/Resource.pm Remove deprecated method new_api() (use new instead). INFO/DEPRECATED, t/papersizes.t, lib/PDF/Builder/Resource/PaperSizes.pm Remove deprecated non-standard paper sizes 4a, 2a, 4b, 2b (use 4a0, 2a0, 4b0, 2b0 standard sizes instead). INFO/DEPRECATED, lib/PDF/Builder/Resource/XObject/Form/BarCode/code3of9.pm Remove deprecated method encode_3of9_string_w_chk() (use encode_3of9_string(*, 1) instead). INFO/DEPRECATED, lib/PDF/Builder/Resource/XObject/Form/BarCode/code3of9.pm Remove deprecated method encode_3of9_w_chk() (use encode_3of9(*, 1, 0) instead). INFO/DEPRECATED, lib/PDF/Builder/Resource/XObject/Form/BarCode/code3of9.pm Remove deprecated method encode_3of9_ext() (use encode_3of9(*, 0, 1) instead). INFO/DEPRECATED, lib/PDF/Builder/Resource/XObject/Form/BarCode/code3of9.pm Remove deprecated method encode_3of9_ext_w_chk() (use encode_3of9(*, 1, 1) instead). INFO/DEPRECATED, lib/PDF/Builder/Resource/XObject/Image.pm Rename deprecated methods imask() to mask() and bpc() to bits_per_component(). INFO/DEPRECATED, lib/PDF/Builder.pm Rename deprecated methods openScalar() to open_scalar() and importpage() to import_page(). INFO/DEPRECATED, lib/PDF/Builder/Annotation.pm Rename deprecated method pdfile() to pdf_file().
lib/PDF/Builder/Resource/XObject/Image/JPEG.pm check for uninitialized var per API2 2.037
Makefile.PL, lib/PDF/Builder/Docs.pm, README Remove "optional" libraries from attempt to install. It was not clear whether they would actually be installed or how users would react to failures to install them. Most of all, there was no information passed to owners of these optional libraries that their efforts were bearing fruit! Just leave them to be manually installed, if desired.
lib/PDF/Builder/Resource/Font/Corefont-Postscript-SynFont-BdFont.pm Check -encode for (invalid) multibyte encodings such as UTF*. There are probably more encoding names to be added later (East Asian alphabets, in particular). Bitmapped distribution fonts (BdFont) doesn't appear to support -encode, so remove it from the POD. TrueType fonts (alone) /do/ support multibyte encodings (as do CJK). Ref PDF::API2 PR 20 https://github.com/ssimms/pdfapi2/pull/20.
lib/PDF/Builder.pm, lib/PDF/Builder/Page.pm restrict rotate() method to multiple of 90 degrees. Also swap 'Rotate' property test order so that find_prop() not called unnecessariy (ref RT 130722). Clarify in the POD that a positive rotation is clockwise.
lib/PDF/Builder/Resource/BaseFont.pm per PDF::API2, default value for returned UniByCId value (when undef), preventing undefined errors.

Modules

PDF::Builder::Win32

PDF::Builder

Facilitates the creation and modification of PDF files

PDF::Builder::Annotation

Add annotations to a PDF

PDF::Builder::Basic::PDF::Array

Corresponds to a PDF array. Inherits from PDF::Builder::Basic::PDF::Objind

PDF::Builder::Basic::PDF::Bool

A special form of PDF::Builder::Basic::PDF::String which holds the strings true or false

PDF::Builder::Basic::PDF::Dict

PDF Dictionaries and Streams. Inherits from PDF::Builder::Basic::PDF::Objind

PDF::Builder::Basic::PDF::File

Holds the trailers and cross-reference tables for a PDF file

PDF::Builder::Basic::PDF::Filter

Abstract superclass for PDF stream filters

PDF::Builder::Basic::PDF::Filter::ASCII85Decode

compress and uncompress stream filters for ASCII-85

PDF::Builder::Basic::PDF::Filter::ASCIIHexDecode

compress and uncompress stream filters for ASCII-Hex

PDF::Builder::Basic::PDF::Filter::FlateDecode

compress and uncompress stream filters for Flate

PDF::Builder::Basic::PDF::Filter::LZWDecode

compress and uncompress stream filters for Lempel-Ziv-Welch

PDF::Builder::Basic::PDF::Filter::RunLengthDecode

compress and uncompress stream filters for Run-Length

PDF::Builder::Basic::PDF::Literal

Literal PDF Object. Inherits from PDF::Builder::Basic::PDF::Objind

PDF::Builder::Basic::PDF::Name

Inherits from PDF::Builder::Basic::PDF::String and stores PDF names (things beginning with /)

PDF::Builder::Basic::PDF::Null

PDF Null type object. This is a subclass of PDF::Builder::Basic::PDF::Objind and cannot be subclassed.

PDF::Builder::Basic::PDF::Number

Numbers in PDF. Inherits from PDF::Builder::Basic::PDF::String

PDF::Builder::Basic::PDF::Objind

PDF indirect object reference. Also acts as an abstract superclass for all elements in a PDF file.

PDF::Builder::Basic::PDF::Page

Represents a PDF page, inherits from PDF::Builder::Basic::PDF::Pages

PDF::Builder::Basic::PDF::Pages

a PDF pages hierarchical element. Inherits from PDF::Builder::Basic::PDF::Dict

PDF::Builder::Basic::PDF::String

PDF String type objects and superclass for simple objects that are basically stringlike (Number, Name, etc.)

PDF::Builder::Basic::PDF::Utils

Utility functions for PDF library

PDF::Builder::Content

Methods for adding graphics and text to a PDF

PDF::Builder::Content::Hyphenate_basic

Simple hyphenation capability

PDF::Builder::Content::Text

additional specialized text-related formatting methods. Inherits from PDF::Builder::Content

PDF::Builder::Docs

additional documentation for Builder module

PDF::Builder::Lite

Lightweight PDF creation methods

PDF::Builder::Matrix

matrix operations library

PDF::Builder::NamedDestination

Add named destination shortcuts to a PDF

PDF::Builder::Outline

Manage PDF outlines (a.k.a. bookmarks)

PDF::Builder::Outlines

further Outline handling. Inherits from PDF::Builder::Outline

PDF::Builder::Page

Methods to interact with individual pages

PDF::Builder::Resource

Base class for PDF resources. Inherit from PDF::Builder::Basic::PDF::Dict

PDF::Builder::Resource::BaseFont

Base class for font resources

PDF::Builder::Resource::CIDFont

Base class for CID fonts

PDF::Builder::Resource::CIDFont::CJKFont

Base class for CJK fonts

PDF::Builder::Resource::CIDFont::TrueType

TrueType font support

PDF::Builder::Resource::CIDFont::TrueType::FontFile

additional code support for TT font files. Inherits from PDF::Builder::Basic::PDF::Dict

PDF::Builder::Resource::ColorSpace

Base class for PDF color spaces

PDF::Builder::Resource::ColorSpace::DeviceN

colorspace handling for Device CMYK. Inherits from PDF::Builder::Resource::ColorSpace

PDF::Builder::Resource::ColorSpace::Indexed

base colorspace support for indexed color models. Inherits from PDF::Builder::Resource::ColorSpace

PDF::Builder::Resource::ColorSpace::Indexed::ACTFile

Adobe Color Table support

PDF::Builder::Resource::ColorSpace::Indexed::Hue

colorspace support for Device RGB. Inherits from PDF::Builder::Resource::ColorSpace::Indexed

PDF::Builder::Resource::ColorSpace::Indexed::WebColor

colorspace support for "Web Safe" Device RGB colors. Inherits from PDF::Builder::Resource::ColorSpace::Indexed

PDF::Builder::Resource::ColorSpace::Separation

Support for color space separations

PDF::Builder::Resource::Colors

translate color names into RGB settings

PDF::Builder::Resource::ExtGState

Graphics state dictionary support

PDF::Builder::Resource::Font

some common support routines for font files. Inherits from PDF::Builder::Resource::BaseFont

PDF::Builder::Resource::Font::BdFont

Module for using bitmapped Fonts.

PDF::Builder::Resource::Font::CoreFont

Module for using the 14 PDF built-in Fonts.

PDF::Builder::Resource::Font::CoreFont::bankgothic

font-specific information for Bank Gothic font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::courier

font-specific information for regular Courier font

PDF::Builder::Resource::Font::CoreFont::courierbold

font-specific information for bold weight Courier font

PDF::Builder::Resource::Font::CoreFont::courierboldoblique

font-specific information for bold weight + slanted Courier font

PDF::Builder::Resource::Font::CoreFont::courieroblique

font-specific information for slanted Courier font

PDF::Builder::Resource::Font::CoreFont::georgia

font-specific information for regular Georgia font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::georgiabold

font-specific information for bold weight Georgia font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::georgiabolditalic

font-specific information for bold weight + italic Georgia font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::georgiaitalic

font-specific information for italic Georgia font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::helvetica

font-specific information for regular Helvetica font

PDF::Builder::Resource::Font::CoreFont::helveticabold

font-specific information for bold weight Helvetica font

PDF::Builder::Resource::Font::CoreFont::helveticaboldoblique

font-specific information for bold weight + slanted Helvetica font

PDF::Builder::Resource::Font::CoreFont::helveticaoblique

font-specific information for slanted Helvetica font

PDF::Builder::Resource::Font::CoreFont::symbol

font-specific information for the Symbol font

PDF::Builder::Resource::Font::CoreFont::timesbold

font-specific information for bold weight Times font

PDF::Builder::Resource::Font::CoreFont::timesbolditalic

font-specific information for bold weight + italic Times font

PDF::Builder::Resource::Font::CoreFont::timesitalic

font-specific information for italic Times font

PDF::Builder::Resource::Font::CoreFont::timesroman

font-specific information for regular (roman) Times font

PDF::Builder::Resource::Font::CoreFont::trebuchet

font-specific information for regular Trebuchet font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::trebuchetbold

font-specific information for bold-weight Trebuchet font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::trebuchetbolditalic

font-specific information for bold weight + italic Trebuchet font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::trebuchetitalic

font-specific information for italic Trebuchet font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::verdana

font-specific information for regular Verdana font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::verdanabold

font-specific information for bold weight Verdana font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::verdanabolditalic

font-specific information for bold weight + italic Verdana font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::verdanaitalic

font-specific information for italic Verdana font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::webdings

font-specific information for WebDings symbol font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::wingdings

font-specific information for WingDings symbol font (not standard PDF core)

PDF::Builder::Resource::Font::CoreFont::zapfdingbats

font-specific information for Zapf Dingbats symbol font

PDF::Builder::Resource::Font::Postscript

support routines for using PostScript fonts. Inherits from PDF::Builder::Resource::Font

PDF::Builder::Resource::Font::SynFont

Module for using synthetic Fonts.

PDF::Builder::Resource::Glyphs

preparsed uniglyph.txt file information

PDF::Builder::Resource::PaperSizes

list of standard paper sizes and their dimensions

PDF::Builder::Resource::Pattern

support stub for patterns. Inherits from PDF::Builder::Resource

PDF::Builder::Resource::Shading

support stub for shading patterns. Inherits from PDF::Builder::Resource

PDF::Builder::Resource::UniFont

Unicode Font Support

PDF::Builder::Resource::XObject

Base class for external objects

PDF::Builder::Resource::XObject::Form

Base class for external form objects

PDF::Builder::Resource::XObject::Form::BarCode

Base class for one-dimensional barcodes

PDF::Builder::Resource::XObject::Form::BarCode::codabar

specific information for CodaBar bar codes. Inherits from PDF::Builder::Resource::XObject::Form::BarCode

PDF::Builder::Resource::XObject::Form::BarCode::code128

Code 128 and EAN-128 barcode support

PDF::Builder::Resource::XObject::Form::BarCode::code3of9

specific information for 3-of-9 bar codes. Inherits from PDF::Builder::Resource::XObject::Form::BarCode

PDF::Builder::Resource::XObject::Form::BarCode::ean13

specific information for EAN-13 bar codes. Inherits from PDF::Builder::Resource::XObject::Form::BarCode

PDF::Builder::Resource::XObject::Form::BarCode::int2of5

specific information for int 2-of-5 bar codes. Inherits from PDF::Builder::Resource::XObject::Form::BarCode

PDF::Builder::Resource::XObject::Form::Hybrid

support routines for Forms. Inherits from PDF::Builder::Content, PDF::Builder::Content::Text, and PDF::Builder::Resource::XObject::Form

PDF::Builder::Resource::XObject::Image

Base class for external raster image objects

PDF::Builder::Resource::XObject::Image::GD

support routines for Graphics Development image library. Inherits from PDF::Builder::Resource::XObject::Image

PDF::Builder::Resource::XObject::Image::GIF

support routines for GIF image library. Inherits from PDF::Builder::Resource::XObject::Image

PDF::Builder::Resource::XObject::Image::JPEG

support routines for JPEG image library. Inherits from PDF::Builder::Resource::XObject::Image

PDF::Builder::Resource::XObject::Image::PNG

support routines for PNG image library (using pure Perl code). Inherits from PDF::Builder::Resource::XObject::Image

PDF::Builder::Resource::XObject::Image::PNG_IPL

support routines for PNG image library (using Image::PNG::Libpng). Inherits from PDF::Builder::Resource::XObject::Image

PDF::Builder::Resource::XObject::Image::PNM

support routines for PNM (Portable aNy Map) image library. Inherits from PDF::Builder::Resource::XObject::Image

PDF::Builder::Resource::XObject::Image::TIFF

TIFF image support

PDF::Builder::Resource::XObject::Image::TIFF::File

support routines for TIFF image library

PDF::Builder::Resource::XObject::Image::TIFF::File_GT

support routines for TIFF image library (Graphics::TIFF enabled)

PDF::Builder::Resource::XObject::Image::TIFF_GT

TIFF image support (Graphics::TIFF enabled)

PDF::Builder::UniWrap

support routines for finding line breakpoints with Unicode text

PDF::Builder::Util

utility package for often-used methods across the package.

Examples

Other files

To install PDF::Builder, copy and paste the appropriate command in to your terminal.

cpanm

cpanm PDF::Builder

CPAN shell

perl -MCPAN -e shell
install PDF::Builder

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)

Changes for version 3.017 - 2019-12-31

Modules

Examples

Other files

Module Install Instructions