Documentation
¶
Overview ¶
Package gofpdf implements a PDF document generator with high level support for text, drawing and images.
Features ¶
- UTF-8 support
- Choice of measurement unit, page format and margins
- Page header and footer management
- Automatic page breaks, line breaks, and text justification
- Inclusion of JPEG, PNG, GIF, TIFF and basic path-only SVG images
- Colors, gradients and alpha channel transparency
- Outline bookmarks
- Internal and external links
- TrueType, Type1 and encoding support
- Page compression
- Lines, Bézier curves, arcs, and ellipses
- Rotation, scaling, skewing, translation, and mirroring
- Clipping
- Document protection
- Layers
- Templates
- Barcodes
- Charting facility
- Import PDFs as templates
gofpdf has no dependencies other than the Go standard library. All tests pass on Linux, Mac and Windows platforms.
gofpdf supports UTF-8 TrueType fonts and “right-to-left” languages. Note that Chinese, Japanese, and Korean characters may not be included in many general purpose fonts. For these languages, a specialized font (for example, NotoSansSC for simplified Chinese) can be used.
Also, support is provided to automatically translate UTF-8 runes to code page encodings for languages that have fewer than 256 glyphs.
Installation ¶
To install the package on your system, run
go get bitbucket.org/thoomycz/gofpdf
Later, to receive updates, run
go get -u -v bitbucket.org/thoomycz/gofpdf/...
Quick Start ¶
The following Go code generates a simple PDF file.
pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() pdf.SetFont("Arial", "B", 16) pdf.Cell(40, 10, "Hello, world") err := pdf.OutputFileAndClose("hello.pdf")
See the functions in the fpdf_test.go file (shown as examples in this documentation) for more advanced PDF examples.
Errors ¶
If an error occurs in an Fpdf method, an internal error field is set. After this occurs, Fpdf method calls typically return without performing any operations and the error state is retained. This error management scheme facilitates PDF generation since individual method calls do not need to be examined for failure; it is generally sufficient to wait until after Output() is called. For the same reason, if an error occurs in the calling application during PDF generation, it may be desirable for the application to transfer the error to the Fpdf instance by calling the SetError() method or the SetErrorf() method. At any time during the life cycle of the Fpdf instance, the error state can be determined with a call to Ok() or Err(). The error itself can be retrieved with a call to Error().
Conversion Notes ¶
This package is a relatively straightforward translation from the original FPDF library written in PHP (despite the caveat in the introduction to Effective Go). The API names have been retained even though the Go idiom would suggest otherwise (for example, pdf.GetX() is used rather than simply pdf.X()). The similarity of the two libraries makes the original FPDF website a good source of information. It includes a forum and FAQ.
However, some internal changes have been made. Page content is built up using buffers (of type bytes.Buffer) rather than repeated string concatenation. Errors are handled as explained above rather than panicking. Output is generated through an interface of type io.Writer or io.WriteCloser. A number of the original PHP methods behave differently based on the type of the arguments that are passed to them; in these cases additional methods have been exported to provide similar functionality. Font definition files are produced in JSON rather than PHP.
Example PDFs ¶
A side effect of running go test ./... is the production of a number of example PDFs. These can be found in the gofpdf/pdf directory after the tests complete.
Please note that these examples run in the context of a test. In order run an example as a standalone application, you’ll need to examine fpdf_test.go for some helper routines, for example exampleFilename() and summary().
Example PDFs can be compared with reference copies in order to verify that they have been generated as expected. This comparison will be performed if a PDF with the same name as the example PDF is placed in the gofpdf/pdf/reference directory and if the third argument to ComparePDFFiles() in internal/example/example.go is true. (By default it is false.) The routine that summarizes an example will look for this file and, if found, will call ComparePDFFiles() to check the example PDF for equality with its reference PDF. If differences exist between the two files they will be printed to standard output and the test will fail. If the reference file is missing, the comparison is considered to succeed. In order to successfully compare two PDFs, the placement of internal resources must be consistent and the internal creation timestamps must be the same. To do this, the methods SetCatalogSort() and SetCreationDate() need to be called for both files. This is done automatically for all examples.
Nonstandard Fonts ¶
Nothing special is required to use the standard PDF fonts (courier, helvetica, times, zapfdingbats) in your documents other than calling SetFont().
You should use AddUTF8Font() or AddUTF8FontFromBytes() to add a TrueType UTF-8 encoded font. Use RTL() and LTR() methods switch between “right-to-left” and “left-to-right” mode.
In order to use a different non-UTF-8 TrueType or Type1 font, you will need to generate a font definition file and, if the font will be embedded into PDFs, a compressed version of the font file. This is done by calling the MakeFont function or using the included makefont command line utility. To create the utility, cd into the makefont subdirectory and run “go build”. This will produce a standalone executable named makefont. Select the appropriate encoding file from the font subdirectory and run the command as in the following example.
./makefont --embed --enc=../font/cp1252.map --dst=../font ../font/calligra.ttf
In your PDF generation code, call AddFont() to load the font and, as with the standard fonts, SetFont() to begin using it. Most examples, including the package example, demonstrate this method. Good sources of free, open-source fonts include Google Fonts and DejaVu Fonts.
Related Packages ¶
The draw2d package is a two dimensional vector graphics library that can generate output in different forms. It uses gofpdf for its document production mode.
Contributing Changes ¶
gofpdf is a global community effort and you are invited to make it even better. If you have implemented a new feature or corrected a problem, please consider contributing your change to the project. A contribution that does not directly pertain to the core functionality of gofpdf should be placed in its own directory directly beneath the contrib directory.
Here are guidelines for making submissions. Your change should
- be compatible with the MIT License
- be properly documented
- be formatted with go fmt
- include an example in fpdf_test.go if appropriate
- conform to the standards of golint and go vet, that is, golint . and go vet . should not generate any warnings
- not diminish test coverage
Pull requests are the preferred means of accepting your changes.
License ¶
gofpdf is released under the MIT License. It is copyrighted by Kurt Jung and the contributors acknowledged below.
Acknowledgments ¶
This package’s code and documentation are closely derived from the FPDF library created by Olivier Plathey, and a number of font and image resources are copied directly from it. Bruno Michel has provided valuable assistance with the code. Drawing support is adapted from the FPDF geometric figures script by David Hernández Sanz. Transparency support is adapted from the FPDF transparency script by Martin Hall-May. Support for gradients and clipping is adapted from FPDF scripts by Andreas Würmser. Support for outline bookmarks is adapted from Olivier Plathey by Manuel Cornes. Layer support is adapted from Olivier Plathey. Support for transformations is adapted from the FPDF transformation script by Moritz Wagner and Andreas Würmser. PDF protection is adapted from the work of Klemen Vodopivec for the FPDF product. Lawrence Kesteloot provided code to allow an image’s extent to be determined prior to placement. Support for vertical alignment within a cell was provided by Stefan Schroeder. Ivan Daniluk generalized the font and image loading code to use the Reader interface while maintaining backward compatibility. Anthony Starks provided code for the Polygon function. Robert Lillack provided the Beziergon function and corrected some naming issues with the internal curve function. Claudio Felber provided implementations for dashed line drawing and generalized font loading. Stani Michiels provided support for multi-segment path drawing with smooth line joins, line join styles, enhanced fill modes, and has helped greatly with package presentation and tests. Templating is adapted by Marcus Downing from the FPDF_Tpl library created by Jan Slabon and Setasign. Jelmer Snoeck contributed packages that generate a variety of barcodes and help with registering images on the web. Jelmer Snoek and Guillermo Pascual augmented the basic HTML functionality with aligned text. Kent Quirk implemented backwards-compatible support for reading DPI from images that support it, and for setting DPI manually and then having it properly taken into account when calculating image size. Paulo Coutinho provided support for static embedded fonts. Dan Meyers added support for embedded JavaScript. David Fish added a generic alias-replacement function to enable, among other things, table of contents functionality. Andy Bakun identified and corrected a problem in which the internal catalogs were not sorted stably. Paul Montag added encoding and decoding functionality for templates, including images that are embedded in templates; this allows templates to be stored independently of gofpdf. Paul also added support for page boxes used in printing PDF documents. Wojciech Matusiak added supported for word spacing. Artem Korotkiy added support of UTF-8 fonts. Dave Barnes added support for imported objects and templates. Brigham Thompson added support for rounded rectangles. Joe Westcott added underline functionality and optimized image storage. Benoit KUGLER contributed support for rectangles with corners of unequal radius, modification times, and for file attachments and annotations.
Roadmap ¶
- Remove all legacy code page font support; use UTF-8 exclusively
- Improve test coverage as reported by the coverage tool.
Example ¶
Example demonstrates the generation of a simple PDF document. Note that since only core fonts are used (in this case Arial, a synonym for Helvetica), an empty string can be specified for the font directory in the call to New(). Note also that the example.Filename() and example.Summary() functions belong to a separate, internal package and are not part of the gofpdf library. If an error occurs at some point during the construction of the document, subsequent method calls exit immediately and the error is finally retrieved with the output call where it can be handled by the application.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New(gofpdf.OrientationPortrait, "mm", "A4", "") pdf.AddPage() pdf.SetFont("Arial", "B", 16) pdf.Cell(40, 10, "Hello World!") fileStr := example.Filename("basic") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/basic.pdf
Index ¶
- Constants
- func CompareBytes(sl1, sl2 []byte, printDiff bool) (err error)
- func ComparePDFFiles(file1Str, file2Str string, printDiff bool) (err error)
- func ComparePDFs(rdr1, rdr2 io.Reader, printDiff bool) (err error)
- func MakeFont(fontFileStr, encodingFileStr, dstDirStr string, msgWriter io.Writer, ...) error
- func SetDefaultCatalogSort(flag bool)
- func SetDefaultCompression(compress bool)
- func SetDefaultCreationDate(tm time.Time)
- func SetDefaultModificationDate(tm time.Time)
- func TickmarkPrecision(div float64) int
- func Tickmarks(min, max float64) (list []float64, precision int)
- func UTF8CutFont(inBuf []byte, cutset string) (outBuf []byte)
- func UnicodeTranslator(r io.Reader) (f func(string) string, err error)
- func UnicodeTranslatorFromFile(fileStr string) (f func(string) string, err error)
- type Attachment
- type FontDescType
- type FontLoader
- type Fpdf
- func (f *Fpdf) AddAttachmentAnnotation(a *Attachment, x, y, w, h float64)
- func (f *Fpdf) AddFont(familyStr, styleStr, fileStr string)
- func (f *Fpdf) AddFontFromBytes(familyStr, styleStr string, jsonFileBytes, zFileBytes []byte)
- func (f *Fpdf) AddFontFromReader(familyStr, styleStr string, r io.Reader)
- func (f *Fpdf) AddLayer(name string, visible bool) (layerID int)
- func (f *Fpdf) AddLink() int
- func (f *Fpdf) AddPage()
- func (f *Fpdf) AddPageFormat(orientationStr string, size SizeType)
- func (f *Fpdf) AddSpotColor(nameStr string, c, m, y, k byte)
- func (f *Fpdf) AddUTF8Font(familyStr, styleStr, fileStr string)
- func (f *Fpdf) AddUTF8FontFromBytes(familyStr, styleStr string, utf8Bytes []byte)
- func (f *Fpdf) AliasNbPages(aliasStr string)
- func (f *Fpdf) Arc(x, y, rx, ry, degRotate, degStart, degEnd float64, styleStr string)
- func (f *Fpdf) ArcTo(x, y, rx, ry, degRotate, degStart, degEnd float64)
- func (f *Fpdf) BeginLayer(id int)
- func (f *Fpdf) Beziergon(points []PointType, styleStr string)
- func (f *Fpdf) Bookmark(txtStr string, level int, y float64)
- func (f *Fpdf) Cell(w, h float64, txtStr string)
- func (f *Fpdf) CellFormat(w, h float64, txtStr, borderStr string, ln int, alignStr string, fill bool, ...)
- func (f *Fpdf) Cellf(w, h float64, fmtStr string, args ...interface{})
- func (f *Fpdf) Circle(x, y, r float64, styleStr string)
- func (f *Fpdf) ClearError()
- func (f *Fpdf) ClipCircle(x, y, r float64, outline bool)
- func (f *Fpdf) ClipEllipse(x, y, rx, ry float64, outline bool)
- func (f *Fpdf) ClipEnd()
- func (f *Fpdf) ClipPolygon(points []PointType, outline bool)
- func (f *Fpdf) ClipRect(x, y, w, h float64, outline bool)
- func (f *Fpdf) ClipRoundedRect(x, y, w, h, r float64, outline bool)
- func (f *Fpdf) ClipRoundedRectExt(x, y, w, h, rTL, rTR, rBR, rBL float64, outline bool)
- func (f *Fpdf) ClipText(x, y float64, txtStr string, outline bool)
- func (f *Fpdf) Close()
- func (f *Fpdf) ClosePath()
- func (f *Fpdf) CreateTemplate(fn func(*Tpl)) Template
- func (f *Fpdf) CreateTemplateCustom(corner PointType, size SizeType, fn func(*Tpl)) Template
- func (f *Fpdf) Curve(x0, y0, cx, cy, x1, y1 float64, styleStr string)
- func (f *Fpdf) CurveBezierCubic(x0, y0, cx0, cy0, cx1, cy1, x1, y1 float64, styleStr string)
- func (f *Fpdf) CurveBezierCubicTo(cx0, cy0, cx1, cy1, x, y float64)
- func (f *Fpdf) CurveCubic(x0, y0, cx0, cy0, x1, y1, cx1, cy1 float64, styleStr string)
- func (f *Fpdf) CurveTo(cx, cy, x, y float64)
- func (f *Fpdf) DrawPath(styleStr string)
- func (f *Fpdf) Ellipse(x, y, rx, ry, degRotate float64, styleStr string)
- func (f *Fpdf) EndLayer()
- func (f *Fpdf) Err() bool
- func (f *Fpdf) Error() error
- func (f *Fpdf) GetAlpha() (alpha float64, blendModeStr string)
- func (f *Fpdf) GetAutoPageBreak() (auto bool, margin float64)
- func (f *Fpdf) GetCellMargin() float64
- func (f *Fpdf) GetConversionRatio() float64
- func (f *Fpdf) GetDrawColor() (int, int, int)
- func (f *Fpdf) GetDrawSpotColor() (name string, c, m, y, k byte)
- func (f *Fpdf) GetFillColor() (int, int, int)
- func (f *Fpdf) GetFillSpotColor() (name string, c, m, y, k byte)
- func (f *Fpdf) GetFontDesc(familyStr, styleStr string) FontDescType
- func (f *Fpdf) GetFontSize() (ptSize, unitSize float64)
- func (f *Fpdf) GetImageInfo(imageStr string) (info *ImageInfoType)
- func (f *Fpdf) GetLineWidth() float64
- func (f *Fpdf) GetMargins() (left, top, right, bottom float64)
- func (f *Fpdf) GetPageSize() (width, height float64)
- func (f *Fpdf) GetPageSizeStr(sizeStr string) (size SizeType)
- func (f *Fpdf) GetStringSymbolWidth(s string) int
- func (f *Fpdf) GetStringWidth(s string) float64
- func (f *Fpdf) GetTextColor() (int, int, int)
- func (f *Fpdf) GetTextSpotColor() (name string, c, m, y, k byte)
- func (f *Fpdf) GetX() float64
- func (f *Fpdf) GetXY() (float64, float64)
- func (f *Fpdf) GetY() float64
- func (f *Fpdf) HTMLBasicNew() (html HTMLBasicType)
- func (f *Fpdf) Image(imageNameStr string, x, y, w, h float64, flow bool, tp string, link int, ...)
- func (f *Fpdf) ImageOptions(imageNameStr string, x, y, w, h float64, flow bool, options ImageOptions, ...)
- func (f *Fpdf) ImageTypeFromMime(mimeStr string) (tp string)
- func (f *Fpdf) ImportObjPos(objPos map[string]map[int]string)
- func (f *Fpdf) ImportObjects(objs map[string][]byte)
- func (f *Fpdf) ImportTemplates(tpls map[string]string)
- func (f *Fpdf) LTR()
- func (f *Fpdf) Line(x1, y1, x2, y2 float64)
- func (f *Fpdf) LineTo(x, y float64)
- func (f *Fpdf) LinearGradient(x, y, w, h float64, r1, g1, b1, r2, g2, b2 int, x1, y1, x2, y2 float64)
- func (f *Fpdf) Link(x, y, w, h float64, link int)
- func (f *Fpdf) LinkString(x, y, w, h float64, linkStr string)
- func (f *Fpdf) Ln(h float64)
- func (f *Fpdf) MoveTo(x, y float64)
- func (f *Fpdf) MultiCell(w, h float64, txtStr, borderStr, alignStr string, fill bool)
- func (f *Fpdf) Ok() bool
- func (f *Fpdf) OpenLayerPane()
- func (f *Fpdf) Output(w io.Writer) error
- func (f *Fpdf) OutputAndClose(w io.WriteCloser) error
- func (f *Fpdf) OutputFileAndClose(fileStr string) error
- func (f *Fpdf) PageCount() int
- func (f *Fpdf) PageNo() int
- func (f *Fpdf) PageSize(pageNum int) (wd, ht float64, unitStr string)
- func (f *Fpdf) PointConvert(pt float64) (u float64)
- func (f *Fpdf) PointToUnitConvert(pt float64) (u float64)
- func (f *Fpdf) Polygon(points []PointType, styleStr string)
- func (f *Fpdf) RTL()
- func (f *Fpdf) RadialGradient(x, y, w, h float64, r1, g1, b1, r2, g2, b2 int, x1, y1, x2, y2, r float64)
- func (f *Fpdf) RawWriteBuf(r io.Reader)
- func (f *Fpdf) RawWriteStr(str string)
- func (f *Fpdf) Rect(x, y, w, h float64, styleStr string)
- func (f *Fpdf) RegisterAlias(alias, replacement string)
- func (f *Fpdf) RegisterImage(fileStr, tp string) (info *ImageInfoType)
- func (f *Fpdf) RegisterImageOptions(fileStr string, options ImageOptions) (info *ImageInfoType)
- func (f *Fpdf) RegisterImageOptionsReader(imgName string, options ImageOptions, r io.Reader) (info *ImageInfoType)
- func (f *Fpdf) RegisterImageReader(imgName, tp string, r io.Reader) (info *ImageInfoType)
- func (f *Fpdf) RoundedRect(x, y, w, h, r float64, corners string, stylestr string)
- func (f *Fpdf) RoundedRectExt(x, y, w, h, rTL, rTR, rBR, rBL float64, stylestr string)
- func (f *Fpdf) SVGBasicWrite(sb *SVGBasicType, scale float64)
- func (f *Fpdf) SetAcceptPageBreakFunc(fnc func() bool)
- func (f *Fpdf) SetAlpha(alpha float64, blendModeStr string)
- func (f *Fpdf) SetAttachments(as []Attachment)
- func (f *Fpdf) SetAuthor(authorStr string, isUTF8 bool)
- func (f *Fpdf) SetAutoPageBreak(auto bool, margin float64)
- func (f *Fpdf) SetCatalogSort(flag bool)
- func (f *Fpdf) SetCellMargin(margin float64)
- func (f *Fpdf) SetCompression(compress bool)
- func (f *Fpdf) SetCreationDate(tm time.Time)
- func (f *Fpdf) SetCreator(creatorStr string, isUTF8 bool)
- func (f *Fpdf) SetDashPattern(dashArray []float64, dashPhase float64)
- func (f *Fpdf) SetDisplayMode(zoomStr, layoutStr string)
- func (f *Fpdf) SetDrawColor(r, g, b int)
- func (f *Fpdf) SetDrawSpotColor(nameStr string, tint byte)
- func (f *Fpdf) SetError(err error)
- func (f *Fpdf) SetErrorf(fmtStr string, args ...interface{})
- func (f *Fpdf) SetFillColor(r, g, b int)
- func (f *Fpdf) SetFillSpotColor(nameStr string, tint byte)
- func (f *Fpdf) SetFont(familyStr, styleStr string, size float64)
- func (f *Fpdf) SetFontLoader(loader FontLoader)
- func (f *Fpdf) SetFontLocation(fontDirStr string)
- func (f *Fpdf) SetFontSize(size float64)
- func (f *Fpdf) SetFontStyle(styleStr string)
- func (f *Fpdf) SetFontUnitSize(size float64)
- func (f *Fpdf) SetFooterFunc(fnc func())
- func (f *Fpdf) SetFooterFuncLpi(fnc func(lastPage bool))
- func (f *Fpdf) SetHeaderFunc(fnc func())
- func (f *Fpdf) SetHeaderFuncMode(fnc func(), homeMode bool)
- func (f *Fpdf) SetHomeXY()
- func (f *Fpdf) SetJavascript(script string)
- func (f *Fpdf) SetKeywords(keywordsStr string, isUTF8 bool)
- func (f *Fpdf) SetLeftMargin(margin float64)
- func (f *Fpdf) SetLineCapStyle(styleStr string)
- func (f *Fpdf) SetLineJoinStyle(styleStr string)
- func (f *Fpdf) SetLineWidth(width float64)
- func (f *Fpdf) SetLink(link int, y float64, page int)
- func (f *Fpdf) SetMargins(left, top, right float64)
- func (f *Fpdf) SetModificationDate(tm time.Time)
- func (f *Fpdf) SetPage(pageNum int)
- func (f *Fpdf) SetPageBox(t string, x, y, wd, ht float64)
- func (f *Fpdf) SetPageBoxRec(t string, pb PageBox)
- func (f *Fpdf) SetProducer(producerStr string, isUTF8 bool)
- func (f *Fpdf) SetProtection(actionFlag byte, userPassStr, ownerPassStr string)
- func (f *Fpdf) SetRightMargin(margin float64)
- func (f *Fpdf) SetSubject(subjectStr string, isUTF8 bool)
- func (f *Fpdf) SetTextColor(r, g, b int)
- func (f *Fpdf) SetTextRenderingMode(mode int)
- func (f *Fpdf) SetTextSpotColor(nameStr string, tint byte)
- func (f *Fpdf) SetTitle(titleStr string, isUTF8 bool)
- func (f *Fpdf) SetTopMargin(margin float64)
- func (f *Fpdf) SetUnderlineThickness(thickness float64)
- func (f *Fpdf) SetWordSpacing(space float64)
- func (f *Fpdf) SetX(x float64)
- func (f *Fpdf) SetXY(x, y float64)
- func (f *Fpdf) SetXmpMetadata(xmpStream []byte)
- func (f *Fpdf) SetY(y float64)
- func (f *Fpdf) SplitLines(txt []byte, w float64) [][]byte
- func (f *Fpdf) SplitText(txt string, w float64) (lines []string)
- func (f *Fpdf) String() string
- func (f *Fpdf) SubWrite(ht float64, str string, subFontSize, subOffset float64, link int, ...)
- func (f *Fpdf) Text(x, y float64, txtStr string)
- func (f *Fpdf) Transform(tm TransformMatrix)
- func (f *Fpdf) TransformBegin()
- func (f *Fpdf) TransformEnd()
- func (f *Fpdf) TransformMirrorHorizontal(x float64)
- func (f *Fpdf) TransformMirrorLine(angle, x, y float64)
- func (f *Fpdf) TransformMirrorPoint(x, y float64)
- func (f *Fpdf) TransformMirrorVertical(y float64)
- func (f *Fpdf) TransformRotate(angle, x, y float64)
- func (f *Fpdf) TransformScale(scaleWd, scaleHt, x, y float64)
- func (f *Fpdf) TransformScaleX(scaleWd, x, y float64)
- func (f *Fpdf) TransformScaleXY(s, x, y float64)
- func (f *Fpdf) TransformScaleY(scaleHt, x, y float64)
- func (f *Fpdf) TransformSkew(angleX, angleY, x, y float64)
- func (f *Fpdf) TransformSkewX(angleX, x, y float64)
- func (f *Fpdf) TransformSkewY(angleY, x, y float64)
- func (f *Fpdf) TransformTranslate(tx, ty float64)
- func (f *Fpdf) TransformTranslateX(tx float64)
- func (f *Fpdf) TransformTranslateY(ty float64)
- func (f *Fpdf) UnicodeTranslatorFromDescriptor(cpStr string) (rep func(string) string)
- func (f *Fpdf) UnitToPointConvert(u float64) (pt float64)
- func (f *Fpdf) UseImportedTemplate(tplName string, scaleX float64, scaleY float64, tX float64, tY float64)
- func (f *Fpdf) UseTemplate(t Template)
- func (f *Fpdf) UseTemplateScaled(t Template, corner PointType, size SizeType)
- func (f *Fpdf) Write(h float64, txtStr string)
- func (f *Fpdf) WriteAligned(width, lineHeight float64, textStr, alignStr string)
- func (f *Fpdf) WriteLinkID(h float64, displayStr string, linkID int)
- func (f *Fpdf) WriteLinkString(h float64, displayStr, targetStr string)
- func (f *Fpdf) Writef(h float64, fmtStr string, args ...interface{})
- type FpdfTpl
- func (t *FpdfTpl) Bytes() []byte
- func (t *FpdfTpl) FromPage(page int) (Template, error)
- func (t *FpdfTpl) FromPages() []Template
- func (t *FpdfTpl) GobDecode(buf []byte) error
- func (t *FpdfTpl) GobEncode() ([]byte, error)
- func (t *FpdfTpl) ID() string
- func (t *FpdfTpl) Images() map[string]*ImageInfoType
- func (t *FpdfTpl) NumPages() int
- func (t *FpdfTpl) Serialize() ([]byte, error)
- func (t *FpdfTpl) Size() (corner PointType, size SizeType)
- func (t *FpdfTpl) Templates() []Template
- type GridType
- func (g GridType) Grid(pdf *Fpdf)
- func (g GridType) Ht(dataHt float64) float64
- func (g GridType) HtAbs(dataHt float64) float64
- func (g GridType) Plot(pdf *Fpdf, xMin, xMax float64, count int, fnc func(x float64) (y float64))
- func (g GridType) Pos(xRel, yRel float64) (x, y float64)
- func (g *GridType) TickmarksContainX(min, max float64)
- func (g *GridType) TickmarksContainY(min, max float64)
- func (g *GridType) TickmarksExtentX(min, div float64, count int)
- func (g *GridType) TickmarksExtentY(min, div float64, count int)
- func (g GridType) Wd(dataWd float64) float64
- func (g GridType) WdAbs(dataWd float64) float64
- func (g GridType) X(dataX float64) float64
- func (g GridType) XRange() (min, max float64)
- func (g GridType) XY(dataX, dataY float64) (x, y float64)
- func (g GridType) Y(dataY float64) float64
- func (g GridType) YRange() (min, max float64)
- type HTMLBasicSegmentType
- type HTMLBasicType
- type ImageInfoType
- func (info *ImageInfoType) Extent() (wd, ht float64)
- func (info *ImageInfoType) GobDecode(buf []byte) (err error)
- func (info *ImageInfoType) GobEncode() (buf []byte, err error)
- func (info *ImageInfoType) Height() float64
- func (info *ImageInfoType) SetDpi(dpi float64)
- func (info *ImageInfoType) Width() float64
- type ImageOptions
- type InitType
- type PageBox
- type Pdf
- type PointType
- type RGBAType
- type RGBType
- type SVGBasicSegmentType
- type SVGBasicType
- type SizeType
- type StateType
- type Template
- type TickFormatFncType
- type Tpl
- type TransformMatrix
- type TtfType
Examples ¶
- Package
- Fpdf.AddAttachmentAnnotation
- Fpdf.AddFont
- Fpdf.AddFontFromBytes
- Fpdf.AddLayer
- Fpdf.AddPage
- Fpdf.AddSpotColor
- Fpdf.AddUTF8Font
- Fpdf.Beziergon
- Fpdf.Bookmark
- Fpdf.Cell (Strikeout)
- Fpdf.CellFormat (Align)
- Fpdf.CellFormat (Codepage)
- Fpdf.CellFormat (Codepageescape)
- Fpdf.CellFormat (Tables)
- Fpdf.Circle
- Fpdf.ClipRect
- Fpdf.ClipText
- Fpdf.CreateTemplate
- Fpdf.DrawPath
- Fpdf.GetStringWidth
- Fpdf.HTMLBasicNew
- Fpdf.Image
- Fpdf.ImageOptions
- Fpdf.LinearGradient
- Fpdf.MoveTo
- Fpdf.MultiCell
- Fpdf.PageSize
- Fpdf.Polygon
- Fpdf.Rect
- Fpdf.RegisterAlias
- Fpdf.RegisterAlias (Utf8)
- Fpdf.RegisterImage
- Fpdf.RegisterImageOptionsReader
- Fpdf.RegisterImageReader
- Fpdf.RoundedRect
- Fpdf.SVGBasicWrite
- Fpdf.SetAcceptPageBreakFunc
- Fpdf.SetAlpha
- Fpdf.SetAttachments
- Fpdf.SetFillColor
- Fpdf.SetFontLoader
- Fpdf.SetJavascript
- Fpdf.SetKeywords
- Fpdf.SetLeftMargin
- Fpdf.SetLineJoinStyle
- Fpdf.SetModificationDate
- Fpdf.SetPage
- Fpdf.SetPageBox
- Fpdf.SetProtection
- Fpdf.SetTextRenderingMode
- Fpdf.SetUnderlineThickness
- Fpdf.SplitLines
- Fpdf.SplitLines (Tables)
- Fpdf.SubWrite
- Fpdf.TransformBegin
- Fpdf.TransformRotate
- Fpdf.WriteAligned
- NewGrid
- TtfParse
- UTF8CutFont
Constants ¶
const ( // OrientationPortrait represents the portrait orientation. OrientationPortrait = "portrait" // OrientationLandscape represents the landscape orientation. OrientationLandscape = "landscape" )
const ( // UnitPoint represents the size unit point UnitPoint = "pt" // UnitMillimeter represents the size unit millimeter UnitMillimeter = "mm" // UnitCentimeter represents the size unit centimeter UnitCentimeter = "cm" // UnitInch represents the size unit inch UnitInch = "inch" )
const ( // PageSizeA3 represents DIN/ISO A3 page size PageSizeA3 = "A3" // PageSizeA4 represents DIN/ISO A4 page size PageSizeA4 = "A4" // PageSizeA5 represents DIN/ISO A5 page size PageSizeA5 = "A5" // PageSizeLetter represents US Letter page size PageSizeLetter = "Letter" // PageSizeLegal represents US Legal page size PageSizeLegal = "Legal" )
const ( // BorderNone set no border BorderNone = "" // BorderFull sets a full border BorderFull = "1" // BorderLeft sets the border on the left side BorderLeft = "L" // BorderTop sets the border at the top BorderTop = "T" // BorderRight sets the border on the right side BorderRight = "R" // BorderBottom sets the border on the bottom BorderBottom = "B" )
const ( // LineBreakNone disables linebreak LineBreakNone = 0 // LineBreakNormal enables normal linebreak LineBreakNormal = 1 // LineBreakBelow enables linebreak below LineBreakBelow = 2 )
const ( // AlignLeft left aligns the cell AlignLeft = "L" // AlignRight right aligns the cell AlignRight = "R" // AlignCenter centers the cell AlignCenter = "C" // AlignTop aligns the cell to the top AlignTop = "T" // AlignBottom aligns the cell to the bottom AlignBottom = "B" // AlignMiddle aligns the cell to the middle AlignMiddle = "M" // AlignBaseline aligns the cell to the baseline AlignBaseline = "B" )
const ( // FontFlagFixedPitch is set if all glyphs have the same width (as // opposed to proportional or variable-pitch fonts, which have // different widths). FontFlagFixedPitch = 1 << 0 // FontFlagSerif is set if glyphs have serifs, which are short // strokes drawn at an angle on the top and bottom of glyph stems. // (Sans serif fonts do not have serifs.) FontFlagSerif = 1 << 1 // FontFlagSymbolic is set if font contains glyphs outside the // Adobe standard Latin character set. This flag and the // Nonsymbolic flag shall not both be set or both be clear. FontFlagSymbolic = 1 << 2 // FontFlagScript is set if glyphs resemble cursive handwriting. FontFlagScript = 1 << 3 // FontFlagNonsymbolic is set if font uses the Adobe standard // Latin character set or a subset of it. FontFlagNonsymbolic = 1 << 5 // FontFlagItalic is set if glyphs have dominant vertical strokes // that are slanted. FontFlagItalic = 1 << 6 // FontFlagAllCap is set if font contains no lowercase letters; // typically used for display purposes, such as for titles or // headlines. FontFlagAllCap = 1 << 16 // SmallCap is set if font contains both uppercase and lowercase // letters. The uppercase letters are similar to those in the // regular version of the same typeface family. The glyphs for the // lowercase letters have the same shapes as the corresponding // uppercase letters, but they are sized and their proportions // adjusted so that they have the same size and stroke weight as // lowercase glyphs in the same typeface family. SmallCap = 1 << 18 // ForceBold determines whether bold glyphs shall be painted with // extra pixels even at very small text sizes by a conforming // reader. If the ForceBold flag is set, features of bold glyphs // may be thickened at small text sizes. ForceBold = 1 << 18 )
Font flags for FontDescType.Flags as defined in the pdf specification.
const ( CnProtectPrint = 4 CnProtectModify = 8 CnProtectCopy = 16 CnProtectAnnotForms = 32 )
Advisory bitflag constants that control document activities
Variables ¶
This section is empty.
Functions ¶
func CompareBytes ¶
CompareBytes compares the bytes referred to by sl1 with those referred to by sl2. Nil is returned if the buffers are equal, otherwise an error.
func ComparePDFFiles ¶
ComparePDFFiles reads and compares the full contents of the two specified files byte-for-byte. Nil is returned if the file contents are equal, or if the second file is missing, otherwise an error.
func ComparePDFs ¶
ComparePDFs reads and compares the full contents of the two specified readers byte-for-byte. Nil is returned if the buffers are equal, otherwise an error.
func MakeFont ¶
func MakeFont(fontFileStr, encodingFileStr, dstDirStr string, msgWriter io.Writer, embed bool) error
MakeFont generates a font definition file in JSON format. A definition file of this type is required to use non-core fonts in the PDF documents that gofpdf generates. See the makefont utility in the gofpdf package for a command line interface to this function.
fontFileStr is the name of the TrueType file (extension .ttf), OpenType file (extension .otf) or binary Type1 file (extension .pfb) from which to generate a definition file. If an OpenType file is specified, it must be one that is based on TrueType outlines, not PostScript outlines; this cannot be determined from the file extension alone. If a Type1 file is specified, a metric file with the same pathname except with the extension .afm must be present.
encodingFileStr is the name of the encoding file that corresponds to the font.
dstDirStr is the name of the directory in which to save the definition file and, if embed is true, the compressed font file.
msgWriter is the writer that is called to display messages throughout the process. Use nil to turn off messages.
embed is true if the font is to be embedded in the PDF files.
func SetDefaultCatalogSort ¶
func SetDefaultCatalogSort(flag bool)
SetDefaultCatalogSort sets the default value of the catalog sort flag that will be used when initializing a new Fpdf instance. See SetCatalogSort() for more details.
func SetDefaultCompression ¶
func SetDefaultCompression(compress bool)
SetDefaultCompression controls the default setting of the internal compression flag. See SetCompression() for more details. Compression is on by default.
func SetDefaultCreationDate ¶
SetDefaultCreationDate sets the default value of the document creation date that will be used when initializing a new Fpdf instance. See SetCreationDate() for more details.
func SetDefaultModificationDate ¶ added in v1.4.3
SetDefaultModificationDate sets the default value of the document modification date that will be used when initializing a new Fpdf instance. See SetCreationDate() for more details.
func TickmarkPrecision ¶ added in v1.4.3
TickmarkPrecision returns an appropriate precision value for label formatting.
func Tickmarks ¶ added in v1.4.3
Tickmarks returns a slice of tickmarks appropriate for a chart axis and an appropriate precision for formatting purposes. The values min and max will be contained within the tickmark range.
func UTF8CutFont ¶ added in v1.4.3
UTF8CutFont is a utility function that generates a TrueType font composed only of the runes included in cutset. The rune glyphs are copied from This function is demonstrated in ExampleUTF8CutFont().
Example ¶
ExampleUTF8CutFont demonstrates how generate a TrueType font subset.
package main import ( "fmt" "io/ioutil" "os" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { var pdfFileStr, fullFontFileStr, subFontFileStr string var subFont, fullFont []byte var err error pdfFileStr = example.Filename("Fpdf_UTF8CutFont") fullFontFileStr = example.FontFile("calligra.ttf") fullFont, err = ioutil.ReadFile(fullFontFileStr) if err == nil { subFontFileStr = "calligra_abcde.ttf" subFont = gofpdf.UTF8CutFont(fullFont, "abcde") err = ioutil.WriteFile(subFontFileStr, subFont, 0600) if err == nil { y := 24.0 pdf := gofpdf.New("P", "mm", "A4", "") fontHt := 17.0 lineHt := pdf.PointConvert(fontHt) write := func(format string, args ...interface{}) { pdf.SetXY(24.0, y) pdf.Cell(200.0, lineHt, fmt.Sprintf(format, args...)) y += lineHt } writeSize := func(fileStr string) { var info os.FileInfo var err error info, err = os.Stat(fileStr) if err == nil { write("%6d: size of %s", info.Size(), fileStr) } } pdf.AddPage() pdf.AddUTF8Font("calligra", "", subFontFileStr) pdf.SetFont("calligra", "", fontHt) write("cabbed") write("vwxyz") pdf.SetFont("courier", "", fontHt) writeSize(fullFontFileStr) writeSize(subFontFileStr) err = pdf.OutputFileAndClose(pdfFileStr) os.Remove(subFontFileStr) } } example.Summary(err, pdfFileStr) }
Output: Successfully generated pdf/Fpdf_UTF8CutFont.pdf
func UnicodeTranslator ¶
UnicodeTranslator returns a function that can be used to translate, where possible, utf-8 strings to a form that is compatible with the specified code page. The returned function accepts a string and returns a string.
r is a reader that should read a buffer made up of content lines that pertain to the code page of interest. Each line is made up of three whitespace separated fields. The first begins with "!" and is followed by two hexadecimal digits that identify the glyph position in the code page of interest. The second field begins with "U+" and is followed by the unicode code point value. The third is the glyph name. A number of these code page map files are packaged with the gfpdf library in the font directory.
An error occurs only if a line is read that does not conform to the expected format. In this case, the returned function is valid but does not perform any rune translation.
func UnicodeTranslatorFromFile ¶
UnicodeTranslatorFromFile returns a function that can be used to translate, where possible, utf-8 strings to a form that is compatible with the specified code page. See UnicodeTranslator for more details.
fileStr identifies a font descriptor file that maps glyph positions to names.
If an error occurs reading the file, the returned function is valid but does not perform any rune translation.
Types ¶
type Attachment ¶ added in v1.4.3
type Attachment struct { Content []byte // Filename is the displayed name of the attachment Filename string // Description is only displayed when using AddAttachmentAnnotation(), // and might be modified by the pdf reader. Description string // contains filtered or unexported fields }
Attachment defines a content to be included in the pdf, in one of the following ways :
- associated with the document as a whole : see SetAttachments()
- accessible via a link localized on a page : see AddAttachmentAnnotation()
type FontDescType ¶
type FontDescType struct { // The maximum height above the baseline reached by glyphs in this // font (for example for "S"). The height of glyphs for accented // characters shall be excluded. Ascent int // The maximum depth below the baseline reached by glyphs in this // font. The value shall be a negative number. Descent int // The vertical coordinate of the top of flat capital letters, // measured from the baseline (for example "H"). CapHeight int // A collection of flags defining various characteristics of the // font. (See the FontFlag* constants.) Flags int // A rectangle, expressed in the glyph coordinate system, that // shall specify the font bounding box. This should be the smallest // rectangle enclosing the shape that would result if all of the // glyphs of the font were placed with their origins coincident // and then filled. FontBBox fontBoxType // The angle, expressed in degrees counterclockwise from the // vertical, of the dominant vertical strokes of the font. (The // 9-o’clock position is 90 degrees, and the 3-o’clock position // is –90 degrees.) The value shall be negative for fonts that // slope to the right, as almost all italic fonts do. ItalicAngle int // The thickness, measured horizontally, of the dominant vertical // stems of glyphs in the font. StemV int // The width to use for character codes whose widths are not // specified in a font dictionary’s Widths array. This shall have // a predictable effect only if all such codes map to glyphs whose // actual widths are the same as the value of the MissingWidth // entry. (Default value: 0.) MissingWidth int }
FontDescType (font descriptor) specifies metrics and other attributes of a font, as distinct from the metrics of individual glyphs (as defined in the pdf specification).
type FontLoader ¶
FontLoader is used to read fonts (JSON font specification and zlib compressed font binaries) from arbitrary locations (e.g. files, zip files, embedded font resources).
Open provides an io.Reader for the specified font file (.json or .z). The file name never includes a path. Open returns an error if the specified file cannot be opened.
type Fpdf ¶
type Fpdf struct {
// contains filtered or unexported fields
}
Fpdf is the principal structure for creating a single PDF document
func New ¶
New returns a pointer to a new Fpdf instance. Its methods are subsequently called to produce a single PDF document.
orientationStr specifies the default page orientation. For portrait mode, specify "P" or "Portrait". For landscape mode, specify "L" or "Landscape". An empty string will be replaced with "P".
unitStr specifies the unit of length used in size parameters for elements other than fonts, which are always measured in points. Specify "pt" for point, "mm" for millimeter, "cm" for centimeter, or "in" for inch. An empty string will be replaced with "mm".
sizeStr specifies the page size. Acceptable values are "A3", "A4", "A5", "Letter", "Legal", or "Tabloid". An empty string will be replaced with "A4".
fontDirStr specifies the file system location in which font resources will be found. An empty string is replaced with ".". This argument only needs to reference an actual directory if a font other than one of the core fonts is used. The core fonts are "courier", "helvetica" (also called "arial"), "times", and "zapfdingbats" (also called "symbol").
func NewCustom ¶
NewCustom returns a pointer to a new Fpdf instance. Its methods are subsequently called to produce a single PDF document. NewCustom() is an alternative to New() that provides additional customization. The PageSize() example demonstrates this method.
func (*Fpdf) AddAttachmentAnnotation ¶ added in v1.4.3
func (f *Fpdf) AddAttachmentAnnotation(a *Attachment, x, y, w, h float64)
AddAttachmentAnnotation puts a link on the current page, on the rectangle defined by `x`, `y`, `w`, `h`. This link points towards the content defined in `a`, which is embedded in the document. Note than no drawing is done by this method : a method like `Cell()` or `Rect()` should be called to indicate to the reader that there is a link here. Requiring a pointer to an Attachment avoids useless copies in the resulting pdf: attachment pointing to the same data will have their content only be included once, and be shared amongst all links. Be aware that not all PDF readers support annotated attachments. See the AddAttachmentAnnotation example for a demonstration of this method.
Example ¶
package main import ( "io/ioutil" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.SetFont("Arial", "", 12) pdf.AddPage() // Per page attachment file, err := ioutil.ReadFile("grid.go") if err != nil { pdf.SetError(err) } a := gofpdf.Attachment{Content: file, Filename: "grid.go", Description: "Some amazing code !"} pdf.SetXY(5, 10) pdf.Rect(2, 10, 50, 15, "D") pdf.AddAttachmentAnnotation(&a, 2, 10, 50, 15) pdf.Cell(50, 15, "A first link") pdf.SetXY(5, 80) pdf.Rect(2, 80, 50, 15, "D") pdf.AddAttachmentAnnotation(&a, 2, 80, 50, 15) pdf.Cell(50, 15, "A second link (no copy)") fileStr := example.Filename("Fpdf_FileAnnotations") err = pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_FileAnnotations.pdf
func (*Fpdf) AddFont ¶
AddFont imports a TrueType, OpenType or Type1 font and makes it available. It is necessary to generate a font definition file first with the makefont utility. It is not necessary to call this function for the core PDF fonts (courier, helvetica, times, zapfdingbats).
The JSON definition file (and the font file itself when embedding) must be present in the font directory. If it is not found, the error "Could not include font definition file" is set.
family specifies the font family. The name can be chosen arbitrarily. If it is a standard family name, it will override the corresponding font. This string is used to subsequently set the font with the SetFont method.
style specifies the font style. Acceptable values are (case insensitive) the empty string for regular style, "B" for bold, "I" for italic, or "BI" or "IB" for bold and italic combined.
fileStr specifies the base name with ".json" extension of the font definition file to be added. The file will be loaded from the font directory specified in the call to New() or SetFontLocation().
Example ¶
ExampleFpdf_AddFont demonstrates the use of a non-standard font.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", example.FontDir()) pdf.AddFont("Calligrapher", "", "calligra.json") pdf.AddPage() pdf.SetFont("Calligrapher", "", 35) pdf.Cell(0, 10, "Enjoy new fonts with FPDF!") fileStr := example.Filename("Fpdf_AddFont") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_AddFont.pdf
func (*Fpdf) AddFontFromBytes ¶
AddFontFromBytes imports a TrueType, OpenType or Type1 font from static bytes within the executable and makes it available for use in the generated document.
family specifies the font family. The name can be chosen arbitrarily. If it is a standard family name, it will override the corresponding font. This string is used to subsequently set the font with the SetFont method.
style specifies the font style. Acceptable values are (case insensitive) the empty string for regular style, "B" for bold, "I" for italic, or "BI" or "IB" for bold and italic combined.
jsonFileBytes contain all bytes of JSON file.
zFileBytes contain all bytes of Z file.
Example ¶
ExampleFpdf_AddFontFromBytes demonstrate how to use embedded fonts from byte array
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" "bitbucket.org/thoomycz/gofpdf/internal/files" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() pdf.AddFontFromBytes("calligra", "", files.CalligraJson, files.CalligraZ) pdf.SetFont("calligra", "", 16) pdf.Cell(40, 10, "Hello World With Embedded Font!") fileStr := example.Filename("Fpdf_EmbeddedFont") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_EmbeddedFont.pdf
func (*Fpdf) AddFontFromReader ¶
AddFontFromReader imports a TrueType, OpenType or Type1 font and makes it available using a reader that satisifies the io.Reader interface. See AddFont for details about familyStr and styleStr.
func (*Fpdf) AddLayer ¶
AddLayer defines a layer that can be shown or hidden when the document is displayed. name specifies the layer name that the document reader will display in the layer list. visible specifies whether the layer will be initially visible. The return value is an integer ID that is used in a call to BeginLayer().
Example ¶
ExampleFpdf_AddLayer demonstrates document layers. The initial visibility of a layer is specified with the second parameter to AddLayer(). The layer list displayed by the document reader allows layer visibility to be controlled interactively.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() pdf.SetFont("Arial", "", 15) pdf.Write(8, "This line doesn't belong to any layer.\n") // Define layers l1 := pdf.AddLayer("Layer 1", true) l2 := pdf.AddLayer("Layer 2", true) // Open layer pane in PDF viewer pdf.OpenLayerPane() // First layer pdf.BeginLayer(l1) pdf.Write(8, "This line belongs to layer 1.\n") pdf.EndLayer() // Second layer pdf.BeginLayer(l2) pdf.Write(8, "This line belongs to layer 2.\n") pdf.EndLayer() // First layer again pdf.BeginLayer(l1) pdf.Write(8, "This line belongs to layer 1 again.\n") pdf.EndLayer() fileStr := example.Filename("Fpdf_AddLayer") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_AddLayer.pdf
func (*Fpdf) AddLink ¶
AddLink creates a new internal link and returns its identifier. An internal link is a clickable area which directs to another place within the document. The identifier can then be passed to Cell(), Write(), Image() or Link(). The destination is defined with SetLink().
func (*Fpdf) AddPage ¶
func (f *Fpdf) AddPage()
AddPage adds a new page to the document. If a page is already present, the Footer() method is called first to output the footer. Then the page is added, the current position set to the top-left corner according to the left and top margins, and Header() is called to display the header.
The font which was set before calling is automatically restored. There is no need to call SetFont() again if you want to continue with the same font. The same is true for colors and line width.
The origin of the coordinate system is at the top-left corner and increasing ordinates go downwards.
See AddPageFormat() for a version of this method that allows the page size and orientation to be different than the default.
Example ¶
ExampleFpdf_AddPage demonsrates the generation of headers, footers and page breaks.
package main import ( "fmt" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.SetTopMargin(30) pdf.SetHeaderFuncMode(func() { pdf.Image(example.ImageFile("logo.png"), 10, 6, 30, 0, false, "", 0, "") pdf.SetY(5) pdf.SetFont("Arial", "B", 15) pdf.Cell(80, 0, "") pdf.CellFormat(30, 10, "Title", "1", 0, "C", false, 0, "") pdf.Ln(20) }, true) pdf.SetFooterFunc(func() { pdf.SetY(-15) pdf.SetFont("Arial", "I", 8) pdf.CellFormat(0, 10, fmt.Sprintf("Page %d/{nb}", pdf.PageNo()), "", 0, "C", false, 0, "") }) pdf.AliasNbPages("") pdf.AddPage() pdf.SetFont("Times", "", 12) for j := 1; j <= 40; j++ { pdf.CellFormat(0, 10, fmt.Sprintf("Printing line number %d", j), "", 1, "", false, 0, "") } fileStr := example.Filename("Fpdf_AddPage") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_AddPage.pdf
func (*Fpdf) AddPageFormat ¶
AddPageFormat adds a new page with non-default orientation or size. See AddPage() for more details.
See New() for a description of orientationStr.
size specifies the size of the new page in the units established in New().
The PageSize() example demonstrates this method.
func (*Fpdf) AddSpotColor ¶ added in v1.4.3
AddSpotColor adds an ink-based CMYK color to the gofpdf instance and associates it with the specified name. The individual components specify percentages ranging from 0 to 100. Values above this are quietly capped to 100. An error occurs if the specified name is already associated with a color.
Example ¶
ExampleFpdf_AddSpotColor demonstrates spot color use
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddSpotColor("PANTONE 145 CVC", 0, 42, 100, 25) pdf.AddPage() pdf.SetFillSpotColor("PANTONE 145 CVC", 90) pdf.Rect(80, 40, 50, 50, "F") fileStr := example.Filename("Fpdf_AddSpotColor") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_AddSpotColor.pdf
func (*Fpdf) AddUTF8Font ¶ added in v1.4.3
AddUTF8Font imports a TrueType font with utf-8 symbols and makes it available. It is necessary to generate a font definition file first with the makefont utility. It is not necessary to call this function for the core PDF fonts (courier, helvetica, times, zapfdingbats).
The JSON definition file (and the font file itself when embedding) must be present in the font directory. If it is not found, the error "Could not include font definition file" is set.
family specifies the font family. The name can be chosen arbitrarily. If it is a standard family name, it will override the corresponding font. This string is used to subsequently set the font with the SetFont method.
style specifies the font style. Acceptable values are (case insensitive) the empty string for regular style, "B" for bold, "I" for italic, or "BI" or "IB" for bold and italic combined.
fileStr specifies the base name with ".json" extension of the font definition file to be added. The file will be loaded from the font directory specified in the call to New() or SetFontLocation().
Example ¶
ExampleFpdf_AddUTF8Font demonstrates how use the font with utf-8 mode
package main import ( "io/ioutil" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { var fileStr string var txtStr []byte var err error pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() pdf.AddUTF8Font("dejavu", "", example.FontFile("DejaVuSansCondensed.ttf")) pdf.AddUTF8Font("dejavu", "B", example.FontFile("DejaVuSansCondensed-Bold.ttf")) pdf.AddUTF8Font("dejavu", "I", example.FontFile("DejaVuSansCondensed-Oblique.ttf")) pdf.AddUTF8Font("dejavu", "BI", example.FontFile("DejaVuSansCondensed-BoldOblique.ttf")) fileStr = example.Filename("Fpdf_AddUTF8Font") txtStr, err = ioutil.ReadFile(example.TextFile("utf-8test.txt")) if err == nil { pdf.SetFont("dejavu", "B", 17) pdf.MultiCell(100, 8, "Text in different languages :", "", "C", false) pdf.SetFont("dejavu", "", 14) pdf.MultiCell(100, 5, string(txtStr), "", "C", false) pdf.Ln(15) txtStr, err = ioutil.ReadFile(example.TextFile("utf-8test2.txt")) if err == nil { pdf.SetFont("dejavu", "BI", 17) pdf.MultiCell(100, 8, "Greek text with alignStr = \"J\":", "", "C", false) pdf.SetFont("dejavu", "I", 14) pdf.MultiCell(100, 5, string(txtStr), "", "J", false) err = pdf.OutputFileAndClose(fileStr) } } example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_AddUTF8Font.pdf
func (*Fpdf) AddUTF8FontFromBytes ¶ added in v1.4.3
AddUTF8FontFromBytes imports a TrueType font with utf-8 symbols from static bytes within the executable and makes it available for use in the generated document.
family specifies the font family. The name can be chosen arbitrarily. If it is a standard family name, it will override the corresponding font. This string is used to subsequently set the font with the SetFont method.
style specifies the font style. Acceptable values are (case insensitive) the empty string for regular style, "B" for bold, "I" for italic, or "BI" or "IB" for bold and italic combined.
jsonFileBytes contain all bytes of JSON file.
zFileBytes contain all bytes of Z file.
func (*Fpdf) AliasNbPages ¶
AliasNbPages defines an alias for the total number of pages. It will be substituted as the document is closed. An empty string is replaced with the string "{nb}".
See the example for AddPage() for a demonstration of this method.
func (*Fpdf) Arc ¶
Arc draws an elliptical arc centered at point (x, y). rx and ry specify its horizontal and vertical radii.
degRotate specifies the angle that the arc will be rotated. degStart and degEnd specify the starting and ending angle of the arc. All angles are specified in degrees and measured counter-clockwise from the 3 o'clock position.
styleStr can be "F" for filled, "D" for outlined only, or "DF" or "FD" for outlined and filled. An empty string will be replaced with "D". Drawing uses the current draw color, line width, and cap style centered on the arc's path. Filling uses the current fill color.
The Circle() example demonstrates this method.
func (*Fpdf) ArcTo ¶
ArcTo draws an elliptical arc centered at point (x, y). rx and ry specify its horizontal and vertical radii. If the start of the arc is not at the current position, a connecting line will be drawn.
degRotate specifies the angle that the arc will be rotated. degStart and degEnd specify the starting and ending angle of the arc. All angles are specified in degrees and measured counter-clockwise from the 3 o'clock position.
styleStr can be "F" for filled, "D" for outlined only, or "DF" or "FD" for outlined and filled. An empty string will be replaced with "D". Drawing uses the current draw color, line width, and cap style centered on the arc's path. Filling uses the current fill color.
The MoveTo() example demonstrates this method.
func (*Fpdf) BeginLayer ¶
BeginLayer is called to begin adding content to the specified layer. All content added to the page between a call to BeginLayer and a call to EndLayer is added to the layer specified by id. See AddLayer for more details.
func (*Fpdf) Beziergon ¶
Beziergon draws a closed figure defined by a series of cubic Bézier curve segments. The first point in the slice defines the starting point of the figure. Each three following points p1, p2, p3 represent a curve segment to the point p3 using p1 and p2 as the Bézier control points.
The x and y fields of the points use the units established in New().
styleStr can be "F" for filled, "D" for outlined only, or "DF" or "FD" for outlined and filled. An empty string will be replaced with "D". Drawing uses the current draw color and line width centered on the ellipse's perimeter. Filling uses the current fill color.
Example ¶
ExampleFpdf_Beziergon demonstrates the Beziergon function.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { const ( margin = 10 wd = 210 unit = (wd - 2*margin) / 6 ht = 297 fontSize = 15 msgStr = `Demonstration of Beziergon function` coefficient = 0.6 delta = coefficient * unit ln = fontSize * 25.4 / 72 offsetX = (wd - 4*unit) / 2.0 offsetY = offsetX + 2*ln ) srcList := []gofpdf.PointType{ {X: 0, Y: 0}, {X: 1, Y: 0}, {X: 1, Y: 1}, {X: 2, Y: 1}, {X: 2, Y: 2}, {X: 3, Y: 2}, {X: 3, Y: 3}, {X: 4, Y: 3}, {X: 4, Y: 4}, {X: 1, Y: 4}, {X: 1, Y: 3}, {X: 0, Y: 3}, } ctrlList := []gofpdf.PointType{ {X: 1, Y: -1}, {X: 1, Y: 1}, {X: 1, Y: 1}, {X: 1, Y: 1}, {X: 1, Y: 1}, {X: 1, Y: 1}, {X: 1, Y: 1}, {X: 1, Y: 1}, {X: -1, Y: 1}, {X: -1, Y: -1}, {X: -1, Y: -1}, {X: -1, Y: -1}, } pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() pdf.SetFont("Helvetica", "", fontSize) for j, src := range srcList { srcList[j].X = offsetX + src.X*unit srcList[j].Y = offsetY + src.Y*unit } for j, ctrl := range ctrlList { ctrlList[j].X = ctrl.X * delta ctrlList[j].Y = ctrl.Y * delta } jPrev := len(srcList) - 1 srcPrev := srcList[jPrev] curveList := []gofpdf.PointType{srcPrev} // point [, control 0, control 1, point]* control := func(x, y float64) { curveList = append(curveList, gofpdf.PointType{X: x, Y: y}) } for j, src := range srcList { ctrl := ctrlList[jPrev] control(srcPrev.X+ctrl.X, srcPrev.Y+ctrl.Y) // Control 0 ctrl = ctrlList[j] control(src.X-ctrl.X, src.Y-ctrl.Y) // Control 1 curveList = append(curveList, src) // Destination jPrev = j srcPrev = src } pdf.MultiCell(wd-margin-margin, ln, msgStr, "", "C", false) pdf.SetDashPattern([]float64{0.8, 0.8}, 0) pdf.SetDrawColor(160, 160, 160) pdf.Polygon(srcList, "D") pdf.SetDashPattern([]float64{}, 0) pdf.SetDrawColor(64, 64, 128) pdf.SetLineWidth(pdf.GetLineWidth() * 3) pdf.Beziergon(curveList, "D") fileStr := example.Filename("Fpdf_Beziergon") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_Beziergon.pdf
func (*Fpdf) Bookmark ¶
Bookmark sets a bookmark that will be displayed in a sidebar outline. txtStr is the title of the bookmark. level specifies the level of the bookmark in the outline; 0 is the top level, 1 is just below, and so on. y specifies the vertical position of the bookmark destination in the current page; -1 indicates the current position.
Example ¶
ExampleFpdf_Bookmark demonstrates the Bookmark method.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() pdf.SetFont("Arial", "", 15) pdf.Bookmark("Page 1", 0, 0) pdf.Bookmark("Paragraph 1", 1, -1) pdf.Cell(0, 6, "Paragraph 1") pdf.Ln(50) pdf.Bookmark("Paragraph 2", 1, -1) pdf.Cell(0, 6, "Paragraph 2") pdf.AddPage() pdf.Bookmark("Page 2", 0, 0) pdf.Bookmark("Paragraph 3", 1, -1) pdf.Cell(0, 6, "Paragraph 3") fileStr := example.Filename("Fpdf_Bookmark") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_Bookmark.pdf
func (*Fpdf) Cell ¶
Cell is a simpler version of CellFormat with no fill, border, links or special alignment. The Cell_strikeout() example demonstrates this method.
Example (Strikeout) ¶
ExampleFpdf_Cell_strikeout demonstrates striked-out text
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") // 210mm x 297mm pdf.AddPage() for fontSize := 4; fontSize < 40; fontSize += 10 { pdf.SetFont("Arial", "S", float64(fontSize)) pdf.SetXY(0, float64(fontSize)) pdf.Cell(40, 10, "Hello World") } fileStr := example.Filename("Fpdf_Cell_strikeout") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_Cell_strikeout.pdf
func (*Fpdf) CellFormat ¶
func (f *Fpdf) CellFormat(w, h float64, txtStr, borderStr string, ln int, alignStr string, fill bool, link int, linkStr string)
CellFormat prints a rectangular cell with optional borders, background color and character string. The upper-left corner of the cell corresponds to the current position. The text can be aligned or centered. After the call, the current position moves to the right or to the next line. It is possible to put a link on the text.
An error will be returned if a call to SetFont() has not already taken place before this method is called.
If automatic page breaking is enabled and the cell goes beyond the limit, a page break is done before outputting.
w and h specify the width and height of the cell. If w is 0, the cell extends up to the right margin. Specifying 0 for h will result in no output, but the current position will be advanced by w.
txtStr specifies the text to display.
borderStr specifies how the cell border will be drawn. An empty string indicates no border, "1" indicates a full border, and one or more of "L", "T", "R" and "B" indicate the left, top, right and bottom sides of the border.
ln indicates where the current position should go after the call. Possible values are 0 (to the right), 1 (to the beginning of the next line), and 2 (below). Putting 1 is equivalent to putting 0 and calling Ln() just after.
alignStr specifies how the text is to be positioned within the cell. Horizontal alignment is controlled by including "L", "C" or "R" (left, center, right) in alignStr. Vertical alignment is controlled by including "T", "M", "B" or "A" (top, middle, bottom, baseline) in alignStr. The default alignment is left middle.
fill is true to paint the cell background or false to leave it transparent.
link is the identifier returned by AddLink() or 0 for no internal link.
linkStr is a target URL or empty for no external link. A non--zero value for link takes precedence over linkStr.
Example (Align) ¶
ExampleFpdf_CellFormat_align demonstrates Stefan Schroeder's code to control vertical alignment.
package main import ( "bytes" "fmt" "io" "io/ioutil" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) type fontResourceType struct { } func (f fontResourceType) Open(name string) (rdr io.Reader, err error) { var buf []byte buf, err = ioutil.ReadFile(example.FontFile(name)) if err == nil { rdr = bytes.NewReader(buf) fmt.Printf("Generalized font loader reading %s\n", name) } return } func main() { type recType struct { align, txt string } recList := []recType{ {"TL", "top left"}, {"TC", "top center"}, {"TR", "top right"}, {"LM", "middle left"}, {"CM", "middle center"}, {"RM", "middle right"}, {"BL", "bottom left"}, {"BC", "bottom center"}, {"BR", "bottom right"}, } recListBaseline := []recType{ {"AL", "baseline left"}, {"AC", "baseline center"}, {"AR", "baseline right"}, } var formatRect = func(pdf *gofpdf.Fpdf, recList []recType) { linkStr := "" for pageJ := 0; pageJ < 2; pageJ++ { pdf.AddPage() pdf.SetMargins(10, 10, 10) pdf.SetAutoPageBreak(false, 0) borderStr := "1" for _, rec := range recList { pdf.SetXY(20, 20) pdf.CellFormat(170, 257, rec.txt, borderStr, 0, rec.align, false, 0, linkStr) borderStr = "" } linkStr = "https://bitbucket.org/thoomycz/gofpdf" } } pdf := gofpdf.New("P", "mm", "A4", "") // A4 210.0 x 297.0 pdf.SetFont("Helvetica", "", 16) formatRect(pdf, recList) formatRect(pdf, recListBaseline) var fr fontResourceType pdf.SetFontLoader(fr) pdf.AddFont("Calligrapher", "", "calligra.json") pdf.SetFont("Calligrapher", "", 16) formatRect(pdf, recListBaseline) fileStr := example.Filename("Fpdf_CellFormat_align") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Generalized font loader reading calligra.json Generalized font loader reading calligra.z Successfully generated pdf/Fpdf_CellFormat_align.pdf
Example (Codepage) ¶
ExampleFpdf_CellFormat_codepage demonstrates the automatic conversion of UTF-8 strings to an 8-bit font encoding.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", example.FontDir()) // A4 210.0 x 297.0 // See documentation for details on how to generate fonts pdf.AddFont("Helvetica-1251", "", "helvetica_1251.json") pdf.AddFont("Helvetica-1253", "", "helvetica_1253.json") fontSize := 16.0 pdf.SetFont("Helvetica", "", fontSize) ht := pdf.PointConvert(fontSize) tr := pdf.UnicodeTranslatorFromDescriptor("") // "" defaults to "cp1252" write := func(str string) { // pdf.CellFormat(190, ht, tr(str), "", 1, "C", false, 0, "") pdf.MultiCell(190, ht, tr(str), "", "C", false) pdf.Ln(ht) } pdf.AddPage() str := `Gofpdf provides a translator that will convert any UTF-8 code point ` + `that is present in the specified code page.` pdf.MultiCell(190, ht, str, "", "L", false) pdf.Ln(2 * ht) write("Voix ambiguë d'un cœur qui au zéphyr préfère les jattes de kiwi.") write("Falsches Üben von Xylophonmusik quält jeden größeren Zwerg.") write("Heizölrückstoßabdämpfung") write("Forårsjævndøgn / Efterårsjævndøgn") write("À noite, vovô Kowalsky vê o ímã cair no pé do pingüim queixoso e vovó" + "põe açúcar no chá de tâmaras do jabuti feliz.") pdf.SetFont("Helvetica-1251", "", fontSize) // Name matches one specified in AddFont() tr = pdf.UnicodeTranslatorFromDescriptor("cp1251") write("Съешь же ещё этих мягких французских булок, да выпей чаю.") pdf.SetFont("Helvetica-1253", "", fontSize) tr = pdf.UnicodeTranslatorFromDescriptor("cp1253") write("Θέλει αρετή και τόλμη η ελευθερία. (Ανδρέας Κάλβος)") fileStr := example.Filename("Fpdf_CellFormat_codepage") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_CellFormat_codepage.pdf
Example (Codepageescape) ¶
ExampleFpdf_CellFormat_codepageescape demonstrates the use of characters in the high range of the Windows-1252 code page (gofdpf default). See the example for CellFormat (4) for a way to do this automatically.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") // A4 210.0 x 297.0 fontSize := 16.0 pdf.SetFont("Helvetica", "", fontSize) ht := pdf.PointConvert(fontSize) write := func(str string) { pdf.CellFormat(190, ht, str, "", 1, "C", false, 0, "") pdf.Ln(ht) } pdf.AddPage() htmlStr := `Until gofpdf supports UTF-8 encoded source text, source text needs ` + `to be specified with all special characters escaped to match the code page ` + `layout of the currently selected font. By default, gofdpf uses code page 1252.` + ` See <a href="http://en.wikipedia.org/wiki/Windows-1252">Wikipedia</a> for ` + `a table of this layout.` html := pdf.HTMLBasicNew() html.Write(ht, htmlStr) pdf.Ln(2 * ht) write("Voix ambigu\xeb d'un c\x9cur qui au z\xe9phyr pr\xe9f\xe8re les jattes de kiwi.") write("Falsches \xdcben von Xylophonmusik qu\xe4lt jeden gr\xf6\xdferen Zwerg.") write("Heiz\xf6lr\xfccksto\xdfabd\xe4mpfung") write("For\xe5rsj\xe6vnd\xf8gn / Efter\xe5rsj\xe6vnd\xf8gn") fileStr := example.Filename("Fpdf_CellFormat_codepageescape") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_CellFormat_codepageescape.pdf
Example (Tables) ¶
ExampleFpdf_CellFormat_tables demonstrates various table styles.
package main import ( "bufio" "fmt" "os" "strings" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) // strDelimit converts 'ABCDEFG' to, for example, 'A,BCD,EFG' func strDelimit(str string, sepstr string, sepcount int) string { pos := len(str) - sepcount for pos > 0 { str = str[:pos] + sepstr + str[pos:] pos = pos - sepcount } return str } func main() { pdf := gofpdf.New("P", "mm", "A4", "") type countryType struct { nameStr, capitalStr, areaStr, popStr string } countryList := make([]countryType, 0, 8) header := []string{"Country", "Capital", "Area (sq km)", "Pop. (thousands)"} loadData := func(fileStr string) { fl, err := os.Open(fileStr) if err == nil { scanner := bufio.NewScanner(fl) var c countryType for scanner.Scan() { // Austria;Vienna;83859;8075 lineStr := scanner.Text() list := strings.Split(lineStr, ";") if len(list) == 4 { c.nameStr = list[0] c.capitalStr = list[1] c.areaStr = list[2] c.popStr = list[3] countryList = append(countryList, c) } else { err = fmt.Errorf("error tokenizing %s", lineStr) } } fl.Close() if len(countryList) == 0 { err = fmt.Errorf("error loading data from %s", fileStr) } } if err != nil { pdf.SetError(err) } } // Simple table basicTable := func() { left := (210.0 - 4*40) / 2 pdf.SetX(left) for _, str := range header { pdf.CellFormat(40, 7, str, "1", 0, "", false, 0, "") } pdf.Ln(-1) for _, c := range countryList { pdf.SetX(left) pdf.CellFormat(40, 6, c.nameStr, "1", 0, "", false, 0, "") pdf.CellFormat(40, 6, c.capitalStr, "1", 0, "", false, 0, "") pdf.CellFormat(40, 6, c.areaStr, "1", 0, "", false, 0, "") pdf.CellFormat(40, 6, c.popStr, "1", 0, "", false, 0, "") pdf.Ln(-1) } } // Better table improvedTable := func() { // Column widths w := []float64{40.0, 35.0, 40.0, 45.0} wSum := 0.0 for _, v := range w { wSum += v } left := (210 - wSum) / 2 // Header pdf.SetX(left) for j, str := range header { pdf.CellFormat(w[j], 7, str, "1", 0, "C", false, 0, "") } pdf.Ln(-1) // Data for _, c := range countryList { pdf.SetX(left) pdf.CellFormat(w[0], 6, c.nameStr, "LR", 0, "", false, 0, "") pdf.CellFormat(w[1], 6, c.capitalStr, "LR", 0, "", false, 0, "") pdf.CellFormat(w[2], 6, strDelimit(c.areaStr, ",", 3), "LR", 0, "R", false, 0, "") pdf.CellFormat(w[3], 6, strDelimit(c.popStr, ",", 3), "LR", 0, "R", false, 0, "") pdf.Ln(-1) } pdf.SetX(left) pdf.CellFormat(wSum, 0, "", "T", 0, "", false, 0, "") } // Colored table fancyTable := func() { // Colors, line width and bold font pdf.SetFillColor(255, 0, 0) pdf.SetTextColor(255, 255, 255) pdf.SetDrawColor(128, 0, 0) pdf.SetLineWidth(.3) pdf.SetFont("", "B", 0) // Header w := []float64{40, 35, 40, 45} wSum := 0.0 for _, v := range w { wSum += v } left := (210 - wSum) / 2 pdf.SetX(left) for j, str := range header { pdf.CellFormat(w[j], 7, str, "1", 0, "C", true, 0, "") } pdf.Ln(-1) // Color and font restoration pdf.SetFillColor(224, 235, 255) pdf.SetTextColor(0, 0, 0) pdf.SetFont("", "", 0) // Data fill := false for _, c := range countryList { pdf.SetX(left) pdf.CellFormat(w[0], 6, c.nameStr, "LR", 0, "", fill, 0, "") pdf.CellFormat(w[1], 6, c.capitalStr, "LR", 0, "", fill, 0, "") pdf.CellFormat(w[2], 6, strDelimit(c.areaStr, ",", 3), "LR", 0, "R", fill, 0, "") pdf.CellFormat(w[3], 6, strDelimit(c.popStr, ",", 3), "LR", 0, "R", fill, 0, "") pdf.Ln(-1) fill = !fill } pdf.SetX(left) pdf.CellFormat(wSum, 0, "", "T", 0, "", false, 0, "") } loadData(example.TextFile("countries.txt")) pdf.SetFont("Arial", "", 14) pdf.AddPage() basicTable() pdf.AddPage() improvedTable() pdf.AddPage() fancyTable() fileStr := example.Filename("Fpdf_CellFormat_tables") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_CellFormat_tables.pdf
func (*Fpdf) Cellf ¶
Cellf is a simpler printf-style version of CellFormat with no fill, border, links or special alignment. See documentation for the fmt package for details on fmtStr and args.
func (*Fpdf) Circle ¶
Circle draws a circle centered on point (x, y) with radius r.
styleStr can be "F" for filled, "D" for outlined only, or "DF" or "FD" for outlined and filled. An empty string will be replaced with "D". Drawing uses the current draw color and line width centered on the circle's perimeter. Filling uses the current fill color.
Example ¶
ExampleFpdf_Circle demonstrates the construction of various geometric figures,
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { const ( thin = 0.2 thick = 3.0 ) pdf := gofpdf.New("", "", "", "") pdf.SetFont("Helvetica", "", 12) pdf.SetFillColor(200, 200, 220) pdf.AddPage() y := 15.0 pdf.Text(10, y, "Circles") pdf.SetFillColor(200, 200, 220) pdf.SetLineWidth(thin) pdf.Circle(20, y+15, 10, "D") pdf.Circle(45, y+15, 10, "F") pdf.Circle(70, y+15, 10, "FD") pdf.SetLineWidth(thick) pdf.Circle(95, y+15, 10, "FD") pdf.SetLineWidth(thin) y += 40.0 pdf.Text(10, y, "Ellipses") pdf.SetFillColor(220, 200, 200) pdf.Ellipse(30, y+15, 20, 10, 0, "D") pdf.Ellipse(75, y+15, 20, 10, 0, "F") pdf.Ellipse(120, y+15, 20, 10, 0, "FD") pdf.SetLineWidth(thick) pdf.Ellipse(165, y+15, 20, 10, 0, "FD") pdf.SetLineWidth(thin) y += 40.0 pdf.Text(10, y, "Curves (quadratic)") pdf.SetFillColor(220, 220, 200) pdf.Curve(10, y+30, 15, y-20, 40, y+30, "D") pdf.Curve(45, y+30, 50, y-20, 75, y+30, "F") pdf.Curve(80, y+30, 85, y-20, 110, y+30, "FD") pdf.SetLineWidth(thick) pdf.Curve(115, y+30, 120, y-20, 145, y+30, "FD") pdf.SetLineCapStyle("round") pdf.Curve(150, y+30, 155, y-20, 180, y+30, "FD") pdf.SetLineWidth(thin) pdf.SetLineCapStyle("butt") y += 40.0 pdf.Text(10, y, "Curves (cubic)") pdf.SetFillColor(220, 200, 220) pdf.CurveBezierCubic(10, y+30, 15, y-20, 10, y+30, 40, y+30, "D") pdf.CurveBezierCubic(45, y+30, 50, y-20, 45, y+30, 75, y+30, "F") pdf.CurveBezierCubic(80, y+30, 85, y-20, 80, y+30, 110, y+30, "FD") pdf.SetLineWidth(thick) pdf.CurveBezierCubic(115, y+30, 120, y-20, 115, y+30, 145, y+30, "FD") pdf.SetLineCapStyle("round") pdf.CurveBezierCubic(150, y+30, 155, y-20, 150, y+30, 180, y+30, "FD") pdf.SetLineWidth(thin) pdf.SetLineCapStyle("butt") y += 40.0 pdf.Text(10, y, "Arcs") pdf.SetFillColor(200, 220, 220) pdf.SetLineWidth(thick) pdf.Arc(45, y+35, 20, 10, 0, 0, 180, "FD") pdf.SetLineWidth(thin) pdf.Arc(45, y+35, 25, 15, 0, 90, 270, "D") pdf.SetLineWidth(thick) pdf.Arc(45, y+35, 30, 20, 0, 0, 360, "D") pdf.SetLineCapStyle("round") pdf.Arc(135, y+35, 20, 10, 135, 0, 180, "FD") pdf.SetLineWidth(thin) pdf.Arc(135, y+35, 25, 15, 135, 90, 270, "D") pdf.SetLineWidth(thick) pdf.Arc(135, y+35, 30, 20, 135, 0, 360, "D") pdf.SetLineWidth(thin) pdf.SetLineCapStyle("butt") fileStr := example.Filename("Fpdf_Circle_figures") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_Circle_figures.pdf
func (*Fpdf) ClearError ¶
func (f *Fpdf) ClearError()
ClearError unsets the internal Fpdf error. This method should be used with care, as an internal error condition usually indicates an unrecoverable problem with the generation of a document. It is intended to deal with cases in which an error is used to select an alternate form of the document.
func (*Fpdf) ClipCircle ¶
ClipCircle begins a circular clipping operation. The circle is centered at (x, y) and has radius r. outline is true to draw a border with the current draw color and line width centered on the circle's perimeter. Only the outer half of the border will be shown. After calling this method, all rendering operations (for example, Image(), LinearGradient(), etc) will be clipped by the specified circle. Call ClipEnd() to restore unclipped operations.
The ClipText() example demonstrates this method.
func (*Fpdf) ClipEllipse ¶
ClipEllipse begins an elliptical clipping operation. The ellipse is centered at (x, y). Its horizontal and vertical radii are specified by rx and ry. outline is true to draw a border with the current draw color and line width centered on the ellipse's perimeter. Only the outer half of the border will be shown. After calling this method, all rendering operations (for example, Image(), LinearGradient(), etc) will be clipped by the specified ellipse. Call ClipEnd() to restore unclipped operations.
This ClipText() example demonstrates this method.
func (*Fpdf) ClipEnd ¶
func (f *Fpdf) ClipEnd()
ClipEnd ends a clipping operation that was started with a call to ClipRect(), ClipRoundedRect(), ClipText(), ClipEllipse(), ClipCircle() or ClipPolygon(). Clipping operations can be nested. The document cannot be successfully output while a clipping operation is active.
The ClipText() example demonstrates this method.
func (*Fpdf) ClipPolygon ¶
ClipPolygon begins a clipping operation within a polygon. The figure is defined by a series of vertices specified by points. The x and y fields of the points use the units established in New(). The last point in the slice will be implicitly joined to the first to close the polygon. outline is true to draw a border with the current draw color and line width centered on the polygon's perimeter. Only the outer half of the border will be shown. After calling this method, all rendering operations (for example, Image(), LinearGradient(), etc) will be clipped by the specified polygon. Call ClipEnd() to restore unclipped operations.
The ClipText() example demonstrates this method.
func (*Fpdf) ClipRect ¶
ClipRect begins a rectangular clipping operation. The rectangle is of width w and height h. Its upper left corner is positioned at point (x, y). outline is true to draw a border with the current draw color and line width centered on the rectangle's perimeter. Only the outer half of the border will be shown. After calling this method, all rendering operations (for example, Image(), LinearGradient(), etc) will be clipped by the specified rectangle. Call ClipEnd() to restore unclipped operations.
This ClipText() example demonstrates this method.
Example ¶
This example demonstrate Clipped table cells
package main import ( "fmt" "strings" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { marginCell := 2. // margin of top/bottom of cell pdf := gofpdf.New("P", "mm", "A4", "") pdf.SetFont("Arial", "", 12) pdf.AddPage() pagew, pageh := pdf.GetPageSize() mleft, mright, _, mbottom := pdf.GetMargins() cols := []float64{60, 100, pagew - mleft - mright - 100 - 60} rows := [][]string{} for i := 1; i <= 50; i++ { word := fmt.Sprintf("%d:%s", i, strings.Repeat("A", i%100)) rows = append(rows, []string{word, word, word}) } for _, row := range rows { _, lineHt := pdf.GetFontSize() height := lineHt + marginCell x, y := pdf.GetXY() // add a new page if the height of the row doesn't fit on the page if y+height >= pageh-mbottom { pdf.AddPage() x, y = pdf.GetXY() } for i, txt := range row { width := cols[i] pdf.Rect(x, y, width, height, "") pdf.ClipRect(x, y, width, height, false) pdf.Cell(width, height, txt) pdf.ClipEnd() x += width } pdf.Ln(-1) } fileStr := example.Filename("Fpdf_ClippedTableCells") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_ClippedTableCells.pdf
func (*Fpdf) ClipRoundedRect ¶
ClipRoundedRect begins a rectangular clipping operation. The rectangle is of width w and height h. Its upper left corner is positioned at point (x, y). The rounded corners of the rectangle are specified by radius r. outline is true to draw a border with the current draw color and line width centered on the rectangle's perimeter. Only the outer half of the border will be shown. After calling this method, all rendering operations (for example, Image(), LinearGradient(), etc) will be clipped by the specified rectangle. Call ClipEnd() to restore unclipped operations.
This ClipText() example demonstrates this method.
func (*Fpdf) ClipRoundedRectExt ¶ added in v1.4.3
ClipRoundedRectExt behaves the same as ClipRoundedRect() but supports a different radius for each corner, given by rTL (top-left), rTR (top-right) rBR (bottom-right), rBL (bottom-left). See ClipRoundedRect() for more details. This method is demonstrated in the ClipText() example.
func (*Fpdf) ClipText ¶
ClipText begins a clipping operation in which rendering is confined to the character string specified by txtStr. The origin (x, y) is on the left of the first character at the baseline. The current font is used. outline is true to draw a border with the current draw color and line width centered on the perimeters of the text characters. Only the outer half of the border will be shown. After calling this method, all rendering operations (for example, Image(), LinearGradient(), etc) will be clipped. Call ClipEnd() to restore unclipped operations.
Example ¶
ExampleFpdf_ClipText demonstrates clipping.
package main import ( "strings" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func loremList() []string { return []string{ "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod " + "tempor incididunt ut labore et dolore magna aliqua.", "Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut " + "aliquip ex ea commodo consequat.", "Duis aute irure dolor in reprehenderit in voluptate velit esse cillum " + "dolore eu fugiat nulla pariatur.", "Excepteur sint occaecat cupidatat non proident, sunt in culpa qui " + "officia deserunt mollit anim id est laborum.", } } func lorem() string { return strings.Join(loremList(), " ") } func main() { pdf := gofpdf.New("", "", "", "") y := 10.0 pdf.AddPage() pdf.SetFont("Helvetica", "", 24) pdf.SetXY(0, y) pdf.ClipText(10, y+12, "Clipping examples", false) pdf.RadialGradient(10, y, 100, 20, 128, 128, 160, 32, 32, 48, 0.25, 0.5, 0.25, 0.5, 0.2) pdf.ClipEnd() y += 12 pdf.SetFont("Helvetica", "B", 120) pdf.SetDrawColor(64, 80, 80) pdf.SetLineWidth(.5) pdf.ClipText(10, y+40, pdf.String(), true) pdf.RadialGradient(10, y, 200, 50, 220, 220, 250, 80, 80, 220, 0.25, 0.5, 0.25, 0.5, 1) pdf.ClipEnd() y += 55 pdf.ClipRect(10, y, 105, 20, true) pdf.SetFillColor(255, 255, 255) pdf.Rect(10, y, 105, 20, "F") pdf.ClipCircle(40, y+10, 15, false) pdf.RadialGradient(25, y, 30, 30, 220, 250, 220, 40, 60, 40, 0.3, 0.85, 0.3, 0.85, 0.5) pdf.ClipEnd() pdf.ClipEllipse(80, y+10, 20, 15, false) pdf.RadialGradient(60, y, 40, 30, 250, 220, 220, 60, 40, 40, 0.3, 0.85, 0.3, 0.85, 0.5) pdf.ClipEnd() pdf.ClipEnd() y += 28 pdf.ClipEllipse(26, y+10, 16, 10, true) pdf.Image(example.ImageFile("logo.jpg"), 10, y, 32, 0, false, "JPG", 0, "") pdf.ClipEnd() pdf.ClipCircle(60, y+10, 10, true) pdf.RadialGradient(50, y, 20, 20, 220, 220, 250, 40, 40, 60, 0.3, 0.7, 0.3, 0.7, 0.5) pdf.ClipEnd() pdf.ClipPolygon([]gofpdf.PointType{{X: 80, Y: y + 20}, {X: 90, Y: y}, {X: 100, Y: y + 20}}, true) pdf.LinearGradient(80, y, 20, 20, 250, 220, 250, 60, 40, 60, 0.5, 1, 0.5, 0.5) pdf.ClipEnd() y += 30 pdf.SetLineWidth(.1) pdf.SetDrawColor(180, 180, 180) pdf.ClipRoundedRect(10, y, 120, 20, 5, true) pdf.RadialGradient(10, y, 120, 20, 255, 255, 255, 240, 240, 220, 0.25, 0.75, 0.25, 0.75, 0.5) pdf.SetXY(5, y-5) pdf.SetFont("Times", "", 12) pdf.MultiCell(130, 5, lorem(), "", "", false) pdf.ClipEnd() y += 30 pdf.SetDrawColor(180, 100, 180) pdf.ClipRoundedRectExt(10, y, 120, 20, 5, 10, 5, 10, true) pdf.RadialGradient(10, y, 120, 20, 255, 255, 255, 240, 240, 220, 0.25, 0.75, 0.25, 0.75, 0.5) pdf.SetXY(5, y-5) pdf.SetFont("Times", "", 12) pdf.MultiCell(130, 5, lorem(), "", "", false) pdf.ClipEnd() fileStr := example.Filename("Fpdf_ClipText") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_ClipText.pdf
func (*Fpdf) Close ¶
func (f *Fpdf) Close()
Close terminates the PDF document. It is not necessary to call this method explicitly because Output(), OutputAndClose() and OutputFileAndClose() do it automatically. If the document contains no page, AddPage() is called to prevent the generation of an invalid document.
func (*Fpdf) ClosePath ¶
func (f *Fpdf) ClosePath()
ClosePath creates a line from the current location to the last MoveTo point (if not the same) and mark the path as closed so the first and last lines join nicely.
The MoveTo() example demonstrates this method.
func (*Fpdf) CreateTemplate ¶
CreateTemplate defines a new template using the current page size.
Example ¶
ExampleFpdf_CreateTemplate demonstrates creating and using templates
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.SetCompression(false) // pdf.SetFont("Times", "", 12) template := pdf.CreateTemplate(func(tpl *gofpdf.Tpl) { tpl.Image(example.ImageFile("logo.png"), 6, 6, 30, 0, false, "", 0, "") tpl.SetFont("Arial", "B", 16) tpl.Text(40, 20, "Template says hello") tpl.SetDrawColor(0, 100, 200) tpl.SetLineWidth(2.5) tpl.Line(95, 12, 105, 22) }) _, tplSize := template.Size() // fmt.Println("Size:", tplSize) // fmt.Println("Scaled:", tplSize.ScaleBy(1.5)) template2 := pdf.CreateTemplate(func(tpl *gofpdf.Tpl) { tpl.UseTemplate(template) subtemplate := tpl.CreateTemplate(func(tpl2 *gofpdf.Tpl) { tpl2.Image(example.ImageFile("logo.png"), 6, 86, 30, 0, false, "", 0, "") tpl2.SetFont("Arial", "B", 16) tpl2.Text(40, 100, "Subtemplate says hello") tpl2.SetDrawColor(0, 200, 100) tpl2.SetLineWidth(2.5) tpl2.Line(102, 92, 112, 102) }) tpl.UseTemplate(subtemplate) }) pdf.SetDrawColor(200, 100, 0) pdf.SetLineWidth(2.5) pdf.SetFont("Arial", "B", 16) // serialize and deserialize template b, _ := template2.Serialize() template3, _ := gofpdf.DeserializeTemplate(b) pdf.AddPage() pdf.UseTemplate(template3) pdf.UseTemplateScaled(template3, gofpdf.PointType{X: 0, Y: 30}, tplSize) pdf.Line(40, 210, 60, 210) pdf.Text(40, 200, "Template example page 1") pdf.AddPage() pdf.UseTemplate(template2) pdf.UseTemplateScaled(template3, gofpdf.PointType{X: 0, Y: 30}, tplSize.ScaleBy(1.4)) pdf.Line(60, 210, 80, 210) pdf.Text(40, 200, "Template example page 2") fileStr := example.Filename("Fpdf_CreateTemplate") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_CreateTemplate.pdf
func (*Fpdf) CreateTemplateCustom ¶
CreateTemplateCustom starts a template, using the given bounds.
func (*Fpdf) Curve ¶
Curve draws a single-segment quadratic Bézier curve. The curve starts at the point (x0, y0) and ends at the point (x1, y1). The control point (cx, cy) specifies the curvature. At the start point, the curve is tangent to the straight line between the start point and the control point. At the end point, the curve is tangent to the straight line between the end point and the control point.
styleStr can be "F" for filled, "D" for outlined only, or "DF" or "FD" for outlined and filled. An empty string will be replaced with "D". Drawing uses the current draw color, line width, and cap style centered on the curve's path. Filling uses the current fill color.
The Circle() example demonstrates this method.
func (*Fpdf) CurveBezierCubic ¶
CurveBezierCubic draws a single-segment cubic Bézier curve. The curve starts at the point (x0, y0) and ends at the point (x1, y1). The control points (cx0, cy0) and (cx1, cy1) specify the curvature. At the start point, the curve is tangent to the straight line between the start point and the control point (cx0, cy0). At the end point, the curve is tangent to the straight line between the end point and the control point (cx1, cy1).
styleStr can be "F" for filled, "D" for outlined only, or "DF" or "FD" for outlined and filled. An empty string will be replaced with "D". Drawing uses the current draw color, line width, and cap style centered on the curve's path. Filling uses the current fill color.
This routine performs the same function as CurveCubic() but uses standard argument order.
The Circle() example demonstrates this method.
func (*Fpdf) CurveBezierCubicTo ¶
CurveBezierCubicTo creates a single-segment cubic Bézier curve. The curve starts at the current stylus location and ends at the point (x, y). The control points (cx0, cy0) and (cx1, cy1) specify the curvature. At the current stylus, the curve is tangent to the straight line between the current stylus location and the control point (cx0, cy0). At the end point, the curve is tangent to the straight line between the end point and the control point (cx1, cy1).
The MoveTo() example demonstrates this method.
func (*Fpdf) CurveCubic ¶
CurveCubic draws a single-segment cubic Bézier curve. This routine performs the same function as CurveBezierCubic() but has a nonstandard argument order. It is retained to preserve backward compatibility.
func (*Fpdf) CurveTo ¶
CurveTo creates a single-segment quadratic Bézier curve. The curve starts at the current stylus location and ends at the point (x, y). The control point (cx, cy) specifies the curvature. At the start point, the curve is tangent to the straight line between the current stylus location and the control point. At the end point, the curve is tangent to the straight line between the end point and the control point.
The MoveTo() example demonstrates this method.
func (*Fpdf) DrawPath ¶
DrawPath actually draws the path on the page.
styleStr can be "F" for filled, "D" for outlined only, or "DF" or "FD" for outlined and filled. An empty string will be replaced with "D". Path-painting operators as defined in the PDF specification are also allowed: "S" (Stroke the path), "s" (Close and stroke the path), "f" (fill the path, using the nonzero winding number), "f*" (Fill the path, using the even-odd rule), "B" (Fill and then stroke the path, using the nonzero winding number rule), "B*" (Fill and then stroke the path, using the even-odd rule), "b" (Close, fill, and then stroke the path, using the nonzero winding number rule) and "b*" (Close, fill, and then stroke the path, using the even-odd rule). Drawing uses the current draw color, line width, and cap style centered on the path. Filling uses the current fill color.
The MoveTo() example demonstrates this method.
Example ¶
ExampleFpdf_DrawPath demonstrates various fill modes.
package main import ( "math" "strconv" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.SetDrawColor(0xff, 0x00, 0x00) pdf.SetFillColor(0x99, 0x99, 0x99) pdf.SetFont("Helvetica", "", 15) pdf.AddPage() pdf.SetAlpha(1, "Multiply") var ( polygon = func(cx, cy, r, n, dir float64) { da := 2 * math.Pi / n pdf.MoveTo(cx+r, cy) pdf.Text(cx+r, cy, "0") i := 1 for a := da; a < 2*math.Pi; a += da { x, y := cx+r*math.Cos(dir*a), cy+r*math.Sin(dir*a) pdf.LineTo(x, y) pdf.Text(x, y, strconv.Itoa(i)) i++ } pdf.ClosePath() } polygons = func(cx, cy, r, n, dir float64) { d := 1.0 for rf := r; rf > 0; rf -= 10 { polygon(cx, cy, rf, n, d) d *= dir } } star = func(cx, cy, r, n float64) { da := 4 * math.Pi / n pdf.MoveTo(cx+r, cy) for a := da; a < 4*math.Pi+da; a += da { x, y := cx+r*math.Cos(a), cy+r*math.Sin(a) pdf.LineTo(x, y) } pdf.ClosePath() } ) // triangle polygons(55, 45, 40, 3, 1) pdf.DrawPath("B") pdf.Text(15, 95, "B (same direction, non zero winding)") // square polygons(155, 45, 40, 4, 1) pdf.DrawPath("B*") pdf.Text(115, 95, "B* (same direction, even odd)") // pentagon polygons(55, 145, 40, 5, -1) pdf.DrawPath("B") pdf.Text(15, 195, "B (different direction, non zero winding)") // hexagon polygons(155, 145, 40, 6, -1) pdf.DrawPath("B*") pdf.Text(115, 195, "B* (different direction, even odd)") // star star(55, 245, 40, 5) pdf.DrawPath("B") pdf.Text(15, 290, "B (non zero winding)") // star star(155, 245, 40, 5) pdf.DrawPath("B*") pdf.Text(115, 290, "B* (even odd)") fileStr := example.Filename("Fpdf_DrawPath_fill") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_DrawPath_fill.pdf
func (*Fpdf) Ellipse ¶
Ellipse draws an ellipse centered at point (x, y). rx and ry specify its horizontal and vertical radii.
degRotate specifies the counter-clockwise angle in degrees that the ellipse will be rotated.
styleStr can be "F" for filled, "D" for outlined only, or "DF" or "FD" for outlined and filled. An empty string will be replaced with "D". Drawing uses the current draw color and line width centered on the ellipse's perimeter. Filling uses the current fill color.
The Circle() example demonstrates this method.
func (*Fpdf) EndLayer ¶
func (f *Fpdf) EndLayer()
EndLayer is called to stop adding content to the currently active layer. See BeginLayer for more details.
func (*Fpdf) Error ¶
Error returns the internal Fpdf error; this will be nil if no error has occurred.
func (*Fpdf) GetAlpha ¶
GetAlpha returns the alpha blending channel, which consists of the alpha transparency value and the blend mode. See SetAlpha for more details.
func (*Fpdf) GetAutoPageBreak ¶ added in v1.4.3
GetAutoPageBreak returns true if automatic pages breaks are enabled, false otherwise. This is followed by the triggering limit from the bottom of the page. This value applies only if automatic page breaks are enabled.
func (*Fpdf) GetCellMargin ¶
GetCellMargin returns the cell margin. This is the amount of space before and after the text within a cell that's left blank, and is in units passed to New(). It defaults to 1mm.
func (*Fpdf) GetConversionRatio ¶
GetConversionRatio returns the conversion ratio based on the unit given when creating the PDF.
func (*Fpdf) GetDrawColor ¶
GetDrawColor returns the most recently set draw color as RGB components (0 - 255). This will not be the current value if a draw color of some other type (for example, spot) has been more recently set.
func (*Fpdf) GetDrawSpotColor ¶ added in v1.4.3
GetDrawSpotColor returns the most recently used spot color information for drawing. This will not be the current drawing color if some other color type such as RGB is active. If no spot color has been set for drawing, zero values are returned.
func (*Fpdf) GetFillColor ¶
GetFillColor returns the most recently set fill color as RGB components (0 - 255). This will not be the current value if a fill color of some other type (for example, spot) has been more recently set.
func (*Fpdf) GetFillSpotColor ¶ added in v1.4.3
GetFillSpotColor returns the most recently used spot color information for fill output. This will not be the current fill color if some other color type such as RGB is active. If no fill spot color has been set, zero values are returned.
func (*Fpdf) GetFontDesc ¶
func (f *Fpdf) GetFontDesc(familyStr, styleStr string) FontDescType
GetFontDesc returns the font descriptor, which can be used for example to find the baseline of a font. If familyStr is empty current font descriptor will be returned. See FontDescType for documentation about the font descriptor. See AddFont for details about familyStr and styleStr.
func (*Fpdf) GetFontSize ¶
GetFontSize returns the size of the current font in points followed by the size in the unit of measure specified in New(). The second value can be used as a line height value in drawing operations.
func (*Fpdf) GetImageInfo ¶
func (f *Fpdf) GetImageInfo(imageStr string) (info *ImageInfoType)
GetImageInfo returns information about the registered image specified by imageStr. If the image has not been registered, nil is returned. The internal error is not modified by this method.
func (*Fpdf) GetLineWidth ¶
GetLineWidth returns the current line thickness.
func (*Fpdf) GetMargins ¶
GetMargins returns the left, top, right, and bottom margins. The first three are set with the SetMargins() method. The bottom margin is set with the SetAutoPageBreak() method.
func (*Fpdf) GetPageSize ¶
GetPageSize returns the current page's width and height. This is the paper's size. To compute the size of the area being used, subtract the margins (see GetMargins()).
func (*Fpdf) GetPageSizeStr ¶ added in v1.4.3
GetPageSizeStr returns the SizeType for the given sizeStr (that is A4, A3, etc..)
func (*Fpdf) GetStringSymbolWidth ¶ added in v1.4.3
GetStringSymbolWidth returns the length of a string in glyf units. A font must be currently selected.
func (*Fpdf) GetStringWidth ¶
GetStringWidth returns the length of a string in user units. A font must be currently selected.
Example ¶
package main import ( "bytes" "fmt" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func hexStr(s string) string { var b bytes.Buffer b.WriteString("\"") for _, ch := range []byte(s) { b.WriteString(fmt.Sprintf("\\x%02x", ch)) } b.WriteString("\":") return b.String() } func main() { pdf := gofpdf.New("", "", "", example.FontDir()) pdf.SetFont("Helvetica", "", 12) pdf.AddPage() for _, s := range []string{"Hello", "世界", "\xe7a va?"} { fmt.Printf("%-32s width %5.2f, bytes %2d, runes %2d\n", hexStr(s), pdf.GetStringWidth(s), len(s), len([]rune(s))) if pdf.Err() { fmt.Println(pdf.Error()) } } pdf.Close() }
Output: "\x48\x65\x6c\x6c\x6f": width 9.64, bytes 5, runes 5 "\xe4\xb8\x96\xe7\x95\x8c": width 13.95, bytes 6, runes 2 "\xe7\x61\x20\x76\x61\x3f": width 12.47, bytes 6, runes 6
func (*Fpdf) GetTextColor ¶
GetTextColor returns the most recently set text color as RGB components (0 - 255). This will not be the current value if a text color of some other type (for example, spot) has been more recently set.
func (*Fpdf) GetTextSpotColor ¶ added in v1.4.3
GetTextSpotColor returns the most recently used spot color information for text output. This will not be the current text color if some other color type such as RGB is active. If no spot color has been set for text, zero values are returned.
func (*Fpdf) GetX ¶
GetX returns the abscissa of the current position.
Note: the value returned will be affected by the current cell margin. To account for this, you may need to either add the value returned by GetCellMargin() to it or call SetCellMargin(0) to remove the cell margin.
func (*Fpdf) GetXY ¶
GetXY returns the abscissa and ordinate of the current position.
Note: the value returned for the abscissa will be affected by the current cell margin. To account for this, you may need to either add the value returned by GetCellMargin() to it or call SetCellMargin(0) to remove the cell margin.
func (*Fpdf) HTMLBasicNew ¶
func (f *Fpdf) HTMLBasicNew() (html HTMLBasicType)
HTMLBasicNew returns an instance that facilitates writing basic HTML in the specified PDF file.
Example ¶
ExampleFpdf_HTMLBasicNew demonstrates internal and external links with and without basic HTML.
package main import ( "os" "path/filepath" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func init() { cleanup() } func cleanup() { filepath.Walk(example.PdfDir(), func(path string, info os.FileInfo, err error) (reterr error) { if info.Mode().IsRegular() { dir, _ := filepath.Split(path) if "reference" != filepath.Base(dir) { if len(path) > 3 { if path[len(path)-4:] == ".pdf" { os.Remove(path) } } } } return }) } func main() { pdf := gofpdf.New("P", "mm", "A4", "") // First page: manual local link pdf.AddPage() pdf.SetFont("Helvetica", "", 20) _, lineHt := pdf.GetFontSize() pdf.Write(lineHt, "To find out what's new in this tutorial, click ") pdf.SetFont("", "U", 0) link := pdf.AddLink() pdf.WriteLinkID(lineHt, "here", link) pdf.SetFont("", "", 0) // Second page: image link and basic HTML with link pdf.AddPage() pdf.SetLink(link, 0, -1) pdf.Image(example.ImageFile("logo.png"), 10, 12, 30, 0, false, "", 0, "http://www.fpdf.org") pdf.SetLeftMargin(45) pdf.SetFontSize(14) _, lineHt = pdf.GetFontSize() htmlStr := `You can now easily print text mixing different styles: <b>bold</b>, ` + `<i>italic</i>, <u>underlined</u>, or <b><i><u>all at once</u></i></b>!<br><br>` + `<center>You can also center text.</center>` + `<right>Or align it to the right.</right>` + `You can also insert links on text, such as ` + `<a href="http://www.fpdf.org">www.fpdf.org</a>, or on an image: click on the logo.` html := pdf.HTMLBasicNew() html.Write(lineHt, htmlStr) fileStr := example.Filename("Fpdf_HTMLBasicNew") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_HTMLBasicNew.pdf
func (*Fpdf) Image ¶
func (f *Fpdf) Image(imageNameStr string, x, y, w, h float64, flow bool, tp string, link int, linkStr string)
Image puts a JPEG, PNG or GIF image in the current page.
Deprecated in favor of ImageOptions -- see that function for details on the behavior of arguments
Example ¶
ExampleFpdf_Image demonstrates how images are included in documents.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() pdf.SetFont("Arial", "", 11) pdf.Image(example.ImageFile("logo.png"), 10, 10, 30, 0, false, "", 0, "") pdf.Text(50, 20, "logo.png") pdf.Image(example.ImageFile("logo.gif"), 10, 40, 30, 0, false, "", 0, "") pdf.Text(50, 50, "logo.gif") pdf.Image(example.ImageFile("logo-gray.png"), 10, 70, 30, 0, false, "", 0, "") pdf.Text(50, 80, "logo-gray.png") pdf.Image(example.ImageFile("logo-rgb.png"), 10, 100, 30, 0, false, "", 0, "") pdf.Text(50, 110, "logo-rgb.png") pdf.Image(example.ImageFile("logo.jpg"), 10, 130, 30, 0, false, "", 0, "") pdf.Text(50, 140, "logo.jpg") fileStr := example.Filename("Fpdf_Image") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_Image.pdf
func (*Fpdf) ImageOptions ¶
func (f *Fpdf) ImageOptions(imageNameStr string, x, y, w, h float64, flow bool, options ImageOptions, link int, linkStr string)
ImageOptions puts a JPEG, PNG or GIF image in the current page. The size it will take on the page can be specified in different ways. If both w and h are 0, the image is rendered at 96 dpi. If either w or h is zero, it will be calculated from the other dimension so that the aspect ratio is maintained. If w and/or h are -1, the dpi for that dimension will be read from the ImageInfoType object. PNG files can contain dpi information, and if present, this information will be populated in the ImageInfoType object and used in Width, Height, and Extent calculations. Otherwise, the SetDpi function can be used to change the dpi from the default of 72.
If w and h are any other negative value, their absolute values indicate their dpi extents.
Supported JPEG formats are 24 bit, 32 bit and gray scale. Supported PNG formats are 24 bit, indexed color, and 8 bit indexed gray scale. If a GIF image is animated, only the first frame is rendered. Transparency is supported. It is possible to put a link on the image.
imageNameStr may be the name of an image as registered with a call to either RegisterImageReader() or RegisterImage(). In the first case, the image is loaded using an io.Reader. This is generally useful when the image is obtained from some other means than as a disk-based file. In the second case, the image is loaded as a file. Alternatively, imageNameStr may directly specify a sufficiently qualified filename.
However the image is loaded, if it is used more than once only one copy is embedded in the file.
If x is negative, the current abscissa is used.
If flow is true, the current y value is advanced after placing the image and a page break may be made if necessary.
If link refers to an internal page anchor (that is, it is non-zero; see AddLink()), the image will be a clickable internal link. Otherwise, if linkStr specifies a URL, the image will be a clickable external link.
Example ¶
ExampleFpdf_ImageOptions demonstrates how the AllowNegativePosition field of the ImageOption struct can be used to affect horizontal image placement.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { var opt gofpdf.ImageOptions pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() pdf.SetFont("Arial", "", 11) pdf.SetX(60) opt.ImageType = "png" pdf.ImageOptions(example.ImageFile("logo.png"), -10, 10, 30, 0, false, opt, 0, "") opt.AllowNegativePosition = true pdf.ImageOptions(example.ImageFile("logo.png"), -10, 50, 30, 0, false, opt, 0, "") fileStr := example.Filename("Fpdf_ImageOptions") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_ImageOptions.pdf
func (*Fpdf) ImageTypeFromMime ¶
ImageTypeFromMime returns the image type used in various image-related functions (for example, Image()) that is associated with the specified MIME type. For example, "jpg" is returned if mimeStr is "image/jpeg". An error is set if the specified MIME type is not supported.
func (*Fpdf) ImportObjPos ¶ added in v1.4.3
ImportObjPos imports object hash positions from gofpdi
func (*Fpdf) ImportObjects ¶ added in v1.4.3
ImportObjects imports objects from gofpdi into current document
func (*Fpdf) ImportTemplates ¶ added in v1.4.3
ImportTemplates imports gofpdi template names into importedTplObjs for inclusion in the procset dictionary
func (*Fpdf) Line ¶
Line draws a line between points (x1, y1) and (x2, y2) using the current draw color, line width and cap style.
func (*Fpdf) LineTo ¶
LineTo creates a line from the current stylus location to (x, y), which becomes the new stylus location. Note that this only creates the line in the path; it does not actually draw the line on the page.
The MoveTo() example demonstrates this method.
func (*Fpdf) LinearGradient ¶
func (f *Fpdf) LinearGradient(x, y, w, h float64, r1, g1, b1, r2, g2, b2 int, x1, y1, x2, y2 float64)
LinearGradient draws a rectangular area with a blending of one color to another. The rectangle is of width w and height h. Its upper left corner is positioned at point (x, y).
Each color is specified with three component values, one each for red, green and blue. The values range from 0 to 255. The first color is specified by (r1, g1, b1) and the second color by (r2, g2, b2).
The blending is controlled with a gradient vector that uses normalized coordinates in which the lower left corner is position (0, 0) and the upper right corner is (1, 1). The vector's origin and destination are specified by the points (x1, y1) and (x2, y2). In a linear gradient, blending occurs perpendicularly to the vector. The vector does not necessarily need to be anchored on the rectangle edge. Color 1 is used up to the origin of the vector and color 2 is used beyond the vector's end point. Between the points the colors are gradually blended.
Example ¶
ExampleFpdf_LinearGradient deomstrates various gradients.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("", "", "", "") pdf.SetFont("Helvetica", "", 12) pdf.AddPage() pdf.LinearGradient(0, 0, 210, 100, 250, 250, 255, 220, 220, 225, 0, 0, 0, .5) pdf.LinearGradient(20, 25, 75, 75, 220, 220, 250, 80, 80, 220, 0, .2, 0, .8) pdf.Rect(20, 25, 75, 75, "D") pdf.LinearGradient(115, 25, 75, 75, 220, 220, 250, 80, 80, 220, 0, 0, 1, 1) pdf.Rect(115, 25, 75, 75, "D") pdf.RadialGradient(20, 120, 75, 75, 220, 220, 250, 80, 80, 220, 0.25, 0.75, 0.25, 0.75, 1) pdf.Rect(20, 120, 75, 75, "D") pdf.RadialGradient(115, 120, 75, 75, 220, 220, 250, 80, 80, 220, 0.25, 0.75, 0.75, 0.75, 0.75) pdf.Rect(115, 120, 75, 75, "D") fileStr := example.Filename("Fpdf_LinearGradient_gradient") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_LinearGradient_gradient.pdf
func (*Fpdf) Link ¶
Link puts a link on a rectangular area of the page. Text or image links are generally put via Cell(), Write() or Image(), but this method can be useful for instance to define a clickable area inside an image. link is the value returned by AddLink().
func (*Fpdf) LinkString ¶
LinkString puts a link on a rectangular area of the page. Text or image links are generally put via Cell(), Write() or Image(), but this method can be useful for instance to define a clickable area inside an image. linkStr is the target URL.
func (*Fpdf) Ln ¶
Ln performs a line break. The current abscissa goes back to the left margin and the ordinate increases by the amount passed in parameter. A negative value of h indicates the height of the last printed cell.
This method is demonstrated in the example for MultiCell.
func (*Fpdf) MoveTo ¶
MoveTo moves the stylus to (x, y) without drawing the path from the previous point. Paths must start with a MoveTo to set the original stylus location or the result is undefined.
Create a "path" by moving a virtual stylus around the page (with MoveTo, LineTo, CurveTo, CurveBezierCubicTo, ArcTo & ClosePath) then draw it or fill it in (with DrawPath). The main advantage of using the path drawing routines rather than multiple Fpdf.Line is that PDF creates nice line joins at the angles, rather than just overlaying the lines.
Example ¶
ExampleFpdf_MoveTo demonstrates the Path Drawing functions, such as: MoveTo, LineTo, CurveTo, ..., ClosePath and DrawPath.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() pdf.MoveTo(20, 20) pdf.LineTo(170, 20) pdf.ArcTo(170, 40, 20, 20, 0, 90, 0) pdf.CurveTo(190, 100, 105, 100) pdf.CurveBezierCubicTo(20, 100, 105, 200, 20, 200) pdf.ClosePath() pdf.SetFillColor(200, 200, 200) pdf.SetLineWidth(3) pdf.DrawPath("DF") fileStr := example.Filename("Fpdf_MoveTo_path") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_MoveTo_path.pdf
func (*Fpdf) MultiCell ¶
MultiCell supports printing text with line breaks. They can be automatic (as soon as the text reaches the right border of the cell) or explicit (via the \n character). As many cells as necessary are output, one below the other.
Text can be aligned, centered or justified. The cell block can be framed and the background painted. See CellFormat() for more details.
The current position after calling MultiCell() is the beginning of the next line, equivalent to calling CellFormat with ln equal to 1.
w is the width of the cells. A value of zero indicates cells that reach to the right margin.
h indicates the line height of each cell in the unit of measure specified in New().
Note: this method has a known bug that treats UTF-8 fonts differently than non-UTF-8 fonts. With UTF-8 fonts, all trailing newlines in txtStr are removed. With a non-UTF-8 font, if txtStr has one or more trailing newlines, only the last is removed. In the next major module version, the UTF-8 logic will be changed to match the non-UTF-8 logic. To prepare for that change, applications that use UTF-8 fonts and depend on having all trailing newlines removed should call strings.TrimRight(txtStr, "\r\n") before calling this method.
Example ¶
ExampleFpdf_MultiCell demonstrates word-wrapping, line justification and page-breaking.
package main import ( "fmt" "io/ioutil" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") titleStr := "20000 Leagues Under the Seas" pdf.SetTitle(titleStr, false) pdf.SetAuthor("Jules Verne", false) pdf.SetHeaderFunc(func() { // Arial bold 15 pdf.SetFont("Arial", "B", 15) // Calculate width of title and position wd := pdf.GetStringWidth(titleStr) + 6 pdf.SetX((210 - wd) / 2) // Colors of frame, background and text pdf.SetDrawColor(0, 80, 180) pdf.SetFillColor(230, 230, 0) pdf.SetTextColor(220, 50, 50) // Thickness of frame (1 mm) pdf.SetLineWidth(1) // Title pdf.CellFormat(wd, 9, titleStr, "1", 1, "C", true, 0, "") // Line break pdf.Ln(10) }) pdf.SetFooterFunc(func() { // Position at 1.5 cm from bottom pdf.SetY(-15) // Arial italic 8 pdf.SetFont("Arial", "I", 8) // Text color in gray pdf.SetTextColor(128, 128, 128) // Page number pdf.CellFormat(0, 10, fmt.Sprintf("Page %d", pdf.PageNo()), "", 0, "C", false, 0, "") }) chapterTitle := func(chapNum int, titleStr string) { // // Arial 12 pdf.SetFont("Arial", "", 12) // Background color pdf.SetFillColor(200, 220, 255) // Title pdf.CellFormat(0, 6, fmt.Sprintf("Chapter %d : %s", chapNum, titleStr), "", 1, "L", true, 0, "") // Line break pdf.Ln(4) } chapterBody := func(fileStr string) { // Read text file txtStr, err := ioutil.ReadFile(fileStr) if err != nil { pdf.SetError(err) } // Times 12 pdf.SetFont("Times", "", 12) // Output justified text pdf.MultiCell(0, 5, string(txtStr), "", "", false) // Line break pdf.Ln(-1) // Mention in italics pdf.SetFont("", "I", 0) pdf.Cell(0, 5, "(end of excerpt)") } printChapter := func(chapNum int, titleStr, fileStr string) { pdf.AddPage() chapterTitle(chapNum, titleStr) chapterBody(fileStr) } printChapter(1, "A RUNAWAY REEF", example.TextFile("20k_c1.txt")) printChapter(2, "THE PROS AND CONS", example.TextFile("20k_c2.txt")) fileStr := example.Filename("Fpdf_MultiCell") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_MultiCell.pdf
func (*Fpdf) OpenLayerPane ¶
func (f *Fpdf) OpenLayerPane()
OpenLayerPane advises the document reader to open the layer pane when the document is initially displayed.
func (*Fpdf) Output ¶
Output sends the PDF document to the writer specified by w. No output will take place if an error has occurred in the document generation process. w remains open after this function returns. After returning, f is in a closed state and its methods should not be called.
func (*Fpdf) OutputAndClose ¶
func (f *Fpdf) OutputAndClose(w io.WriteCloser) error
OutputAndClose sends the PDF document to the writer specified by w. This method will close both f and w, even if an error is detected and no document is produced.
func (*Fpdf) OutputFileAndClose ¶
OutputFileAndClose creates or truncates the file specified by fileStr and writes the PDF document to it. This method will close f and the newly written file, even if an error is detected and no document is produced.
Most examples demonstrate the use of this method.
func (*Fpdf) PageCount ¶ added in v1.4.3
PageCount returns the number of pages currently in the document. Since page numbers in gofpdf are one-based, the page count is the same as the page number of the current last page.
func (*Fpdf) PageNo ¶
PageNo returns the current page number.
See the example for AddPage() for a demonstration of this method.
func (*Fpdf) PageSize ¶
PageSize returns the width and height of the specified page in the units established in New(). These return values are followed by the unit of measure itself. If pageNum is zero or otherwise out of bounds, it returns the default page size, that is, the size of the page that would be added by AddPage().
Example ¶
ExampleFpdf_PageSize generates a PDF document with various page sizes.
package main import ( "fmt" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.NewCustom(&gofpdf.InitType{ UnitStr: "in", Size: gofpdf.SizeType{Wd: 6, Ht: 6}, FontDirStr: example.FontDir(), }) pdf.SetMargins(0.5, 1, 0.5) pdf.SetFont("Times", "", 14) pdf.AddPageFormat("L", gofpdf.SizeType{Wd: 3, Ht: 12}) pdf.SetXY(0.5, 1.5) pdf.CellFormat(11, 0.2, "12 in x 3 in", "", 0, "C", false, 0, "") pdf.AddPage() // Default size established in NewCustom() pdf.SetXY(0.5, 3) pdf.CellFormat(5, 0.2, "6 in x 6 in", "", 0, "C", false, 0, "") pdf.AddPageFormat("P", gofpdf.SizeType{Wd: 3, Ht: 12}) pdf.SetXY(0.5, 6) pdf.CellFormat(2, 0.2, "3 in x 12 in", "", 0, "C", false, 0, "") for j := 0; j <= 3; j++ { wd, ht, u := pdf.PageSize(j) fmt.Printf("%d: %6.2f %s, %6.2f %s\n", j, wd, u, ht, u) } fileStr := example.Filename("Fpdf_PageSize") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: 0: 6.00 in, 6.00 in 1: 12.00 in, 3.00 in 2: 6.00 in, 6.00 in 3: 3.00 in, 12.00 in Successfully generated pdf/Fpdf_PageSize.pdf
func (*Fpdf) PointConvert ¶
PointConvert returns the value of pt, expressed in points (1/72 inch), as a value expressed in the unit of measure specified in New(). Since font management in Fpdf uses points, this method can help with line height calculations and other methods that require user units.
func (*Fpdf) PointToUnitConvert ¶
PointToUnitConvert is an alias for PointConvert.
func (*Fpdf) Polygon ¶
Polygon draws a closed figure defined by a series of vertices specified by points. The x and y fields of the points use the units established in New(). The last point in the slice will be implicitly joined to the first to close the polygon.
styleStr can be "F" for filled, "D" for outlined only, or "DF" or "FD" for outlined and filled. An empty string will be replaced with "D". Drawing uses the current draw color and line width centered on the ellipse's perimeter. Filling uses the current fill color.
Example ¶
ExampleFpdf_Polygon displays equilateral polygons in a demonstration of the Polygon function.
package main import ( "math" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { const rowCount = 5 const colCount = 4 const ptSize = 36 var x, y, radius, gap, advance float64 var rgVal int var pts []gofpdf.PointType vertices := func(count int) (res []gofpdf.PointType) { var pt gofpdf.PointType res = make([]gofpdf.PointType, 0, count) mlt := 2.0 * math.Pi / float64(count) for j := 0; j < count; j++ { pt.Y, pt.X = math.Sincos(float64(j) * mlt) res = append(res, gofpdf.PointType{ X: x + radius*pt.X, Y: y + radius*pt.Y}) } return } pdf := gofpdf.New("P", "mm", "A4", "") // A4 210.0 x 297.0 pdf.AddPage() pdf.SetFont("Helvetica", "", ptSize) pdf.SetDrawColor(0, 80, 180) gap = 12.0 pdf.SetY(gap) pdf.CellFormat(190.0, gap, "Equilateral polygons", "", 1, "C", false, 0, "") radius = (210.0 - float64(colCount+1)*gap) / (2.0 * float64(colCount)) advance = gap + 2.0*radius y = 2*gap + pdf.PointConvert(ptSize) + radius rgVal = 230 for row := 0; row < rowCount; row++ { pdf.SetFillColor(rgVal, rgVal, 0) rgVal -= 12 x = gap + radius for col := 0; col < colCount; col++ { pts = vertices(row*colCount + col + 3) pdf.Polygon(pts, "FD") x += advance } y += advance } fileStr := example.Filename("Fpdf_Polygon") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_Polygon.pdf
func (*Fpdf) RadialGradient ¶
func (f *Fpdf) RadialGradient(x, y, w, h float64, r1, g1, b1, r2, g2, b2 int, x1, y1, x2, y2, r float64)
RadialGradient draws a rectangular area with a blending of one color to another. The rectangle is of width w and height h. Its upper left corner is positioned at point (x, y).
Each color is specified with three component values, one each for red, green and blue. The values range from 0 to 255. The first color is specified by (r1, g1, b1) and the second color by (r2, g2, b2).
The blending is controlled with a point and a circle, both specified with normalized coordinates in which the lower left corner of the rendered rectangle is position (0, 0) and the upper right corner is (1, 1). Color 1 begins at the origin point specified by (x1, y1). Color 2 begins at the circle specified by the center point (x2, y2) and radius r. Colors are gradually blended from the origin to the circle. The origin and the circle's center do not necessarily have to coincide, but the origin must be within the circle to avoid rendering problems.
The LinearGradient() example demonstrates this method.
func (*Fpdf) RawWriteBuf ¶
RawWriteBuf writes the contents of the specified buffer directly to the PDF generation buffer. This is a low-level function that is not required for normal PDF construction. An understanding of the PDF specification is needed to use this method correctly.
func (*Fpdf) RawWriteStr ¶
RawWriteStr writes a string directly to the PDF generation buffer. This is a low-level function that is not required for normal PDF construction. An understanding of the PDF specification is needed to use this method correctly.
func (*Fpdf) Rect ¶
Rect outputs a rectangle of width w and height h with the upper left corner positioned at point (x, y).
It can be drawn (border only), filled (with no border) or both. styleStr can be "F" for filled, "D" for outlined only, or "DF" or "FD" for outlined and filled. An empty string will be replaced with "D". Drawing uses the current draw color and line width centered on the rectangle's perimeter. Filling uses the current fill color.
Example ¶
This example demonstrate wrapped table cells
package main import ( "fmt" "strings" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { marginCell := 2. // margin of top/bottom of cell pdf := gofpdf.New("P", "mm", "A4", "") pdf.SetFont("Arial", "", 12) pdf.AddPage() pagew, pageh := pdf.GetPageSize() mleft, mright, _, mbottom := pdf.GetMargins() cols := []float64{60, 100, pagew - mleft - mright - 100 - 60} rows := [][]string{} for i := 1; i <= 30; i++ { word := fmt.Sprintf("%d:%s", i, strings.Repeat("A", i%100)) rows = append(rows, []string{word, word, word}) } for _, row := range rows { curx, y := pdf.GetXY() x := curx height := 0. _, lineHt := pdf.GetFontSize() for i, txt := range row { lines := pdf.SplitLines([]byte(txt), cols[i]) h := float64(len(lines))*lineHt + marginCell*float64(len(lines)) if h > height { height = h } } // add a new page if the height of the row doesn't fit on the page if pdf.GetY()+height > pageh-mbottom { pdf.AddPage() y = pdf.GetY() } for i, txt := range row { width := cols[i] pdf.Rect(x, y, width, height, "") pdf.MultiCell(width, lineHt+marginCell, txt, "", "", false) x += width pdf.SetXY(x, y) } pdf.SetXY(curx, y+height) } fileStr := example.Filename("Fpdf_WrappedTableCells") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_WrappedTableCells.pdf
func (*Fpdf) RegisterAlias ¶ added in v1.4.3
RegisterAlias adds an (alias, replacement) pair to the document so we can replace all occurrences of that alias after writing but before the document is closed. Functions ExampleFpdf_RegisterAlias() and ExampleFpdf_RegisterAlias_utf8() in fpdf_test.go demonstrate this method.
Example ¶
ExampleFpdf_RegisterAlias demonstrates how to use `RegisterAlias` to create a table of contents.
package main import ( "fmt" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.SetFont("Arial", "", 12) pdf.AliasNbPages("") pdf.AddPage() // Write the table of contents. We use aliases instead of the page number // because we don't know which page the section will begin on. numSections := 3 for i := 1; i <= numSections; i++ { pdf.Cell(0, 10, fmt.Sprintf("Section %d begins on page {mark %d}", i, i)) pdf.Ln(10) } // Write the sections. Before we start writing, we use `RegisterAlias` to // ensure that the alias written in the table of contents will be replaced // by the current page number. for i := 1; i <= numSections; i++ { pdf.AddPage() pdf.RegisterAlias(fmt.Sprintf("{mark %d}", i), fmt.Sprintf("%d", pdf.PageNo())) pdf.Write(10, fmt.Sprintf("Section %d, page %d of {nb}", i, pdf.PageNo())) } fileStr := example.Filename("Fpdf_RegisterAlias") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_RegisterAlias.pdf
Example (Utf8) ¶
ExampleFpdf_RegisterAlias_utf8 demonstrates how to use `RegisterAlias` to create a table of contents. This particular example demonstrates the use of UTF-8 aliases.
package main import ( "fmt" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddUTF8Font("dejavu", "", example.FontFile("DejaVuSansCondensed.ttf")) pdf.SetFont("dejavu", "", 12) pdf.AliasNbPages("{entute}") pdf.AddPage() // Write the table of contents. We use aliases instead of the page number // because we don't know which page the section will begin on. numSections := 3 for i := 1; i <= numSections; i++ { pdf.Cell(0, 10, fmt.Sprintf("Sekcio %d komenciĝas ĉe paĝo {ĉi tiu marko %d}", i, i)) pdf.Ln(10) } // Write the sections. Before we start writing, we use `RegisterAlias` to // ensure that the alias written in the table of contents will be replaced // by the current page number. for i := 1; i <= numSections; i++ { pdf.AddPage() pdf.RegisterAlias(fmt.Sprintf("{ĉi tiu marko %d}", i), fmt.Sprintf("%d", pdf.PageNo())) pdf.Write(10, fmt.Sprintf("Sekcio %d, paĝo %d de {entute}", i, pdf.PageNo())) } fileStr := example.Filename("Fpdf_RegisterAliasUTF8") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_RegisterAliasUTF8.pdf
func (*Fpdf) RegisterImage ¶
func (f *Fpdf) RegisterImage(fileStr, tp string) (info *ImageInfoType)
RegisterImage registers an image, adding it to the PDF file but not adding it to the page. Use Image() with the same filename to add the image to the page. Note that Image() calls this function, so this function is only necessary if you need information about the image before placing it.
This function is now deprecated in favor of RegisterImageOptions. See Image() for restrictions on the image and the "tp" parameters.
Example ¶
ExampleFpdf_RegisterImage demonstrates Lawrence Kesteloot's image registration code.
package main import ( "fmt" "path/filepath" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { const ( margin = 10 wd = 210 ht = 297 ) fileList := []string{ "logo-gray.png", "logo.jpg", "logo.png", "logo-rgb.png", "logo-progressive.jpg", } var infoPtr *gofpdf.ImageInfoType var imageFileStr string var imgWd, imgHt, lf, tp float64 pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() pdf.SetMargins(10, 10, 10) pdf.SetFont("Helvetica", "", 15) for j, str := range fileList { imageFileStr = example.ImageFile(str) infoPtr = pdf.RegisterImage(imageFileStr, "") imgWd, imgHt = infoPtr.Extent() switch j { case 0: lf = margin tp = margin case 1: lf = wd - margin - imgWd tp = margin case 2: lf = (wd - imgWd) / 2.0 tp = (ht - imgHt) / 2.0 case 3: lf = margin tp = ht - imgHt - margin case 4: lf = wd - imgWd - margin tp = ht - imgHt - margin } pdf.Image(imageFileStr, lf, tp, imgWd, imgHt, false, "", 0, "") } fileStr := example.Filename("Fpdf_RegisterImage") // Test the image information retrieval method infoShow := func(imageStr string) { imageStr = example.ImageFile(imageStr) info := pdf.GetImageInfo(imageStr) if info != nil { if info.Width() > 0.0 { fmt.Printf("Image %s is registered\n", filepath.ToSlash(imageStr)) } else { fmt.Printf("Incorrect information for image %s\n", filepath.ToSlash(imageStr)) } } else { fmt.Printf("Image %s is not registered\n", filepath.ToSlash(imageStr)) } } infoShow(fileList[0]) infoShow("foo.png") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Image image/logo-gray.png is registered Image image/foo.png is not registered Successfully generated pdf/Fpdf_RegisterImage.pdf
func (*Fpdf) RegisterImageOptions ¶
func (f *Fpdf) RegisterImageOptions(fileStr string, options ImageOptions) (info *ImageInfoType)
RegisterImageOptions registers an image, adding it to the PDF file but not adding it to the page. Use Image() with the same filename to add the image to the page. Note that Image() calls this function, so this function is only necessary if you need information about the image before placing it. See Image() for restrictions on the image and the "tp" parameters.
func (*Fpdf) RegisterImageOptionsReader ¶
func (f *Fpdf) RegisterImageOptionsReader(imgName string, options ImageOptions, r io.Reader) (info *ImageInfoType)
RegisterImageOptionsReader registers an image, reading it from Reader r, adding it to the PDF file but not adding it to the page. Use Image() with the same name to add the image to the page. Note that tp should be specified in this case.
See Image() for restrictions on the image and the options parameters.
Example ¶
ExampleFpdf_RegisterImageOptionsReader demonstrates how to load an image from a io.Reader (in this case, a file) and register it with options.
package main import ( "os" "path/filepath" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func init() { cleanup() } func cleanup() { filepath.Walk(example.PdfDir(), func(path string, info os.FileInfo, err error) (reterr error) { if info.Mode().IsRegular() { dir, _ := filepath.Split(path) if "reference" != filepath.Base(dir) { if len(path) > 3 { if path[len(path)-4:] == ".pdf" { os.Remove(path) } } } } return }) } func main() { var ( opt gofpdf.ImageOptions pdfStr string fl *os.File err error ) pdfStr = example.Filename("Fpdf_RegisterImageOptionsReader") pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() pdf.SetFont("Arial", "", 11) fl, err = os.Open(example.ImageFile("logo.png")) if err == nil { opt.ImageType = "png" opt.AllowNegativePosition = true _ = pdf.RegisterImageOptionsReader("logo", opt, fl) fl.Close() for x := -20.0; x <= 40.0; x += 5 { pdf.ImageOptions("logo", x, x+30, 0, 0, false, opt, 0, "") } err = pdf.OutputFileAndClose(pdfStr) } example.Summary(err, pdfStr) }
Output: Successfully generated pdf/Fpdf_RegisterImageOptionsReader.pdf
func (*Fpdf) RegisterImageReader ¶
func (f *Fpdf) RegisterImageReader(imgName, tp string, r io.Reader) (info *ImageInfoType)
RegisterImageReader registers an image, reading it from Reader r, adding it to the PDF file but not adding it to the page.
This function is now deprecated in favor of RegisterImageOptionsReader
Example ¶
ExampleFpdf_RegisterImageReader demonstrates the use of an image that is retrieved from a web server.
package main import ( "net/http" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { const ( margin = 10 wd = 210 ht = 297 fontSize = 15 urlStr = "https://bitbucket.org/thoomycz/gofpdf/blob/master/image/gofpdf.png?raw=true" msgStr = `Images from the web can be easily embedded when a PDF document is generated.` ) var ( rsp *http.Response err error tp string ) pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() pdf.SetFont("Helvetica", "", fontSize) ln := pdf.PointConvert(fontSize) pdf.MultiCell(wd-margin-margin, ln, msgStr, "", "L", false) rsp, err = http.Get(urlStr) if err == nil { tp = pdf.ImageTypeFromMime(rsp.Header["Content-Type"][0]) infoPtr := pdf.RegisterImageReader(urlStr, tp, rsp.Body) if pdf.Ok() { imgWd, imgHt := infoPtr.Extent() pdf.Image(urlStr, (wd-imgWd)/2.0, pdf.GetY()+ln, imgWd, imgHt, false, tp, 0, "") } } else { pdf.SetError(err) } fileStr := example.Filename("Fpdf_RegisterImageReader_url") err = pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_RegisterImageReader_url.pdf
func (*Fpdf) RoundedRect ¶ added in v1.4.3
RoundedRect outputs a rectangle of width w and height h with the upper left corner positioned at point (x, y). It can be drawn (border only), filled (with no border) or both. styleStr can be "F" for filled, "D" for outlined only, or "DF" or "FD" for outlined and filled. An empty string will be replaced with "D". Drawing uses the current draw color and line width centered on the rectangle's perimeter. Filling uses the current fill color. The rounded corners of the rectangle are specified by radius r. corners is a string that includes "1" to round the upper left corner, "2" to round the upper right corner, "3" to round the lower right corner, and "4" to round the lower left corner. The RoundedRect example demonstrates this method.
Example ¶
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { const ( wd = 40.0 hgap = 10.0 radius = 10.0 ht = 60.0 vgap = 10.0 ) corner := func(b1, b2, b3, b4 bool) (cstr string) { if b1 { cstr = "1" } if b2 { cstr += "2" } if b3 { cstr += "3" } if b4 { cstr += "4" } return } pdf := gofpdf.New("P", "mm", "A4", "") // 210 x 297 pdf.AddPage() pdf.SetLineWidth(0.5) y := vgap r := 40 g := 30 b := 20 for row := 0; row < 4; row++ { x := hgap for col := 0; col < 4; col++ { pdf.SetFillColor(r, g, b) pdf.RoundedRect(x, y, wd, ht, radius, corner(row&1 == 1, row&2 == 2, col&1 == 1, col&2 == 2), "FD") r += 8 g += 10 b += 12 x += wd + hgap } y += ht + vgap } pdf.AddPage() pdf.RoundedRectExt(10, 20, 40, 80, 4., 0., 20, 0., "FD") fileStr := example.Filename("Fpdf_RoundedRect") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_RoundedRect.pdf
func (*Fpdf) RoundedRectExt ¶ added in v1.4.3
RoundedRectExt behaves the same as RoundedRect() but supports a different radius for each corner. A zero radius means squared corner. See RoundedRect() for more details. This method is demonstrated in the RoundedRect() example.
func (*Fpdf) SVGBasicWrite ¶
func (f *Fpdf) SVGBasicWrite(sb *SVGBasicType, scale float64)
SVGBasicWrite renders the paths encoded in the basic SVG image specified by sb. The scale value is used to convert the coordinates in the path to the unit of measure specified in New(). The current position (as set with a call to SetXY()) is used as the origin of the image. The current line cap style (as set with SetLineCapStyle()), line width (as set with SetLineWidth()), and draw color (as set with SetDrawColor()) are used in drawing the image paths.
Example ¶
ExampleFpdf_SVGBasicWrite demonstrates how to render a simple path-only SVG image of the type generated by the jSignature web control.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { const ( fontPtSize = 16.0 wd = 100.0 sigFileStr = "signature.svg" ) var ( sig gofpdf.SVGBasicType err error ) pdf := gofpdf.New("P", "mm", "A4", "") // A4 210.0 x 297.0 pdf.SetFont("Times", "", fontPtSize) lineHt := pdf.PointConvert(fontPtSize) pdf.AddPage() pdf.SetMargins(10, 10, 10) htmlStr := `This example renders a simple ` + `<a href="http://www.w3.org/TR/SVG/">SVG</a> (scalable vector graphics) ` + `image that contains only basic path commands without any styling, ` + `color fill, reflection or endpoint closures. In particular, the ` + `type of vector graphic returned from a ` + `<a href="http://willowsystems.github.io/jSignature/#/demo/">jSignature</a> ` + `web control is supported and is used in this example.` html := pdf.HTMLBasicNew() html.Write(lineHt, htmlStr) sig, err = gofpdf.SVGBasicFileParse(example.ImageFile(sigFileStr)) if err == nil { scale := 100 / sig.Wd scaleY := 30 / sig.Ht if scale > scaleY { scale = scaleY } pdf.SetLineCapStyle("round") pdf.SetLineWidth(0.25) pdf.SetDrawColor(0, 0, 128) pdf.SetXY((210.0-scale*sig.Wd)/2.0, pdf.GetY()+10) pdf.SVGBasicWrite(&sig, scale) } else { pdf.SetError(err) } fileStr := example.Filename("Fpdf_SVGBasicWrite") err = pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_SVGBasicWrite.pdf
func (*Fpdf) SetAcceptPageBreakFunc ¶
SetAcceptPageBreakFunc allows the application to control where page breaks occur.
fnc is an application function (typically a closure) that is called by the library whenever a page break condition is met. The break is issued if true is returned. The default implementation returns a value according to the mode selected by SetAutoPageBreak. The function provided should not be called by the application.
See the example for SetLeftMargin() to see how this function can be used to manage multiple columns.
Example ¶
This example demonstrates Landscape mode with images.
package main import ( "strings" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func loremList() []string { return []string{ "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod " + "tempor incididunt ut labore et dolore magna aliqua.", "Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut " + "aliquip ex ea commodo consequat.", "Duis aute irure dolor in reprehenderit in voluptate velit esse cillum " + "dolore eu fugiat nulla pariatur.", "Excepteur sint occaecat cupidatat non proident, sunt in culpa qui " + "officia deserunt mollit anim id est laborum.", } } func lorem() string { return strings.Join(loremList(), " ") } func main() { var y0 float64 var crrntCol int loremStr := lorem() pdf := gofpdf.New("L", "mm", "A4", "") const ( pageWd = 297.0 // A4 210.0 x 297.0 margin = 10.0 gutter = 4 colNum = 3 colWd = (pageWd - 2*margin - (colNum-1)*gutter) / colNum ) setCol := func(col int) { crrntCol = col x := margin + float64(col)*(colWd+gutter) pdf.SetLeftMargin(x) pdf.SetX(x) } pdf.SetHeaderFunc(func() { titleStr := "gofpdf" pdf.SetFont("Helvetica", "B", 48) wd := pdf.GetStringWidth(titleStr) + 6 pdf.SetX((pageWd - wd) / 2) pdf.SetTextColor(128, 128, 160) pdf.Write(12, titleStr[:2]) pdf.SetTextColor(128, 128, 128) pdf.Write(12, titleStr[2:]) pdf.Ln(20) y0 = pdf.GetY() }) pdf.SetAcceptPageBreakFunc(func() bool { if crrntCol < colNum-1 { setCol(crrntCol + 1) pdf.SetY(y0) // Start new column, not new page return false } setCol(0) return true }) pdf.AddPage() pdf.SetFont("Times", "", 12) for j := 0; j < 20; j++ { if j == 1 { pdf.Image(example.ImageFile("fpdf.png"), -1, 0, colWd, 0, true, "", 0, "") } else if j == 5 { pdf.Image(example.ImageFile("golang-gopher.png"), -1, 0, colWd, 0, true, "", 0, "") } pdf.MultiCell(colWd, 5, loremStr, "", "", false) pdf.Ln(-1) } fileStr := example.Filename("Fpdf_SetAcceptPageBreakFunc_landscape") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_SetAcceptPageBreakFunc_landscape.pdf
func (*Fpdf) SetAlpha ¶
SetAlpha sets the alpha blending channel. The blending effect applies to text, drawings and images.
alpha must be a value between 0.0 (fully transparent) to 1.0 (fully opaque). Values outside of this range result in an error.
blendModeStr must be one of "Normal", "Multiply", "Screen", "Overlay", "Darken", "Lighten", "ColorDodge", "ColorBurn","HardLight", "SoftLight", "Difference", "Exclusion", "Hue", "Saturation", "Color", or "Luminosity". An empty string is replaced with "Normal".
To reset normal rendering after applying a blending mode, call this method with alpha set to 1.0 and blendModeStr set to "Normal".
Example ¶
ExampleFpdf_SetAlpha demonstrates alpha transparency.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { const ( gapX = 10.0 gapY = 9.0 rectW = 40.0 rectH = 58.0 pageW = 210 pageH = 297 ) modeList := []string{"Normal", "Multiply", "Screen", "Overlay", "Darken", "Lighten", "ColorDodge", "ColorBurn", "HardLight", "SoftLight", "Difference", "Exclusion", "Hue", "Saturation", "Color", "Luminosity"} pdf := gofpdf.New("", "", "", "") pdf.SetLineWidth(2) pdf.SetAutoPageBreak(false, 0) pdf.AddPage() pdf.SetFont("Helvetica", "", 18) pdf.SetXY(0, gapY) pdf.SetTextColor(0, 0, 0) pdf.CellFormat(pageW, gapY, "Alpha Blending Modes", "", 0, "C", false, 0, "") j := 0 y := 3 * gapY for col := 0; col < 4; col++ { x := gapX for row := 0; row < 4; row++ { pdf.Rect(x, y, rectW, rectH, "D") pdf.SetFont("Helvetica", "B", 12) pdf.SetFillColor(0, 0, 0) pdf.SetTextColor(250, 250, 230) pdf.SetXY(x, y+rectH-4) pdf.CellFormat(rectW, 5, modeList[j], "", 0, "C", true, 0, "") pdf.SetFont("Helvetica", "I", 150) pdf.SetTextColor(80, 80, 120) pdf.SetXY(x, y+2) pdf.CellFormat(rectW, rectH, "A", "", 0, "C", false, 0, "") pdf.SetAlpha(0.5, modeList[j]) pdf.Image(example.ImageFile("golang-gopher.png"), x-gapX, y, rectW+2*gapX, 0, false, "", 0, "") pdf.SetAlpha(1.0, "Normal") x += rectW + gapX j++ } y += rectH + gapY } fileStr := example.Filename("Fpdf_SetAlpha_transparency") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_SetAlpha_transparency.pdf
func (*Fpdf) SetAttachments ¶ added in v1.4.3
func (f *Fpdf) SetAttachments(as []Attachment)
SetAttachments writes attachments as embedded files (document attachment). These attachments are global, see AddAttachmentAnnotation() for a link anchored in a page. Note that only the last call of SetAttachments is useful, previous calls are discarded. Be aware that not all PDF readers support document attachments. See the SetAttachment example for a demonstration of this method.
Example ¶
ExampleFpdf_SetTextRenderingMode demonstrates embedding files in PDFs, at the top-level.
package main import ( "io/ioutil" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") // Global attachments file, err := ioutil.ReadFile("grid.go") if err != nil { pdf.SetError(err) } a1 := gofpdf.Attachment{Content: file, Filename: "grid.go"} file, err = ioutil.ReadFile("LICENSE") if err != nil { pdf.SetError(err) } a2 := gofpdf.Attachment{Content: file, Filename: "License"} pdf.SetAttachments([]gofpdf.Attachment{a1, a2}) fileStr := example.Filename("Fpdf_EmbeddedFiles") err = pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_EmbeddedFiles.pdf
func (*Fpdf) SetAuthor ¶
SetAuthor defines the author of the document. isUTF8 indicates if the string is encoded in ISO-8859-1 (false) or UTF-8 (true).
func (*Fpdf) SetAutoPageBreak ¶
SetAutoPageBreak enables or disables the automatic page breaking mode. When enabling, the second parameter is the distance from the bottom of the page that defines the triggering limit. By default, the mode is on and the margin is 2 cm.
func (*Fpdf) SetCatalogSort ¶
SetCatalogSort sets a flag that will be used, if true, to consistently order the document's internal resource catalogs. This method is typically only used for test purposes to facilitate PDF comparison.
func (*Fpdf) SetCellMargin ¶
SetCellMargin sets the cell margin. This is the amount of space before and after the text within a cell that's left blank, and is in units passed to New().
func (*Fpdf) SetCompression ¶
SetCompression activates or deactivates page compression with zlib. When activated, the internal representation of each page is compressed, which leads to a compression ratio of about 2 for the resulting document. Compression is on by default.
func (*Fpdf) SetCreationDate ¶
SetCreationDate fixes the document's internal CreationDate value. By default, the time when the document is generated is used for this value. This method is typically only used for testing purposes to facilitate PDF comparison. Specify a zero-value time to revert to the default behavior.
func (*Fpdf) SetCreator ¶
SetCreator defines the creator of the document. isUTF8 indicates if the string is encoded in ISO-8859-1 (false) or UTF-8 (true).
func (*Fpdf) SetDashPattern ¶
SetDashPattern sets the dash pattern that is used to draw lines. The dashArray elements are numbers that specify the lengths, in units established in New(), of alternating dashes and gaps. The dash phase specifies the distance into the dash pattern at which to start the dash. The dash pattern is retained from page to page. Call this method with an empty array to restore solid line drawing.
The Beziergon() example demonstrates this method.
func (*Fpdf) SetDisplayMode ¶
SetDisplayMode sets advisory display directives for the document viewer. Pages can be displayed entirely on screen, occupy the full width of the window, use real size, be scaled by a specific zooming factor or use viewer default (configured in the Preferences menu of Adobe Reader). The page layout can be specified so that pages are displayed individually or in pairs.
zoomStr can be "fullpage" to display the entire page on screen, "fullwidth" to use maximum width of window, "real" to use real size (equivalent to 100% zoom) or "default" to use viewer default mode.
layoutStr can be "single" (or "SinglePage") to display one page at once, "continuous" (or "OneColumn") to display pages continuously, "two" (or "TwoColumnLeft") to display two pages on two columns with odd-numbered pages on the left, or "TwoColumnRight" to display two pages on two columns with odd-numbered pages on the right, or "TwoPageLeft" to display pages two at a time with odd-numbered pages on the left, or "TwoPageRight" to display pages two at a time with odd-numbered pages on the right, or "default" to use viewer default mode.
func (*Fpdf) SetDrawColor ¶
SetDrawColor defines the color used for all drawing operations (lines, rectangles and cell borders). It is expressed in RGB components (0 - 255). The method can be called before the first page is created. The value is retained from page to page.
func (*Fpdf) SetDrawSpotColor ¶ added in v1.4.3
SetDrawSpotColor sets the current draw color to the spot color associated with nameStr. An error occurs if the name is not associated with a color. The value for tint ranges from 0 (no intensity) to 100 (full intensity). It is quietly bounded to this range.
func (*Fpdf) SetError ¶
SetError sets an error to halt PDF generation. This may facilitate error handling by application. See also Ok(), Err() and Error().
func (*Fpdf) SetErrorf ¶
SetErrorf sets the internal Fpdf error with formatted text to halt PDF generation; this may facilitate error handling by application. If an error condition is already set, this call is ignored.
See the documentation for printing in the standard fmt package for details about fmtStr and args.
func (*Fpdf) SetFillColor ¶
SetFillColor defines the color used for all filling operations (filled rectangles and cell backgrounds). It is expressed in RGB components (0 -255). The method can be called before the first page is created and the value is retained from page to page.
Example ¶
ExampleFpdf_SetFillColor demonstrates how graphic attributes are properly assigned within multiple transformations. See issue #234.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() pdf.SetFont("Arial", "", 8) draw := func(trX, trY float64) { pdf.TransformBegin() pdf.TransformTranslateX(trX) pdf.TransformTranslateY(trY) pdf.SetLineJoinStyle("round") pdf.SetLineWidth(0.5) pdf.SetDrawColor(128, 64, 0) pdf.SetFillColor(255, 127, 0) pdf.SetAlpha(0.5, "Normal") pdf.SetDashPattern([]float64{5, 10}, 0) pdf.Rect(0, 0, 40, 40, "FD") pdf.SetFontSize(12) pdf.SetXY(5, 5) pdf.Write(0, "Test") pdf.TransformEnd() } draw(5, 5) draw(50, 50) fileStr := example.Filename("Fpdf_SetFillColor") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_SetFillColor.pdf
func (*Fpdf) SetFillSpotColor ¶ added in v1.4.3
SetFillSpotColor sets the current fill color to the spot color associated with nameStr. An error occurs if the name is not associated with a color. The value for tint ranges from 0 (no intensity) to 100 (full intensity). It is quietly bounded to this range.
func (*Fpdf) SetFont ¶
SetFont sets the font used to print character strings. It is mandatory to call this method at least once before printing text or the resulting document will not be valid.
The font can be either a standard one or a font added via the AddFont() method or AddFontFromReader() method. Standard fonts use the Windows encoding cp1252 (Western Europe).
The method can be called before the first page is created and the font is kept from page to page. If you just wish to change the current font size, it is simpler to call SetFontSize().
Note: the font definition file must be accessible. An error is set if the file cannot be read.
familyStr specifies the font family. It can be either a name defined by AddFont(), AddFontFromReader() or one of the standard families (case insensitive): "Courier" for fixed-width, "Helvetica" or "Arial" for sans serif, "Times" for serif, "Symbol" or "ZapfDingbats" for symbolic.
styleStr can be "B" (bold), "I" (italic), "U" (underscore), "S" (strike-out) or any combination. The default value (specified with an empty string) is regular. Bold and italic styles do not apply to Symbol and ZapfDingbats.
size is the font size measured in points. The default value is the current size. If no size has been specified since the beginning of the document, the value taken is 12.
func (*Fpdf) SetFontLoader ¶
func (f *Fpdf) SetFontLoader(loader FontLoader)
SetFontLoader sets a loader used to read font files (.json and .z) from an arbitrary source. If a font loader has been specified, it is used to load the named font resources when AddFont() is called. If this operation fails, an attempt is made to load the resources from the configured font directory (see SetFontLocation()).
Example ¶
ExampleFpdf_SetFontLoader demonstrates loading a non-standard font using a generalized font loader. fontResourceType implements the FontLoader interface and is defined locally in the test source code.
package main import ( "bytes" "fmt" "io" "io/ioutil" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) type fontResourceType struct { } func (f fontResourceType) Open(name string) (rdr io.Reader, err error) { var buf []byte buf, err = ioutil.ReadFile(example.FontFile(name)) if err == nil { rdr = bytes.NewReader(buf) fmt.Printf("Generalized font loader reading %s\n", name) } return } func main() { var fr fontResourceType pdf := gofpdf.New("P", "mm", "A4", "") pdf.SetFontLoader(fr) pdf.AddFont("Calligrapher", "", "calligra.json") pdf.AddPage() pdf.SetFont("Calligrapher", "", 35) pdf.Cell(0, 10, "Load fonts from any source") fileStr := example.Filename("Fpdf_SetFontLoader") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Generalized font loader reading calligra.json Generalized font loader reading calligra.z Successfully generated pdf/Fpdf_SetFontLoader.pdf
func (*Fpdf) SetFontLocation ¶
SetFontLocation sets the location in the file system of the font and font definition files.
func (*Fpdf) SetFontSize ¶
SetFontSize defines the size of the current font. Size is specified in points (1/ 72 inch). See also SetFontUnitSize().
func (*Fpdf) SetFontStyle ¶ added in v1.4.3
SetFontStyle sets the style of the current font. See also SetFont()
func (*Fpdf) SetFontUnitSize ¶
SetFontUnitSize defines the size of the current font. Size is specified in the unit of measure specified in New(). See also SetFontSize().
func (*Fpdf) SetFooterFunc ¶
func (f *Fpdf) SetFooterFunc(fnc func())
SetFooterFunc sets the function that lets the application render the page footer. The specified function is automatically called by AddPage() and Close() and should not be called directly by the application. The implementation in Fpdf is empty, so you have to provide an appropriate function if you want page footers. fnc will typically be a closure that has access to the Fpdf instance and other document generation variables. See SetFooterFuncLpi for a similar function that passes a last page indicator.
This method is demonstrated in the example for AddPage().
func (*Fpdf) SetFooterFuncLpi ¶ added in v1.4.3
SetFooterFuncLpi sets the function that lets the application render the page footer. The specified function is automatically called by AddPage() and Close() and should not be called directly by the application. It is passed a boolean that is true if the last page of the document is being rendered. The implementation in Fpdf is empty, so you have to provide an appropriate function if you want page footers. fnc will typically be a closure that has access to the Fpdf instance and other document generation variables.
func (*Fpdf) SetHeaderFunc ¶
func (f *Fpdf) SetHeaderFunc(fnc func())
SetHeaderFunc sets the function that lets the application render the page header. The specified function is automatically called by AddPage() and should not be called directly by the application. The implementation in Fpdf is empty, so you have to provide an appropriate function if you want page headers. fnc will typically be a closure that has access to the Fpdf instance and other document generation variables.
A header is a convenient place to put background content that repeats on each page such as a watermark. When this is done, remember to reset the X and Y values so the normal content begins where expected. Including a watermark on each page is demonstrated in the example for TransformRotate.
This method is demonstrated in the example for AddPage().
func (*Fpdf) SetHeaderFuncMode ¶ added in v1.4.3
SetHeaderFuncMode sets the function that lets the application render the page header. See SetHeaderFunc() for more details. The value for homeMode should be set to true to have the current position set to the left and top margin after the header function is called.
func (*Fpdf) SetHomeXY ¶ added in v1.4.3
func (f *Fpdf) SetHomeXY()
SetHomeXY is a convenience method that sets the current position to the left and top margins.
func (*Fpdf) SetJavascript ¶ added in v1.4.3
SetJavascript adds Adobe JavaScript to the document.
Example ¶
ExampleFpdf_SetJavascript demonstrates including JavaScript in the document.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.SetJavascript("print(true);") pdf.AddPage() pdf.SetFont("Arial", "", 12) pdf.Write(10, "Auto-print.") fileStr := example.Filename("Fpdf_SetJavascript") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_SetJavascript.pdf
func (*Fpdf) SetKeywords ¶
SetKeywords defines the keywords of the document. keywordStr is a space-delimited string, for example "invoice August". isUTF8 indicates if the string is encoded
Example ¶
This example tests corner cases as reported by the gocov tool.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { var err error fileStr := example.Filename("Fpdf_SetKeywords") err = gofpdf.MakeFont(example.FontFile("CalligrapherRegular.pfb"), example.FontFile("cp1252.map"), example.FontDir(), nil, true) if err == nil { pdf := gofpdf.New("", "", "", "") pdf.SetFontLocation(example.FontDir()) pdf.SetTitle("世界", true) pdf.SetAuthor("世界", true) pdf.SetSubject("世界", true) pdf.SetCreator("世界", true) pdf.SetKeywords("世界", true) pdf.AddFont("Calligrapher", "", "CalligrapherRegular.json") pdf.AddPage() pdf.SetFont("Calligrapher", "", 16) pdf.Writef(5, "\x95 %s \x95", pdf) err = pdf.OutputFileAndClose(fileStr) } example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_SetKeywords.pdf
func (*Fpdf) SetLeftMargin ¶
SetLeftMargin defines the left margin. The method can be called before creating the first page. If the current abscissa gets out of page, it is brought back to the margin.
Example ¶
ExampleFpdf_SetLeftMargin demonstrates the generation of a PDF document that has multiple columns. This is accomplished with the SetLeftMargin() and Cell() methods.
package main import ( "fmt" "io/ioutil" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { var y0 float64 var crrntCol int pdf := gofpdf.New("P", "mm", "A4", "") pdf.SetDisplayMode("fullpage", "TwoColumnLeft") titleStr := "20000 Leagues Under the Seas" pdf.SetTitle(titleStr, false) pdf.SetAuthor("Jules Verne", false) setCol := func(col int) { // Set position at a given column crrntCol = col x := 10.0 + float64(col)*65.0 pdf.SetLeftMargin(x) pdf.SetX(x) } chapterTitle := func(chapNum int, titleStr string) { // Arial 12 pdf.SetFont("Arial", "", 12) // Background color pdf.SetFillColor(200, 220, 255) // Title pdf.CellFormat(0, 6, fmt.Sprintf("Chapter %d : %s", chapNum, titleStr), "", 1, "L", true, 0, "") // Line break pdf.Ln(4) y0 = pdf.GetY() } chapterBody := func(fileStr string) { // Read text file txtStr, err := ioutil.ReadFile(fileStr) if err != nil { pdf.SetError(err) } // Font pdf.SetFont("Times", "", 12) // Output text in a 6 cm width column pdf.MultiCell(60, 5, string(txtStr), "", "", false) pdf.Ln(-1) // Mention pdf.SetFont("", "I", 0) pdf.Cell(0, 5, "(end of excerpt)") // Go back to first column setCol(0) } printChapter := func(num int, titleStr, fileStr string) { // Add chapter pdf.AddPage() chapterTitle(num, titleStr) chapterBody(fileStr) } pdf.SetAcceptPageBreakFunc(func() bool { // Method accepting or not automatic page break if crrntCol < 2 { // Go to next column setCol(crrntCol + 1) // Set ordinate to top pdf.SetY(y0) // Keep on page return false } // Go back to first column setCol(0) // Page break return true }) pdf.SetHeaderFunc(func() { // Arial bold 15 pdf.SetFont("Arial", "B", 15) // Calculate width of title and position wd := pdf.GetStringWidth(titleStr) + 6 pdf.SetX((210 - wd) / 2) // Colors of frame, background and text pdf.SetDrawColor(0, 80, 180) pdf.SetFillColor(230, 230, 0) pdf.SetTextColor(220, 50, 50) // Thickness of frame (1 mm) pdf.SetLineWidth(1) // Title pdf.CellFormat(wd, 9, titleStr, "1", 1, "C", true, 0, "") // Line break pdf.Ln(10) // Save ordinate y0 = pdf.GetY() }) pdf.SetFooterFunc(func() { // Position at 1.5 cm from bottom pdf.SetY(-15) // Arial italic 8 pdf.SetFont("Arial", "I", 8) // Text color in gray pdf.SetTextColor(128, 128, 128) // Page number pdf.CellFormat(0, 10, fmt.Sprintf("Page %d", pdf.PageNo()), "", 0, "C", false, 0, "") }) printChapter(1, "A RUNAWAY REEF", example.TextFile("20k_c1.txt")) printChapter(2, "THE PROS AND CONS", example.TextFile("20k_c2.txt")) fileStr := example.Filename("Fpdf_SetLeftMargin_multicolumn") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_SetLeftMargin_multicolumn.pdf
func (*Fpdf) SetLineCapStyle ¶
SetLineCapStyle defines the line cap style. styleStr should be "butt", "round" or "square". A square style projects from the end of the line. The method can be called before the first page is created. The value is retained from page to page.
func (*Fpdf) SetLineJoinStyle ¶
SetLineJoinStyle defines the line cap style. styleStr should be "miter", "round" or "bevel". The method can be called before the first page is created. The value is retained from page to page.
Example ¶
ExampleFpdf_SetLineJoinStyle demonstrates various line cap and line join styles.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { const offset = 75.0 pdf := gofpdf.New("L", "mm", "A4", "") pdf.AddPage() var draw = func(cap, join string, x0, y0, x1, y1 float64) { // transform begin & end needed to isolate caps and joins pdf.SetLineCapStyle(cap) pdf.SetLineJoinStyle(join) // Draw thick line pdf.SetDrawColor(0x33, 0x33, 0x33) pdf.SetLineWidth(30.0) pdf.MoveTo(x0, y0) pdf.LineTo((x0+x1)/2+offset, (y0+y1)/2) pdf.LineTo(x1, y1) pdf.DrawPath("D") // Draw thin helping line pdf.SetDrawColor(0xFF, 0x33, 0x33) pdf.SetLineWidth(2.56) pdf.MoveTo(x0, y0) pdf.LineTo((x0+x1)/2+offset, (y0+y1)/2) pdf.LineTo(x1, y1) pdf.DrawPath("D") } x := 35.0 caps := []string{"butt", "square", "round"} joins := []string{"bevel", "miter", "round"} for i := range caps { draw(caps[i], joins[i], x, 50, x, 160) x += offset } fileStr := example.Filename("Fpdf_SetLineJoinStyle_caps") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_SetLineJoinStyle_caps.pdf
func (*Fpdf) SetLineWidth ¶
SetLineWidth defines the line width. By default, the value equals 0.2 mm. The method can be called before the first page is created. The value is retained from page to page.
func (*Fpdf) SetMargins ¶
SetMargins defines the left, top and right margins. By default, they equal 1 cm. Call this method to change them. If the value of the right margin is less than zero, it is set to the same as the left margin.
func (*Fpdf) SetModificationDate ¶ added in v1.4.3
SetModificationDate fixes the document's internal ModDate value. See `SetCreationDate` for more details.
Example ¶
package main import ( "time" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { // pdfinfo (from http://www.xpdfreader.com) reports the following for this example : // ~ pdfinfo -box pdf/Fpdf_PageBox.pdf // Producer: FPDF 1.7 // CreationDate: Sat Jan 1 00:00:00 2000 // ModDate: Sun Jan 2 10:22:30 2000 pdf := gofpdf.New("", "", "", "") pdf.AddPage() pdf.SetModificationDate(time.Date(2000, 1, 2, 10, 22, 30, 0, time.UTC)) fileStr := example.Filename("Fpdf_SetModificationDate") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_SetModificationDate.pdf
func (*Fpdf) SetPage ¶ added in v1.4.3
SetPage sets the current page to that of a valid page in the PDF document. pageNum is one-based. The SetPage() example demonstrates this method.
Example ¶
ExampleFpdf_SetPage demomstrates the SetPage() method, allowing content generation to be deferred until all pages have been added.
package main import ( "math/rand" "strconv" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { rnd := rand.New(rand.NewSource(0)) // Make reproducible documents pdf := gofpdf.New("L", "cm", "A4", "") pdf.SetFont("Times", "", 12) var time []float64 temperaturesFromSensors := make([][]float64, 5) maxs := []float64{25, 41, 89, 62, 11} for i := range temperaturesFromSensors { temperaturesFromSensors[i] = make([]float64, 0) } for i := 0.0; i < 100; i += 0.5 { time = append(time, i) for j, sensor := range temperaturesFromSensors { dataValue := rnd.Float64() * maxs[j] sensor = append(sensor, dataValue) temperaturesFromSensors[j] = sensor } } var graphs []gofpdf.GridType var pageNums []int xMax := time[len(time)-1] for i := range temperaturesFromSensors { //Create a new page and graph for each sensor we want to graph. pdf.AddPage() pdf.Ln(1) //Custom label per sensor pdf.WriteAligned(0, 0, "Temperature Sensor "+strconv.Itoa(i+1)+" (C) vs Time (min)", "C") pdf.Ln(0.5) graph := gofpdf.NewGrid(pdf.GetX(), pdf.GetY(), 20, 10) graph.TickmarksContainX(0, xMax) //Custom Y axis graph.TickmarksContainY(0, maxs[i]) graph.Grid(pdf) //Save references and locations. graphs = append(graphs, graph) pageNums = append(pageNums, pdf.PageNo()) } // For each X, graph the Y in each sensor. for i, currTime := range time { for j, sensor := range temperaturesFromSensors { pdf.SetPage(pageNums[j]) graph := graphs[j] temperature := sensor[i] pdf.Circle(graph.X(currTime), graph.Y(temperature), 0.04, "D") } } fileStr := example.Filename("Fpdf_SetPage") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_SetPage.pdf
func (*Fpdf) SetPageBox ¶ added in v1.4.3
SetPageBox sets the page box for the current page, and any following pages. Allowable types are trim, trimbox, crop, cropbox, bleed, bleedbox, art and artbox box types are case insensitive.
Example ¶
ExampleFpdf_SetPageBox demonstrates the use of a page box
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { // pdfinfo (from http://www.xpdfreader.com) reports the following for this example: // ~ pdfinfo -box pdf/Fpdf_PageBox.pdf // Producer: FPDF 1.7 // CreationDate: Sat Jan 1 00:00:00 2000 // ModDate: Sat Jan 1 00:00:00 2000 // Tagged: no // Form: none // Pages: 1 // Encrypted: no // Page size: 493.23 x 739.85 pts (rotated 0 degrees) // MediaBox: 0.00 0.00 595.28 841.89 // CropBox: 51.02 51.02 544.25 790.87 // BleedBox: 51.02 51.02 544.25 790.87 // TrimBox: 51.02 51.02 544.25 790.87 // ArtBox: 51.02 51.02 544.25 790.87 // File size: 1053 bytes // Optimized: no // PDF version: 1.3 const ( wd = 210 ht = 297 fontsize = 6 boxmargin = 3 * fontsize ) pdf := gofpdf.New("P", "mm", "A4", "") // 210mm x 297mm pdf.SetPageBox("crop", boxmargin, boxmargin, wd-2*boxmargin, ht-2*boxmargin) pdf.SetFont("Arial", "", pdf.UnitToPointConvert(fontsize)) pdf.AddPage() pdf.MoveTo(fontsize, fontsize) pdf.Write(fontsize, "This will be cropped from printed output") pdf.MoveTo(boxmargin+fontsize, boxmargin+fontsize) pdf.Write(fontsize, "This will be displayed in cropped output") fileStr := example.Filename("Fpdf_PageBox") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_PageBox.pdf
func (*Fpdf) SetPageBoxRec ¶ added in v1.4.3
SetPageBoxRec sets the page box for the current page, and any following pages. Allowable types are trim, trimbox, crop, cropbox, bleed, bleedbox, art and artbox box types are case insensitive. See SetPageBox() for a method that specifies the coordinates and extent of the page box individually.
func (*Fpdf) SetProducer ¶ added in v1.4.3
SetProducer defines the producer of the document. isUTF8 indicates if the string is encoded in ISO-8859-1 (false) or UTF-8 (true).
func (*Fpdf) SetProtection ¶
SetProtection applies certain constraints on the finished PDF document.
actionFlag is a bitflag that controls various document operations. CnProtectPrint allows the document to be printed. CnProtectModify allows a document to be modified by a PDF editor. CnProtectCopy allows text and images to be copied into the system clipboard. CnProtectAnnotForms allows annotations and forms to be added by a PDF editor. These values can be combined by or-ing them together, for example, CnProtectCopy|CnProtectModify. This flag is advisory; not all PDF readers implement the constraints that this argument attempts to control.
userPassStr specifies the password that will need to be provided to view the contents of the PDF. The permissions specified by actionFlag will apply.
ownerPassStr specifies the password that will need to be provided to gain full access to the document regardless of the actionFlag value. An empty string for this argument will be replaced with a random value, effectively prohibiting full access to the document.
Example ¶
ExampleFpdf_SetProtection demonstrates password protection for documents.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.SetProtection(gofpdf.CnProtectPrint, "123", "abc") pdf.AddPage() pdf.SetFont("Arial", "", 12) pdf.Write(10, "Password-protected.") fileStr := example.Filename("Fpdf_SetProtection") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_SetProtection.pdf
func (*Fpdf) SetRightMargin ¶
SetRightMargin defines the right margin. The method can be called before creating the first page.
func (*Fpdf) SetSubject ¶
SetSubject defines the subject of the document. isUTF8 indicates if the string is encoded in ISO-8859-1 (false) or UTF-8 (true).
func (*Fpdf) SetTextColor ¶
SetTextColor defines the color used for text. It is expressed in RGB components (0 - 255). The method can be called before the first page is created. The value is retained from page to page.
func (*Fpdf) SetTextRenderingMode ¶ added in v1.4.3
SetTextRenderingMode sets the rendering mode of following text. The mode can be as follows: 0: Fill text 1: Stroke text 2: Fill, then stroke text 3: Neither fill nor stroke text (invisible) 4: Fill text and add to path for clipping 5: Stroke text and add to path for clipping 6: Fills then stroke text and add to path for clipping 7: Add text to path for clipping This method is demonstrated in the SetTextRenderingMode example.
Example ¶
ExampleFpdf_SetTextRenderingMode demonstrates rendering modes in PDFs.
package main import ( "fmt" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") // 210mm x 297mm pdf.AddPage() fontSz := float64(16) lineSz := pdf.PointToUnitConvert(fontSz) pdf.SetFont("Times", "", fontSz) pdf.Write(lineSz, "This document demonstrates various modes of text rendering. Search for \"Mode 3\" "+ "to locate text that has been rendered invisibly. This selection can be copied "+ "into the clipboard as usual and is useful for overlaying onto non-textual elements such "+ "as images to make them searchable.\n\n") fontSz = float64(125) lineSz = pdf.PointToUnitConvert(fontSz) pdf.SetFontSize(fontSz) pdf.SetTextColor(170, 170, 190) pdf.SetDrawColor(50, 60, 90) write := func(mode int) { pdf.SetTextRenderingMode(mode) pdf.CellFormat(210, lineSz, fmt.Sprintf("Mode %d", mode), "", 1, "", false, 0, "") } for mode := 0; mode < 4; mode++ { write(mode) } write(0) fileStr := example.Filename("Fpdf_TextRenderingMode") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_TextRenderingMode.pdf
func (*Fpdf) SetTextSpotColor ¶ added in v1.4.3
SetTextSpotColor sets the current text color to the spot color associated with nameStr. An error occurs if the name is not associated with a color. The value for tint ranges from 0 (no intensity) to 100 (full intensity). It is quietly bounded to this range.
func (*Fpdf) SetTitle ¶
SetTitle defines the title of the document. isUTF8 indicates if the string is encoded in ISO-8859-1 (false) or UTF-8 (true).
func (*Fpdf) SetTopMargin ¶
SetTopMargin defines the top margin. The method can be called before creating the first page.
func (*Fpdf) SetUnderlineThickness ¶ added in v1.4.3
SetUnderlineThickness accepts a multiplier for adjusting the text underline thickness, defaulting to 1. See SetUnderlineThickness example.
Example ¶
ExampleFpdf_SetUnderlineThickness demonstrates how to adjust the text underline thickness.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") // 210mm x 297mm pdf.AddPage() pdf.SetFont("Arial", "U", 12) pdf.SetUnderlineThickness(0.5) pdf.CellFormat(0, 10, "Thin underline", "", 1, "", false, 0, "") pdf.SetUnderlineThickness(1) pdf.CellFormat(0, 10, "Normal underline", "", 1, "", false, 0, "") pdf.SetUnderlineThickness(2) pdf.CellFormat(0, 10, "Thicker underline", "", 1, "", false, 0, "") fileStr := example.Filename("Fpdf_UnderlineThickness") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_UnderlineThickness.pdf
func (*Fpdf) SetWordSpacing ¶ added in v1.4.3
SetWordSpacing sets spacing between words of following text. See the WriteAligned() example for a demonstration of its use.
func (*Fpdf) SetX ¶
SetX defines the abscissa of the current position. If the passed value is negative, it is relative to the right of the page.
func (*Fpdf) SetXY ¶
SetXY defines the abscissa and ordinate of the current position. If the passed values are negative, they are relative respectively to the right and bottom of the page.
func (*Fpdf) SetXmpMetadata ¶ added in v1.4.3
SetXmpMetadata defines XMP metadata that will be embedded with the document.
func (*Fpdf) SetY ¶
SetY moves the current abscissa back to the left margin and sets the ordinate. If the passed value is negative, it is relative to the bottom of the page.
func (*Fpdf) SplitLines ¶
SplitLines splits text into several lines using the current font. Each line has its length limited to a maximum width given by w. This function can be used to determine the total height of wrapped text for vertical placement purposes.
This method is useful for codepage-based fonts only. For UTF-8 encoded text, use SplitText().
You can use MultiCell if you want to print a text on several lines in a simple way.
Example ¶
ExampleFpdf_SplitLines demonstrates Bruno Michel's line splitting function.
package main import ( "strings" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func loremList() []string { return []string{ "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod " + "tempor incididunt ut labore et dolore magna aliqua.", "Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut " + "aliquip ex ea commodo consequat.", "Duis aute irure dolor in reprehenderit in voluptate velit esse cillum " + "dolore eu fugiat nulla pariatur.", "Excepteur sint occaecat cupidatat non proident, sunt in culpa qui " + "officia deserunt mollit anim id est laborum.", } } func lorem() string { return strings.Join(loremList(), " ") } func main() { const ( fontPtSize = 18.0 wd = 100.0 ) pdf := gofpdf.New("P", "mm", "A4", "") // A4 210.0 x 297.0 pdf.SetFont("Times", "", fontPtSize) _, lineHt := pdf.GetFontSize() pdf.AddPage() pdf.SetMargins(10, 10, 10) lines := pdf.SplitLines([]byte(lorem()), wd) ht := float64(len(lines)) * lineHt y := (297.0 - ht) / 2.0 pdf.SetDrawColor(128, 128, 128) pdf.SetFillColor(255, 255, 210) x := (210.0 - (wd + 40.0)) / 2.0 pdf.Rect(x, y-20.0, wd+40.0, ht+40.0, "FD") pdf.SetY(y) for _, line := range lines { pdf.CellFormat(190.0, lineHt, string(line), "", 1, "C", false, 0, "") } fileStr := example.Filename("Fpdf_Splitlines") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_Splitlines.pdf
Example (Tables) ¶
ExampleFpdf_SplitLines_tables demonstrates word-wrapped table cells
package main import ( "strings" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func loremList() []string { return []string{ "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod " + "tempor incididunt ut labore et dolore magna aliqua.", "Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut " + "aliquip ex ea commodo consequat.", "Duis aute irure dolor in reprehenderit in voluptate velit esse cillum " + "dolore eu fugiat nulla pariatur.", "Excepteur sint occaecat cupidatat non proident, sunt in culpa qui " + "officia deserunt mollit anim id est laborum.", } } func main() { const ( colCount = 3 colWd = 60.0 marginH = 15.0 lineHt = 5.5 cellGap = 2.0 ) // var colStrList [colCount]string type cellType struct { str string list [][]byte ht float64 } var ( cellList [colCount]cellType cell cellType ) pdf := gofpdf.New("P", "mm", "A4", "") // 210 x 297 header := [colCount]string{"Column A", "Column B", "Column C"} alignList := [colCount]string{"L", "C", "R"} strList := loremList() pdf.SetMargins(marginH, 15, marginH) pdf.SetFont("Arial", "", 14) pdf.AddPage() // Headers pdf.SetTextColor(224, 224, 224) pdf.SetFillColor(64, 64, 64) for colJ := 0; colJ < colCount; colJ++ { pdf.CellFormat(colWd, 10, header[colJ], "1", 0, "CM", true, 0, "") } pdf.Ln(-1) pdf.SetTextColor(24, 24, 24) pdf.SetFillColor(255, 255, 255) // Rows y := pdf.GetY() count := 0 for rowJ := 0; rowJ < 2; rowJ++ { maxHt := lineHt // Cell height calculation loop for colJ := 0; colJ < colCount; colJ++ { count++ if count > len(strList) { count = 1 } cell.str = strings.Join(strList[0:count], " ") cell.list = pdf.SplitLines([]byte(cell.str), colWd-cellGap-cellGap) cell.ht = float64(len(cell.list)) * lineHt if cell.ht > maxHt { maxHt = cell.ht } cellList[colJ] = cell } // Cell render loop x := marginH for colJ := 0; colJ < colCount; colJ++ { pdf.Rect(x, y, colWd, maxHt+cellGap+cellGap, "D") cell = cellList[colJ] cellY := y + cellGap + (maxHt-cell.ht)/2 for splitJ := 0; splitJ < len(cell.list); splitJ++ { pdf.SetXY(x+cellGap, cellY) pdf.CellFormat(colWd-cellGap-cellGap, lineHt, string(cell.list[splitJ]), "", 0, alignList[colJ], false, 0, "") cellY += lineHt } x += colWd } y += maxHt + cellGap + cellGap } fileStr := example.Filename("Fpdf_SplitLines_tables") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_SplitLines_tables.pdf
func (*Fpdf) SplitText ¶ added in v1.4.3
SplitText splits UTF-8 encoded text into several lines using the current font. Each line has its length limited to a maximum width given by w. This function can be used to determine the total height of wrapped text for vertical placement purposes.
func (*Fpdf) SubWrite ¶ added in v1.4.3
func (f *Fpdf) SubWrite(ht float64, str string, subFontSize, subOffset float64, link int, linkStr string)
SubWrite prints text from the current position in the same way as Write(). ht is the line height in the unit of measure specified in New(). str specifies the text to write. subFontSize is the size of the font in points. subOffset is the vertical offset of the text in points; a positive value indicates a superscript, a negative value indicates a subscript. link is the identifier returned by AddLink() or 0 for no internal link. linkStr is a target URL or empty for no external link. A non--zero value for link takes precedence over linkStr.
The SubWrite example demonstrates this method.
Example ¶
ExampleFpdf_SubWrite demonstrates subscripted and superscripted text Adapted from http://www.fpdf.org/en/script/script61.php
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { const ( fontSize = 12 halfX = 105 ) pdf := gofpdf.New("P", "mm", "A4", "") // 210mm x 297mm pdf.AddPage() pdf.SetFont("Arial", "", fontSize) _, lineHt := pdf.GetFontSize() pdf.Write(lineHt, "Hello World!") pdf.SetX(halfX) pdf.Write(lineHt, "This is standard text.\n") pdf.Ln(lineHt * 2) pdf.SubWrite(10, "H", 33, 0, 0, "") pdf.Write(10, "ello World!") pdf.SetX(halfX) pdf.Write(10, "This is text with a capital first letter.\n") pdf.Ln(lineHt * 2) pdf.SubWrite(lineHt, "Y", 6, 0, 0, "") pdf.Write(lineHt, "ou can also begin the sentence with a small letter. And word wrap also works if the line is too long, like this one is.") pdf.SetX(halfX) pdf.Write(lineHt, "This is text with a small first letter.\n") pdf.Ln(lineHt * 2) pdf.Write(lineHt, "The world has a lot of km") pdf.SubWrite(lineHt, "2", 6, 4, 0, "") pdf.SetX(halfX) pdf.Write(lineHt, "This is text with a superscripted letter.\n") pdf.Ln(lineHt * 2) pdf.Write(lineHt, "The world has a lot of H") pdf.SubWrite(lineHt, "2", 6, -3, 0, "") pdf.Write(lineHt, "O") pdf.SetX(halfX) pdf.Write(lineHt, "This is text with a subscripted letter.\n") fileStr := example.Filename("Fpdf_SubWrite") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_SubWrite.pdf
func (*Fpdf) Text ¶
Text prints a character string. The origin (x, y) is on the left of the first character at the baseline. This method permits a string to be placed precisely on the page, but it is usually easier to use Cell(), MultiCell() or Write() which are the standard methods to print text.
func (*Fpdf) Transform ¶
func (f *Fpdf) Transform(tm TransformMatrix)
Transform generally transforms the following text, drawings and images according to the specified matrix. It is typically easier to use the various methods such as TransformRotate() and TransformMirrorVertical() instead.
func (*Fpdf) TransformBegin ¶
func (f *Fpdf) TransformBegin()
TransformBegin sets up a transformation context for subsequent text, drawings and images. The typical usage is to immediately follow a call to this method with a call to one or more of the transformation methods such as TransformScale(), TransformSkew(), etc. This is followed by text, drawing or image output and finally a call to TransformEnd(). All transformation contexts must be properly ended prior to outputting the document.
Example ¶
ExampleFpdf_TransformBegin demonstrates various transformations. It is adapted from an example script by Moritz Wagner and Andreas Würmser.
package main import ( "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { const ( light = 200 dark = 0 ) var refX, refY float64 var refStr string pdf := gofpdf.New("P", "mm", "A4", "") pdf.AddPage() color := func(val int) { pdf.SetDrawColor(val, val, val) pdf.SetTextColor(val, val, val) } reference := func(str string, x, y float64, val int) { color(val) pdf.Rect(x, y, 40, 10, "D") pdf.Text(x, y-1, str) } refDraw := func(str string, x, y float64) { refStr = str refX = x refY = y reference(str, x, y, light) } refDupe := func() { reference(refStr, refX, refY, dark) } titleStr := "Transformations" titlePt := 36.0 titleHt := pdf.PointConvert(titlePt) pdf.SetFont("Helvetica", "", titlePt) titleWd := pdf.GetStringWidth(titleStr) titleX := (210 - titleWd) / 2 pdf.Text(titleX, 10+titleHt, titleStr) pdf.TransformBegin() pdf.TransformMirrorVertical(10 + titleHt + 0.5) pdf.ClipText(titleX, 10+titleHt, titleStr, false) // Remember that the transform will mirror the gradient box too pdf.LinearGradient(titleX, 10, titleWd, titleHt+4, 120, 120, 120, 255, 255, 255, 0, 0, 0, 0.6) pdf.ClipEnd() pdf.TransformEnd() pdf.SetFont("Helvetica", "", 12) // Scale by 150% centered by lower left corner of the rectangle refDraw("Scale", 50, 60) pdf.TransformBegin() pdf.TransformScaleXY(150, 50, 70) refDupe() pdf.TransformEnd() // Translate 7 to the right, 5 to the bottom refDraw("Translate", 125, 60) pdf.TransformBegin() pdf.TransformTranslate(7, 5) refDupe() pdf.TransformEnd() // Rotate 20 degrees counter-clockwise centered by the lower left corner of // the rectangle refDraw("Rotate", 50, 110) pdf.TransformBegin() pdf.TransformRotate(20, 50, 120) refDupe() pdf.TransformEnd() // Skew 30 degrees along the x-axis centered by the lower left corner of the // rectangle refDraw("Skew", 125, 110) pdf.TransformBegin() pdf.TransformSkewX(30, 125, 110) refDupe() pdf.TransformEnd() // Mirror horizontally with axis of reflection at left side of the rectangle refDraw("Mirror horizontal", 50, 160) pdf.TransformBegin() pdf.TransformMirrorHorizontal(50) refDupe() pdf.TransformEnd() // Mirror vertically with axis of reflection at bottom side of the rectangle refDraw("Mirror vertical", 125, 160) pdf.TransformBegin() pdf.TransformMirrorVertical(170) refDupe() pdf.TransformEnd() // Reflect against a point at the lower left point of rectangle refDraw("Mirror point", 50, 210) pdf.TransformBegin() pdf.TransformMirrorPoint(50, 220) refDupe() pdf.TransformEnd() // Mirror against a straight line described by a point and an angle angle := -20.0 px := 120.0 py := 220.0 refDraw("Mirror line", 125, 210) pdf.TransformBegin() pdf.TransformRotate(angle, px, py) pdf.Line(px-1, py-1, px+1, py+1) pdf.Line(px-1, py+1, px+1, py-1) pdf.Line(px-5, py, px+60, py) pdf.TransformEnd() pdf.TransformBegin() pdf.TransformMirrorLine(angle, px, py) refDupe() pdf.TransformEnd() fileStr := example.Filename("Fpdf_TransformBegin") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_TransformBegin.pdf
func (*Fpdf) TransformEnd ¶
func (f *Fpdf) TransformEnd()
TransformEnd applies a transformation that was begun with a call to TransformBegin().
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformMirrorHorizontal ¶
TransformMirrorHorizontal horizontally mirrors the following text, drawings and images. x is the axis of reflection.
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformMirrorLine ¶
TransformMirrorLine symmetrically mirrors the following text, drawings and images on the line defined by angle and the point (x, y). angles is specified in degrees and measured counter-clockwise from the 3 o'clock position.
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformMirrorPoint ¶
TransformMirrorPoint symmetrically mirrors the following text, drawings and images on the point specified by (x, y).
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformMirrorVertical ¶
TransformMirrorVertical vertically mirrors the following text, drawings and images. y is the axis of reflection.
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformRotate ¶
TransformRotate rotates the following text, drawings and images around the center point (x, y). angle is specified in degrees and measured counter-clockwise from the 3 o'clock position.
The TransformBegin() example demonstrates this method.
Example ¶
ExampleFpdf_TransformRotate demonstrates how to rotate text within a header to make a watermark that appears on each page.
package main import ( "strings" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func loremList() []string { return []string{ "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod " + "tempor incididunt ut labore et dolore magna aliqua.", "Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut " + "aliquip ex ea commodo consequat.", "Duis aute irure dolor in reprehenderit in voluptate velit esse cillum " + "dolore eu fugiat nulla pariatur.", "Excepteur sint occaecat cupidatat non proident, sunt in culpa qui " + "officia deserunt mollit anim id est laborum.", } } func lorem() string { return strings.Join(loremList(), " ") } func main() { loremStr := lorem() + "\n\n" pdf := gofpdf.New("P", "mm", "A4", "") margin := 25.0 pdf.SetMargins(margin, margin, margin) fontHt := 13.0 lineHt := pdf.PointToUnitConvert(fontHt) markFontHt := 50.0 markLineHt := pdf.PointToUnitConvert(markFontHt) markY := (297.0 - markLineHt) / 2.0 ctrX := 210.0 / 2.0 ctrY := 297.0 / 2.0 pdf.SetHeaderFunc(func() { pdf.SetFont("Arial", "B", markFontHt) pdf.SetTextColor(206, 216, 232) pdf.SetXY(margin, markY) pdf.TransformBegin() pdf.TransformRotate(45, ctrX, ctrY) pdf.CellFormat(0, markLineHt, "W A T E R M A R K D E M O", "", 0, "C", false, 0, "") pdf.TransformEnd() pdf.SetXY(margin, margin) }) pdf.AddPage() pdf.SetFont("Arial", "", 8) for j := 0; j < 25; j++ { pdf.MultiCell(0, lineHt, loremStr, "", "L", false) } fileStr := example.Filename("Fpdf_RotateText") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_RotateText.pdf
func (*Fpdf) TransformScale ¶
TransformScale generally scales the following text, drawings and images. scaleWd and scaleHt are the percentage scaling factors for width and height. (x, y) is center of scaling.
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformScaleX ¶
TransformScaleX scales the width of the following text, drawings and images. scaleWd is the percentage scaling factor. (x, y) is center of scaling.
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformScaleXY ¶
TransformScaleXY uniformly scales the width and height of the following text, drawings and images. s is the percentage scaling factor for both width and height. (x, y) is center of scaling.
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformScaleY ¶
TransformScaleY scales the height of the following text, drawings and images. scaleHt is the percentage scaling factor. (x, y) is center of scaling.
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformSkew ¶
TransformSkew generally skews the following text, drawings and images keeping the point (x, y) stationary. angleX ranges from -90 degrees (skew to the left) to 90 degrees (skew to the right). angleY ranges from -90 degrees (skew to the bottom) to 90 degrees (skew to the top).
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformSkewX ¶
TransformSkewX horizontally skews the following text, drawings and images keeping the point (x, y) stationary. angleX ranges from -90 degrees (skew to the left) to 90 degrees (skew to the right).
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformSkewY ¶
TransformSkewY vertically skews the following text, drawings and images keeping the point (x, y) stationary. angleY ranges from -90 degrees (skew to the bottom) to 90 degrees (skew to the top).
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformTranslate ¶
TransformTranslate moves the following text, drawings and images horizontally and vertically by the amounts specified by tx and ty.
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformTranslateX ¶
TransformTranslateX moves the following text, drawings and images horizontally by the amount specified by tx.
The TransformBegin() example demonstrates this method.
func (*Fpdf) TransformTranslateY ¶
TransformTranslateY moves the following text, drawings and images vertically by the amount specified by ty.
The TransformBegin() example demonstrates this method.
func (*Fpdf) UnicodeTranslatorFromDescriptor ¶
UnicodeTranslatorFromDescriptor returns a function that can be used to translate, where possible, utf-8 strings to a form that is compatible with the specified code page. See UnicodeTranslator for more details.
cpStr identifies a code page. A descriptor file in the font directory, set with the fontDirStr argument in the call to New(), should have this name plus the extension ".map". If cpStr is empty, it will be replaced with "cp1252", the gofpdf code page default.
If an error occurs reading the descriptor, the returned function is valid but does not perform any rune translation.
The CellFormat_codepage example demonstrates this method.
func (*Fpdf) UnitToPointConvert ¶
UnitToPointConvert returns the value of u, expressed in the unit of measure specified in New(), as a value expressed in points (1/72 inch). Since font management in Fpdf uses points, this method can help with setting font sizes based on the sizes of other non-font page elements.
func (*Fpdf) UseImportedTemplate ¶ added in v1.4.3
func (f *Fpdf) UseImportedTemplate(tplName string, scaleX float64, scaleY float64, tX float64, tY float64)
UseImportedTemplate uses imported template from gofpdi. It draws imported PDF page onto page.
func (*Fpdf) UseTemplate ¶
UseTemplate adds a template to the current page or another template, using the size and position at which it was originally written.
func (*Fpdf) UseTemplateScaled ¶
UseTemplateScaled adds a template to the current page or another template, using the given page coordinates.
func (*Fpdf) Write ¶
Write prints text from the current position. When the right margin is reached (or the \n character is met) a line break occurs and text continues from the left margin. Upon method exit, the current position is left just at the end of the text.
It is possible to put a link on the text.
h indicates the line height in the unit of measure specified in New().
func (*Fpdf) WriteAligned ¶
WriteAligned is an implementation of Write that makes it possible to align text.
width indicates the width of the box the text will be drawn in. This is in the unit of measure specified in New(). If it is set to 0, the bounding box of the page will be taken (pageWidth - leftMargin - rightMargin).
lineHeight indicates the line height in the unit of measure specified in New().
alignStr sees to horizontal alignment of the given textStr. The options are "L", "C" and "R" (Left, Center, Right). The default is "L".
Example ¶
ExampleFpdf_WriteAligned demonstrates how to align text with the Write function.
package main import ( "strings" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", example.FontDir()) pdf.SetLeftMargin(50.0) pdf.SetRightMargin(50.0) pdf.AddPage() pdf.SetFont("Helvetica", "", 12) pdf.WriteAligned(0, 35, "This text is the default alignment, Left", "") pdf.Ln(35) pdf.WriteAligned(0, 35, "This text is aligned Left", "L") pdf.Ln(35) pdf.WriteAligned(0, 35, "This text is aligned Center", "C") pdf.Ln(35) pdf.WriteAligned(0, 35, "This text is aligned Right", "R") pdf.Ln(35) line := "This can by used to write justified text" leftMargin, _, rightMargin, _ := pdf.GetMargins() pageWidth, _ := pdf.GetPageSize() pageWidth -= leftMargin + rightMargin pdf.SetWordSpacing((pageWidth - pdf.GetStringWidth(line)) / float64(strings.Count(line, " "))) pdf.WriteAligned(pageWidth, 35, line, "L") fileStr := example.Filename("Fpdf_WriteAligned") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_WriteAligned.pdf
func (*Fpdf) WriteLinkID ¶
WriteLinkID writes text that when clicked jumps to another location in the PDF. linkID is an identifier returned by AddLink(). See Write() for argument details.
func (*Fpdf) WriteLinkString ¶
WriteLinkString writes text that when clicked launches an external URL. See Write() for argument details.
type FpdfTpl ¶
type FpdfTpl struct {
// contains filtered or unexported fields
}
FpdfTpl is a concrete implementation of the Template interface.
func (*FpdfTpl) FromPages ¶ added in v1.4.3
FromPages creates a template slice with all the pages within a template.
func (*FpdfTpl) GobDecode ¶ added in v1.4.3
GobDecode decodes the specified byte buffer into the receiving template.
func (*FpdfTpl) GobEncode ¶ added in v1.4.3
GobEncode encodes the receiving template into a byte buffer. Use GobDecode to decode the byte buffer back to a template.
func (*FpdfTpl) Images ¶
func (t *FpdfTpl) Images() map[string]*ImageInfoType
Images returns a list of the images used in this template
func (*FpdfTpl) NumPages ¶ added in v1.4.3
NumPages returns the number of available pages within the template. Look at FromPage and FromPages on access to that content.
func (*FpdfTpl) Serialize ¶ added in v1.4.3
Serialize turns a template into a byte string for later deserialization
type GridType ¶ added in v1.4.3
type GridType struct {
// Labels are inside of graph boundary
XLabelIn, YLabelIn bool
// Labels on X-axis should be rotated
XLabelRotate bool
// Formatters; use nil to eliminate labels
XTickStr, YTickStr TickFormatFncType
// Subdivisions between tickmarks
XDiv, YDiv int
// Line and label colors
ClrText, ClrMain, ClrSub RGBAType
// Line thickness
WdMain, WdSub float64
// Label height in points
TextSize float64
// contains filtered or unexported fields
}
GridType assists with the generation of graphs. It allows the application to work with logical data coordinates rather than page coordinates and assists with the drawing of a background grid.
func NewGrid ¶ added in v1.4.3
NewGrid returns a variable of type GridType that is initialized to draw on a rectangle of width w and height h with the upper left corner positioned at point (x, y). The coordinates are in page units, that is, the same as those specified in New().
The returned variable is initialized with a very simple default tickmark layout that ranges from 0 to 1 in both axes. Prior to calling Grid(), the application may establish a more suitable tickmark layout by calling the methods TickmarksContainX() and TickmarksContainY(). These methods bound the data range with appropriate boundaries and divisions. Alternatively, if the exact extent and divisions of the tickmark layout are known, the methods TickmarksExtentX() and TickmarksExtentY may be called instead.
Example ¶
ExampleNewGrid demonstrates the generation of graph grids.
package main import ( "math" "time" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { pdf := gofpdf.New("P", "mm", "A4", "") pdf.SetFont("Arial", "", 12) pdf.AddPage() gr := gofpdf.NewGrid(13, 10, 187, 130) gr.TickmarksExtentX(0, 10, 4) gr.TickmarksExtentY(0, 10, 3) gr.Grid(pdf) gr = gofpdf.NewGrid(13, 154, 187, 128) gr.XLabelRotate = true gr.TickmarksExtentX(0, 1, 12) gr.XDiv = 5 gr.TickmarksContainY(0, 1.1) gr.YDiv = 20 // Replace X label formatter with month abbreviation gr.XTickStr = func(val float64, precision int) string { return time.Month(math.Mod(val, 12) + 1).String()[0:3] } gr.Grid(pdf) dot := func(x, y float64) { pdf.Circle(gr.X(x), gr.Y(y), 0.5, "F") } pts := []float64{0.39, 0.457, 0.612, 0.84, 0.998, 1.037, 1.015, 0.918, 0.772, 0.659, 0.593, 0.164} for month, val := range pts { dot(float64(month)+0.5, val) } pdf.SetDrawColor(255, 64, 64) pdf.SetAlpha(0.5, "Normal") pdf.SetLineWidth(1.2) gr.Plot(pdf, 0.5, 11.5, 50, func(x float64) float64 { // http://www.xuru.org/rt/PR.asp return 0.227 * math.Exp(-0.0373*x*x+0.471*x) }) pdf.SetAlpha(1.0, "Normal") pdf.SetXY(gr.X(0.5), gr.Y(1.35)) pdf.SetFontSize(14) pdf.Write(0, "Solar energy (MWh) per month, 2016") pdf.AddPage() gr = gofpdf.NewGrid(13, 10, 187, 274) gr.TickmarksContainX(2.3, 3.4) gr.TickmarksContainY(10.4, 56.8) gr.Grid(pdf) fileStr := example.Filename("Fpdf_Grid") err := pdf.OutputFileAndClose(fileStr) example.Summary(err, fileStr) }
Output: Successfully generated pdf/Fpdf_Grid.pdf
func (GridType) Grid ¶ added in v1.4.3
Grid generates a graph-paperlike set of grid lines on the current page.
func (GridType) Ht ¶ added in v1.4.3
Ht converts dataHt, specified in logical data units, to the unit of measure specified in New().
func (GridType) HtAbs ¶ added in v1.4.3
HtAbs returns the absolute value of dataHt, specified in logical data units, that has been converted to the unit of measure specified in New().
func (GridType) Plot ¶ added in v1.4.3
Plot plots a series of count line segments from xMin to xMax. It repeatedly calls fnc(x) to retrieve the y value associate with x. The currently selected line drawing attributes are used.
func (GridType) Pos ¶ added in v1.4.3
Pos returns the point, in page units, indicated by the relative positions xRel and yRel. These are values between 0 and 1. xRel specifies the relative position between the grid's left and right edges. yRel specifies the relative position between the grid's bottom and top edges.
func (*GridType) TickmarksContainX ¶ added in v1.4.3
TickmarksContainX sets the tickmarks to be shown by Grid() in the horizontal dimension. The argument min and max specify the minimum and maximum values to be contained within the grid. The tickmark values that are generated are suitable for general purpose graphs.
See TickmarkExtentX() for an alternative to this method to be used when the exact values of the tickmarks are to be set by the application.
func (*GridType) TickmarksContainY ¶ added in v1.4.3
TickmarksContainY sets the tickmarks to be shown by Grid() in the vertical dimension. The argument min and max specify the minimum and maximum values to be contained within the grid. The tickmark values that are generated are suitable for general purpose graphs.
See TickmarkExtentY() for an alternative to this method to be used when the exact values of the tickmarks are to be set by the application.
func (*GridType) TickmarksExtentX ¶ added in v1.4.3
TickmarksExtentX sets the tickmarks to be shown by Grid() in the horizontal dimension. count specifies number of major tickmark subdivisions to be graphed. min specifies the leftmost data value. div specifies, in data units, the extent of each major tickmark subdivision.
See TickmarkContainX() for an alternative to this method to be used when viewer-friendly tickmarks are to be determined automatically.
func (*GridType) TickmarksExtentY ¶ added in v1.4.3
TickmarksExtentY sets the tickmarks to be shown by Grid() in the vertical dimension. count specifies number of major tickmark subdivisions to be graphed. min specifies the bottommost data value. div specifies, in data units, the extent of each major tickmark subdivision.
See TickmarkContainY() for an alternative to this method to be used when viewer-friendly tickmarks are to be determined automatically.
func (GridType) Wd ¶ added in v1.4.3
Wd converts dataWd, specified in logical data units, to the unit of measure specified in New().
func (GridType) WdAbs ¶ added in v1.4.3
WdAbs returns the absolute value of dataWd, specified in logical data units, that has been converted to the unit of measure specified in New().
func (GridType) X ¶ added in v1.4.3
X converts dataX, specified in logical data units, to the X position on the current page.
func (GridType) XRange ¶ added in v1.4.3
XRange returns the minimum and maximum values for the current tickmark sequence. These correspond to the data values of the graph's left and right edges.
func (GridType) XY ¶ added in v1.4.3
XY converts dataX and dataY, specified in logical data units, to the X and Y position on the current page.
type HTMLBasicSegmentType ¶
type HTMLBasicSegmentType struct { Cat byte // 'O' open tag, 'C' close tag, 'T' text Str string // Literal text unchanged, tags are lower case Attr map[string]string // Attribute keys are lower case }
HTMLBasicSegmentType defines a segment of literal text in which the current attributes do not vary, or an open tag or a close tag.
func HTMLBasicTokenize ¶
func HTMLBasicTokenize(htmlStr string) (list []HTMLBasicSegmentType)
HTMLBasicTokenize returns a list of HTML tags and literal elements. This is done with regular expressions, so the result is only marginally better than useless.
type HTMLBasicType ¶
type HTMLBasicType struct { Link struct { ClrR, ClrG, ClrB int Bold, Italic, Underscore bool } // contains filtered or unexported fields }
HTMLBasicType is used for rendering a very basic subset of HTML. It supports only hyperlinks and bold, italic and underscore attributes. In the Link structure, the ClrR, ClrG and ClrB fields (0 through 255) define the color of hyperlinks. The Bold, Italic and Underscore values define the hyperlink style.
func (*HTMLBasicType) Write ¶
func (html *HTMLBasicType) Write(lineHt float64, htmlStr string)
Write prints text from the current position using the currently selected font. See HTMLBasicNew() to create a receiver that is associated with the PDF document instance. The text can be encoded with a basic subset of HTML that includes hyperlinks and tags for italic (I), bold (B), underscore (U) and center (CENTER) attributes. When the right margin is reached a line break occurs and text continues from the left margin. Upon method exit, the current position is left at the end of the text.
lineHt indicates the line height in the unit of measure specified in New().
type ImageInfoType ¶
type ImageInfoType struct {
// contains filtered or unexported fields
}
ImageInfoType contains size, color and other information about an image. Changes to this structure should be reflected in its GobEncode and GobDecode methods.
func (*ImageInfoType) Extent ¶
func (info *ImageInfoType) Extent() (wd, ht float64)
Extent returns the width and height of the image in the units of the Fpdf object.
func (*ImageInfoType) GobDecode ¶ added in v1.4.3
func (info *ImageInfoType) GobDecode(buf []byte) (err error)
GobDecode decodes the specified byte buffer (generated by GobEncode) into the receiving image.
func (*ImageInfoType) GobEncode ¶ added in v1.4.3
func (info *ImageInfoType) GobEncode() (buf []byte, err error)
GobEncode encodes the receiving image to a byte slice.
func (*ImageInfoType) Height ¶
func (info *ImageInfoType) Height() float64
Height returns the height of the image in the units of the Fpdf object.
func (*ImageInfoType) SetDpi ¶
func (info *ImageInfoType) SetDpi(dpi float64)
SetDpi sets the dots per inch for an image. PNG images MAY have their dpi set automatically, if the image specifies it. DPI information is not currently available automatically for JPG and GIF images, so if it's important to you, you can set it here. It defaults to 72 dpi.
func (*ImageInfoType) Width ¶
func (info *ImageInfoType) Width() float64
Width returns the width of the image in the units of the Fpdf object.
type ImageOptions ¶
ImageOptions provides a place to hang any options we want to use while parsing an image.
ImageType's possible values are (case insensitive): "JPG", "JPEG", "PNG" and "GIF". If empty, the type is inferred from the file extension.
ReadDpi defines whether to attempt to automatically read the image dpi information from the image file. Normally, this should be set to true (understanding that not all images will have this info available). However, for backwards compatibility with previous versions of the API, it defaults to false.
AllowNegativePosition can be set to true in order to prevent the default coercion of negative x values to the current x position.
type InitType ¶
type InitType struct { OrientationStr string UnitStr string SizeStr string Size SizeType FontDirStr string }
InitType is used with NewCustom() to customize an Fpdf instance. OrientationStr, UnitStr, SizeStr and FontDirStr correspond to the arguments accepted by New(). If the Wd and Ht fields of Size are each greater than zero, Size will be used to set the default page size rather than SizeStr. Wd and Ht are specified in the units of measure indicated by UnitStr.
type PageBox ¶ added in v1.4.3
PageBox defines the coordinates and extent of the various page box types
type Pdf ¶ added in v1.4.3
type Pdf interface { AddFont(familyStr, styleStr, fileStr string) AddFontFromBytes(familyStr, styleStr string, jsonFileBytes, zFileBytes []byte) AddFontFromReader(familyStr, styleStr string, r io.Reader) AddLayer(name string, visible bool) (layerID int) AddLink() int AddPage() AddPageFormat(orientationStr string, size SizeType) AddSpotColor(nameStr string, c, m, y, k byte) AliasNbPages(aliasStr string) ArcTo(x, y, rx, ry, degRotate, degStart, degEnd float64) Arc(x, y, rx, ry, degRotate, degStart, degEnd float64, styleStr string) BeginLayer(id int) Beziergon(points []PointType, styleStr string) Bookmark(txtStr string, level int, y float64) CellFormat(w, h float64, txtStr, borderStr string, ln int, alignStr string, fill bool, link int, linkStr string) Cellf(w, h float64, fmtStr string, args ...interface{}) Cell(w, h float64, txtStr string) Circle(x, y, r float64, styleStr string) ClearError() ClipCircle(x, y, r float64, outline bool) ClipEllipse(x, y, rx, ry float64, outline bool) ClipEnd() ClipPolygon(points []PointType, outline bool) ClipRect(x, y, w, h float64, outline bool) ClipRoundedRect(x, y, w, h, r float64, outline bool) ClipText(x, y float64, txtStr string, outline bool) Close() ClosePath() CreateTemplateCustom(corner PointType, size SizeType, fn func(*Tpl)) Template CreateTemplate(fn func(*Tpl)) Template CurveBezierCubicTo(cx0, cy0, cx1, cy1, x, y float64) CurveBezierCubic(x0, y0, cx0, cy0, cx1, cy1, x1, y1 float64, styleStr string) CurveCubic(x0, y0, cx0, cy0, x1, y1, cx1, cy1 float64, styleStr string) CurveTo(cx, cy, x, y float64) Curve(x0, y0, cx, cy, x1, y1 float64, styleStr string) DrawPath(styleStr string) Ellipse(x, y, rx, ry, degRotate float64, styleStr string) EndLayer() Err() bool Error() error GetAlpha() (alpha float64, blendModeStr string) GetAutoPageBreak() (auto bool, margin float64) GetCellMargin() float64 GetConversionRatio() float64 GetDrawColor() (int, int, int) GetDrawSpotColor() (name string, c, m, y, k byte) GetFillColor() (int, int, int) GetFillSpotColor() (name string, c, m, y, k byte) GetFontDesc(familyStr, styleStr string) FontDescType GetFontSize() (ptSize, unitSize float64) GetImageInfo(imageStr string) (info *ImageInfoType) GetLineWidth() float64 GetMargins() (left, top, right, bottom float64) GetPageSizeStr(sizeStr string) (size SizeType) GetPageSize() (width, height float64) GetStringWidth(s string) float64 GetTextColor() (int, int, int) GetTextSpotColor() (name string, c, m, y, k byte) GetX() float64 GetXY() (float64, float64) GetY() float64 HTMLBasicNew() (html HTMLBasicType) Image(imageNameStr string, x, y, w, h float64, flow bool, tp string, link int, linkStr string) ImageOptions(imageNameStr string, x, y, w, h float64, flow bool, options ImageOptions, link int, linkStr string) ImageTypeFromMime(mimeStr string) (tp string) LinearGradient(x, y, w, h float64, r1, g1, b1, r2, g2, b2 int, x1, y1, x2, y2 float64) LineTo(x, y float64) Line(x1, y1, x2, y2 float64) LinkString(x, y, w, h float64, linkStr string) Link(x, y, w, h float64, link int) Ln(h float64) MoveTo(x, y float64) MultiCell(w, h float64, txtStr, borderStr, alignStr string, fill bool) Ok() bool OpenLayerPane() OutputAndClose(w io.WriteCloser) error OutputFileAndClose(fileStr string) error Output(w io.Writer) error PageCount() int PageNo() int PageSize(pageNum int) (wd, ht float64, unitStr string) PointConvert(pt float64) (u float64) PointToUnitConvert(pt float64) (u float64) Polygon(points []PointType, styleStr string) RadialGradient(x, y, w, h float64, r1, g1, b1, r2, g2, b2 int, x1, y1, x2, y2, r float64) RawWriteBuf(r io.Reader) RawWriteStr(str string) Rect(x, y, w, h float64, styleStr string) RegisterAlias(alias, replacement string) RegisterImage(fileStr, tp string) (info *ImageInfoType) RegisterImageOptions(fileStr string, options ImageOptions) (info *ImageInfoType) RegisterImageOptionsReader(imgName string, options ImageOptions, r io.Reader) (info *ImageInfoType) RegisterImageReader(imgName, tp string, r io.Reader) (info *ImageInfoType) SetAcceptPageBreakFunc(fnc func() bool) SetAlpha(alpha float64, blendModeStr string) SetAuthor(authorStr string, isUTF8 bool) SetAutoPageBreak(auto bool, margin float64) SetCatalogSort(flag bool) SetCellMargin(margin float64) SetCompression(compress bool) SetCreationDate(tm time.Time) SetCreator(creatorStr string, isUTF8 bool) SetDashPattern(dashArray []float64, dashPhase float64) SetDisplayMode(zoomStr, layoutStr string) SetDrawColor(r, g, b int) SetDrawSpotColor(nameStr string, tint byte) SetError(err error) SetErrorf(fmtStr string, args ...interface{}) SetFillColor(r, g, b int) SetFillSpotColor(nameStr string, tint byte) SetFont(familyStr, styleStr string, size float64) SetFontLoader(loader FontLoader) SetFontLocation(fontDirStr string) SetFontSize(size float64) SetFontStyle(styleStr string) SetFontUnitSize(size float64) SetHeaderFunc(fnc func()) SetHeaderFuncMode(fnc func(), homeMode bool) SetHomeXY() SetJavascript(script string) SetKeywords(keywordsStr string, isUTF8 bool) SetLeftMargin(margin float64) SetLineCapStyle(styleStr string) SetLineJoinStyle(styleStr string) SetLineWidth(width float64) SetLink(link int, y float64, page int) SetMargins(left, top, right float64) SetPageBoxRec(t string, pb PageBox) SetPageBox(t string, x, y, wd, ht float64) SetPage(pageNum int) SetProtection(actionFlag byte, userPassStr, ownerPassStr string) SetRightMargin(margin float64) SetSubject(subjectStr string, isUTF8 bool) SetTextColor(r, g, b int) SetTextSpotColor(nameStr string, tint byte) SetTitle(titleStr string, isUTF8 bool) SetTopMargin(margin float64) SetUnderlineThickness(thickness float64) SetXmpMetadata(xmpStream []byte) SetX(x float64) SetXY(x, y float64) SetY(y float64) SplitLines(txt []byte, w float64) [][]byte String() string SVGBasicWrite(sb *SVGBasicType, scale float64) Text(x, y float64, txtStr string) TransformBegin() TransformEnd() TransformMirrorHorizontal(x float64) TransformMirrorLine(angle, x, y float64) TransformMirrorPoint(x, y float64) TransformMirrorVertical(y float64) TransformRotate(angle, x, y float64) TransformScale(scaleWd, scaleHt, x, y float64) TransformScaleX(scaleWd, x, y float64) TransformScaleXY(s, x, y float64) TransformScaleY(scaleHt, x, y float64) TransformSkew(angleX, angleY, x, y float64) TransformSkewX(angleX, x, y float64) TransformSkewY(angleY, x, y float64) Transform(tm TransformMatrix) TransformTranslate(tx, ty float64) TransformTranslateX(tx float64) TransformTranslateY(ty float64) UnicodeTranslatorFromDescriptor(cpStr string) (rep func(string) string) UnitToPointConvert(u float64) (pt float64) UseTemplateScaled(t Template, corner PointType, size SizeType) UseTemplate(t Template) WriteAligned(width, lineHeight float64, textStr, alignStr string) Writef(h float64, fmtStr string, args ...interface{}) Write(h float64, txtStr string) WriteLinkID(h float64, displayStr string, linkID int) WriteLinkString(h float64, displayStr, targetStr string) }
Pdf defines the interface used for various methods. It is implemented by the main FPDF instance as well as templates.
type PointType ¶
type PointType struct {
X, Y float64
}
PointType fields X and Y specify the horizontal and vertical coordinates of a point, typically used in drawing.
type RGBAType ¶ added in v1.4.3
RGBAType holds fields for red, green and blue color components (0..255) and an alpha transparency value (0..1)
type RGBType ¶ added in v1.4.3
type RGBType struct {
R, G, B int
}
RGBType holds fields for red, green and blue color components (0..255)
type SVGBasicSegmentType ¶
type SVGBasicSegmentType struct { Cmd byte // See http://www.w3.org/TR/SVG/paths.html for path command structure Arg [6]float64 }
SVGBasicSegmentType describes a single curve or position segment
type SVGBasicType ¶
type SVGBasicType struct {
Wd, Ht float64
Segments [][]SVGBasicSegmentType
}
SVGBasicType aggregates the information needed to describe a multi-segment basic vector image
func SVGBasicFileParse ¶
func SVGBasicFileParse(svgFileStr string) (sig SVGBasicType, err error)
SVGBasicFileParse parses a simple scalable vector graphics (SVG) file into a basic descriptor. The SVGBasicWrite() example demonstrates this method.
func SVGBasicParse ¶
func SVGBasicParse(buf []byte) (sig SVGBasicType, err error)
SVGBasicParse parses a simple scalable vector graphics (SVG) buffer into a descriptor. Only a small subset of the SVG standard, in particular the path information generated by jSignature, is supported. The returned path data includes only the commands 'M' (absolute moveto: x, y), 'L' (absolute lineto: x, y), 'C' (absolute cubic Bézier curve: cx0, cy0, cx1, cy1, x1,y1), 'Q' (absolute quadratic Bézier curve: x0, y0, x1, y1) and 'Z' (closepath).
type SizeType ¶
type SizeType struct {
Wd, Ht float64
}
SizeType fields Wd and Ht specify the horizontal and vertical extents of a document element such as a page.
func (*SizeType) Orientation ¶
Orientation returns the orientation of a given size: "P" for portrait, "L" for landscape
func (*SizeType) ScaleToHeight ¶
ScaleToHeight adjusts the width of a size to match the given height
func (*SizeType) ScaleToWidth ¶
ScaleToWidth adjusts the height of a size to match the given width
type StateType ¶ added in v1.4.3
type StateType struct {
// contains filtered or unexported fields
}
StateType holds various commonly used drawing values for convenient retrieval (StateGet()) and restore (Put) methods.
type Template ¶
type Template interface { ID() string Size() (PointType, SizeType) Bytes() []byte Images() map[string]*ImageInfoType Templates() []Template NumPages() int FromPage(int) (Template, error) FromPages() []Template Serialize() ([]byte, error) gob.GobDecoder gob.GobEncoder }
Template is an object that can be written to, then used and re-used any number of times within a document.
func CreateTemplate ¶
func CreateTemplate(corner PointType, size SizeType, unitStr, fontDirStr string, fn func(*Tpl)) Template
CreateTemplate creates a template that is not attached to any document.
This function is deprecated; it incorrectly assumes that a page with a width smaller than its height is oriented in portrait mode, otherwise it assumes landscape mode. This causes problems when placing the template in a master document where this condition does not apply. CreateTpl() is a similar function that lets you specify the orientation to avoid this problem.
func CreateTpl ¶ added in v1.4.3
func CreateTpl(corner PointType, size SizeType, orientationStr, unitStr, fontDirStr string, fn func(*Tpl)) Template
CreateTpl creates a template not attached to any document
func DeserializeTemplate ¶ added in v1.4.3
DeserializeTemplate creaties a template from a previously serialized template
type TickFormatFncType ¶ added in v1.4.3
TickFormatFncType defines a callback for label drawing.
type Tpl ¶
type Tpl struct {
Fpdf
}
Tpl is an Fpdf used for writing a template. It has most of the facilities of an Fpdf, but cannot add more pages. Tpl is used directly only during the limited time a template is writable.
type TransformMatrix ¶
type TransformMatrix struct {
A, B, C, D, E, F float64
}
TransformMatrix is used for generalized transformations of text, drawings and images.
type TtfType ¶
type TtfType struct { Embeddable bool UnitsPerEm uint16 PostScriptName string Bold bool ItalicAngle int16 IsFixedPitch bool TypoAscender int16 TypoDescender int16 UnderlinePosition int16 UnderlineThickness int16 Xmin, Ymin, Xmax, Ymax int16 CapHeight int16 Widths []uint16 Chars map[uint16]uint16 }
TtfType contains metrics of a TrueType font.
func TtfParse ¶
TtfParse extracts various metrics from a TrueType font file.
Example ¶
package main import ( "fmt" "bitbucket.org/thoomycz/gofpdf" "bitbucket.org/thoomycz/gofpdf/internal/example" ) func main() { ttf, err := gofpdf.TtfParse(example.FontDir() + "/calligra.ttf") if err == nil { fmt.Printf("Postscript name: %s\n", ttf.PostScriptName) fmt.Printf("unitsPerEm: %8d\n", ttf.UnitsPerEm) fmt.Printf("Xmin: %8d\n", ttf.Xmin) fmt.Printf("Ymin: %8d\n", ttf.Ymin) fmt.Printf("Xmax: %8d\n", ttf.Xmax) fmt.Printf("Ymax: %8d\n", ttf.Ymax) } else { fmt.Printf("%s\n", err) } }
Output: Postscript name: CalligrapherRegular unitsPerEm: 1000 Xmin: -173 Ymin: -234 Xmax: 1328 Ymax: 899
Source Files
¶
Directories
¶
Path | Synopsis |
---|---|
contrib
|
|
barcode
Package barcode provides helper methods for adding barcodes of different types to your pdf document.
|
Package barcode provides helper methods for adding barcodes of different types to your pdf document. |
gofpdi
Package gofpdi wraps the gofpdi PDF library to import existing PDFs as templates.
|
Package gofpdi wraps the gofpdi PDF library to import existing PDFs as templates. |
tiff
Package tiff allows standard (LZW-compressed) TIFF images to be used in documents generated with gofpdf.
|
Package tiff allows standard (LZW-compressed) TIFF images to be used in documents generated with gofpdf. |
internal
|
|
example
Package example provides some helper routines for the test packages of gofpdf and its various contributed packages located beneath the contrib directory.
|
Package example provides some helper routines for the test packages of gofpdf and its various contributed packages located beneath the contrib directory. |
Command makefont generates a font definition file.
|
Command makefont generates a font definition file. |