pdfcpu

package
v1.0.1 Latest Latest
Warning

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

 Go to latest Published: Dec 10, 2024 License: Apache-2.0 Imports: 45 Imported by: 0

Documentation

Overview

Package pdfcpu is a PDF processing library written in Go supporting encryption. It provides an API and a command line interface. Supported are all versions up to PDF 1.7 (ISO-32000).

The commands are: 

annotations   list, remove page annotations
attachments   list, add, remove, extract embedded file attachments
booklet       arrange pages onto larger sheets of paper to make a booklet or zine
bookmarks     list, import, export, remove bookmarks
boxes         list, add, remove page boundaries for selected pages
changeopw     change owner password
changeupw     change user password
collect       create custom sequence of selected pages
config        print configuration
create        create PDF content including forms via JSON
crop          set cropbox for selected pages
cut           custom cut pages horizontally or vertically
decrypt       remove password protection
encrypt       set password protection
extract       extract images, fonts, content, pages or metadata
fonts         install, list supported fonts, create cheat sheets
form          list, remove fields, lock, unlock, reset, export, fill form via JSON or CSV
grid          rearrange pages or images for enhanced browsing experience
images        list images for selected pages
import        import/convert images to PDF
info          print file info
keywords      list, add, remove keywords
merge         concatenate PDFs
ndown         cut selected pages into n pages symmetrically
nup           rearrange pages or images for reduced number of pages
optimize      optimize PDF by getting rid of redundant page resources
pagelayout    list, set, reset page layout for opened document
pagemode      list, set, reset page mode for opened document
pages         insert, remove selected pages
paper         print list of supported paper sizes
permissions   list, set user access permissions
portfolio     list, add, remove, extract portfolio entries with optional description
poster        cut selected pages into poster by paper size or dimensions
properties    list, add, remove document properties
resize        scale selected pages
rotate        rotate selected pages
selectedpages print definition of the -pages flag
split         split up a PDF by span or bookmark
stamp         add, remove, update Unicode text, image or PDF stamps for selected pages
trim          create trimmed version of selected pages
validate      validate PDF against PDF 32000-1:2008 (PDF 1.7) + basic PDF 2.0 validation
version       print version
viewpref      list, set, reset viewer preferences for opened document
watermark     add, remove, update Unicode text, image or PDF watermarks for selected pages
zoom          zoom in/out of selected pages by magnification factor or corresponding margin

Index

Constants

View Source 
const (

	// ObjectStreamMaxObjects limits the number of objects within an object stream written.
	ObjectStreamMaxObjects = 100
)

Variables

View Source 
var (
	ErrWrongPassword         = errors.New("pdfcpu: please provide the correct password")
	ErrCorruptHeader         = errors.New("pdfcpu: no header version available")
	ErrReferenceDoesNotExist = errors.New("pdfcpu: referenced object does not exist")
)
View Source 
var (
	ErrUnknownEncryption = errors.New("pdfcpu: unknown encryption")
)
View Source 
var (
	ErrUnsupported16BPC = errors.New("unsupported 16 bits per component")
)

Errors to be identified.

View Source 
var (
	ErrUnsupportedVersion = errors.New("pdfcpu: PDF 2.0 unsupported for this operation")
)
View Source 
var (
	NUpValues = []int{2, 3, 4, 6, 8, 9, 12, 16}
)
View Source 
var NUpValuesForBooklets = []int{2, 4, 6, 8}

Functions

func AddAnnotation 

func AddAnnotation(
	ctx *model.Context,
	pageDictIndRef *types.IndirectRef,
	pageDict types.Dict,
	pageNr int,
	ar model.AnnotationRenderer,
	incr bool) (*types.IndirectRef, types.Dict, error)

AddAnnotation adds ar to pageDict.

func AddAnnotationToPage 

func AddAnnotationToPage(ctx *model.Context, pageNr int, ar model.AnnotationRenderer, incr bool) (*types.IndirectRef, types.Dict, error)

func AddAnnotations 

func AddAnnotations(ctx *model.Context, selectedPages types.IntSet, ar model.AnnotationRenderer, incr bool) (bool, error)

AddAnnotations adds ar to selected pages.

func AddAnnotationsMap 

func AddAnnotationsMap(ctx *model.Context, m map[int][]model.AnnotationRenderer, incr bool) (bool, error)

