api

package
Version: v0.3.12 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 12, 2021 License: Apache-2.0 Imports: 17 Imported by: 31

Documentation

Overview

Package api lets you integrate pdfcpu's operations into your Go backend.

There are two api layers supporting all pdfcpu operations:

1) The file based layer (used by pdfcpu's cli)
2) The io.ReadSeeker/io.Writer based layer for backend integration.

For any pdfcpu command there are two functions.

The file based function always calls the io.ReadSeeker/io.Writer based function:

func CommandFile(inFile, outFile string, conf *pdf.Configuration) error
func Command(rs io.ReadSeeker, w io.Writer, conf *pdf.Configuration) error

eg. for optimization:

func OptimizeFile(inFile, outFile string, conf *pdf.Configuration) error
func Optimize(rs io.ReadSeeker, w io.Writer, conf *pdf.Configuration) error

Index

Examples

Constants

This section is empty.

Variables

This section is empty.

Functions

func AddAnnotations added in v0.3.12

func AddAnnotations(rs io.ReadSeeker, w io.Writer, selectedPages []string, ann pdfcpu.AnnotationRenderer, conf *pdfcpu.Configuration) error

AddAnnotations adds annotations for selected pages in rs and writes the result to w.

func AddAnnotationsAsIncrement added in v0.3.12

func AddAnnotationsAsIncrement(rws io.ReadWriteSeeker, selectedPages []string, ar pdfcpu.AnnotationRenderer, conf *pdfcpu.Configuration) error

AddAnnotationsAsIncrement adds annotations for selected pages in rws and writes out a PDF increment.

func AddAnnotationsFile added in v0.3.12

func AddAnnotationsFile(inFile, outFile string, selectedPages []string, ar pdfcpu.AnnotationRenderer, conf *pdfcpu.Configuration, incr bool) (err error)

AddAnnotationsFile adds annotations for selected pages to a PDF context read from inFile and writes the result to outFile.

func AddAnnotationsMap added in v0.3.12

func AddAnnotationsMap(rs io.ReadSeeker, w io.Writer, m map[int][]pdfcpu.AnnotationRenderer, conf *pdfcpu.Configuration) error

AddAnnotationsMap adds annotations in m to corresponding pages of rs and writes the result to w.

func AddAnnotationsMapAsIncrement added in v0.3.12

func AddAnnotationsMapAsIncrement(rws io.ReadWriteSeeker, m map[int][]pdfcpu.AnnotationRenderer, conf *pdfcpu.Configuration) error

AddAnnotationsMapAsIncrement adds annotations in m to corresponding pages of rws and writes out a PDF increment.

func AddAnnotationsMapFile added in v0.3.12

func AddAnnotationsMapFile(inFile, outFile string, m map[int][]pdfcpu.AnnotationRenderer, conf *pdfcpu.Configuration, incr bool) (err error)

AddAnnotationsMapFile adds annotations in m to corresponding pages of inFile and writes the result to outFile.

func AddAttachments

func AddAttachments(rs io.ReadSeeker, w io.Writer, files []string, coll bool, conf *pdfcpu.Configuration) error

AddAttachments embeds files into a PDF context read from rs and writes the result to w. file is either a file name or a file name and a description separated by a comma.

func AddAttachmentsFile added in v0.2.3

func AddAttachmentsFile(inFile, outFile string, files []string, coll bool, conf *pdfcpu.Configuration) (err error)

AddAttachmentsFile embeds files into a PDF context read from inFile and writes the result to outFile.

Example
// Attach 3 files to in.pdf.
AddAttachmentsFile("in.pdf", "", []string{"img.jpg", "attach.pdf", "test.zip"}, false, nil)
Output:

func AddBookmarks added in v0.3.12

func AddBookmarks(rs io.ReadSeeker, w io.Writer, bms []pdf.Bookmark, conf *pdf.Configuration) error

AddBookmarks adds a single bookmark outline layer to the PDF context read from rs and writes the result to w.

func AddBookmarksFile added in v0.3.12

func AddBookmarksFile(inFile, outFile string, bms []pdf.Bookmark, conf *pdf.Configuration) (err error)

AddBookmarksFile adds a single bookmark outline layer to the PDF context read from inFile and writes the result to outFile.

func AddBoxes added in v0.3.8

func AddBoxes(rs io.ReadSeeker, w io.Writer, selectedPages []string, pb *pdfcpu.PageBoundaries, conf *pdfcpu.Configuration) error

AddBoxes adds page boundaries for selected pages of rs and writes result to w.

func AddBoxesFile added in v0.3.8

func AddBoxesFile(inFile, outFile string, selectedPages []string, pb *pdfcpu.PageBoundaries, conf *pdfcpu.Configuration) error

AddBoxesFile adds page boundaries for selected pages of inFile and writes result to outFile.

func AddImageWatermarksFile added in v0.3.4

func AddImageWatermarksFile(inFile, outFile string, selectedPages []string, onTop bool, fileName, desc string, conf *pdfcpu.Configuration) error

AddImageWatermarksFile adds image stamps/watermarks to all selected pages of inFile and writes the result to outFile.

func AddImageWatermarksForReaderFile added in v0.3.12

func AddImageWatermarksForReaderFile(inFile, outFile string, selectedPages []string, onTop bool, r io.Reader, desc string, conf *pdfcpu.Configuration) error

AddImageWatermarksForReaderFile adds image stamps/watermarks to all selected pages of inFile for r and writes the result to outFile.

func AddKeywords added in v0.3.2

func AddKeywords(rs io.ReadSeeker, w io.Writer, files []string, conf *pdf.Configuration) error

AddKeywords embeds files into a PDF context read from rs and writes the result to w.

func AddKeywordsFile added in v0.3.2

func AddKeywordsFile(inFile, outFile string, files []string, conf *pdf.Configuration) (err error)

AddKeywordsFile embeds files into a PDF context read from inFile and writes the result to outFile.

func AddPDFWatermarksFile added in v0.3.4

func AddPDFWatermarksFile(inFile, outFile string, selectedPages []string, onTop bool, fileName, desc string, conf *pdfcpu.Configuration) error

