v0.0.453

exerr/data.go

@@ -69,6 +69,9 @@ var (
 	TypeUnauthorized = NewType("UNAUTHORIZED", langext.Ptr(401))
 	TypeAuthFailed   = NewType("AUTH_FAILED", langext.Ptr(401))
 
+	TypeInvalidImage    = NewType("IMAGEEXT_INVALID_IMAGE", langext.Ptr(400))
+	TypeInvalidMimeType = NewType("IMAGEEXT_INVALID_MIMETYPE", langext.Ptr(400))
+
 	// other values come from the downstream application that uses goext
 )
 

go.mod

@@ -14,7 +14,11 @@ require (
 	golang.org/x/term v0.20.0
 )
 
-require golang.org/x/sync v0.7.0
+require (
+	github.com/disintegration/imaging v1.6.2
+	github.com/jung-kurt/gofpdf v1.16.2
+	golang.org/x/sync v0.7.0
+)
 
 require (
 	github.com/bytedance/sonic v1.11.6 // indirect
@@ -50,6 +54,7 @@ require (
 	github.com/xdg-go/stringprep v1.0.4 // indirect
 	github.com/youmark/pkcs8 v0.0.0-20240424034433-3c2c7870ae76 // indirect
 	golang.org/x/arch v0.8.0 // indirect
+	golang.org/x/image v0.16.0 // indirect
 	golang.org/x/net v0.25.0 // indirect
 	golang.org/x/text v0.15.0 // indirect
 	google.golang.org/protobuf v1.34.1 // indirect

go.sum

@@ -1,4 +1,5 @@
 filippo.io/edwards25519 v1.1.0/go.mod h1:BxyFTGdWcka3PhytdK4V28tE5sGfRvvvRV7EaN4VDT4=
+github.com/boombuler/barcode v1.0.0/go.mod h1:paBWMcWSl3LHKBqUq+rly7CNSldXjb2rDl3JlRe0mD8=
 github.com/bytedance/sonic v1.5.0/go.mod h1:ED5hyg4y6t3/9Ku1R6dU/4KyJ48DZ4jPhfY1O2AihPM=
 github.com/bytedance/sonic v1.10.0-rc/go.mod h1:ElCzW+ufi8qKqNW0FY314xriJhyJhuoJ3gFZdAHF7NM=
 github.com/bytedance/sonic v1.10.2 h1:GQebETVBxYB7JGWJtLBi07OVzWwt+8dWA00gEVW2ZFE=
@@ -42,6 +43,8 @@ github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSV
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/disintegration/imaging v1.6.2 h1:w1LecBlG2Lnp8B3jk5zSuNqd7b4DXhcjwek1ei82L+c=
+github.com/disintegration/imaging v1.6.2/go.mod h1:44/5580QXChDfwIclfc/PCwrr44amcmDAg8hxG0Ewe4=
 github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY=
 github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto=
 github.com/gabriel-vasile/mimetype v1.4.3 h1:in2uUcidCuFcDKtdcBxlR0rJ1+fsokWf+uqxgUFjbI0=
@@ -95,6 +98,9 @@ github.com/jmoiron/sqlx v1.4.0 h1:1PLqN7S1UYp5t4SrVVnt4nUVNemrDAtxlulVe+Qgm3o=
 github.com/jmoiron/sqlx v1.4.0/go.mod h1:ZrZ7UsYB/weZdl2Bxg6jCRO9c3YHl8r3ahlKmRT4JLY=
 github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
 github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
+github.com/jung-kurt/gofpdf v1.0.0/go.mod h1:7Id9E/uU8ce6rXgefFLlgrJj/GYY22cpxn+r32jIOes=
+github.com/jung-kurt/gofpdf v1.16.2 h1:jgbatWHfRlPYiK85qgevsZTHviWXKwB1TTiKdz5PtRc=
+github.com/jung-kurt/gofpdf v1.16.2/go.mod h1:1hl7y57EsiPAkLbOwzpzqgx1A30nQCk/YmFV8S2vmK0=
 github.com/klauspost/compress v1.13.6/go.mod h1:/3/Vjq9QcHkK5uEr5lBEmyoZ1iFhe47etQ6QUkpK6sk=
 github.com/klauspost/compress v1.17.4 h1:Ej5ixsIri7BrIjBkRZLTo6ghwrEtHFk7ijlczPW4fZ4=
 github.com/klauspost/compress v1.17.4/go.mod h1:/dCuZOvVtNoHsyb+cuJD3itjs3NbnF6KH9zAO4BDxPM=
@@ -143,6 +149,8 @@ github.com/pelletier/go-toml/v2 v2.2.1 h1:9TA9+T8+8CUCO2+WYnDLCgrYi9+omqKXyjDtos
 github.com/pelletier/go-toml/v2 v2.2.1/go.mod h1:1t835xjRzz80PqgE6HHgN2JOsmgYu/h4qDAS4n929Rs=
 github.com/pelletier/go-toml/v2 v2.2.2 h1:aYUidT7k73Pcl9nb2gScu7NSrKCSHIDE89b3+6Wq+LM=
 github.com/pelletier/go-toml/v2 v2.2.2/go.mod h1:1t835xjRzz80PqgE6HHgN2JOsmgYu/h4qDAS4n929Rs=
+github.com/phpdave11/gofpdi v1.0.7/go.mod h1:vBmVV0Do6hSBHC8uKUQ71JGW+ZGQq74llk/7bXwjDoI=
+github.com/pkg/errors v0.8.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
 github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
@@ -154,10 +162,12 @@ github.com/rs/zerolog v1.31.0 h1:FcTR3NnLWW+NnTwwhFWiJSZr4ECLpqCm6QsEnyvbV4A=
 github.com/rs/zerolog v1.31.0/go.mod h1:/7mN4D5sKwJLZQ2b/znpjC3/GQWY/xaDXUM0kKWRHss=
 github.com/rs/zerolog v1.32.0 h1:keLypqrlIjaFsbmJOBdB/qvyF8KEtCWHwobLp5l/mQ0=
 github.com/rs/zerolog v1.32.0/go.mod h1:/7mN4D5sKwJLZQ2b/znpjC3/GQWY/xaDXUM0kKWRHss=
+github.com/ruudk/golang-pdf417 v0.0.0-20181029194003-1af4ab5afa58/go.mod h1:6lfFZQK844Gfx8o5WFuvpxWRwnSoipWe/p622j1v06w=
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
 github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
 github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
+github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=
 github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
 github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
@@ -213,6 +223,11 @@ golang.org/x/crypto v0.22.0 h1:g1v0xeRhjcugydODzvb3mEM9SQ0HGp9s/nh3COQ/C30=
 golang.org/x/crypto v0.22.0/go.mod h1:vr6Su+7cTlO45qkww3VDJlzDn0ctJvRgYbC2NvXHt+M=
 golang.org/x/crypto v0.23.0 h1:dIJU/v2J8Mdglj/8rJ6UUOM3Zc9zLZxVZwwxMooUSAI=
 golang.org/x/crypto v0.23.0/go.mod h1:CKFgDieR+mRhux2Lsu27y0fO304Db0wZe70UKqHu0v8=
+golang.org/x/image v0.0.0-20190910094157-69e4b8554b2a/go.mod h1:FeLwcggjj3mMvU+oOTbSwawSJRM1uh48EjtB4UJZlP0=
+golang.org/x/image v0.0.0-20191009234506-e7c1f5e7dbb8 h1:hVwzHzIUGRjiF7EcUjqNxk3NCfkPxbDKRdnNE1Rpg0U=
+golang.org/x/image v0.0.0-20191009234506-e7c1f5e7dbb8/go.mod h1:FeLwcggjj3mMvU+oOTbSwawSJRM1uh48EjtB4UJZlP0=
+golang.org/x/image v0.16.0 h1:9kloLAKhUufZhA12l5fwnx2NZW39/we1UhBesW433jw=
+golang.org/x/image v0.16.0/go.mod h1:ugSZItdV4nOxyqp56HmXwH0Ry0nBCpjnZdpDaIHdoPs=
 golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4=
 golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
 golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=

goextVersion.go

@@ -1,5 +1,5 @@
 package goext
 
-const GoextVersion = "0.0.448"
+const GoextVersion = "0.0.453"
 
-const GoextVersionTimestamp = "2024-05-12T16:45:45+0200"
+const GoextVersionTimestamp = "2024-05-14T14:57:10+0200"

imageext/enums.go

@@ -0,0 +1,3 @@
+package imageext
+
+//go:generate go run ../_gen/enum-generate.go -- enums_gen.go

imageext/enums_gen.go

@@ -0,0 +1,216 @@
+// Code generated by enum-generate.go DO NOT EDIT.
+
+package imageext
+
+import "gogs.mikescher.com/BlackForestBytes/goext/langext"
+import "gogs.mikescher.com/BlackForestBytes/goext/enums"
+
+const ChecksumEnumGenerator = "1da5383c33ee442fd0b899369053f66bdc85bed2dbf906949d3edfeedfe13340" // GoExtVersion: 0.0.449
+
+// ================================ ImageFit ================================
+//
+// File:       image.go
+// StringEnum: true
+// DescrEnum:  false
+// DataEnum:   false
+//
+
+var __ImageFitValues = []ImageFit{
+	ImageFitStretch,
+	ImageFitCover,
+	ImageFitContainCenter,
+	ImageFitContainTopLeft,
+	ImageFitContainTopRight,
+	ImageFitContainBottomLeft,
+	ImageFitContainBottomRight,
+}
+
+var __ImageFitVarnames = map[ImageFit]string{
+	ImageFitStretch:            "ImageFitStretch",
+	ImageFitCover:              "ImageFitCover",
+	ImageFitContainCenter:      "ImageFitContainCenter",
+	ImageFitContainTopLeft:     "ImageFitContainTopLeft",
+	ImageFitContainTopRight:    "ImageFitContainTopRight",
+	ImageFitContainBottomLeft:  "ImageFitContainBottomLeft",
+	ImageFitContainBottomRight: "ImageFitContainBottomRight",
+}
+
+func (e ImageFit) Valid() bool {
+	return langext.InArray(e, __ImageFitValues)
+}
+
+func (e ImageFit) Values() []ImageFit {
+	return __ImageFitValues
+}
+
+func (e ImageFit) ValuesAny() []any {
+	return langext.ArrCastToAny(__ImageFitValues)
+}
+
+func (e ImageFit) ValuesMeta() []enums.EnumMetaValue {
+	return ImageFitValuesMeta()
+}
+
+func (e ImageFit) String() string {
+	return string(e)
+}
+
+func (e ImageFit) VarName() string {
+	if d, ok := __ImageFitVarnames[e]; ok {
+		return d
+	}
+	return ""
+}
+
+func (e ImageFit) TypeName() string {
+	return "ImageFit"
+}
+
+func (e ImageFit) PackageName() string {
+	return "media"
+}
+
+func (e ImageFit) Meta() enums.EnumMetaValue {
+	return enums.EnumMetaValue{VarName: e.VarName(), Value: e, Description: nil}
+}
+
+func ParseImageFit(vv string) (ImageFit, bool) {
+	for _, ev := range __ImageFitValues {
+		if string(ev) == vv {
+			return ev, true
+		}
+	}
+	return "", false
+}
+
+func ImageFitValues() []ImageFit {
+	return __ImageFitValues
+}
+
+func ImageFitValuesMeta() []enums.EnumMetaValue {
+	return []enums.EnumMetaValue{
+		ImageFitStretch.Meta(),
+		ImageFitCover.Meta(),
+		ImageFitContainCenter.Meta(),
+		ImageFitContainTopLeft.Meta(),
+		ImageFitContainTopRight.Meta(),
+		ImageFitContainBottomLeft.Meta(),
+		ImageFitContainBottomRight.Meta(),
+	}
+}
+
+// ================================ ImageCompresson ================================
+//
+// File:       image.go
+// StringEnum: true
+// DescrEnum:  false
+// DataEnum:   false
+//
+
+var __ImageCompressonValues = []ImageCompresson{
+	CompressionPNGNone,
+	CompressionPNGSpeed,
+	CompressionPNGBest,
+	CompressionJPEG100,
+	CompressionJPEG90,
+	CompressionJPEG80,
+	CompressionJPEG70,
+	CompressionJPEG60,
+	CompressionJPEG50,
+	CompressionJPEG25,
+	CompressionJPEG10,
+	CompressionJPEG1,
+}
+
+var __ImageCompressonVarnames = map[ImageCompresson]string{
+	CompressionPNGNone:  "CompressionPNGNone",
+	CompressionPNGSpeed: "CompressionPNGSpeed",
+	CompressionPNGBest:  "CompressionPNGBest",
+	CompressionJPEG100:  "CompressionJPEG100",
+	CompressionJPEG90:   "CompressionJPEG90",
+	CompressionJPEG80:   "CompressionJPEG80",
+	CompressionJPEG70:   "CompressionJPEG70",
+	CompressionJPEG60:   "CompressionJPEG60",
+	CompressionJPEG50:   "CompressionJPEG50",
+	CompressionJPEG25:   "CompressionJPEG25",
+	CompressionJPEG10:   "CompressionJPEG10",
+	CompressionJPEG1:    "CompressionJPEG1",
+}
+
+func (e ImageCompresson) Valid() bool {
+	return langext.InArray(e, __ImageCompressonValues)
+}
+
+func (e ImageCompresson) Values() []ImageCompresson {
+	return __ImageCompressonValues
+}
+
+func (e ImageCompresson) ValuesAny() []any {
+	return langext.ArrCastToAny(__ImageCompressonValues)
+}
+
+func (e ImageCompresson) ValuesMeta() []enums.EnumMetaValue {
+	return ImageCompressonValuesMeta()
+}
+
+func (e ImageCompresson) String() string {
+	return string(e)
+}
+
+func (e ImageCompresson) VarName() string {
+	if d, ok := __ImageCompressonVarnames[e]; ok {
+		return d
+	}
+	return ""
+}
+
+func (e ImageCompresson) TypeName() string {
+	return "ImageCompresson"
+}
+
+func (e ImageCompresson) PackageName() string {
+	return "media"
+}
+
+func (e ImageCompresson) Meta() enums.EnumMetaValue {
+	return enums.EnumMetaValue{VarName: e.VarName(), Value: e, Description: nil}
+}
+
+func ParseImageCompresson(vv string) (ImageCompresson, bool) {
+	for _, ev := range __ImageCompressonValues {
+		if string(ev) == vv {
+			return ev, true
+		}
+	}
+	return "", false
+}
+
+func ImageCompressonValues() []ImageCompresson {
+	return __ImageCompressonValues
+}
+
+func ImageCompressonValuesMeta() []enums.EnumMetaValue {
+	return []enums.EnumMetaValue{
+		CompressionPNGNone.Meta(),
+		CompressionPNGSpeed.Meta(),
+		CompressionPNGBest.Meta(),
+		CompressionJPEG100.Meta(),
+		CompressionJPEG90.Meta(),
+		CompressionJPEG80.Meta(),
+		CompressionJPEG70.Meta(),
+		CompressionJPEG60.Meta(),
+		CompressionJPEG50.Meta(),
+		CompressionJPEG25.Meta(),
+		CompressionJPEG10.Meta(),
+		CompressionJPEG1.Meta(),
+	}
+}
+
+// ================================ ================= ================================
+
+func AllPackageEnums() []enums.Enum {
+	return []enums.Enum{
+		ImageFitStretch,    // ImageFit
+		CompressionPNGNone, // ImageCompresson
+	}
+}

imageext/image.go

@@ -0,0 +1,317 @@
+package imageext
+
+import (
+	"bytes"
+	"fmt"
+	"github.com/disintegration/imaging"
+	"gogs.mikescher.com/BlackForestBytes/goext/exerr"
+	"gogs.mikescher.com/BlackForestBytes/goext/mathext"
+	"image"
+	"image/color"
+	"image/draw"
+	"image/jpeg"
+	"image/png"
+	"io"
+	"math"
+)
+
+type ImageFit string //@enum:type
+
+const (
+	ImageFitStretch            ImageFit = "STRETCH"
+	ImageFitCover              ImageFit = "COVER"
+	ImageFitContainCenter      ImageFit = "CONTAIN_CENTER"
+	ImageFitContainTopLeft     ImageFit = "CONTAIN_TOPLEFT"
+	ImageFitContainTopRight    ImageFit = "CONTAIN_TOPRIGHT"
+	ImageFitContainBottomLeft  ImageFit = "CONTAIN_BOTTOMLEFT"
+	ImageFitContainBottomRight ImageFit = "CONTAIN_BOTTOMRIGHT"
+)
+
+type ImageCrop struct { // all crop values are percentages!
+
+	CropX      float64 `bson:"cropX"      json:"cropX"`
+	CropY      float64 `bson:"cropY"      json:"cropY"`
+	CropWidth  float64 `bson:"cropWidth"  json:"cropWidth"`
+	CropHeight float64 `bson:"cropHeight" json:"cropHeight"`
+}
+
+type ImageCompresson string //@enum:type
+
+const (
+	CompressionPNGNone  ImageCompresson = "PNG_NONE"
+	CompressionPNGSpeed ImageCompresson = "PNG_SPEED"
+	CompressionPNGBest  ImageCompresson = "PNG_BEST"
+	CompressionJPEG100  ImageCompresson = "JPEG_100"
+	CompressionJPEG90   ImageCompresson = "JPEG_090"
+	CompressionJPEG80   ImageCompresson = "JPEG_080"
+	CompressionJPEG70   ImageCompresson = "JPEG_070"
+	CompressionJPEG60   ImageCompresson = "JPEG_060"
+	CompressionJPEG50   ImageCompresson = "JPEG_050"
+	CompressionJPEG25   ImageCompresson = "JPEG_025"
+	CompressionJPEG10   ImageCompresson = "JPEG_010"
+	CompressionJPEG1    ImageCompresson = "JPEG_001"
+)
+
+func CropImage(img image.Image, px float64, py float64, pw float64, ph float64) (image.Image, error) {
+
+	type subImager interface {
+		SubImage(r image.Rectangle) image.Image
+	}
+
+	x := int(float64(img.Bounds().Dx()) * px)
+	y := int(float64(img.Bounds().Dy()) * py)
+	w := int(float64(img.Bounds().Dx()) * pw)
+	h := int(float64(img.Bounds().Dy()) * ph)
+
+	if simg, ok := img.(subImager); ok {
+
+		return simg.SubImage(image.Rect(x, y, x+w, y+h)), nil
+
+	} else {
+
+		bfr1 := bytes.Buffer{}
+		err := png.Encode(&bfr1, img)
+		if err != nil {
+			return nil, exerr.Wrap(err, "").Build()
+		}
+		imgPNG, err := png.Decode(&bfr1)
+		if err != nil {
+			return nil, exerr.Wrap(err, "").Build()
+		}
+
+		return imgPNG.(subImager).SubImage(image.Rect(x, y, w+w, y+h)), nil
+	}
+}
+
+func EncodeImage(img image.Image, compression ImageCompresson) (bytes.Buffer, string, error) {
+	var err error
+
+	bfr := bytes.Buffer{}
+
+	switch compression {
+	case CompressionPNGNone:
+		enc := &png.Encoder{CompressionLevel: png.NoCompression}
+		err = enc.Encode(&bfr, img)
+		if err != nil {
+			return bytes.Buffer{}, "", exerr.Wrap(err, "").Build()
+		}
+		return bfr, "image/png", nil
+	case CompressionPNGSpeed:
+		enc := &png.Encoder{CompressionLevel: png.BestSpeed}
+		err = enc.Encode(&bfr, img)
+		if err != nil {
+			return bytes.Buffer{}, "", exerr.Wrap(err, "").Build()
+		}
+		return bfr, "image/png", nil
+	case CompressionPNGBest:
+		enc := &png.Encoder{CompressionLevel: png.BestCompression}
+		err = enc.Encode(&bfr, img)
+		if err != nil {
+			return bytes.Buffer{}, "", exerr.Wrap(err, "").Build()
+		}
+		return bfr, "image/png", nil
+	case CompressionJPEG100:
+		err = jpeg.Encode(&bfr, img, &jpeg.Options{Quality: 100})
+		if err != nil {
+			return bytes.Buffer{}, "", exerr.Wrap(err, "").Build()
+		}
+		return bfr, "image/jpeg", nil
+	case CompressionJPEG90:
+		err = jpeg.Encode(&bfr, img, &jpeg.Options{Quality: 90})
+		if err != nil {
+			return bytes.Buffer{}, "", exerr.Wrap(err, "").Build()
+		}
+		return bfr, "image/jpeg", nil
+	case CompressionJPEG80:
+		err = jpeg.Encode(&bfr, img, &jpeg.Options{Quality: 80})
+		if err != nil {
+			return bytes.Buffer{}, "", exerr.Wrap(err, "").Build()
+		}
+		return bfr, "image/jpeg", nil
+	case CompressionJPEG70:
+		err = jpeg.Encode(&bfr, img, &jpeg.Options{Quality: 70})
+		if err != nil {
+			return bytes.Buffer{}, "", exerr.Wrap(err, "").Build()
+		}
+		return bfr, "image/jpeg", nil
+	case CompressionJPEG60:
+		err = jpeg.Encode(&bfr, img, &jpeg.Options{Quality: 60})
+		if err != nil {
+			return bytes.Buffer{}, "", exerr.Wrap(err, "").Build()
+		}
+		return bfr, "image/jpeg", nil
+	case CompressionJPEG50:
+		err = jpeg.Encode(&bfr, img, &jpeg.Options{Quality: 50})
+		if err != nil {
+			return bytes.Buffer{}, "", exerr.Wrap(err, "").Build()
+		}
+		return bfr, "image/jpeg", nil
+	case CompressionJPEG25:
+		err = jpeg.Encode(&bfr, img, &jpeg.Options{Quality: 25})
+		if err != nil {
+			return bytes.Buffer{}, "", exerr.Wrap(err, "").Build()
+		}
+		return bfr, "image/jpeg", nil
+	case CompressionJPEG10:
+		err = jpeg.Encode(&bfr, img, &jpeg.Options{Quality: 10})
+		if err != nil {
+			return bytes.Buffer{}, "", exerr.Wrap(err, "").Build()
+		}
+		return bfr, "image/jpeg", nil
+	case CompressionJPEG1:
+		err = jpeg.Encode(&bfr, img, &jpeg.Options{Quality: 1})
+		if err != nil {
+			return bytes.Buffer{}, "", exerr.Wrap(err, "").Build()
+		}
+		return bfr, "image/jpeg", nil
+	default:
+		return bytes.Buffer{}, "", exerr.New(exerr.TypeInternal, "unknown compression method: "+compression.String()).Build()
+	}
+}
+
+func ObjectFitImage(img image.Image, bbw float64, bbh float64, fit ImageFit, fillColor color.Color) (image.Image, error) {
+
+	iw := img.Bounds().Size().X
+	ih := img.Bounds().Size().Y
+
+	// [iw, ih]   is the size of the image
+	// [bbw, bbh] is the target bounding box,
+	//             - it specifies the target ratio
+	//             - and the maximal target resolution
+
+	facW := float64(iw) / bbw
+	facH := float64(ih) / bbh
+
+	// facW is the ratio between iw and bbw
+	//  - it is the factor by which the bounding box must be multiplied to reach the image size (in the x-axis)
+	//
+	// (same is true for facH, but for the height and y-axis)
+
+	if fit == ImageFitCover {
+
+		// image-fit:cover completely fills the target-bounding-box, it potentially cuts parts of the image away
+
+		// we use the smaller (!) value of facW and facH, because we want to have the smallest possible destination rect (due to file size)
+		// and because the image is made to completely fill the bounding-box, the smaller factor (= teh dimension the image is stretched more) is relevant
+
+		// but we cap `fac` at 1 (can be larger than 1)
+		// a value >1 would mean the final image resolution is biger than the bounding box, which we do not want.
+
+		// if the initial image (iw, ih) is already bigger than the bounding box (bbw, bbh), facW and facH are always >1 and fac will be 1
+		// which means we will simply use the bounding box as destination rect (and scale the image down)
+
+		fac := mathext.Clamp(mathext.Min(facW, facH), 0.0, 1.0)
+
+		// we scale the bounding box by fac (both dimension the same amount, to keep the bounding-box ratio)
+
+		w := int(math.Round(bbw * fac))
+		h := int(math.Round(bbh * fac))
+
+		img = imaging.Fill(img, w, h, imaging.Center, imaging.Lanczos)
+
+		newImg := image.NewRGBA(image.Rect(0, 0, w, h))
+
+		draw.Draw(newImg, newImg.Bounds(), &image.Uniform{C: fillColor}, image.Pt(0, 0), draw.Src)
+		draw.Draw(newImg, newImg.Bounds(), img, image.Pt(0, 0), draw.Over)
+
+		return newImg, nil
+	}
+
+	if fit == ImageFitContainCenter || fit == ImageFitContainTopLeft || fit == ImageFitContainTopRight || fit == ImageFitContainBottomLeft || fit == ImageFitContainBottomRight {
+
+		// image-fit:cover fills the target-bounding-box with the image, there is potentially empty-space, it potentially cuts parts of the image away
+
+		// we use the bigger (!) value of facW and facH,
+		// because the image is made to fit the bounding-box, the bigger factor (= the dimension the image is stretched less) is relevant
+
+		// but we cap `fac` at 1 (can be larger than 1)
+		// a value >1 would mean the final image resolution is biger than the bounding box, which we do not want.
+
+		// if the initial image (iw, ih) is already bigger than the bounding box (bbw, bbh), facW and facH are always >1 and fac will be 1
+		// which means we will simply use the bounding box as destination rect (and scale the image down)
+
+		facOut := mathext.Clamp(mathext.Max(facW, facH), 0.0, 1.0)
+
+		// we scale the bounding box by fac (both dimension the same amount, to keep the bounding-box ratio)
+
+		ow := int(math.Round(bbw * facOut))
+		oh := int(math.Round(bbh * facOut))
+
+		facScale := mathext.Min(float64(ow)/float64(iw), float64(oh)/float64(ih))
+
+		dw := int(math.Round(float64(iw) * facScale))
+		dh := int(math.Round(float64(ih) * facScale))
+
+		img = imaging.Resize(img, dw, dh, imaging.Lanczos)
+
+		var destBounds image.Rectangle
+		if fit == ImageFitContainCenter {
+			destBounds = image.Rect((ow-dw)/2, (oh-dh)/2, (ow-dw)/2+dw, (oh-dh)/2+dh)
+		} else if fit == ImageFitContainTopLeft {
+			destBounds = image.Rect(0, 0, iw, dh)
+		} else if fit == ImageFitContainTopRight {
+			destBounds = image.Rect(ow-iw, 0, ow, dh)
+		} else if fit == ImageFitContainBottomLeft {
+			destBounds = image.Rect(0, oh-dh, iw, oh)
+		} else if fit == ImageFitContainBottomRight {
+			destBounds = image.Rect(ow-dw, oh-dh, ow, oh)
+		}
+
+		newImg := image.NewRGBA(image.Rect(0, 0, ow, oh))
+
+		draw.Draw(newImg, newImg.Bounds(), &image.Uniform{C: fillColor}, image.Pt(0, 0), draw.Src)
+		draw.Draw(newImg, destBounds, img, image.Pt(0, 0), draw.Over)
+
+		return newImg, nil
+	}
+
+	if fit == ImageFitStretch {
+
+		// image-fit:stretch simply stretches the image to the bounding box
+
+		// we use the bigger value of [facW;facH], to (potentially) scale the bounding box down before applying it
+		// theoretically we could directly use [bbw, bbh] in the call to imaging.Resize,
+		// but if the image is (a lot) smaller than the bouding box it is useful to scale it down to reduce final pdf filesize
+
+		// we also cap fac at 1, because we never want the final rect to be bigger than the inputted bounding box (see comments at start of method)
+
+		fac := mathext.Clamp(mathext.Max(facW, facH), 0.0, 1.0)
+
+		// we scale the bounding box by fac (both dimension the same amount, to keep the bounding-box ratio)
+
+		w := int(math.Round(bbw * fac))
+		h := int(math.Round(bbh * fac))
+
+		img = imaging.Resize(img, w, h, imaging.Lanczos)
+
+		newImg := image.NewRGBA(image.Rect(0, 0, w, h))
+
+		draw.Draw(newImg, newImg.Bounds(), &image.Uniform{C: fillColor}, image.Pt(0, 0), draw.Src)
+		draw.Draw(newImg, newImg.Bounds(), img, image.Pt(0, 0), draw.Over)
+
+		return newImg, nil
+	}
+
+	return nil, exerr.New(exerr.TypeInternal, fmt.Sprintf("unknown image-fit: '%s'", fit)).Build()
+}
+
+func VerifyAndDecodeImage(data io.Reader, mime string) (image.Image, error) {
+
+	if mime == "image/jpeg" {
+		img, err := jpeg.Decode(data)
+		if err != nil {
+			return nil, exerr.Wrap(err, "failed to decode blob as jpeg").WithType(exerr.TypeInvalidImage).Build()
+		}
+		return img, nil
+	}
+
+	if mime == "image/png" {
+		img, err := png.Decode(data)
+		if err != nil {
+			return nil, exerr.Wrap(err, "failed to decode blob as png").WithType(exerr.TypeInvalidImage).Build()
+		}
+		return img, nil
+	}
+
+	return nil, exerr.New(exerr.TypeInvalidMimeType, fmt.Sprintf("unknown/invalid image mimetype: '%s'", mime)).Build()
+}

wmo/collection.go

@@ -95,7 +95,7 @@ func (c *Coll[TData]) WithUnmarshalHook(fn func(d TData) TData) *Coll[TData] {
 // WithMarshalHook
 // function that is called for every object before writing to DB
 func (c *Coll[TData]) WithMarshalHook(fn func(d TData) TData) *Coll[TData] {
-	c.extraModPipeline = append(c.marshalHooks, fn)
+	c.marshalHooks = append(c.marshalHooks, fn)
 
 	return c
 }

wpdf/wpdf.go

@@ -0,0 +1,187 @@
+package wpdf
+
+import (
+	"bytes"
+	"github.com/jung-kurt/gofpdf"
+)
+
+type WPDFBuilder struct {
+	b          *gofpdf.Fpdf
+	tr         func(string) string
+	cellHeight float64
+	fontName   PDFFontFamily
+	fontStyle  PDFFontStyle
+	fontSize   float64
+}
+
+type PDFMargins struct {
+	Left  float64
+	Top   float64
+	Right float64
+}
+
+type PDFColor struct {
+	R int
+	G int
+	B int
+}
+
+func NewPDFBuilder(orientation PDFOrientation, size PDFSize, unicode bool) *WPDFBuilder {
+
+	fpdfbuilder := gofpdf.New(string(orientation), "mm", string(size), "")
+
+	var tr func(string) string
+	if unicode {
+		tr = fpdfbuilder.UnicodeTranslatorFromDescriptor("")
+	} else {
+		tr = func(s string) string { return s }
+	}
+
+	b := &WPDFBuilder{
+		b:          fpdfbuilder,
+		tr:         tr,
+		cellHeight: 5,
+	}
+
+	b.SetMargins(PDFMargins{Left: 15, Top: 25, Right: 15}) // default values
+	b.SetFont(FontHelvetica, Normal, 12)                   // ensures font is set
+
+	return b
+}
+
+func (b *WPDFBuilder) FPDF() *gofpdf.Fpdf {
+	return b.b
+}
+
+func (b *WPDFBuilder) SetMargins(v PDFMargins) {
+	b.b.SetMargins(v.Left, v.Top, v.Right)
+}
+
+func (b *WPDFBuilder) AddPage() {
+	b.b.AddPage()
+}
+
+func (b *WPDFBuilder) SetTextColor(cr, cg, cb int) {
+	b.b.SetTextColor(cr, cg, cb)
+}
+
+func (b *WPDFBuilder) GetTextColor() (cr, cg, cb int) {
+	return b.b.GetTextColor()
+}
+
+func (b *WPDFBuilder) SetDrawColor(cr, cg, cb int) {
+	b.b.SetDrawColor(cr, cg, cb)
+}
+
+func (b *WPDFBuilder) GetDrawColor() (cr, cg, cb int) {
+	return b.b.GetDrawColor()
+}
+
+func (b *WPDFBuilder) SetFillColor(cr, cg, cb int) {
+	b.b.SetFillColor(cr, cg, cb)
+}
+
+func (b *WPDFBuilder) GetFillColor() (cr, cg, cb int) {
+	return b.b.GetFillColor()
+}
+
+func (b *WPDFBuilder) SetLineWidth(w float64) {
+	b.b.SetLineWidth(w)
+}
+
+func (b *WPDFBuilder) GetLineWidth() float64 {
+	return b.b.GetLineWidth()
+}
+
+func (b *WPDFBuilder) SetFont(fontName PDFFontFamily, fontStyle PDFFontStyle, fontSize float64) {
+	b.b.SetFont(string(fontName), string(fontStyle), fontSize)
+
+	b.fontName = fontName
+	b.fontStyle = fontStyle
+	b.fontSize = fontSize
+
+	b.cellHeight = b.b.PointConvert(fontSize)
+}
+
+func (b *WPDFBuilder) Ln(h float64) {
+	b.b.Ln(h)
+}
+
+func (b *WPDFBuilder) Build() ([]byte, error) {
+	buf := new(bytes.Buffer)
+	err := b.b.Output(buf)
+	if err != nil {
+		return nil, err
+	}
+	return buf.Bytes(), nil
+}
+
+func (b *WPDFBuilder) SetX(x float64) {
+	b.b.SetX(x)
+}
+
+func (b *WPDFBuilder) GetX() float64 {
+	return b.b.GetX()
+}
+
+func (b *WPDFBuilder) SetY(y float64) {
+	b.b.SetY(y)
+}
+
+func (b *WPDFBuilder) GetY() float64 {
+	return b.b.GetY()
+}
+
+func (b *WPDFBuilder) SetXY(x float64, y float64) {
+	b.b.SetXY(x, y)
+}
+
+func (b *WPDFBuilder) GetXY() (x float64, y float64) {
+	return b.b.GetXY()
+}
+
+func (b *WPDFBuilder) GetMargins() (left, top, right, bottom float64) {
+	return b.b.GetMargins()
+}
+
+func (b *WPDFBuilder) GetMarginLeft() float64 {
+	v, _, _, _ := b.b.GetMargins()
+	return v
+}
+
+func (b *WPDFBuilder) GetMarginTop() float64 {
+	_, v, _, _ := b.b.GetMargins()
+	return v
+}
+
+func (b *WPDFBuilder) GetMarginRight() float64 {
+	_, _, v, _ := b.b.GetMargins()
+	return v
+}
+
+func (b *WPDFBuilder) GetMarginBottom() float64 {
+	_, _, _, v := b.b.GetMargins()
+	return v
+}
+
+func (b *WPDFBuilder) GetPageSize() (width, height float64) {
+	return b.b.GetPageSize()
+}
+
+func (b *WPDFBuilder) GetPageWidth() float64 {
+	v, _ := b.b.GetPageSize()
+	return v
+}
+
+func (b *WPDFBuilder) GetPageHeight() float64 {
+	_, v := b.b.GetPageSize()
+	return v
+}
+
+func (b *WPDFBuilder) GetWorkAreaWidth() float64 {
+	return b.GetPageWidth() - b.GetMarginLeft() - b.GetMarginRight()
+}
+
+func (b *WPDFBuilder) GetStringWidth(str string) float64 {
+	return b.b.GetStringWidth(str)
+}

wpdf/wpdfCell.go

@@ -0,0 +1,173 @@
+package wpdf
+
+import "gogs.mikescher.com/BlackForestBytes/goext/langext"
+
+type PDFCellOpt struct {
+	width             *float64
+	height            *float64
+	border            *PDFBorder
+	ln                *PDFTextBreak
+	align             *PDFTextAlign
+	fill              *bool
+	link              *int
+	linkStr           *string
+	fontNameOverride  *PDFFontFamily
+	fontStyleOverride *PDFFontStyle
+	fontSizeOverride  *float64
+	extraLn           *float64
+	x                 *float64
+	autoWidth         *bool
+}
+
+func NewPDFCellOpt() *PDFCellOpt {
+	return &PDFCellOpt{}
+}
+
+func (opt *PDFCellOpt) Width(v float64) *PDFCellOpt {
+	opt.width = &v
+	return opt
+}
+
+func (opt *PDFCellOpt) Height(v float64) *PDFCellOpt {
+	opt.height = &v
+	return opt
+}
+
+func (opt *PDFCellOpt) Border(v PDFBorder) *PDFCellOpt {
+	opt.border = &v
+	return opt
+}
+
+func (opt *PDFCellOpt) LnPos(v PDFTextBreak) *PDFCellOpt {
+	opt.ln = &v
+	return opt
+}
+
+func (opt *PDFCellOpt) Align(v PDFTextAlign) *PDFCellOpt {
+	opt.align = &v
+	return opt
+}
+
+func (opt *PDFCellOpt) FillBackground(v bool) *PDFCellOpt {
+	opt.fill = &v
+	return opt
+}
+
+func (opt *PDFCellOpt) Link(v int) *PDFCellOpt {
+	opt.link = &v
+	return opt
+}
+
+func (opt *PDFCellOpt) LinkStr(v string) *PDFCellOpt {
+	opt.linkStr = &v
+	return opt
+}
+
+func (opt *PDFCellOpt) Font(fontName PDFFontFamily, fontStyle PDFFontStyle, fontSize float64) *PDFCellOpt {
+	opt.fontNameOverride = &fontName
+	opt.fontStyleOverride = &fontStyle
+	opt.fontSizeOverride = &fontSize
+	return opt
+}
+
+func (opt *PDFCellOpt) FontName(v PDFFontFamily) *PDFCellOpt {
+	opt.fontNameOverride = &v
+	return opt
+}
+
+func (opt *PDFCellOpt) FontStyle(v PDFFontStyle) *PDFCellOpt {
+	opt.fontStyleOverride = &v
+	return opt
+}
+
+func (opt *PDFCellOpt) FontSize(v float64) *PDFCellOpt {
+	opt.fontSizeOverride = &v
+	return opt
+}
+
+func (opt *PDFCellOpt) Bold() *PDFCellOpt {
+	opt.fontStyleOverride = langext.Ptr(Bold)
+	return opt
+}
+
+func (opt *PDFCellOpt) Italic() *PDFCellOpt {
+	opt.fontStyleOverride = langext.Ptr(Italic)
+	return opt
+}
+
+func (opt *PDFCellOpt) LnAfter(v float64) *PDFCellOpt {
+	opt.extraLn = &v
+	return opt
+}
+
+func (opt *PDFCellOpt) X(v float64) *PDFCellOpt {
+	opt.x = &v
+	return opt
+}
+
+func (opt *PDFCellOpt) AutoWidth() *PDFCellOpt {
+	opt.autoWidth = langext.PTrue
+	return opt
+}
+
+func (b *WPDFBuilder) Cell(txt string, opts ...*PDFCellOpt) {
+
+	txtTR := b.tr(txt)
+
+	width := float64(0)
+	height := b.cellHeight
+	border := BorderNone
+	ln := BreakToNextLine
+	align := AlignLeft
+	fill := false
+	link := 0
+	linkStr := ""
+	var fontNameOverride *PDFFontFamily
+	var fontStyleOverride *PDFFontStyle
+	var fontSizeOverride *float64
+	extraLn := float64(0)
+	var x *float64
+	autoWidth := false
+
+	for _, opt := range opts {
+		width = langext.Coalesce(opt.width, width)
+		height = langext.Coalesce(opt.height, height)
+		border = langext.Coalesce(opt.border, border)
+		ln = langext.Coalesce(opt.ln, ln)
+		align = langext.Coalesce(opt.align, align)
+		fill = langext.Coalesce(opt.fill, fill)
+		link = langext.Coalesce(opt.link, link)
+		linkStr = langext.Coalesce(opt.linkStr, linkStr)
+		fontNameOverride = langext.CoalesceOpt(opt.fontNameOverride, fontNameOverride)
+		fontStyleOverride = langext.CoalesceOpt(opt.fontStyleOverride, fontStyleOverride)
+		fontSizeOverride = langext.CoalesceOpt(opt.fontSizeOverride, fontSizeOverride)
+		extraLn = langext.Coalesce(opt.extraLn, extraLn)
+		x = langext.CoalesceOpt(opt.x, x)
+		autoWidth = langext.Coalesce(opt.autoWidth, autoWidth)
+	}
+
+	if fontNameOverride != nil || fontStyleOverride != nil || fontSizeOverride != nil {
+		oldFontName := b.fontName
+		oldFontStyle := b.fontStyle
+		oldFontSize := b.fontSize
+		newFontName := langext.Coalesce(fontNameOverride, oldFontName)
+		newFontStyle := langext.Coalesce(fontStyleOverride, oldFontStyle)
+		newFontSize := langext.Coalesce(fontSizeOverride, oldFontSize)
+		b.SetFont(newFontName, newFontStyle, newFontSize)
+		defer func() { b.SetFont(oldFontName, oldFontStyle, oldFontSize) }()
+	}
+
+	if x != nil {
+		b.b.SetX(*x)
+	}
+
+	if autoWidth {
+		width = b.b.GetStringWidth(txtTR)
+	}
+
+	b.b.CellFormat(width, height, txtTR, string(border), int(ln), string(align), fill, link, linkStr)
+
+	if extraLn != 0 {
+		b.b.Ln(extraLn)
+	}
+}

wpdf/wpdfConstants.go

@@ -0,0 +1,80 @@
+package wpdf
+
+type PDFOrientation string
+
+const (
+	Portrait  PDFOrientation = "P"
+	Landscape PDFOrientation = "L"
+)
+
+type PDFSize string
+
+const (
+	SizeA3      PDFSize = "A3"
+	SizeA4      PDFSize = "A4"
+	SizeA5      PDFSize = "A4"
+	SizeLetter  PDFSize = "Letter"
+	SizeLegal   PDFSize = "Legal"
+	SizeTabloid PDFSize = "Tabloid"
+)
+
+type PDFFontFamily string
+
+const (
+	FontCourier      PDFFontFamily = "courier"
+	FontHelvetica    PDFFontFamily = "helvetica"
+	FontTimes        PDFFontFamily = "times"
+	FontZapfDingbats PDFFontFamily = "zapfdingbats"
+	FontSymbol       PDFFontFamily = "symbol"
+)
+
+type PDFFontStyle string
+
+const (
+	Normal     PDFFontStyle = ""
+	Bold       PDFFontStyle = "B"
+	Italic     PDFFontStyle = "I"
+	BoldItalic PDFFontStyle = "IB"
+)
+
+type PDFBorder string
+
+const (
+	BorderNone   PDFBorder = ""
+	BorderFull   PDFBorder = "1"
+	BorderLeft   PDFBorder = "L"
+	BorderTop    PDFBorder = "T"
+	BorderRight  PDFBorder = "R"
+	BorderBottom PDFBorder = "B"
+	BorderTLR    PDFBorder = "TLR"
+	BorderLR     PDFBorder = "LR"
+)
+
+type PDFTextBreak int
+
+const (
+	BreakToRight    PDFTextBreak = 0
+	BreakToNextLine PDFTextBreak = 1
+	BreakToBelow    PDFTextBreak = 2
+)
+
+type PDFTextAlign string
+
+const (
+	AlignLeft       PDFTextAlign = "L"
+	AlignHorzCenter PDFTextAlign = "C"
+	AlignRight      PDFTextAlign = "R"
+)
+
+type PDFRectStyle string
+
+const (
+	RectFill        PDFRectStyle = "F"
+	RectOutline     PDFRectStyle = "D"
+	RectFillOutline PDFRectStyle = "FD"
+)
+
+const (
+	BackgroundFill        = true
+	BackgroundTransparent = false
+)

wpdf/wpdfImage.go

@@ -0,0 +1,315 @@
+package wpdf
+
+import (
+	"bytes"
+	"github.com/jung-kurt/gofpdf"
+	"gogs.mikescher.com/BlackForestBytes/goext/imageext"
+	"gogs.mikescher.com/BlackForestBytes/goext/langext"
+	"image"
+	"image/color"
+	"net/http"
+)
+
+type PDFImageRef struct {
+	Info  *gofpdf.ImageInfoType
+	Name  string
+	Bin   []byte
+	Image *image.Image
+	Mime  string
+}
+
+type PDFImageRegisterOpt struct {
+	imageType             *string
+	readDpi               *bool
+	allowNegativePosition *bool
+	name                  *string
+}
+
+func NewPDFImageRegisterOpt() *PDFImageRegisterOpt {
+	return &PDFImageRegisterOpt{}
+}
+
+func (opt *PDFImageRegisterOpt) ImageType(v string) *PDFImageRegisterOpt {
+	opt.imageType = &v
+	return opt
+}
+
+func (opt *PDFImageRegisterOpt) ReadDpi(v bool) *PDFImageRegisterOpt {
+	opt.readDpi = &v
+	return opt
+}
+
+func (opt *PDFImageRegisterOpt) AllowNegativePosition(v bool) *PDFImageRegisterOpt {
+	opt.allowNegativePosition = &v
+	return opt
+}
+
+func (opt *PDFImageRegisterOpt) Name(v string) *PDFImageRegisterOpt {
+	opt.name = &v
+	return opt
+}
+
+func (b *WPDFBuilder) RegisterImage(bin []byte, opts ...*PDFImageRegisterOpt) *PDFImageRef {
+	imgName := "fpdf_img_" + langext.MustRawHexUUID()
+	imageType := ""
+	readDpi := false
+	allowNegativePosition := false
+	mime := "application/octet-stream"
+
+	for _, opt := range opts {
+		imageType = langext.Coalesce(opt.imageType, imageType)
+		readDpi = langext.Coalesce(opt.readDpi, readDpi)
+		allowNegativePosition = langext.Coalesce(opt.allowNegativePosition, allowNegativePosition)
+		imgName = langext.Coalesce(opt.name, imgName)
+	}
+
+	if imageType == "" {
+		ct := http.DetectContentType(bin[:512])
+		switch ct {
+		case "image/jpg":
+			imageType = "JPG"
+			mime = ct
+		case "image/jpeg":
+			imageType = "JPEG"
+			mime = ct
+		case "image/png":
+			imageType = "PNG"
+			mime = ct
+		case "image/gif":
+			imageType = "GIF"
+			mime = ct
+		}
+	} else {
+		switch imageType {
+		case "JPG":
+		case "JPEG":
+			mime = "image/jpeg"
+		case "PNG":
+			mime = "image/png"
+		case "GIF":
+			mime = "image/gif"
+		}
+	}
+
+	options := gofpdf.ImageOptions{
+		ImageType:             imageType,
+		ReadDpi:               readDpi,
+		AllowNegativePosition: allowNegativePosition,
+	}
+
+	info := b.b.RegisterImageOptionsReader(imgName, options, bytes.NewReader(bin))
+
+	return &PDFImageRef{
+		Name:  imgName,
+		Info:  info,
+		Bin:   bin,
+		Image: nil,
+		Mime:  mime,
+	}
+}
+
+type PDFImageOpt struct {
+	x                     *float64
+	y                     *float64
+	width                 *float64
+	height                *float64
+	flow                  *bool
+	link                  *int
+	linkStr               *string
+	imageType             *string
+	readDpi               *bool
+	allowNegativePosition *bool
+	imageFit              *imageext.ImageFit
+	fillColor             *color.Color
+	compression           *imageext.ImageCompresson
+	reEncodePixelPerMM    *float64
+	crop                  *imageext.ImageCrop
+}
+
+func NewPDFImageOpt() *PDFImageOpt {
+	return &PDFImageOpt{}
+}
+
+func (opt *PDFImageOpt) X(v float64) *PDFImageOpt {
+	opt.x = &v
+	return opt
+}
+
+func (opt *PDFImageOpt) Y(v float64) *PDFImageOpt {
+	opt.y = &v
+	return opt
+}
+
+func (opt *PDFImageOpt) Width(v float64) *PDFImageOpt {
+	opt.width = &v
+	return opt
+}
+
+func (opt *PDFImageOpt) Height(v float64) *PDFImageOpt {
+	opt.height = &v
+	return opt
+}
+
+func (opt *PDFImageOpt) Flow(v bool) *PDFImageOpt {
+	opt.flow = &v
+	return opt
+}
+
+func (opt *PDFImageOpt) Link(v int) *PDFImageOpt {
+	opt.link = &v
+	return opt
+}
+
+func (opt *PDFImageOpt) LinkStr(v string) *PDFImageOpt {
+	opt.linkStr = &v
+	return opt
+}
+
+func (opt *PDFImageOpt) ImageType(v string) *PDFImageOpt {
+	opt.imageType = &v
+	return opt
+}
+
+func (opt *PDFImageOpt) ReadDpi(v bool) *PDFImageOpt {
+	opt.readDpi = &v
+	return opt
+}
+
+func (opt *PDFImageOpt) AllowNegativePosition(v bool) *PDFImageOpt {
+	opt.allowNegativePosition = &v
+	return opt
+}
+
+func (opt *PDFImageOpt) ImageFit(v imageext.ImageFit) *PDFImageOpt {
+	opt.imageFit = &v
+	return opt
+
+}
+
+func (opt *PDFImageOpt) FillColor(v color.Color) *PDFImageOpt {
+	opt.fillColor = &v
+	return opt
+}
+
+func (opt *PDFImageOpt) Compression(v imageext.ImageCompresson) *PDFImageOpt {
+	opt.compression = &v
+	return opt
+}
+
+func (opt *PDFImageOpt) ReEncodePixelPerMM(v float64) *PDFImageOpt {
+	opt.reEncodePixelPerMM = &v
+	return opt
+}
+
+func (opt *PDFImageOpt) Crop(cropX float64, cropY float64, cropWidth float64, cropHeight float64) *PDFImageOpt {
+	opt.crop = &imageext.ImageCrop{
+		CropX:      cropX,
+		CropY:      cropY,
+		CropWidth:  cropWidth,
+		CropHeight: cropHeight,
+	}
+	return opt
+}
+
+func (b *WPDFBuilder) Image(img *PDFImageRef, opts ...*PDFImageOpt) {
+	var err error
+
+	x := b.GetX()
+	y := b.GetY()
+	w := img.Info.Width()
+	h := img.Info.Height()
+	flow := true
+	link := 0
+	linkStr := ""
+	imageType := ""
+	readDpi := false
+	allowNegativePosition := false
+	reEncodePixelPerMM := 15.0
+	var imageFit *imageext.ImageFit = nil
+	var fillColor color.Color = color.Transparent
+	compression := imageext.CompressionPNGSpeed
+	var crop *imageext.ImageCrop = nil
+
+	for _, opt := range opts {
+		x = langext.Coalesce(opt.x, x)
+		y = langext.Coalesce(opt.y, y)
+		w = langext.Coalesce(opt.width, w)
+		h = langext.Coalesce(opt.height, h)
+		flow = langext.Coalesce(opt.flow, flow)
+		link = langext.Coalesce(opt.link, link)
+		linkStr = langext.Coalesce(opt.linkStr, linkStr)
+		imageType = langext.Coalesce(opt.imageType, imageType)
+		readDpi = langext.Coalesce(opt.readDpi, readDpi)
+		allowNegativePosition = langext.Coalesce(opt.allowNegativePosition, allowNegativePosition)
+		imageFit = langext.CoalesceOpt(opt.imageFit, imageFit)
+		fillColor = langext.Coalesce(opt.fillColor, fillColor)
+		compression = langext.Coalesce(opt.compression, compression)
+		reEncodePixelPerMM = langext.Coalesce(opt.reEncodePixelPerMM, reEncodePixelPerMM)
+		crop = langext.CoalesceOpt(opt.crop, crop)
+	}
+
+	regName := img.Name
+
+	if imageFit != nil || fillColor != nil || crop != nil {
+
+		var dataimg image.Image
+		if img.Image != nil {
+			dataimg = *img.Image
+		} else {
+			dataimg, err = imageext.VerifyAndDecodeImage(bytes.NewReader(img.Bin), img.Mime)
+			if err != nil {
+				b.b.SetError(err)
+				return
+			}
+		}
+
+		if crop != nil {
+			dataimg, err = imageext.CropImage(dataimg, crop.CropX, crop.CropY, crop.CropWidth, crop.CropHeight)
+			if err != nil {
+				b.b.SetError(err)
+				return
+			}
+		}
+
+		if imageFit != nil {
+			pdfPixelPerMillimeter := 15.0
+
+			pxw := w * pdfPixelPerMillimeter
+			pxh := h * pdfPixelPerMillimeter
+
+			dataimg, err = imageext.ObjectFitImage(dataimg, pxw, pxh, *imageFit, fillColor)
+			if err != nil {
+				b.b.SetError(err)
+				return
+			}
+		}
+
+		bfr, imgMime, err := imageext.EncodeImage(dataimg, compression)
+		if err != nil {
+			b.b.SetError(err)
+			return
+		}
+
+		regName = regName + "_" + langext.MustRawHexUUID()
+
+		switch imgMime {
+		case "image/jpeg":
+			imageType = "JPEG"
+		case "image/png":
+			imageType = "PNG"
+		case "image/gif":
+			imageType = "GIF"
+		}
+
+		b.b.RegisterImageOptionsReader(regName, gofpdf.ImageOptions{ImageType: imageType}, &bfr)
+
+	}
+
+	fpdfOpt := gofpdf.ImageOptions{
+		ImageType:             imageType,
+		ReadDpi:               readDpi,
+		AllowNegativePosition: allowNegativePosition,
+	}
+
+	b.b.ImageOptions(regName, x, y, w, h, flow, fpdfOpt, link, linkStr)
+}

wpdf/wpdfMultiCell.go

@@ -0,0 +1,137 @@
+package wpdf
+
+import "gogs.mikescher.com/BlackForestBytes/goext/langext"
+
+type PDFMultiCellOpt struct {
+	width             *float64
+	height            *float64
+	border            *PDFBorder
+	align             *PDFTextAlign
+	fill              *bool
+	fontNameOverride  *PDFFontFamily
+	fontStyleOverride *PDFFontStyle
+	fontSizeOverride  *float64
+	extraLn           *float64
+	x                 *float64
+}
+
+func NewPDFMultiCellOpt() *PDFMultiCellOpt {
+	return &PDFMultiCellOpt{}
+}
+
+func (opt *PDFMultiCellOpt) Width(v float64) *PDFMultiCellOpt {
+	opt.width = &v
+	return opt
+}
+
+func (opt *PDFMultiCellOpt) Height(v float64) *PDFMultiCellOpt {
+	opt.height = &v
+	return opt
+}
+
+func (opt *PDFMultiCellOpt) Border(v PDFBorder) *PDFMultiCellOpt {
+	opt.border = &v
+	return opt
+}
+
+func (opt *PDFMultiCellOpt) Align(v PDFTextAlign) *PDFMultiCellOpt {
+	opt.align = &v
+	return opt
+}
+
+func (opt *PDFMultiCellOpt) FillBackground(v bool) *PDFMultiCellOpt {
+	opt.fill = &v
+	return opt
+}
+
+func (opt *PDFMultiCellOpt) Font(fontName PDFFontFamily, fontStyle PDFFontStyle, fontSize float64) *PDFMultiCellOpt {
+	opt.fontNameOverride = &fontName
+	opt.fontStyleOverride = &fontStyle
+	opt.fontSizeOverride = &fontSize
+	return opt
+}
+
+func (opt *PDFMultiCellOpt) FontName(v PDFFontFamily) *PDFMultiCellOpt {
+	opt.fontNameOverride = &v
+	return opt
+}
+
+func (opt *PDFMultiCellOpt) FontStyle(v PDFFontStyle) *PDFMultiCellOpt {
+	opt.fontStyleOverride = &v
+	return opt
+}
+
+func (opt *PDFMultiCellOpt) FontSize(v float64) *PDFMultiCellOpt {
+	opt.fontSizeOverride = &v
+	return opt
+}
+
+func (opt *PDFMultiCellOpt) Bold() *PDFMultiCellOpt {
+	opt.fontStyleOverride = langext.Ptr(Bold)
+	return opt
+}
+
+func (opt *PDFMultiCellOpt) Italic() *PDFMultiCellOpt {
+	opt.fontStyleOverride = langext.Ptr(Italic)
+	return opt
+}
+
+func (opt *PDFMultiCellOpt) LnAfter(v float64) *PDFMultiCellOpt {
+	opt.extraLn = &v
+	return opt
+}
+
+func (opt *PDFMultiCellOpt) X(v float64) *PDFMultiCellOpt {
+	opt.x = &v
+	return opt
+}
+
+func (b *WPDFBuilder) MultiCell(txt string, opts ...*PDFMultiCellOpt) {
+
+	txtTR := b.tr(txt)
+
+	width := float64(0)
+	height := b.cellHeight
+	border := BorderNone
+	align := AlignLeft
+	fill := false
+	var fontNameOverride *PDFFontFamily
+	var fontStyleOverride *PDFFontStyle
+	var fontSizeOverride *float64
+	extraLn := float64(0)
+	var x *float64
+
+	for _, opt := range opts {
+		width = langext.Coalesce(opt.width, width)
+		height = langext.Coalesce(opt.height, height)
+		border = langext.Coalesce(opt.border, border)
+		align = langext.Coalesce(opt.align, align)
+		fill = langext.Coalesce(opt.fill, fill)
+		fontNameOverride = langext.CoalesceOpt(opt.fontNameOverride, fontNameOverride)
+		fontStyleOverride = langext.CoalesceOpt(opt.fontStyleOverride, fontStyleOverride)
+		fontSizeOverride = langext.CoalesceOpt(opt.fontSizeOverride, fontSizeOverride)
+		extraLn = langext.Coalesce(opt.extraLn, extraLn)
+		x = langext.CoalesceOpt(opt.x, x)
+	}
+
+	if fontNameOverride != nil || fontStyleOverride != nil || fontSizeOverride != nil {
+		oldFontName := b.fontName
+		oldFontStyle := b.fontStyle
+		oldFontSize := b.fontSize
+		newFontName := langext.Coalesce(fontNameOverride, oldFontName)
+		newFontStyle := langext.Coalesce(fontStyleOverride, oldFontStyle)
+		newFontSize := langext.Coalesce(fontSizeOverride, oldFontSize)
+		b.SetFont(newFontName, newFontStyle, newFontSize)
+		defer func() { b.SetFont(oldFontName, oldFontStyle, oldFontSize) }()
+	}
+
+	if x != nil {
+		b.b.SetX(*x)
+	}
+
+	b.b.MultiCell(width, height, txtTR, string(border), string(align), fill)
+
+	if extraLn != 0 {
+		b.b.Ln(extraLn)
+	}
+}

wpdf/wpdfRect.go

@@ -0,0 +1,126 @@
+package wpdf
+
+import "gogs.mikescher.com/BlackForestBytes/goext/langext"
+
+type PDFRectOpt struct {
+	x         *float64
+	y         *float64
+	lineWidth *float64
+	drawColor *PDFColor
+	fillColor *PDFColor
+	radiusTL  *float64
+	radiusTR  *float64
+	radiusBR  *float64
+	radiusBL  *float64
+}
+
+func NewPDFRectOpt() *PDFRectOpt {
+	return &PDFRectOpt{}
+}
+
+func (opt *PDFRectOpt) X(v float64) *PDFRectOpt {
+	opt.x = &v
+	return opt
+}
+
+func (opt *PDFRectOpt) Y(v float64) *PDFRectOpt {
+	opt.y = &v
+	return opt
+}
+
+func (opt *PDFRectOpt) LineWidth(v float64) *PDFRectOpt {
+	opt.lineWidth = &v
+	return opt
+}
+
+func (opt *PDFRectOpt) DrawColor(cr, cg, cb int) *PDFRectOpt {
+	opt.drawColor = &PDFColor{R: cr, G: cg, B: cb}
+	return opt
+}
+
+func (opt *PDFRectOpt) DrawColorHex(c uint32) *PDFRectOpt {
+	opt.drawColor = &PDFColor{R: int((c >> 16) & 0xFF), G: int((c >> 8) & 0xFF), B: int((c >> 0) & 0xFF)}
+	return opt
+}
+
+func (opt *PDFRectOpt) FillColor(cr, cg, cb int) *PDFRectOpt {
+	opt.fillColor = &PDFColor{R: cr, G: cg, B: cb}
+	return opt
+}
+
+func (opt *PDFRectOpt) FillColorHex(c uint32) *PDFRectOpt {
+	opt.fillColor = &PDFColor{R: int((c >> 16) & 0xFF), G: int((c >> 8) & 0xFF), B: int((c >> 0) & 0xFF)}
+	return opt
+}
+
+func (opt *PDFRectOpt) Rounded(radius float64) *PDFRectOpt {
+	opt.radiusTL = &radius
+	opt.radiusTR = &radius
+	opt.radiusBR = &radius
+	opt.radiusBL = &radius
+	return opt
+}
+
+func (opt *PDFRectOpt) RadiusTL(radius float64) *PDFRectOpt {
+	opt.radiusTL = &radius
+	return opt
+}
+
+func (opt *PDFRectOpt) RadiusTR(radius float64) *PDFRectOpt {
+	opt.radiusTR = &radius
+	return opt
+}
+
+func (opt *PDFRectOpt) RadiusBL(radius float64) *PDFRectOpt {
+	opt.radiusBL = &radius
+	return opt
+}
+
+func (opt *PDFRectOpt) RadiusBR(radius float64) *PDFRectOpt {
+	opt.radiusBR = &radius
+	return opt
+}
+
+func (b *WPDFBuilder) Rect(w float64, h float64, styleStr PDFRectStyle, opts ...*PDFRectOpt) {
+	x := b.GetX()
+	y := b.GetY()
+	var lineWidth *float64
+	var drawColor *PDFColor
+	var fillColor *PDFColor
+	radiusTL := float64(0)
+	radiusTR := float64(0)
+	radiusBR := float64(0)
+	radiusBL := float64(0)
+
+	for _, opt := range opts {
+		x = langext.Coalesce(opt.x, x)
+		y = langext.Coalesce(opt.y, y)
+		lineWidth = langext.CoalesceOpt(opt.lineWidth, lineWidth)
+		drawColor = langext.CoalesceOpt(opt.drawColor, drawColor)
+		fillColor = langext.CoalesceOpt(opt.fillColor, fillColor)
+		radiusTL = langext.Coalesce(opt.radiusTL, radiusTL)
+		radiusTR = langext.Coalesce(opt.radiusTR, radiusTR)
+		radiusBR = langext.Coalesce(opt.radiusBR, radiusBR)
+		radiusBL = langext.Coalesce(opt.radiusBL, radiusBL)
+	}
+
+	if lineWidth != nil {
+		old := b.GetLineWidth()
+		b.SetLineWidth(*lineWidth)
+		defer func() { b.SetLineWidth(old) }()
+	}
+
+	if drawColor != nil {
+		oldR, oldG, oldB := b.GetDrawColor()
+		b.SetDrawColor(drawColor.R, drawColor.G, drawColor.B)
+		defer func() { b.SetDrawColor(oldR, oldG, oldB) }()
+	}
+
+	if fillColor != nil {
+		oldR, oldG, oldB := b.GetFillColor()
+		b.SetFillColor(fillColor.R, fillColor.G, fillColor.B)
+		defer func() { b.SetFillColor(oldR, oldG, oldB) }()
+	}
+
+	b.b.RoundedRectExt(x, y, w, h, radiusTL, radiusTR, radiusBR, radiusBL, string(styleStr))
+}