AddAnnotationsMap adds annotations in m to corresponding pages.

func AddBookmarks 

func AddBookmarks(ctx *model.Context, bms []Bookmark, replace bool) error

AddBookmarks adds bms to ctx.

func AddPageTreeWithSamplePage 

func AddPageTreeWithSamplePage(xRefTable *model.XRefTable, rootDict types.Dict, p model.Page) error

func AddPages 

func AddPages(ctxSrc, ctxDest *model.Context, pageNrs []int, usePgCache bool) error

AddPages adds pages and corresponding resources from ctxSrc to ctxDest.

func AddWatermarks 

func AddWatermarks(ctx *model.Context, selectedPages types.IntSet, wm *model.Watermark) error

AddWatermarks adds watermarks to all pages selected.

func AddWatermarksMap 

func AddWatermarksMap(ctx *model.Context, m map[int]*model.Watermark) error

AddWatermarksMap adds watermarks in m to corresponding pages.

func AddWatermarksSliceMap 

func AddWatermarksSliceMap(ctx *model.Context, m map[int][]*model.Watermark) error

AddWatermarksSliceMap adds watermarks in m to corresponding pages.

func Annotation 

func Annotation(xRefTable *model.XRefTable, d types.Dict) (model.AnnotationRenderer, error)

Annotation returns an annotation renderer. Validation sets up a cache of annotation renderers.

func AnnotationsForSelectedPages 

func AnnotationsForSelectedPages(ctx *model.Context, selectedPages types.IntSet) map[int]model.PgAnnots

func AppendStatsFile 

func AppendStatsFile(ctx *model.Context) error

AppendStatsFile appends a stats line for this xRefTable to the configured csv file name.

func BookletFromImages 

func BookletFromImages(ctx *model.Context, fileNames []string, nup *model.NUp, pagesDict types.Dict, pagesIndRef *types.IndirectRef) error

BookletFromImages creates a booklet version of the image sequence represented by fileNames.

func BookletFromPDF 

func BookletFromPDF(ctx *model.Context, selectedPages types.IntSet, nup *model.NUp) error

BookletFromPDF creates a booklet version of the PDF represented by xRefTable.

func BookmarkList 

func BookmarkList(ctx *model.Context) ([]string, error)

func CacheFormFonts 

func CacheFormFonts(ctx *model.Context) error

func CachedAnnotationObjNrs 

func CachedAnnotationObjNrs(ctx *model.Context) ([]int, error)

CachedAnnotationObjNrs returns a list of object numbers representing known annotation dict indirect references.

func ColorSpaceComponents 

func ColorSpaceComponents(xRefTable *model.XRefTable, sd *types.StreamDict) (int, error)

ColorSpaceComponents returns the corresponding number of used color components for sd's colorspace.

func ColorSpaceString 

func ColorSpaceString(ctx *model.Context, sd *types.StreamDict) (string, error)

ColorSpaceString returns a string representation for sd's colorspace.

func CreateAnnotationDemoXRef 

func CreateAnnotationDemoXRef() (*model.XRefTable, error)

CreateAnnotationDemoXRef creates a PDF file with examples of annotations and actions.

func CreateContext 

func CreateContext(xRefTable *model.XRefTable, conf *model.Configuration) *model.Context

CreateContext creates a Context for given cross reference table and configuration.

func CreateContextWithXRefTable 

func CreateContextWithXRefTable(conf *model.Configuration, pageDim *types.Dim) (*model.Context, error)

CreateContextWithXRefTable creates a Context with an xRefTable without pages for given configuration.

func CreateDemoXRef 

func CreateDemoXRef() (*model.XRefTable, error)

CreateDemoXRef creates a minimal single page PDF file for demo purposes.

func CreateFormDemoXRef 

func CreateFormDemoXRef() (*model.XRefTable, error)

CreateFormDemoXRef creates an xRefTable with an AcroForm example.

func CreateResourceDictInheritanceDemoXRef 

func CreateResourceDictInheritanceDemoXRef() (*model.XRefTable, error)

CreateResourceDictInheritanceDemoXRef creates a page tree for testing resource dict inheritance.

func CreateTestPageContent 

func CreateTestPageContent(p model.Page)

CreateTestPageContent draws a test grid.

func CreateXRefTableWithRootDict 

func CreateXRefTableWithRootDict() (*model.XRefTable, error)

func CutPage 