AddPDFWatermarksFile adds PDF stamps/watermarks to all selected pages of inFile and writes the result to outFile.

func AddProperties added in v0.3.2

func AddProperties(rs io.ReadSeeker, w io.Writer, properties map[string]string, conf *pdf.Configuration) error

AddProperties embeds files into a PDF context read from rs and writes the result to w.

func AddPropertiesFile added in v0.3.2

func AddPropertiesFile(inFile, outFile string, properties map[string]string, conf *pdf.Configuration) (err error)

AddPropertiesFile embeds files into a PDF context read from inFile and writes the result to outFile.

func AddTextWatermarksFile added in v0.3.4

func AddTextWatermarksFile(inFile, outFile string, selectedPages []string, onTop bool, text, desc string, conf *pdfcpu.Configuration) error

AddTextWatermarksFile adds text stamps/watermarks to all selected pages of inFile and writes the result to outFile.

func AddWatermarks added in v0.1.16

func AddWatermarks(rs io.ReadSeeker, w io.Writer, selectedPages []string, wm *pdfcpu.Watermark, conf *pdfcpu.Configuration) error

AddWatermarks adds watermarks to all pages selected in rs and writes the result to w.

func AddWatermarksFile added in v0.2.3

func AddWatermarksFile(inFile, outFile string, selectedPages []string, wm *pdfcpu.Watermark, conf *pdfcpu.Configuration) (err error)

AddWatermarksFile adds watermarks to all selected pages of inFile and writes the result to outFile.

Example
// Unique abbreviations are accepted for all watermark descriptor parameters.
// eg. sc = scalefactor or rot = rotation

// Add a "Demo" watermark to all pages of in.pdf along the diagonal running from lower left to upper right.
onTop := false
update := false
wm, _ := TextWatermark("Demo", "", onTop, update, pdfcpu.POINTS)
AddWatermarksFile("in.pdf", "", nil, wm, nil)

// Stamp all odd pages of in.pdf in red "Confidential" in 48 point Courier
// using a rotation angle of 45 degrees and an absolute scalefactor of 1.0.
onTop = true
wm, _ = TextWatermark("Confidential", "font:Courier, points:48, col: 1 0 0, rot:45, sc:1 abs, ", onTop, update, pdfcpu.POINTS)
AddWatermarksFile("in.pdf", "", []string{"odd"}, wm, nil)

// Add image stamps to in.pdf using absolute scaling and a negative rotation of 90 degrees.
wm, _ = ImageWatermark("image.png", "scalefactor:.5 a, rot:-90", onTop, update, pdfcpu.POINTS)
AddWatermarksFile("in.pdf", "", nil, wm, nil)

// Add a PDF stamp to all pages of in.pdf using the 2nd page of stamp.pdf, use absolute scaling of 0.5
// and rotate along the 2nd diagonal running from upper left to lower right corner.
wm, _ = PDFWatermark("stamp.pdf:2", "sc:.5 abs, diagonal:2", onTop, update, pdfcpu.POINTS)
AddWatermarksFile("in.pdf", "", nil, wm, nil)
Output:

func AddWatermarksMap added in v0.3.8

func AddWatermarksMap(rs io.ReadSeeker, w io.Writer, m map[int]*pdfcpu.Watermark, conf *pdfcpu.Configuration) error

AddWatermarksMap adds watermarks in m to corresponding pages in rs and writes the result to w.

func AddWatermarksMapFile added in v0.3.8

func AddWatermarksMapFile(inFile, outFile string, m map[int]*pdfcpu.Watermark, conf *pdfcpu.Configuration) (err error)

AddWatermarksMapFile adds watermarks to corresponding pages in m of inFile and writes the result to outFile.

func AddWatermarksSliceMap added in v0.3.10

func AddWatermarksSliceMap(rs io.ReadSeeker, w io.Writer, m map[int][]*pdfcpu.Watermark, conf *pdfcpu.Configuration) error

AddWatermarksSliceMap adds watermarks in m to corresponding pages in rs and writes the result to w.

func AddWatermarksSliceMapFile added in v0.3.10

func AddWatermarksSliceMapFile(inFile, outFile string, m map[int][]*pdfcpu.Watermark, conf *pdfcpu.Configuration) (err error)

AddWatermarksSliceMapFile adds watermarks to corresponding pages in m of inFile and writes the result to outFile.

func Booklet added in v0.3.9

func Booklet(rs io.ReadSeeker, w io.Writer, imgFiles, selectedPages []string, nup *pdfcpu.NUp, conf *pdfcpu.Configuration) error

Booklet arranges PDF pages on larger sheets of paper and writes the result to w.

func BookletFile added in v0.3.9

func BookletFile(inFiles []string, outFile string, selectedPages []string, nup *pdfcpu.NUp, conf *pdfcpu.Configuration) (err error)

BookletFile rearranges PDF pages or images into a booklet layout and writes the result to outFile.

func BookletFromImages added in v0.3.9

func BookletFromImages(conf *pdfcpu.Configuration, imageFileNames []string, nup *pdfcpu.NUp) (*pdfcpu.Context, error)

BookletFromImages creates a booklet from images.

func Box added in v0.3.8

func Box(s string, u pdfcpu.DisplayUnit) (*pdfcpu.Box, error)

Box parses a box definition.

func ChangeOwnerPasswordFile added in v0.2.3

func ChangeOwnerPasswordFile(inFile, outFile string, pwOld, pwNew string, conf *pdfcpu.Configuration) error

ChangeOwnerPasswordFile reads inFile, changes the user password and writes the result to outFile. A configuration containing the current passwords is required.

Example
// Changing the owner password for an AES-256 encrypted file.
conf := pdfcpu.NewAESConfiguration("upw", "opw", 256)
ChangeOwnerPasswordFile("in.pdf", "", "opw", "opwNew", conf)
Output:

func ChangeUserPasswordFile added in v0.2.3

func ChangeUserPasswordFile(inFile, outFile string, pwOld, pwNew string, conf *pdfcpu.Configuration) error

