summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKurt <kurt.w.jung@gmail.com>2019-07-20 09:58:15 -0400
committerKurt <kurt.w.jung@gmail.com>2019-07-20 09:58:15 -0400
commitacaf282a0e3bde4d968e13541d61a0c8f8db42ac (patch)
tree02b1aa692ebd2ccbca092e2ec67f0ea6e2926896
parent5a3837eac46daca22df96b6b65a184cafef7e03e (diff)
parente914c59514da0d291277444b0de1b572fb9544d9 (diff)
Merge branch 'ImageOptionsReader' of https://github.com/estenssoros/gofpdf into estenssoros-ImageOptionsReader
-rw-r--r--fpdf.go67
-rw-r--r--fpdf_test.go23
2 files changed, 90 insertions, 0 deletions
diff --git a/fpdf.go b/fpdf.go
index ca48fb5..319e89d 100644
--- a/fpdf.go
+++ b/fpdf.go
@@ -2986,6 +2986,73 @@ func (f *Fpdf) ImageOptions(imageNameStr string, x, y, w, h float64, flow bool,
return
}
+// ImageOptionsReader registers an image, reading it from Reader r, and 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.
+//
+// r is an io.Reader that implements the Read() function
+//
+// 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.
+func (f *Fpdf) ImageOptionsReader(imageNameStr string, r io.Reader, x, y, w, h float64, flow bool, options ImageOptions, link int, linkStr string) {
+ if f.err != nil {
+ return
+ }
+
+ var info *ImageInfoType
+
+ i, ok := f.images[imageNameStr]
+ if ok {
+ info = i
+ } else {
+ if options.ImageType == "" {
+ pos := strings.LastIndex(imageNameStr, ".")
+ if pos < 0 {
+ f.err = fmt.Errorf("image file has no extension and no type was specified: %s", imageNameStr)
+ return
+ }
+ options.ImageType = imageNameStr[pos+1:]
+ }
+ info = f.RegisterImageOptionsReader(imageNameStr, options, r)
+ if f.err != nil {
+ return
+ }
+ }
+ f.imageOut(info, x, y, w, h, options.AllowNegativePosition, flow, link, linkStr)
+ return
+}
+
// RegisterImageReader registers an image, reading it from Reader r, adding it
// to the PDF file but not adding it to the page.
//
diff --git a/fpdf_test.go b/fpdf_test.go
index 7ee0831..5ef88aa 100644
--- a/fpdf_test.go
+++ b/fpdf_test.go
@@ -858,6 +858,29 @@ func ExampleFpdf_ImageOptions() {
// Successfully generated pdf/Fpdf_ImageOptions.pdf
}
+// ImageOption struct can be used to affect horizontal image placement.
+func ExampleFpdf_ImageOptionsReader() {
+ var opt gofpdf.ImageOptions
+
+ pdf := gofpdf.New("P", "mm", "A4", "")
+ pdf.AddPage()
+ pdf.SetFont("Arial", "", 11)
+ pdf.SetX(60)
+ opt.ImageType = "png"
+ bytes, err := ioutil.ReadAll(example.ImageFile("logo.png"))
+ if err!=nil{
+ t.Fatal(err)
+ }
+ pdf.ImageOptionsReader(example.ImageFile("logo.png"), bytes.NewReader(bytes),-10, 10, 30, 0, false, opt, 0, "")
+ opt.AllowNegativePosition = true
+ pdf.ImageOptionsReader(example.ImageFile("logo.png"),bytes.NewReader(bytes), -10, 50, 30, 0, false, opt, 0, "")
+ fileStr := example.Filename("Fpdf_ImageOptionsReader")
+ err := pdf.OutputFileAndClose(fileStr)
+ example.Summary(err, fileStr)
+ // Output:
+ // Successfully generated pdf/Fpdf_ImageOptionsReader.pdf
+}
+
// This examples demonstrates Landscape mode with images.
func ExampleFpdf_SetAcceptPageBreakFunc() {
var y0 float64