func CutPage(ctxSrc *model.Context, i int, cut *model.Cut) (*model.Context, error)

func DefaultBookletConfig 

func DefaultBookletConfig() *model.NUp

DefaultBookletConfig returns the default configuration for a booklet

func DetectPageTreeWatermarks 

func DetectPageTreeWatermarks(ctx *model.Context) error

DetectPageTreeWatermarks checks xRefTable's page tree for watermarks and records the result to xRefTable.Watermarked.

func DetectWatermarks 

func DetectWatermarks(ctx *model.Context) error

DetectWatermarks checks ctx for watermarks and records the result to xRefTable.Watermarked.

func EnsureOutlines 

func EnsureOutlines(ctx *model.Context, fName string, append bool) error

func ExportBookmarksJSON 

func ExportBookmarksJSON(ctx *model.Context, source string, w io.Writer) (bool, error)

func ExtractImage 

func ExtractImage(ctx *model.Context, sd *types.StreamDict, thumb bool, resourceID string, objNr int, stub bool) (*model.Image, error)

ExtractImage extracts an image from sd.

func ExtractPageContent 

func ExtractPageContent(ctx *model.Context, pageNr int) (io.Reader, error)

ExtractPageContent extracts the consolidated page content stream for pageNr.

func ExtractPageImages 

func ExtractPageImages(ctx *model.Context, pageNr int, stub bool) (map[int]model.Image, error)

ExtractPageImages extracts all images used by pageNr. Optionally return stubs only.

func ExtractPages 

func ExtractPages(ctx *model.Context, pageNrs []int, usePgCache bool) (*model.Context, error)

ExtractPages extracts pageNrs into a new single page context.

func FontObjNrs 

func FontObjNrs(ctx *model.Context, pageNr int) []int

FontObjNrs returns all font dict objNrs for pageNr. Requires an optimized context.

func GetBookletOrdering 

func GetBookletOrdering(pages types.IntSet, nup *model.NUp) []model.BookletPage

func ImageBookletConfig 

func ImageBookletConfig(val int, desc string, conf *model.Configuration) (*model.NUp, error)

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

func ImageGridConfig 

func ImageGridConfig(rows, cols int, desc string, conf *model.Configuration) (*model.NUp, error)

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

func ImageNUpConfig 

func ImageNUpConfig(val int, desc string, conf *model.Configuration) (*model.NUp, error)

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

func ImageObjNrs 

func ImageObjNrs(ctx *model.Context, pageNr int) []int

ImageObjNrs returns all image dict objNrs for pageNr. Requires an optimized context.

func ImportBookmarks 

func ImportBookmarks(ctx *model.Context, rd io.Reader, replace bool) (bool, error)

ImportBookmarks creates/replaces outlines in ctx as provided by rd.

func KeywordsAdd 

func KeywordsAdd(ctx *model.Context, keywords []string) error

KeywordsAdd adds keywords to the document info dict. Returns true if at least one keyword was added.

func KeywordsList 

func KeywordsList(ctx *model.Context) ([]string, error)

KeywordsList returns a list of keywords as recorded in the document info dict.

func KeywordsRemove 

func KeywordsRemove(ctx *model.Context, keywords []string) (bool, error)

KeywordsRemove deletes keywords from the document info dict. Returns true if at least one keyword was removed.

func ListAnnotations 

func ListAnnotations(annots map[int]model.PgAnnots) (int, []string, error)

ListAnnotations returns a formatted list of annotations.

func ListImages 

func ListImages(ctx *model.Context, selectedPages types.IntSet) ([]string, error)

ListImages returns a formatted list of embedded images.

func ListInfo 

func ListInfo(info *PDFInfo, selectedPages types.IntSet) ([]string, error)

ListInfo returns formatted info about ctx.

func MergeXRefTables 

func MergeXRefTables(fName string, ctxSrc, ctxDest *model.Context, zip, dividerPage bool) (err error)

MergeXRefTables merges Context ctxSrc into ctxDest by appending its page tree. zip ... zip 2 files together (eg. 1A,1B,2A,2B,3A,3B...) dividerPage ... insert blank page between merged files (not applicable for zipping)

func NDownPage 

func NDownPage(ctxSrc *model.Context, i, n int, cut *model.Cut) (*model.Context, error)

func NUpFromMultipleImages 