ChangeUserPasswordFile reads inFile, changes the user password and writes the result to outFile. A configuration containing the current passwords is required.

Example
// Changing the user password for an AES-256 encrypted file.
conf := pdfcpu.NewAESConfiguration("upw", "opw", 256)
ChangeUserPasswordFile("in.pdf", "", "upw", "upwNew", conf)
Output:

func Collect added in v0.3.2

func Collect(rs io.ReadSeeker, w io.Writer, selectedPages []string, conf *pdfcpu.Configuration) error

Collect creates a custom PDF page sequence for selected pages of rs and writes the result to w.

func CollectFile added in v0.3.2

func CollectFile(inFile, outFile string, selectedPages []string, conf *pdfcpu.Configuration) (err error)

CollectFile creates a custom PDF page sequence for inFile and writes the result to outFile.

func CreateCheatSheetsUserFonts added in v0.3.7

func CreateCheatSheetsUserFonts(fontNames []string) error

CreateCheatSheetsUserFonts creates single page PDF cheat sheets for installed user fonts.

func CreatePDFFile added in v0.2.3

func CreatePDFFile(xRefTable *pdf.XRefTable, outFile string, conf *pdf.Configuration) error

CreatePDFFile creates a PDF file for an xRefTable and writes it to outFile.

func CreateUserFontDemoFiles added in v0.3.7

func CreateUserFontDemoFiles(dir, fn string) error

CreateUserFontDemoFiles creates single page PDF for each Unicode plane covered.

func Crop added in v0.3.8

func Crop(rs io.ReadSeeker, w io.Writer, selectedPages []string, b *pdfcpu.Box, conf *pdfcpu.Configuration) error

Crop adds crop boxes for selected pages of rs and writes result to w.

func CropFile added in v0.3.8

func CropFile(inFile, outFile string, selectedPages []string, b *pdfcpu.Box, conf *pdfcpu.Configuration) error

CropFile adds crop boxes for selected pages of inFile and writes result to outFile.

func DecryptFile added in v0.2.3

func DecryptFile(inFile, outFile string, conf *pdfcpu.Configuration) error

DecryptFile decrypts inFile and writes the result to outFile. A configuration containing the current passwords is required.

Example
// Decrypting an AES-256 encrypted file.
conf := pdfcpu.NewAESConfiguration("upw", "opw", 256)
DecryptFile("in.pdf", "", conf)
Output:

func DisableConfigDir added in v0.3.6

func DisableConfigDir()

DisableConfigDir disables the configuration directory. Any needed default configuration will be loaded from configuration.go Since the config dir also contains the user font dir, this also limits font usage to the default core font set No user fonts will be available.

func EncryptFile added in v0.2.3

func EncryptFile(inFile, outFile string, conf *pdfcpu.Configuration) error

EncryptFile encrypts inFile and writes the result to outFile. A configuration containing the current passwords is required.

Example
// Encrypting a file using AES-256.
conf := pdfcpu.NewAESConfiguration("upw", "opw", 256)
EncryptFile("in.pdf", "", conf)
Output:

func EnsureDefaultConfigAt added in v0.3.6

func EnsureDefaultConfigAt(path string) error

EnsureDefaultConfigAt switches to the pdfcpu config dir located at path. If path/pdfcpu is not existent, it will be created including config.yml

func ExtractAttachments

func ExtractAttachments(rs io.ReadSeeker, outDir string, fileNames []string, conf *pdfcpu.Configuration) error

ExtractAttachments extracts embedded files from a PDF context read from rs into outDir.

func ExtractAttachmentsFile added in v0.2.3

func ExtractAttachmentsFile(inFile, outDir string, files []string, conf *pdfcpu.Configuration) error

ExtractAttachmentsFile extracts embedded files from a PDF context read from inFile into outDir.

Example
// Extract 1 attachment from in.pdf into outDir.
ExtractAttachmentsFile("in.pdf", "outDir", []string{"img.jpg"}, nil)

// Extract all attachments from in.pdf into outDir
ExtractAttachmentsFile("in.pdf", "outDir", nil, nil)
Output:

func ExtractAttachmentsRaw added in v0.3.12

func ExtractAttachmentsRaw(rs io.ReadSeeker, outDir string, fileNames []string, conf *pdfcpu.Configuration) ([]pdfcpu.Attachment, error)

ExtractAttachmentsRaw extracts embedded files from a PDF context read from rs.

func ExtractContent

func ExtractContent(rs io.ReadSeeker, outDir, fileName string, selectedPages []string, conf *pdfcpu.Configuration) error

ExtractContent dumps "PDF source" files from rs into outDir for selected pages.

func ExtractContentFile added in v0.2.3

func ExtractContentFile(inFile, outDir string, selectedPages []string, conf *pdfcpu.Configuration) error

ExtractContentFile dumps "PDF source" files from inFile into outDir for selected pages.

Example
// Extract content for all pages in PDF syntax from in.pdf into outDir.
ExtractContentFile("in.pdf", "outDir", nil, nil)
Output:

func ExtractFonts

func ExtractFonts(rs io.ReadSeeker, outDir, fileName string, selectedPages []string, conf *pdfcpu.Configuration) error

ExtractFonts dumps embedded fontfiles from rs into outDir for selected pages.

func ExtractFontsFile added in v0.2.3

func ExtractFontsFile(inFile, outDir string, selectedPages []string, conf *pdfcpu.Configuration) error

ExtractFontsFile dumps embedded fontfiles from inFile into outDir for selected pages.

Example
// Extract embedded fonts for pages 1-3 from in.pdf into outDir.
ExtractFontsFile("in.pdf", "outDir", []string{"1-3"}, nil)
Output:

func ExtractImages

func ExtractImages(rs io.ReadSeeker, selectedPages []string, digestImage func(pdfcpu.Image, bool, int) error, conf *pdfcpu.Configuration) error

ExtractImages extracts and digests embedded image resources from rs for selected pages.

func ExtractImagesFile added in v0.2.3

func ExtractImagesFile(inFile, outDir string, selectedPages []string, conf *pdfcpu.Configuration) error

