PDF-Builder

Changes for version 3.018 - 2020-04-24

lib/PDF/Builder/Content.pm-Page.pm [RT 132403] clarify documentation on the two different rotate() methods.
lib/PDF/Builder/Content/Hyphenate_basic.pm, lib/PDF/Builder/Content.pm- Docs.pm, lib/PDF/Builder/Resource/BaseFont.pm, examples/HarfBuzz.pl, examples/resources/HarfBuzz_example.pdf, examples/examples.output, examples/README, tools/3_examples.pl, INFO/old/examples.bat, Makefile.PL, README, MANIFEST Implement support for use of HarfBuzz::Shaper (to shape chunks of text). [RT 113700] This is an optional installation (manually done). examples/HarfBuzz.pl will not run if you do not have HarfBuzz::Shaper installed. HarfBuzz_example.pdf is provided in examples/resources/ in case you can't (yet) run HarfBuzz.pl. It demonstrates the use of HarfBuzz::Shaper for a variety of Western (ligatures and kerning), Middle Eastern (script and RTL), and South and Southeast Asian scripts.
lib/PDF/Builder/Content.pm Add 'none' option to text underline and strikethrough options. This was added to permit the option (underline or strikethrough) to be given in the code, but allow a 'none' value in those cases where drawing an underline or strikethrough is not desired. This is still the default.
examples/021_synfonts, examples/examples.output, examples/README The synthetic font example only showed for regular BankGothic font. Added bold, bold-italic, and italic cases. Note that there is something a bit odd about Bank Gothic -- it looks like it may only have regular weight (no bold) and the italic is questionable.
tools/TTFdump.pl, MANIFEST, lib/PDF/Builder/Resource/Font/CoreFont.pm, lib/PDF/Builder/Resource/BaseFont.pm, examples/022_truefonts, lib/PDF/Builder/Resource/Font/CoreFont/courier*.pm- helvetica*.pm-times*.pm-georgia*.pm-trebuchet*.pm-verdana*.pm Add full set of glyph widths to core font metrics files [RT 57248]. This is intended to allow correct rendering of non-Latin-1 single byte fonts, by expanding the width listing beyond Latin-1. A utility is provided to read a TTF/OTF font and return glyph lists in a format that can be dropped into a [typeface].pm file. Only glyph widths table was changed (no other metrics). Arial was used for Helvetica metrics, BankGothic could not be found (not sure what's being substituted for it), and various symbology fonts were not changed. Courier "missing width" updated to reflect the character used to indicate a missing glyph.
INFO/RoadMap Update some items. Mention other packages PDF::Table, Text::Layout, and HarfBuzz::Shaper that may be useful.
lib/PDF/Builder/Resource/CIDFont.pm For TTF (ttfont) fix improper ToUnicode cmap so that a PDF may be searched (was broken in 3.016).
lib/PDF/Builder/Content.pm Add example of using add() function to cancel Chrome browser scaling and Y-axis flip before new content is added to an existing PDF.
lib/PDF/Builder/Content.pm, lib/PDF/Builder/Content/Text.pm Remind users not to use charspace() when working with a connected (script) font such as Arabic, Devanagari, cursive handwriting, etc. Add -nocs option to text line fill (justified) routines to not use any charspace() values when expanding or shrinking text content to fit.
lib/PDF/Builder/Basic/PDF/File.pm. The earlier fix for corrupted xref table only ran under diagnostics. Now only the warning message is under the diagnostics flag (-diags), and the fixup attempt is always run.
INFO/Changes_2019, Changes, MANIFEST, lib/PDF/Builder.pm, README, Makefile.PL, INFO/KNOWN_INCOMP 3.017 build/release, 2020 copyright, archive 2019 changes.
(see INFO/Changes_2019 for earlier changes) (see INFO/Changes-ver_2 for changes to PDF::API2 up through 2.033)

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. Metrics and glyph list from Arial typeface.

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

font-specific information for bold weight Helvetica font. Metrics and glyph list from Arial typeface.

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

font-specific information for bold weight + slanted Helvetica font. Metrics and glyph list from Arial font.

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

font-specific information for slanted Helvetica font. Metrics and glyph list from Arial 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.018 - 2020-04-24

Modules

Examples

Other files

Module Install Instructions