func NUpFromMultipleImages(ctx *model.Context, fileNames []string, nup *model.NUp, pagesDict types.Dict, pagesIndRef *types.IndirectRef) error

NUpFromMultipleImages creates pages in NUp-style rendering each image once.

func NUpFromOneImage 

func NUpFromOneImage(ctx *model.Context, fileName string, nup *model.NUp, pagesDict types.Dict, pagesIndRef *types.IndirectRef) error

NUpFromOneImage creates one page with instances of one image.

func NUpFromPDF 

func NUpFromPDF(ctx *model.Context, selectedPages types.IntSet, nup *model.NUp) error

NUpFromPDF creates an n-up version of the PDF represented by xRefTable.

func NewNUpPageForImage 

func NewNUpPageForImage(xRefTable *model.XRefTable, fileName string, parentIndRef *types.IndirectRef, nup *model.NUp) (*types.IndirectRef, error)

NewNUpPageForImage creates a new page dict in xRefTable for given image filename and n-up conf.

func NewPageForImage 

func NewPageForImage(xRefTable *model.XRefTable, r io.Reader, parentIndRef *types.IndirectRef, imp *Import) (*types.IndirectRef, error)

NewPageForImage creates a new page dict in xRefTable for given image reader r.

func OptimizeXRefTable 

func OptimizeXRefTable(ctx *model.Context) error

OptimizeXRefTable optimizes an xRefTable by locating and getting rid of redundant embedded fonts and images.

func PDFBookletConfig 

func PDFBookletConfig(val int, desc string, conf *model.Configuration) (*model.NUp, error)

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

func PDFGridConfig 

func PDFGridConfig(rows, cols int, desc string, conf *model.Configuration) (*model.NUp, error)

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

func PDFNUpConfig 

func PDFNUpConfig(val int, desc string, conf *model.Configuration) (*model.NUp, error)

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

func PageObjFromDestination 

func PageObjFromDestination(ctx *model.Context, dest types.Object) (*types.IndirectRef, error)

PageObjFromDestinationArray returns an IndirectRef of the destinations page.

func ParseCutConfig 

func ParseCutConfig(s string, u types.DisplayUnit) (*model.Cut, error)

ParseCutConfig parses a Cut command string into an internal structure. optionally: horizontalCut, verticalCut, bgcolor, border, margin, origin

func ParseCutConfigForN 

func ParseCutConfigForN(n int, s string, u types.DisplayUnit) (*model.Cut, error)

ParseCutConfigForN parses a NDown command string into an internal structure. n, Optionally: border, margin, bgcolor

func ParseCutConfigForPoster 

func ParseCutConfigForPoster(s string, u types.DisplayUnit) (*model.Cut, error)

ParseCutConfigForPoster parses a Cut command string into an internal structure. formsize(=papersize) or dimensions, optionally: scalefactor, border, margin, bgcolor

func ParseImageWatermarkDetails 

func ParseImageWatermarkDetails(fileName, desc string, onTop bool, u types.DisplayUnit) (*model.Watermark, error)

ParseImageWatermarkDetails parses an image Watermark/Stamp command string into an internal structure.

func ParseNUpDetails 

func ParseNUpDetails(s string, nup *model.NUp) error

ParseNUpDetails parses a NUp command string into an internal structure.

func ParseNUpGridDefinition 

func ParseNUpGridDefinition(rows, cols int, nUp *model.NUp) error

ParseNUpGridDefinition parses NUp grid dimensions into an internal structure.

func ParseNUpValue 

func ParseNUpValue(n int, nUp *model.NUp) error

ParseNUpValue parses the NUp value into an internal structure.

func ParseObject 

func ParseObject(ctx *model.Context, offset int64, objNr, genNr int) (types.Object, error)

ParseObject parses an object from file at given offset.

func ParseObjectWithContext 

func ParseObjectWithContext(c context.Context, ctx *model.Context, offset int64, objNr, genNr int) (types.Object, error)

func ParsePDFWatermarkDetails 

func ParsePDFWatermarkDetails(fileName, desc string, onTop bool, u types.DisplayUnit) (*model.Watermark, error)

ParsePDFWatermarkDetails parses a PDF Watermark/Stamp command string into an internal structure.

func ParsePageDim 

func ParsePageDim(v string, u types.DisplayUnit) (*types.Dim, string, error)

func ParseResizeConfig 

func ParseResizeConfig(s string, u types.DisplayUnit) (*model.Resize, error)