ExtractImagesFile dumps embedded image resources from inFile into outDir for selected pages.

Example
// Extract embedded images from in.pdf into outDir.
ExtractImagesFile("in.pdf", "outDir", nil, nil)
Output:

func ExtractImagesRaw added in v0.3.12

func ExtractImagesRaw(rs io.ReadSeeker, selectedPages []string, conf *pdfcpu.Configuration) ([]pdfcpu.Image, error)

ExtractImagesRaw returns []pdfcpu.Image containing io.Readers for images contained in selectedPages.

func ExtractMetadata added in v0.1.16

func ExtractMetadata(rs io.ReadSeeker, outDir, fileName string, conf *pdfcpu.Configuration) error

ExtractMetadata dumps all metadata dict entries for rs into outDir.

func ExtractMetadataFile added in v0.2.3

func ExtractMetadataFile(inFile, outDir string, conf *pdfcpu.Configuration) error

ExtractMetadataFile dumps all metadata dict entries for inFile into outDir.

Example
// Extract all metadata from in.pdf into outDir.
ExtractMetadataFile("in.pdf", "outDir", nil)
Output:

func ExtractPages

func ExtractPages(rs io.ReadSeeker, outDir, fileName string, selectedPages []string, conf *pdfcpu.Configuration) error

ExtractPages generates single page PDF files from rs in outDir for selected pages.

func ExtractPagesFile added in v0.2.3

func ExtractPagesFile(inFile, outDir string, selectedPages []string, conf *pdfcpu.Configuration) error

ExtractPagesFile generates single page PDF files from inFile in outDir for selected pages.

Example
// Extract all even numbered pages from in.pdf into outDir.
ExtractPagesFile("in.pdf", "outDir", []string{"even"}, nil)
Output:

func GetPermissions added in v0.3.4

func GetPermissions(rs io.ReadSeeker, conf *pdfcpu.Configuration) (*int16, error)

GetPermissions returns the permissions for rs.

func GetPermissionsFile added in v0.3.4

func GetPermissionsFile(inFile string, conf *pdfcpu.Configuration) (*int16, error)

GetPermissionsFile returns the permissions for inFile.

func HasWatermarks added in v0.3.1

func HasWatermarks(rs io.ReadSeeker, conf *pdfcpu.Configuration) (bool, error)

HasWatermarks checks rs for watermarks.

func HasWatermarksFile added in v0.3.1

func HasWatermarksFile(inFile string, conf *pdfcpu.Configuration) (bool, error)

HasWatermarksFile checks inFile for watermarks.

func ImageBookletConfig added in v0.3.9

func ImageBookletConfig(val int, desc string) (*pdfcpu.NUp, error)

ImageBookletConfig returns an NUp configuration for Booklet-ing image files.

func ImageGridConfig added in v0.3.9

func ImageGridConfig(rows, cols int, desc string) (*pdfcpu.NUp, error)

ImageGridConfig returns a grid configuration for Grid-ing image files.

func ImageNUpConfig added in v0.3.9

func ImageNUpConfig(val int, desc string) (*pdfcpu.NUp, error)

ImageNUpConfig returns an NUp configuration for Nup-ing image files.

func ImageWatermark added in v0.3.4

func ImageWatermark(fileName, desc string, onTop, update bool, u pdfcpu.DisplayUnit) (*pdfcpu.Watermark, error)

ImageWatermark returns an image watermark configuration.

func ImageWatermarkForReader added in v0.3.12

func ImageWatermarkForReader(r io.Reader, desc string, onTop, update bool, u pdfcpu.DisplayUnit) (*pdfcpu.Watermark, error)

ImageWatermarkForReader returns an image watermark configuration for r.

func Import added in v0.3.8

func Import(s string, u pdfcpu.DisplayUnit) (*pdfcpu.Import, error)

Import parses an Import command string into an internal structure.

func ImportImages added in v0.1.20

func ImportImages(rs io.ReadSeeker, w io.Writer, imgs []io.Reader, imp *pdfcpu.Import, conf *pdfcpu.Configuration) error

ImportImages appends PDF pages containing images to rs and writes the result to w. If rs == nil a new PDF file will be written to w.

func ImportImagesFile added in v0.2.3

func ImportImagesFile(imgFiles []string, outFile string, imp *pdfcpu.Import, conf *pdfcpu.Configuration) (err error)

ImportImagesFile appends PDF pages containing images to outFile which will be created if necessary.

Example
// Convert an image into a single page of out.pdf which will be created if necessary.
// The page dimensions will match the image dimensions.
// If out.pdf already exists, append a new page.
// Use the default import configuration.
ImportImagesFile([]string{"image.png"}, "out.pdf", nil, nil)

// Import images by creating an A3 page for each image.
// Images are page centered with 1.0 relative scaling.
// Import an image as a new page of the existing out.pdf.
imp, _ := Import("form:A3, pos:c, s:1.0", pdfcpu.POINTS)
ImportImagesFile([]string{"a1.png", "a2.jpg", "a3.tiff"}, "out.pdf", imp, nil)
Output:

func Info added in v0.2.3

func Info(rs io.ReadSeeker, selectedPages []string, conf *pdfcpu.Configuration) ([]string, error)

Info returns information about rs.

func InfoFile added in v0.2.3

func InfoFile(inFile string, selectedPages []string, conf *pdfcpu.Configuration) ([]string, error)

InfoFile returns information about inFile.

func InsertPages added in v0.2.3

func InsertPages(rs io.ReadSeeker, w io.Writer, selectedPages []string, before bool, conf *pdfcpu.Configuration) error

InsertPages inserts a blank page before or after every page selected of rs and writes the result to w.

func InsertPagesFile added in v0.2.3

func InsertPagesFile(inFile, outFile string, selectedPages []string, before bool, conf *pdfcpu.Configuration) (err error)

InsertPagesFile inserts a blank page before or after every inFile page selected and writes the result to w.

Example
// Insert a blank page into in.pdf before page #3.
InsertPagesFile("in.pdf", "", []string{"3"}, true, nil)

// Insert a blank page into in.pdf after every page.
InsertPagesFile("in.pdf", "", nil, false, nil)
Output:

func InstallFonts added in v0.3.1

func InstallFonts(fileNames []string) error

InstallFonts installs true type fonts for embedding.

func ListAnnotations added in v0.3.12

func ListAnnotations(rs io.ReadSeeker, selectedPages []string, conf *pdfcpu.Configuration) (int, []string, error)

ListAnnotations returns a list of page annotations of rs.

func ListAnnotationsFile added in v0.3.12

func ListAnnotationsFile(inFile string, selectedPages []string, conf *pdfcpu.Configuration) (int, []string, error)

ListAnnotationsFile returns a list of page annotations of inFile.

func ListAttachments

func ListAttachments(rs io.ReadSeeker, conf *pdfcpu.Configuration) ([]string, error)

ListAttachments returns a list of embedded file attachments of rs with optional description.

func ListAttachmentsCompact added in v0.3.12

func ListAttachmentsCompact(rs io.ReadSeeker, conf *pdfcpu.Configuration) ([]string, error)

ListAttachmentsCompact returns a list of embedded file attachments of rs w/o optional description.

func ListAttachmentsCompactFile added in v0.3.12

func ListAttachmentsCompactFile(inFile string, conf *pdfcpu.Configuration) ([]string, error)

ListAttachmentsCompactFile returns a list of embedded file attachments of inFile w/o optional description.

func ListAttachmentsFile added in v0.2.3

func ListAttachmentsFile(inFile string, conf *pdfcpu.Configuration) ([]string, error)

ListAttachmentsFile returns a list of embedded file attachments of inFile with optional description.

Example
// Output a list of attachments of in.pdf.
list, _ := ListAttachmentsFile("in.pdf", nil)
for _, s := range list {
	fmt.Println(s)
}
Output:

func ListBoxes added in v0.3.8

func ListBoxes(rs io.ReadSeeker, selectedPages []string, pb *pdfcpu.PageBoundaries, conf *pdfcpu.Configuration) ([]string, error)

ListBoxes returns a list of page boundaries for selected pages of rs.

func ListBoxesFile added in v0.3.8

func ListBoxesFile(inFile string, selectedPages []string, pb *pdfcpu.PageBoundaries, conf *pdfcpu.Configuration) ([]string, error)

ListBoxesFile returns a list of page boundaries for selected pages of inFile.

func ListFonts added in v0.3.1

func ListFonts() ([]string, error)

ListFonts returns a list of supported fonts.

func ListImages added in v0.3.12

func ListImages(rs io.ReadSeeker, selectedPages []string, conf *pdfcpu.Configuration) ([]string, error)

ListImages returns a list of page annotations of rs.

func ListImagesFile added in v0.3.12

func ListImagesFile(inFile string, selectedPages []string, conf *pdfcpu.Configuration) ([]string, error)

ListImagesFile returns a list of embedded images of inFile.

func ListKeywords added in v0.3.2

func ListKeywords(rs io.ReadSeeker, conf *pdf.Configuration) ([]string, error)

ListKeywords returns the keyword list of rs.

func ListKeywordsFile added in v0.3.2

func ListKeywordsFile(inFile string, conf *pdf.Configuration) ([]string, error)

ListKeywordsFile returns the keyword list of inFile.

func ListPermissions

func ListPermissions(rs io.ReadSeeker, conf *pdfcpu.Configuration) ([]string, error)

ListPermissions returns a list of user access permissions.

func ListPermissionsFile added in v0.2.3

func ListPermissionsFile(inFile string, conf *pdfcpu.Configuration) ([]string, error)

ListPermissionsFile returns a list of user access permissions for inFile.

Example
// Output the current permissions of in.pdf.
list, _ := ListPermissionsFile("in.pdf", nil)
for _, s := range list {
	fmt.Println(s)
}
Output:

func ListProperties added in v0.3.2

func ListProperties(rs io.ReadSeeker, conf *pdf.Configuration) ([]string, error)

ListProperties returns the property list of rs.

func ListPropertiesFile added in v0.3.2

func ListPropertiesFile(inFile string, conf *pdf.Configuration) ([]string, error)

ListPropertiesFile returns the property list of inFile.

func LoadConfiguration added in v0.3.7

func LoadConfiguration()

LoadConfiguration locates and loads the default configuration and also loads installed user fonts.

func Merge

func Merge(rsc []io.ReadSeeker, w io.Writer, conf *pdfcpu.Configuration) error

Merge merges a sequence of PDF streams and writes the result to w.

func MergeAppendFile added in v0.3.3

func MergeAppendFile(inFiles []string, outFile string, conf *pdfcpu.Configuration) (err error)

MergeAppendFile merges a sequence of inFiles and writes the result to outFile. This operation corresponds to file concatenation in the order specified by inFiles. If outFile already exists, inFiles will be appended.

Example
// Merge inFiles by concatenation in the order specified and write the result to out.pdf.
// If out.pdf already exists it will be preserved and serves as the beginning of the merge result.
inFiles := []string{"in1.pdf", "in2.pdf"}
MergeAppendFile(inFiles, "out.pdf", nil)
Output:

func MergeCreateFile added in v0.3.3

func MergeCreateFile(inFiles []string, outFile string, conf *pdfcpu.Configuration) error

MergeCreateFile merges a sequence of inFiles and writes the result to outFile. This operation corresponds to file concatenation in the order specified by inFiles. The first entry of inFiles serves as the destination context where all remaining files get merged into.

Example
// Merge inFiles by concatenation in the order specified and write the result to out.pdf.
// out.pdf will be overwritten.
inFiles := []string{"in1.pdf", "in2.pdf"}
MergeCreateFile(inFiles, "out.pdf", nil)
Output:

func NUp added in v0.1.21

func NUp(rs io.ReadSeeker, w io.Writer, imgFiles, selectedPages []string, nup *pdfcpu.NUp, conf *pdfcpu.Configuration) error

NUp rearranges PDF pages or images into page grids and writes the result to w. Either rs or imgFiles will be used.

func NUpFile added in v0.2.3

