Bump version

Author: hhrutter

README.md

@@ -9,6 +9,7 @@
 [![Latest release](https://img.shields.io/github/release/pdfcpu/pdfcpu.svg)](https://github.com/pdfcpu/pdfcpu/releases)
 
 <a href="https://pdfcpu.io"><img src="resources/logoSmall.png" width="150"></a>
+<a href="https://pdfa.org"><img src="resources/pdfa.png" width="75"></a>
 
 pdfcpu is a PDF processing library written in [Go](http://golang.org) supporting encryption.
 It provides both an API and a CLI. Supported are all versions up to PDF 1.7 (ISO-32000).
@@ -51,6 +52,7 @@ The main focus lies on strong support for batch processing and scripting via a r
 * [collect](https://pdfcpu.io/core/collect)
 * [create](https://pdfcpu.io/generate/create)
 * [crop](https://pdfcpu.io/core/crop)
+* [cut](https://pdfcpu.io/generate/cut)
 * [decrypt](https://pdfcpu.io/encrypt/decryptPDF)
 * [encrypt](https://pdfcpu.io/encrypt/encryptPDF)
 * [extract](https://pdfcpu.io/extract/extract)
@@ -62,11 +64,13 @@ The main focus lies on strong support for batch processing and scripting via a r
 * [info](https://pdfcpu.io/info)
 * [keywords](https://pdfcpu.io/keywords/keywords)
 * [merge](https://pdfcpu.io/core/merge)
+* [ndown](https://pdfcpu.io/generate/ndown)
 * [nup](https://pdfcpu.io/generate/nup)
 * [optimize](https://pdfcpu.io/core/optimize)
 * [pages](https://pdfcpu.io/pages/pages)
 * [permissions](https://pdfcpu.io/encrypt/perm_add)
 * [portfolio](https://pdfcpu.io/portfolio/portfolio)
+* [poster](https://pdfcpu.io/generate/poster)
 * [properties](https://pdfcpu.io/properties/properties)
 * [resize](https://pdfcpu.io/core/resize)
 * [rotate](https://pdfcpu.io/core/rotate)
@@ -141,14 +145,15 @@ docker run -it --mount type=bind,source="$(pwd)",target=/app pdfcpu ./pdfcpu val
 
 ### What
 
-* Please open an issue if you find a bug or want to propose a change.
+* Please [create](https://github.com/pdfcpu/pdfcpu/issues/new/choose) an issue if you find a bug or want to propose a change.
 * Feature requests - always welcome!
 * Bug fixes - always welcome!
-* PRs - anytime!
+* PRs - let's [discuss](https://github.com/pdfcpu/pdfcpu/discussions) first or [create](https://github.com/pdfcpu/pdfcpu/issues/new/choose) an issue.
 * pdfcpu is stable but still *Alpha* and occasionally undergoing heavy changes.
 
 ### How
 
+* The pdfcpu [discussion board](https://github.com/pdfcpu/pdfcpu/discussions) is open! Please engage in any form helpful for the community.
 * If you want to report a bug please attach the *very verbose* (`pdfcpu cmd -vv ...`) output and ideally a test PDF that you can share.
 * Always make sure your contribution is based on the latest commit.
 * Please sign your commits.
@@ -201,8 +206,3 @@ Usage of pdfcpu assumes you know about and respect all copyrights of any PDF con
 
 Apache-2.0
 
-## Powered By
-
-<p align="center">
-  <a href="https://golang.org"> <img src="resources/Go-Logo_Aqua.png" width="200"> </a>
-</p>

cmd/pdfcpu/usage.go

@@ -1109,14 +1109,33 @@ Supported usecases:
 	usageLongResize = `Resize existing pages.
 
       pages ... please refer to "pdfcpu selectedpages"
-description ... scalefactor, dimensions, enforce:f/t, formsize(=papersize), bgcolor
+description ... scalefactor, dimensions, formsize, enforce, border, bgcolor
      inFile ... input pdf file
     outFile ... output pdf file
 
-      Use scalefactor < 1 to shrink pages
-      Use scalefactor > 1 to enlarge pages
-                               
-      Examples: 
+    <description> is a comma separated configuration string containing:
+
+      scalefactor:  Resize page by scale factor.
+                        Use scale < 1 to shrink pages.
+                        Use scale > 1 to enlarge pages.
+
+      formsize:     Resize page to form/paper size eg. A4, Letter, Legal...
+                        Append 'L' to enforce landscape mode. (eg. A3L)
+                        Append 'P' to enforce portrait mode. (eg. A4P, TabloidP)
+                        Please refer to "pdfcpu paper" for a comprehensive list of defined paper sizes.
+                        "papersize" is also accepted.
+
+      dimensions:   Resize page to custom dimensions.
+                        (width height) in given display unit eg. "400 200"
+
+      enforce:      if dimensions set only, enforce orientation (on/off, true/false, t/f).
+
+      border:       if dimensions set only, draw content region border (on/off, true/false, t/f).
+
+      bgcolor:      if dimensions set only, background color value for unused page regions.
+   
+      
+   Examples: 
 
          pdfcpu resize "scale:2" in.pdf out.pdf
             Enlarge pages by doubling the page dimensions, keep orientation.
@@ -1143,14 +1162,34 @@ description ... scalefactor, dimensions, enforce:f/t, formsize(=papersize), bgco
 	usageLongPoster = `Create a poster using paper size.
 
    pages       ... Please refer to "pdfcpu selectedpages"
-   description ... formsize(=papersize), dimensions, scalefactor, border, margin, bgcolor
+   description ... formsize(=papersize), dimensions, scalefactor, margin, bgcolor, border
    inFile      ... input pdf file
    outDir      ... output directory
    outFileName ... output file name
 
-   Optionally scale your page dimensions then define the poster grid tile size via form size or dimensions.
+   Optionally scale up your page dimensions then define the poster grid tile size via form size or dimensions.
+
+   <description> is a comma separated configuration string containing:
+
+      scalefactor:  Enlarge page by scale factor > 1.
+
+      formsize:     Posterize using tiles with form/paper size eg. A4, Letter, Legal...
+                        Append 'L' to enforce landscape mode. (eg. A3L)
+                        Append 'P' to enforce portrait mode. (eg. A4P, TabloidP)
+                        Please refer to "pdfcpu paper" for a comprehensive list of defined paper sizes.
+                        "papersize" is also accepted.
+
+      dimensions:   Posterize using tiles with custom dimensions.
+                        (width height) in given display unit eg. "400 200"
+
+      margin:       Apply margin / glue area (float >= 0 in given display unit)
+
+      bgcolor:      color value for visualization of margin / glue area.
+
+      border:       if margin set, draw content region border (on/off, true/false, t/f) 
+   
    
-      Examples:
+   Examples:
 
          pdfcpu poster "f:A4" in.pdf outDir
             Page format is A2, the printer supports A4.
@@ -1160,21 +1199,30 @@ description ... scalefactor, dimensions, enforce:f/t, formsize(=papersize), bgco
             Page format is A2, the printer supports A4.
             Generate a poster(A0) via a corresponding 4x4 grid of A4 pages.
 
-         pdfcpu poster -u cm -- "dim:15 10" in.pdf outDir
-            Generate a poster via a corresponding grid with cell size 15x10 cm.
+         pdfcpu poster -u cm -- "dim:15 10, margin:1, bgcol:DarkGray, border:on" in.pdf outDir
+            Generate a poster via a corresponding grid with cell size 15x10 cm and provide a glue area of 1 cm.
             
    See also the related commands: ndown, cut`
 
 	usageNDown     = "usage: pdfcpu ndown [-p(ages) selectedPages] -- [description] n inFile outDir [outFileName]" + generalFlags
 	usageLongNDown = `Cut selected page into n pages symmetrically.
 
    pages       ... Please refer to "pdfcpu selectedpages"
-   description ... border, margin, bgcolor
+   description ... margin, bgcolor, border
    n           ... the n-Down value (see below for details)
    inFile      ... input pdf file
    outDir      ... output directory
    outFileName ... output file name
 
+   <description> is a comma separated configuration string containing:
+
+      margin:       Apply margin / glue area (float >= 0 in given display unit)
+
+      bgcolor:      color value for visualization of margin / glue area.
+
+      border:       if margin set, draw content region border (on/off, true/false, t/f) 
+    
+
                                   grid Eg. 
    Supported values for n: 2 ...  1x2  A1 -> 2 x A2
                            3 ...  1x3       
@@ -1184,7 +1232,8 @@ description ... scalefactor, dimensions, enforce:f/t, formsize(=papersize), bgco
                           12 ...  3x4      
                           16 ...  4x4  A1 -> 16 x A5
 
-      Examples:
+
+   Examples:
 
          pdfcpu ndown 2 in.pdf outDir
             Page format is A2, the printer supports A3.
@@ -1193,22 +1242,41 @@ description ... scalefactor, dimensions, enforce:f/t, formsize(=papersize), bgco
          pdfcpu ndown 4 in.pdf outDir
             Page format is A2, the printer supports A4.
             Quick cut page into 4 equally (A4) sized pages.
+
+         pdfcpu ndown -u cm -- "margin:1, bgcol:DarkGray, border:on" 4 in.pdf outDir
+            Page format is A2, the printer supports A4.
+            Quick cut page into 4 equally (A4) sized pages and provide a glue area of 1 cm.
             
    See also the related commands: poster, cut`
 
 	usageCut     = "usage: pdfcpu cut [-p(ages) selectedPages] -- description inFile outDir [outFileName]" + generalFlags
 	usageLongCut = `Custom cut pages horizontally or vertically.
 
    pages       ... Please refer to "pdfcpu selectedpages"
-   description ... horizontal, vertical, origin, bgcolor, border, margin
+   description ... horizontal, vertical, margin, bgcolor, border
    inFile      ... input pdf file
    outDir      ... output directory
    outFileName ... output file name
 
    Fine grained custom page cutting.
    Apply any number of horizontal or vertical page cuts.
 
-      Examples:
+   <description> is a comma separated configuration string containing:
+
+      horizontal:   Apply horizontal page cuts at height fraction (origin top left corner) 
+                    A sequence of fractions separated by white space.
+
+      vertical:     Apply vertical page cuts at width fraction (origin top left corner)
+                    A sequence of fractions separated by white space.
+
+      margin:       Apply margin / glue area (float >= 0 in given display unit)
+
+      bgcolor:      color value for visualization of margin / glue area.
+              
+      border:       if margin set, draw content region border (on/off, true/false, t/f) 
+    
+   
+   Examples:
 
          pdfcpu cut -- "hor:.25" inFile outDir
             Apply a horizontal page cut at 0.25*height
@@ -1217,7 +1285,6 @@ description ... scalefactor, dimensions, enforce:f/t, formsize(=papersize), bgco
          pdfcpu cut -- "hor:.25, vert:.75" inFile outDir
             Apply a horizontal page cut at 0.25*height
             Apply a vertical page cut at 0.75*width
-            Results in 4 PDF pages.
 
          pdfcpu cut -- "hor:.33 .66" inFile outDir
             Has the same effect as: pdfcpu ndown 3 in.pdf outDir

pkg/api/test/api_test.go

@@ -107,7 +107,7 @@ func copyFile(t *testing.T, srcFileName, destFileName string) error {
 
 func imageFileNames(t *testing.T, dir string) []string {
 	t.Helper()
-	fn, err := model.ImageFileNames(dir)
+	fn, err := model.ImageFileNames(dir, types.MB)
 	if err != nil {
 		t.Fatal(err)
 	}

pkg/api/test/cut_test.go

@@ -25,10 +25,10 @@ import (
 	"github.com/pdfcpu/pdfcpu/pkg/pdfcpu/types"
 )
 
-func testCut(t *testing.T, msg, inFile, outDir, outFile, cutConf string) {
+func testCut(t *testing.T, msg, inFile, outDir, outFile string, unit types.DisplayUnit, cutConf string) {
 	t.Helper()
 
-	cut, err := pdfcpu.ParseCutConfig(cutConf, types.POINTS)
+	cut, err := pdfcpu.ParseCutConfig(cutConf, unit)
 	if err != nil {
 		t.Fatalf("%s: %v\n", msg, err)
 	}
@@ -46,46 +46,59 @@ func TestCut(t *testing.T) {
 		msg             string
 		inFile          string
 		outDir, outFile string
+		unit            types.DisplayUnit
 		cutConf         string
 	}{
 		{"TestRotatedCutHor",
 			"testRot.pdf",
 			"cut",
 			"cutHorRot",
-			"hor:.5"},
+			types.CENTIMETRES,
+			"hor:.5, margin:1, border:on"},
 
 		{"TestCutHor",
 			"test.pdf",
 			"cut",
 			"cutHor",
-			"hor:.5"},
+			types.CENTIMETRES,
+			"hor:.5, margin:1, bgcol:#E9967A, border:on"},
 
 		{"TestCutVer",
 			"test.pdf",
 			"cut",
 			"cutVer",
-			"ver:.5"},
+			types.CENTIMETRES,
+			"ver:.5, margin:1, bgcol:#E9967A"},
 
 		{"TestCutHorAndVerQuarter",
 			"test.pdf",
 			"cut",
 			"cutHorAndVerQuarter",
+			types.POINTS,
 			"h:.5, v:.5"},
 
 		{"TestCutHorAndVerThird",
 			"test.pdf",
 			"cut",
 			"cutHorAndVerThird",
-			"h:.33, h:.66, v:.33, v:.66"},
+			types.POINTS,
+			"h:.33333, h:.66666, v:.33333, v:.66666"},
+
+		{"Test",
+			"test.pdf",
+			"cut",
+			"cutCustom",
+			types.POINTS,
+			"h:.25, v:.5"},
 	} {
-		testCut(t, tt.msg, tt.inFile, tt.outDir, tt.outFile, tt.cutConf)
+		testCut(t, tt.msg, tt.inFile, tt.outDir, tt.outFile, tt.unit, tt.cutConf)
 	}
 }
 
-func testNDown(t *testing.T, msg, inFile, outDir, outFile string, n int, cutConf string) {
+func testNDown(t *testing.T, msg, inFile, outDir, outFile string, n int, unit types.DisplayUnit, cutConf string) {
 	t.Helper()
 
-	cut, err := pdfcpu.ParseCutConfigForN(n, cutConf, types.POINTS)
+	cut, err := pdfcpu.ParseCutConfigForN(n, cutConf, unit)
 	if err != nil {
 		t.Fatalf("%s: %v\n", msg, err)
 	}
@@ -104,37 +117,42 @@ func TestNDown(t *testing.T) {
 		inFile          string
 		outDir, outFile string
 		n               int
+		unit            types.DisplayUnit
 		cutConf         string
 	}{
 		{"TestNDownRot2",
 			"testRot.pdf",
 			"cut",
 			"ndownRot2",
 			2,
-			""}, // optional border, margin, bgcolor
+			types.CENTIMETRES,
+			"margin:1, bgcol:#E9967A"},
 
 		{"TestNDown2",
 			"test.pdf",
 			"cut",
 			"ndown2",
 			2,
-			""}, // optional border, margin, bgcolor
+			types.CENTIMETRES,
+			"margin:1, border:on"},
 
 		{"TestNDown9",
 			"test.pdf",
 			"cut",
 			"ndown9",
 			9,
-			""}, // optional border, margin, bgcolor
+			types.CENTIMETRES,
+			"margin:1, bgcol:#E9967A, border:on"},
 
 		{"TestNDown16",
 			"test.pdf",
 			"cut",
 			"ndown16",
 			16,
+			types.CENTIMETRES,
 			""}, // optional border, margin, bgcolor
 	} {
-		testNDown(t, tt.msg, tt.inFile, tt.outDir, tt.outFile, tt.n, tt.cutConf)
+		testNDown(t, tt.msg, tt.inFile, tt.outDir, tt.outFile, tt.n, tt.unit, tt.cutConf)
 	}
 }
 
@@ -173,22 +191,22 @@ func TestPoster(t *testing.T) {
 			"test.pdf", // A4
 			"cut",
 			"posterScaled",
-			types.POINTS,
-			"f:A6, scale:2.0"},
+			types.CENTIMETRES,
+			"f:A6, scale:2.0, margin:1, bgcol:#E9967A"},
 
 		{"TestPosterDim", // grid made up of 15x10 cm tiles => A4
 			"test.pdf", // A4
 			"cut",
 			"posterDim",
 			types.CENTIMETRES,
-			"dim:15 10"},
+			"dim:15 10, margin:1, border:on"},
 
 		{"TestPosterDimScaled", // grid made up of 15x10 cm tiles => A2
 			"test.pdf", // A4
 			"cut",
 			"posterDimScaled",
 			types.CENTIMETRES,
-			"dim:15 10, scale:2.0"},
+			"dim:15 10, scale:2.0, margin:1, bgcol:#E9967A, border:on"},
 	} {
 		testPoster(t, tt.msg, tt.inFile, tt.outDir, tt.outFile, tt.unit, tt.cutConf)
 	}