ParseResizeConfig parses a Resize command string into an internal structure. "scale:.5, form:A4, dim:400 200 bgcol:#D00000"

func ParseTextWatermarkDetails 

func ParseTextWatermarkDetails(text, desc string, onTop bool, u types.DisplayUnit) (*model.Watermark, error)

ParseTextWatermarkDetails parses a text Watermark/Stamp command string into an internal structure.

func ParseZoomConfig 

func ParseZoomConfig(s string, u types.DisplayUnit) (*model.Zoom, error)

ParseZoomConfig parses a Zoom command string into an internal structure.

func Permissions 

func Permissions(ctx *model.Context) (list []string)

Permissions returns a list of set permissions.

func PermissionsList 

func PermissionsList(p int) (list []string)

PermissionsList returns a list of set permissions.

func PosterPage 

func PosterPage(ctxSrc *model.Context, i int, cut *model.Cut) (*model.Context, error)

func PropertiesAdd 

func PropertiesAdd(ctx *model.Context, properties map[string]string) error

PropertiesAdd adds properties into the document info dict. Returns true if at least one property was added.

func PropertiesList 

func PropertiesList(ctx *model.Context) ([]string, error)

PropertiesList returns a list of document properties as recorded in the document info dict.

func PropertiesRemove 

func PropertiesRemove(ctx *model.Context, properties []string) (bool, error)

PropertiesRemove deletes specified properties. Returns true if at least one property was removed.

func Read 

func Read(rs io.ReadSeeker, conf *model.Configuration) (*model.Context, error)

Read takes a readSeeker and generates a PDF model context, an in-memory representation containing a cross reference table.

func ReadFile 

func ReadFile(inFile string, conf *model.Configuration) (*model.Context, error)

ReadFile reads in a PDF file and builds an internal structure holding its cross reference table aka the PDF model context.

func ReadFileWithContext 

func ReadFileWithContext(c context.Context, inFile string, conf *model.Configuration) (*model.Context, error)

ReadFileContext reads in a PDF file and builds an internal structure holding its cross reference table aka the PDF model context. If the passed Go context is cancelled, reading will be interrupted.

func ReadWithContext 

func ReadWithContext(c context.Context, rs io.ReadSeeker, conf *model.Configuration) (*model.Context, error)

Read takes a readSeeker and generates a PDF model context, an in-memory representation containing a cross reference table. If the passed Go context is cancelled, reading will be interrupted.

func RemoveAnnotations 

func RemoveAnnotations(ctx *model.Context, selectedPages types.IntSet, idsAndTypes []string, objNrs []int, incr bool) (bool, error)

RemoveAnnotations removes annotations for selected pages by id, type or object number. All annotations for selected pages are removed if neither idsAndTypes nor objNrs are provided.

func RemoveAnnotationsFromPageDict 

func RemoveAnnotationsFromPageDict(
	ctx *model.Context,
	annotTypes []model.AnnotationType,
	ids []string,
	objNrSet types.IntSet,
	pageDict types.Dict,
	pageDictObjNr,
	pageNr int,
	incr bool) (bool, error)

RemoveAnnotationsFromPageDict removes an annotation by annotType, id and obj# from pageDict.

func RemoveBookmarks 

func RemoveBookmarks(ctx *model.Context) (bool, error)

RemoveBookmarks erases all outlines from ctx.

func RemoveWatermarks 

func RemoveWatermarks(ctx *model.Context, selectedPages types.IntSet) error

RemoveWatermarks removes watermarks for all pages selected.

func RenderImage 

func RenderImage(xRefTable *model.XRefTable, sd *types.StreamDict, thumb bool, resourceName string, objNr int) (io.Reader, string, error)

RenderImage returns a reader for a decoded image stream.

func Resize 

func Resize(ctx *model.Context, selectedPages types.IntSet, res *model.Resize) error

func RotatePages 

func RotatePages(ctx *model.Context, selectedPages types.IntSet, rotation int) error

RotatePages rotates all selected pages by a multiple of 90 degrees.

func StreamLength 

func StreamLength(ctx *model.Context, sd *types.StreamDict) (int64, error)

StreamLength returns sd's stream length.

func Write 

func Write(ctx *model.Context) (err error)

Write generates a PDF file for the cross reference table contained in Context.

func WriteImage 