func NUpFile(inFiles []string, outFile string, selectedPages []string, nup *pdfcpu.NUp, conf *pdfcpu.Configuration) (err error)

NUpFile rearranges PDF pages or images into page grids and writes the result to outFile.

Example
// 4-Up in.pdf and write result to out.pdf.
nup, _ := PDFNUpConfig(4, "")
inFiles := []string{"in.pdf"}
NUpFile(inFiles, "out.pdf", nil, nup, nil)

// 9-Up a sequence of images using format Tabloid w/o borders and no margins.
nup, _ = ImageNUpConfig(9, "f:Tabloid, b:off, m:0")
inFiles = []string{"in1.png", "in2.jpg", "in3.tiff"}
NUpFile(inFiles, "out.pdf", nil, nup, nil)

// TestGridFromPDF
nup, _ = PDFGridConfig(1, 3, "f:LegalL")
inFiles = []string{"in.pdf"}
NUpFile(inFiles, "out.pdf", nil, nup, nil)

// TestGridFromImages
nup, _ = ImageGridConfig(4, 2, "d:500 500, m:20, b:off")
inFiles = []string{"in1.png", "in2.jpg", "in3.tiff"}
NUpFile(inFiles, "out.pdf", nil, nup, nil)
Output:

func NUpFromImage added in v0.3.8

func NUpFromImage(conf *pdfcpu.Configuration, imageFileNames []string, nup *pdfcpu.NUp) (*pdfcpu.Context, error)

NUpFromImage creates a single page n-up PDF for one image or a sequence of n-up pages for more than one image.

func Optimize

func Optimize(rs io.ReadSeeker, w io.Writer, conf *pdfcpu.Configuration) error

Optimize reads a PDF stream from rs and writes the optimized PDF stream to w.

func OptimizeContext added in v0.1.18

func OptimizeContext(ctx *pdfcpu.Context) error

OptimizeContext optimizes ctx.

func OptimizeFile added in v0.2.3

func OptimizeFile(inFile, outFile string, conf *pdfcpu.Configuration) (err error)

OptimizeFile reads inFile and writes the optimized PDF to outFile. If outFile is not provided then inFile gets overwritten which leads to the same result as when inFile equals outFile.

Example
conf := pdfcpu.NewDefaultConfiguration()

// Set passwords for encrypted files.
conf.UserPW = "upw"
conf.OwnerPW = "opw"

// Configure end of line sequence for writing.
conf.Eol = pdfcpu.EolLF

// Create an optimized version of in.pdf and write it to out.pdf.
OptimizeFile("in.pdf", "out.pdf", conf)

// Create an optimized version of inFile.
// If you want to modify the original file, pass an empty string for outFile.
// Use nil for a default configuration.
OptimizeFile("in.pdf", "", nil)
Output:

func PDFBookletConfig added in v0.3.9

func PDFBookletConfig(val int, desc string) (*pdfcpu.NUp, error)

PDFBookletConfig returns an NUp configuration for Booklet-ing PDF files.

func PDFGridConfig added in v0.3.9

func PDFGridConfig(rows, cols int, desc string) (*pdfcpu.NUp, error)

PDFGridConfig returns a grid configuration for Grid-ing PDF files.

func PDFNUpConfig added in v0.3.9

func PDFNUpConfig(val int, desc string) (*pdfcpu.NUp, error)

PDFNUpConfig returns an NUp configuration for Nup-ing PDF files.

func PDFWatermark added in v0.3.4

func PDFWatermark(fileName, desc string, onTop, update bool, u pdfcpu.DisplayUnit) (*pdfcpu.Watermark, error)

PDFWatermark returns a PDF watermark configuration.

func PageBoundaries added in v0.3.8

func PageBoundaries(s string, unit pdfcpu.DisplayUnit) (*pdfcpu.PageBoundaries, error)

PageBoundaries parses a list of box definitions and assignments.

func PageBoundariesFromBoxList added in v0.3.8

func PageBoundariesFromBoxList(s string) (*pdfcpu.PageBoundaries, error)

PageBoundariesFromBoxList parses a list of box types.

func PageCount added in v0.2.3

func PageCount(rs io.ReadSeeker, conf *pdfcpu.Configuration) (int, error)

PageCount returns rs's page count.

func PageCountFile added in v0.3.1

func PageCountFile(inFile string) (int, error)

PageCountFile returns inFile's page count.

func PageDims added in v0.2.4

func PageDims(rs io.ReadSeeker, conf *pdfcpu.Configuration) ([]pdfcpu.Dim, error)

PageDims returns a sorted slice of mediaBox dimensions for rs.

func PageDimsFile added in v0.2.5

func PageDimsFile(inFile string) ([]pdfcpu.Dim, error)

PageDimsFile returns a sorted slice of mediaBox dimensions for inFile.

func PagesForPageCollection added in v0.3.2

func PagesForPageCollection(pageCount int, pageSelection []string) ([]int, error)

PagesForPageCollection returns a slice of page numbers for a page collection. Any page number in any order any number of times allowed.

func PagesForPageRange added in v0.3.6

func PagesForPageRange(from, thru int) []int

PagesForPageRange returns a slice of page numbers for a page range.

func PagesForPageSelection added in v0.3.2

func PagesForPageSelection(pageCount int, pageSelection []string, ensureAllforNone bool) (pdf.IntSet, error)

PagesForPageSelection ensures a set of page numbers for an ascending page sequence where each page number may appear only once.

func ParsePageSelection

func ParsePageSelection(s string) ([]string, error)

ParsePageSelection ensures a correct page selection expression.

func ReadContext added in v0.1.18

func ReadContext(rs io.ReadSeeker, conf *pdfcpu.Configuration) (*pdfcpu.Context, error)

ReadContext uses an io.ReadSeeker to build an internal structure holding its cross reference table aka the Context.

func ReadContextFile added in v0.2.3

func ReadContextFile(inFile string) (*pdfcpu.Context, error)

ReadContextFile returns inFile's validated context.

func RemoveAnnotations added in v0.3.12

func RemoveAnnotations(rs io.ReadSeeker, w io.Writer, selectedPages, ids []string, objNrs []int, conf *pdfcpu.Configuration) error

