diff --git a/README.md b/README.md index 3e1d261..12f1500 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,7 @@ The "paper" size does not change, just the elements are resized. ## Dependencies The script uses `basename`, `cat`, `grep`, `bc`, `head` and `gs` (ghostscript). You probably have everything installed already, except for ghostscript. +Optional dependencies are `imagemagick`, `pdfinfo` and `mdls` (Mac). ##### apt-get ``` @@ -19,17 +20,24 @@ sudo yum install ghostscript bc ``` brew install ghostscript ``` -##### ImageMagick -As of version 1.2.7 ImageMagick was reintroduced as an optional way to get the first page size. -You will need to install imagemagick and have `identify` available on your `$PATH` to then use the `-i` parameter. - - +##### Optionals +From version 1.4.x I decided to create an adaptive method of getting the pagesize. It will try different methods if the previous one fails. People can also force a specific mode of operation with the `-m` parameter. + +The order of operation is as follows: + 1. Try to get `/MediaBox` with cat + grep + 2. Failed AND MacOs ? Try mdls + 3. Failed AND NOT MacOS ? Try pdfinfo + 4. Failed ? Try ImageMagick's identify + 5. Failed ? Exit with error message + +The postscript/ghostscript method was removed until I can write a PS script that gets the page size. + ## Help info ``` $ pdfscale -h -pdfscale v1.3.1 +pdfscale v1.4.5 -Usage: pdfscale [-v] [-s ] [-i] [outfile.pdf] +Usage: pdfscale [-v] [-s ] [-i|-c] [outfile.pdf] pdfscale -h pdfscale -V @@ -38,15 +46,24 @@ Parameters: Use twice for even more information -h Print this help to screen and exits -V Prints version to screen and exits - -i Use imagemagick to get page size, - instead of postscript method + -m Force a mode of page size detection. + Will disable the Adaptive Mode. -c Use cat + grep to get page size, instead of postscript method -s Changes the scaling factor, defaults to 0.95 MUST be a number bigger than zero. Eg. -s 0.8 for 80% of the original size +Modes: + a, adaptive Default mode, tries all the methods below + c, cat+grep Forces the use of the cat + grep method + m, mdls Forces the use of MacOS Quartz mdls + p, pdfinfo Forces the use of Linux PdfInfo + i, identify Forces the use of ImageMagick's Identify + Notes: + - Page size detection will try different modes until it gets + a page size, or you can force a mode with -m 'mode' - Options must be passed before the file names to be parsed - The output filename is optional. If no file name is passed the output file will have the same name/destination of the @@ -62,24 +79,42 @@ Examples: pdfscale myPdfFile.pdf myScaledPdf pdfscale -v -v myPdfFile.pdf pdfscale -s 0.85 myPdfFile.pdf myScaledPdf.pdf - pdfscale -i -s 0.80 -v myPdfFile.pdf + pdfscale -m pdfinfo -s 0.80 -v myPdfFile.pdf pdfscale -v -v -s 0.7 myPdfFile.pdf pdfscale -h ``` -## Example run +## Example runs ``` -$ pdfscale -i -v -s 0.5 ../input.pdf -pdfscale v1.2.10 - Verbose execution +$ ./pdfScale.sh -v -m i ../00-test-xml2dacte.pdf +pdfScale.sh v1.4.5 - Verbose execution Checking for ghostscript and bcmath Checking for imagemagick's identify - Scale factor: 0.5 - Input file: ../input.pdf - Output file: ../input.SCALED.pdf + Scale factor: 0.95 + Input file: ../00-test-xml2dacte.pdf + Output file: ../00-test-xml2dacte.SCALED.pdf + Adaptive mode: Disabled + Method: ImageMagick's Identify Width: 595 postscript-points Height: 842 postscript-points - Translation X: 297.500000 - Translation Y: 421.000000 + Translation X: 15.657425 + Translation Y: 22.157230 +``` +``` +$ ./pdfScale.sh -v -v ../input-nup.pdf +2017-02-22:03:09:59 | pdfScale.sh v1.4.5 - Verbose execution +2017-02-22:03:09:59 | Checking for ghostscript and bcmath +2017-02-22:03:09:59 | Scale factor: 0.95 +2017-02-22:03:09:59 | Input file: ../input-nup.pdf +2017-02-22:03:09:59 | Output file: ../input-nup.SCALED.pdf +2017-02-22:03:09:59 | Adaptive mode: Enabled +2017-02-22:03:09:59 | Method: Cat + Grep +2017-02-22:03:09:59 | Failed +2017-02-22:03:09:59 | Method: Mac Quartz mdls +2017-02-22:03:09:59 | Width: 595 postscript-points +2017-02-22:03:09:59 | Height: 842 postscript-points +2017-02-22:03:09:59 | Translation X: 15.657425 +2017-02-22:03:09:59 | Translation Y: 22.157230 ``` ## System Install