func WriteImage(xRefTable *model.XRefTable, fileName string, sd *types.StreamDict, thumb bool, objNr int) (string, error)

WriteImage writes a PDF image object to disk.

func WriteImageToDisk 

func WriteImageToDisk(outDir, fileName string) func(model.Image, bool, int) error

WriteImageToDisk returns a closure for writing img to disk.

func WriteIncrement 

func WriteIncrement(ctx *model.Context) error

WriteIncrement writes a PDF increment..

func WriteReader 

func WriteReader(path string, r io.Reader) error

WriteReader consumes r's content by writing it to a file at path.

func Zoom 

func Zoom(ctx *model.Context, selectedPages types.IntSet, zoom *model.Zoom) error

Types

type AnnotListMaxLengths 

type AnnotListMaxLengths struct {
	ObjNr, ID, Rect, Content int
}

type Bookmark 

type Bookmark struct {
	Title    string             `json:"title"`
	PageFrom int                `json:"page"`
	PageThru int                `json:"-"` // for extraction only; >= pageFrom and reaches until before pageFrom of the next bookmark.
	Bold     bool               `json:"bold,omitempty"`
	Italic   bool               `json:"italic,omitempty"`
	Color    *color.SimpleColor `json:"color,omitempty"`
	Kids     []Bookmark         `json:"kids,omitempty"`
	Parent   *Bookmark          `json:"-"`
}

Bookmark represents an outline item tree.

func Bookmarks 

func Bookmarks(ctx *model.Context) ([]Bookmark, error)

Bookmarks returns all ctx bookmark information recursively.

func BookmarksForOutlineItem 

func BookmarksForOutlineItem(ctx *model.Context, item *types.IndirectRef, parent *Bookmark) ([]Bookmark, error)

BookmarksForOutlineItem returns the bookmarks tree for an outline item.

func (Bookmark) Style 

func (bm Bookmark) Style() int

Style returns an int corresponding to the bookmark style.

type BookmarkTree 

type BookmarkTree struct {
	Header    Header     `json:"header"`
	Bookmarks []Bookmark `json:"bookmarks"`
}

func ExportBookmarks 

func ExportBookmarks(ctx *model.Context, source string) (*BookmarkTree, error)

type Font 

type Font struct {
	io.Reader
	Name string
	Type string
}

Font is a Reader representing an embedded font.

func ExtractFont 

func ExtractFont(ctx *model.Context, fontObject model.FontObject, objNr int) (*Font, error)

ExtractFont extracts a font from fontObject.

func ExtractFormFonts 

func ExtractFormFonts(ctx *model.Context) ([]Font, error)

ExtractPageFonts extracts all form fonts.

func ExtractPageFonts 

func ExtractPageFonts(ctx *model.Context, pageNr int) ([]Font, error)

ExtractPageFonts extracts all fonts used by pageNr. 

type Header struct {
	Source   string   `json:"source,omitempty"`
	Version  string   `json:"version"`
	Creation string   `json:"creation"`
	ID       []string `json:"id,omitempty"`
	Title    string   `json:"title,omitempty"`
	Author   string   `json:"author,omitempty"`
	Creator  string   `json:"creator,omitempty"`
	Producer string   `json:"producer,omitempty"`
	Subject  string   `json:"subject,omitempty"`
	Keywords string   `json:"keywords,omitempty"`
}

type ImageListMaxLengths 

type ImageListMaxLengths struct {
	ObjNr, ID, Size, Filters int
}

func Images 

func Images(ctx *model.Context, selectedPages types.IntSet) ([]map[int]model.Image, *ImageListMaxLengths, error)

Images returns all embedded images of ctx.

type Import 

type Import struct {
	PageDim  *types.Dim        // page dimensions in display unit.
	PageSize string            // one of A0,A1,A2,A3,A4(=default),A5,A6,A7,A8,Letter,Legal,Ledger,Tabloid,Executive,ANSIC,ANSID,ANSIE.
	UserDim  bool              // true if one of dimensions or paperSize provided overriding the default.
	DPI      int               // destination resolution to apply in dots per inch.
	Pos      types.Anchor      // position anchor, one of tl,tc,tr,l,c,r,bl,bc,br,full.
	Dx, Dy   float64           // anchor offset.
	Scale    float64           // relative scale factor. 0 <= x <= 1
	ScaleAbs bool              // true for absolute scaling.
	InpUnit  types.DisplayUnit // input display unit.
	Gray     bool              // true for rendering in Gray.
	Sepia    bool
	BgColor  *color.SimpleColor // background color
}