RemoveAnnotations removes annotations for selected pages by id and object number from a PDF context read from rs and writes the result to w.

func RemoveAnnotationsAsIncrement added in v0.3.12

func RemoveAnnotationsAsIncrement(rws io.ReadWriteSeeker, selectedPages, ids []string, objNrs []int, conf *pdfcpu.Configuration) error

RemoveAnnotationsAsIncrement removes annotations for selected pages by ids and object number from a PDF context read from rs and writes out a PDF increment.

func RemoveAnnotationsFile added in v0.3.12

func RemoveAnnotationsFile(inFile, outFile string, selectedPages, ids []string, objNrs []int, conf *pdfcpu.Configuration, incr bool) (err error)

RemoveAnnotationsFile removes annotations for selected pages by id and object number from a PDF context read from inFile and writes the result to outFile.

func RemoveAttachments

func RemoveAttachments(rs io.ReadSeeker, w io.Writer, files []string, conf *pdfcpu.Configuration) error

RemoveAttachments deletes embedded files from a PDF context read from rs and writes the result to w.

func RemoveAttachmentsFile added in v0.2.3

func RemoveAttachmentsFile(inFile, outFile string, files []string, conf *pdfcpu.Configuration) (err error)

RemoveAttachmentsFile deletes embedded files from a PDF context read from inFile and writes the result to outFile.

Example
// Remove 1 attachment from in.pdf.
RemoveAttachmentsFile("in.pdf", "", []string{"img.jpg"}, nil)

// Remove all attachments from in.pdf
RemoveAttachmentsFile("in.pdf", "", nil, nil)
Output:

func RemoveBoxes added in v0.3.8

func RemoveBoxes(rs io.ReadSeeker, w io.Writer, selectedPages []string, pb *pdfcpu.PageBoundaries, conf *pdfcpu.Configuration) error

RemoveBoxes removes page boundaries as specified in pb for selected pages of rs and writes result to w.

func RemoveBoxesFile added in v0.3.8

func RemoveBoxesFile(inFile, outFile string, selectedPages []string, pb *pdfcpu.PageBoundaries, conf *pdfcpu.Configuration) error

RemoveBoxesFile removes page boundaries as specified in pb for selected pages of inFile and writes result to outFile.

func RemoveKeywords added in v0.3.2

func RemoveKeywords(rs io.ReadSeeker, w io.Writer, keywords []string, conf *pdf.Configuration) error

RemoveKeywords deletes embedded files from a PDF context read from rs and writes the result to w.

func RemoveKeywordsFile added in v0.3.2

func RemoveKeywordsFile(inFile, outFile string, keywords []string, conf *pdf.Configuration) (err error)

RemoveKeywordsFile deletes embedded files from a PDF context read from inFile and writes the result to outFile.

func RemovePages added in v0.2.3

func RemovePages(rs io.ReadSeeker, w io.Writer, selectedPages []string, conf *pdfcpu.Configuration) error

RemovePages removes selected pages from rs and writes the result to w.

func RemovePagesFile added in v0.2.3

func RemovePagesFile(inFile, outFile string, selectedPages []string, conf *pdfcpu.Configuration) (err error)

RemovePagesFile removes selected inFile pages and writes the result to outFile..

Example
// Remove pages 2 and 8 of in.pdf.
RemovePagesFile("in.pdf", "", []string{"2", "8"}, nil)

// Remove first 2 pages of in.pdf.
RemovePagesFile("in.pdf", "", []string{"-2"}, nil)

// Remove all pages >= 10 of in.pdf.
RemovePagesFile("in.pdf", "", []string{"10-"}, nil)
Output:

func RemoveProperties added in v0.3.2

func RemoveProperties(rs io.ReadSeeker, w io.Writer, properties []string, conf *pdf.Configuration) error

RemoveProperties deletes embedded files from a PDF context read from rs and writes the result to w.

func RemovePropertiesFile added in v0.3.2

func RemovePropertiesFile(inFile, outFile string, properties []string, conf *pdf.Configuration) (err error)

RemovePropertiesFile deletes embedded files from a PDF context read from inFile and writes the result to outFile.

func RemoveWatermarks added in v0.2.5

func RemoveWatermarks(rs io.ReadSeeker, w io.Writer, selectedPages []string, conf *pdfcpu.Configuration) error

RemoveWatermarks removes watermarks from all pages selected in rs and writes the result to w.

func RemoveWatermarksFile added in v0.2.5

func RemoveWatermarksFile(inFile, outFile string, selectedPages []string, conf *pdfcpu.Configuration) (err error)

RemoveWatermarksFile removes watermarks from all selected pages of inFile and writes the result to outFile.

Example
// Add a "Demo" stamp to all pages of in.pdf along the diagonal running from lower left to upper right.
onTop := true
update := false
wm, _ := TextWatermark("Demo", "", onTop, update, pdfcpu.POINTS)
AddWatermarksFile("in.pdf", "", nil, wm, nil)

// Update stamp for correction:
update = true
wm, _ = TextWatermark("Confidential", "", onTop, update, pdfcpu.POINTS)
AddWatermarksFile("in.pdf", "", nil, wm, nil)

// Add another watermark on top of page 1
wm, _ = TextWatermark("Footer stamp", "c:.5 1 1, pos:bc", onTop, update, pdfcpu.POINTS)
AddWatermarksFile("in.pdf", "", nil, wm, nil)

// Remove watermark on page 1
RemoveWatermarksFile("in.pdf", "", []string{"1"}, nil)

// Remove all watermarks
RemoveWatermarksFile("in.pdf", "", nil, nil)
Output:

func Rotate added in v0.1.20

func Rotate(rs io.ReadSeeker, w io.Writer, rotation int, selectedPages []string, conf *pdfcpu.Configuration) error

Rotate rotates selected pages of rs clockwise by rotation degrees and writes the result to w.

func RotateFile added in v0.2.3

func RotateFile(inFile, outFile string, rotation int, selectedPages []string, conf *pdfcpu.Configuration) (err error)

RotateFile rotates selected pages of inFile clockwise by rotation degrees and writes the result to outFile.

Example
// Rotate all pages of in.pdf, clockwise by 90 degrees and write the result to out.pdf.
RotateFile("in.pdf", "out.pdf", 90, nil, nil)

// Rotate the first page of in.pdf by 180 degrees.
// If you want to modify the original file, pass an empty string as outFile.
RotateFile("in.pdf", "", 180, []string{"1"}, nil)
Output:

func SetPermissions added in v0.2.3

func SetPermissions(rs io.ReadSeeker, w io.Writer, conf *pdfcpu.Configuration) error

SetPermissions sets user access permissions. inFile has to be encrypted. A configuration containing the current passwords is required.

func SetPermissionsFile added in v0.2.3

func SetPermissionsFile(inFile, outFile string, conf *pdfcpu.Configuration) (err error)

SetPermissionsFile sets inFile's user access permissions. inFile has to be encrypted. A configuration containing the current passwords is required.

Example
// Setting all permissions for the AES-256 encrypted in.pdf.
conf := pdfcpu.NewAESConfiguration("upw", "opw", 256)
conf.Permissions = pdfcpu.PermissionsAll
SetPermissionsFile("in.pdf", "", conf)

// Restricting permissions for the AES-256 encrypted in.pdf.
conf = pdfcpu.NewAESConfiguration("upw", "opw", 256)
conf.Permissions = pdfcpu.PermissionsNone
SetPermissionsFile("in.pdf", "", conf)
Output:

func Split

func Split(rs io.ReadSeeker, outDir, fileName string, span int, conf *pdfcpu.Configuration) error

Split generates a sequence of PDF files in outDir for the PDF stream read from rs obeying given split span. If span == 1 splitting results in single page PDFs. If span == 0 we split along given bookmarks (level 1 only). Default span: 1

func SplitFile added in v0.2.3

func SplitFile(inFile, outDir string, span int, conf *pdfcpu.Configuration) error

SplitFile generates a sequence of PDF files in outDir for inFile obeying given split span. If span == 1 splitting results in single page PDFs. If span == 0 we split along given bookmarks (level 1 only). Default span: 1

Example
// Create single page PDFs for in.pdf in outDir using the default configuration.
SplitFile("in.pdf", "outDir", 1, nil)

// Create dual page PDFs for in.pdf in outDir using the default configuration.
SplitFile("in.pdf", "outDir", 2, nil)

// Create a sequence of PDFs representing bookmark secions.
SplitFile("in.pdf", "outDir", 0, nil)
Output:

func TextWatermark added in v0.3.4

func TextWatermark(text, desc string, onTop, update bool, u pdfcpu.DisplayUnit) (*pdfcpu.Watermark, error)

TextWatermark returns a text watermark configuration.

func Trim

func Trim(rs io.ReadSeeker, w io.Writer, selectedPages []string, conf *pdfcpu.Configuration) error

Trim generates a trimmed version of rs containing all selected pages and writes the result to w.

func TrimFile added in v0.2.3

func TrimFile(inFile, outFile string, selectedPages []string, conf *pdfcpu.Configuration) (err error)

TrimFile generates a trimmed version of inFile containing all selected pages and writes the result to outFile.

Example
// Create a trimmed version of in.pdf containing odd page numbers only.
TrimFile("in.pdf", "outFile", []string{"odd"}, nil)

// Create a trimmed version of in.pdf containing the first two pages only.
// If you want to modify the original file, pass an empty string for outFile.
TrimFile("in.pdf", "", []string{"1-2"}, nil)
Output:

func UpdateImageWatermarksFile added in v0.3.4

func UpdateImageWatermarksFile(inFile, outFile string, selectedPages []string, onTop bool, fileName, desc string, conf *pdfcpu.Configuration) error

UpdateImageWatermarksFile adds image stamps/watermarks to all selected pages of inFile and writes the result to outFile.

func UpdatePDFWatermarksFile added in v0.3.4

func UpdatePDFWatermarksFile(inFile, outFile string, selectedPages []string, onTop bool, fileName, desc string, conf *pdfcpu.Configuration) error

UpdatePDFWatermarksFile adds PDF stamps/watermarks to all selected pages of inFile and writes the result to outFile.

func UpdateTextWatermarksFile added in v0.3.4

func UpdateTextWatermarksFile(inFile, outFile string, selectedPages []string, onTop bool, text, desc string, conf *pdfcpu.Configuration) error

UpdateTextWatermarksFile adds text stamps/watermarks to all selected pages of inFile and writes the result to outFile.

func Validate

func Validate(rs io.ReadSeeker, conf *pdfcpu.Configuration) error

Validate validates a PDF stream read from rs.

func ValidateContext added in v0.1.18

func ValidateContext(ctx *pdfcpu.Context) error

ValidateContext validates ctx.

func ValidateFile added in v0.2.3

func ValidateFile(inFile string, conf *pdfcpu.Configuration) error

ValidateFile validates inFile.

Example
// Use the default configuration to validate in.pdf.
ValidateFile("in.pdf", nil)
Output:

func WatermarkContext added in v0.3.1

func WatermarkContext(ctx *pdfcpu.Context, selectedPages pdfcpu.IntSet, wm *pdfcpu.Watermark) error

WatermarkContext applies wm for selected pages to ctx.

func WriteContext added in v0.1.18

func WriteContext(ctx *pdfcpu.Context, w io.Writer) error

WriteContext writes ctx to w.

func WriteContextFile added in v0.3.1

func WriteContextFile(ctx *pdfcpu.Context, outFile string) error

WriteContextFile writes ctx to outFile.

func WriteIncrement added in v0.3.12

func WriteIncrement(ctx *pdfcpu.Context, w io.Writer) error

WriteIncrement writes a PDF increment for ctx to w.

Types

type ReadSeekerCloser added in v0.2.3

type ReadSeekerCloser interface {
	io.ReadSeeker
	io.Closer
}

ReadSeekerCloser combines io.ReadSeeker and io.Closer

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
t or T : Toggle theme light dark auto
y or Y : Canonical URL