Import represents the command details for the command "ImportImage".

func DefaultImportConfig 

func DefaultImportConfig() *Import

DefaultImportConfig returns the default configuration.

func ParseImportDetails 

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

ParseImportDetails parses an Import command string into an internal structure.

func (Import) String 

func (imp Import) String() string

type Metadata 

type Metadata struct {
	io.Reader          // metadata
	ObjNr       int    // metadata dict objNr
	ParentObjNr int    // container object number
	ParentType  string // container dict type
}

Metadata is a Reader representing a metadata dict.

func ExtractMetadata 

func ExtractMetadata(ctx *model.Context) ([]Metadata, error)

ExtractMetadata returns all metadata of ctx.

type PDFImage 

type PDFImage struct {
	// contains filtered or unexported fields
}

PDFImage represents a XObject of subtype image.

type PDFInfo 

type PDFInfo struct {
	FileName           string                          `json:"source,omitempty"`
	Version            string                          `json:"version"`
	PageCount          int                             `json:"pageCount"`
	PageBoundaries     []model.PageBoundaries          `json:"-"`
	Boundaries         map[string]model.PageBoundaries `json:"pageBoundaries,omitempty"`
	PageDimensions     map[types.Dim]bool              `json:"-"`
	Dimensions         []types.Dim                     `json:"pageSizes,omitempty"`
	Title              string                          `json:"title"`
	Author             string                          `json:"author"`
	Subject            string                          `json:"subject"`
	Producer           string                          `json:"producer"`
	Creator            string                          `json:"creator"`
	CreationDate       string                          `json:"creationDate"`
	ModificationDate   string                          `json:"modificationDate"`
	PageMode           string                          `json:"pageMode,omitempty"`
	PageLayout         string                          `json:"pageLayout,omitempty"`
	ViewerPref         *model.ViewerPreferences        `json:"viewerPreferences,omitempty"`
	Keywords           []string                        `json:"keywords"`
	Properties         map[string]string               `json:"properties"`
	Tagged             bool                            `json:"tagged"`
	Hybrid             bool                            `json:"hybrid"`
	Linearized         bool                            `json:"linearized"`
	UsingXRefStreams   bool                            `json:"usingXRefStreams"`
	UsingObjectStreams bool                            `json:"usingObjectStreams"`
	Watermarked        bool                            `json:"watermarked"`
	Thumbnails         bool                            `json:"thumbnails"`
	Form               bool                            `json:"form"`
	Signatures         bool                            `json:"signatures"`
	AppendOnly         bool                            `json:"appendOnly"`
	Outlines           bool                            `json:"bookmarks"`
	Names              bool                            `json:"names"`
	Encrypted          bool                            `json:"encrypted"`
	Permissions        int                             `json:"permissions"`
	Attachments        []model.Attachment              `json:"attachments,omitempty"`
	Unit               types.DisplayUnit               `json:"-"`
	UnitString         string                          `json:"unit"`
}

func Info 

func Info(ctx *model.Context, fileName string, selectedPages types.IntSet) (*PDFInfo, error)

Info returns info about ctx.

type PageConfiguration 

type PageConfiguration struct {
	PageDim  *types.Dim        // page dimensions in display unit.
	PageSize string            // one of A0,A1,A2,A3,A4(=default),A5,A6,A7,A8,Letter,Legal,Ledger,Tabloid,Executive,ANSIC,ANSID,ANSIE.
	UserDim  bool              // true if one of dimensions or paperSize provided overriding the default.
	InpUnit  types.DisplayUnit // input display unit.
}

PageConfiguration represents the page config for the "pages insert" command.

func DefaultPageConfiguration 

func DefaultPageConfiguration() *PageConfiguration

DefaultPageConfiguration returns the default configuration.

func ParsePageConfiguration 

func ParsePageConfiguration(s string, u types.DisplayUnit) (*PageConfiguration, error)

ParsePageConfiguration parses a page configuration string into an internal structure.

func (PageConfiguration) String 

func (p PageConfiguration) String() string

Source Files

View all Source files

Directories

Path Synopsis
Package validate implements validation against PDF 32000-1:2008.
 Package validate implements validation against PDF 32000-1:2008.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.