"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "extra/pdfidiff.1" between
littleutils-1.2.4.tar.lz and littleutils-1.2.5.tar.lz

About: littleutils are a collection of small and simple utilities (rename files, search for duplicate files, ...).

pdfidiff.1  (littleutils-1.2.4.tar.lz):pdfidiff.1  (littleutils-1.2.5.tar.lz)
PDFIDIFF(1) General Commands Manual PDFIDIFF(1) PDFIDIFF(1) General Commands Manual PDFIDIFF(1)
NAME NAME
pdfidiff - compares two PDF files and write differences to a third file f ile. pdfidiff - compares two PDF files and write differences to a third file f ile.
SYNOPSIS SYNOPSIS
pdfidiff [-h(elp)] [-f fuzz_dist] [-g(hostscript)] [-m mode] [-o(ptim ize)] [-q(uiet)] [-r resolution] pdfidiff [-h(elp)] [-f fuzz_dist] [-g(hostscript)] [-m mode] [-o(ptim ize)] [-q(uiet)] [-r resolution]
[-s(ingle_threaded)] oldfile newfile deltafile [-s(ingle_threaded)] oldfile newfile deltafile
DESCRIPTION DESCRIPTION
pdfidiff reads in any two PDF files readable by ghostscript and write out pdfidiff reads in any two PDF files readable by poppler (or ghostscript)
an image-based "delta" file and write out an image-based
that represents the differences between the two files. "delta" file that represents the differences between the two files. T
his is accomplished by using the
pdftocairo (or gs), imagdiff, img2pdf, and tempname utilities.
OPTIONS OPTIONS
-h Print help and quit. -h Print help and quit.
-g Use ghostscript (gs) instead of poppler (pdftocairo) as the PDF re ndering engine. -g Use ghostscript (gs) instead of poppler (pdftocairo) as the PDF re ndering engine.
-f fuzz_dist -f fuzz_dist
When performing a grayscale difference analysis, any pixel values within the distance specified by When performing a grayscale difference analysis, any pixel values within the distance specified by
-f option are considered equal. This option has no effect on a co lor difference analysis. The -f option are considered equal. This option has no effect on a color difference analysis. The
default value is 1. default value is 1.
-m mode -m mode
Set of the mode of the difference analysis. At present, five mode s are available, as described in Set of the mode of the difference analysis. At present, five mode s are available, as described in
the MODES section. The default mode is 2. the MODES section. The default mode is 2.
-o Use opt-pdf to minimize the filesize of intermediate PNG files
before assembling the final PDF
file.
-q Cause pdfidiff to silence the progress information normally printe d during operation. -q Cause pdfidiff to silence the progress information normally printe d during operation.
-r resolution -r resolution
Use the specified resolution (in DPI) when converting from PDF to intermediate PNG. The default Use the specified resolution (in DPI) when converting from PDF to intermediate PNG. The default
value is 300. value is 300.
-o Use opt-pdf to minimize the filesize of intermediate PNG files -s The pdfidiff utility will normally utilize GNU parallel (if p
before assembling the final PDF resent on the system) to perform
file. operations in parallel to reduce computation time. Using this opt
ion will force single-threaded
-s The pdfidiff utility will normally utilize GNU parallel (if presen
t on the system) to perform
operations in parallel to reduce computation time. Using this o
ption will force single-threaded
operation. operation.
MODES MODES
1 Grayscale: In this mode, both input files are converted to graysc 1 Grayscale: In this mode, both input files are converted to grays
ale PNG files. Any pixels that cale PNG files. Any pixels that
are darker (when comparing old to new) are highlighted in BLUE, are darker (when comparing old to new) are highlighted in BLUE, an
and any pixels that are brighter d any pixels that are brighter
are highlighted in RED. [On a B&W drawing with a white backgroun are highlighted in RED. [On a B&W drawing with a white backg
d, this results in additions round, this results in additions
being highlighted in BLUE, and subtractions being highlighted in R ED.] being highlighted in BLUE, and subtractions being highlighted in R ED.]
2 Grayscale (lightened): This works much like the Grayscale ana 2 Grayscale (lightened): This works much like the Grayscale analysi
lysis of mode 1, except that all s of mode 1, except that all
unchanged pixels are shifted halfway towards white. This makes it unchanged pixels are shifted halfway towards white. This makes
easier to identify changes on it easier to identify changes on
files where the background is predominantly white. files where the background is predominantly white.
3 Grayscale (darkened): This works much like the Grayscale ana 3 Grayscale (darkened): This works much like the Grayscale analysis
lysis of mode 1, except that all of mode 1, except that all
unchanged pixels are shifted halfway towards black. This makes it unchanged pixels are shifted halfway towards black. This makes
easier to identify changes on it easier to identify changes on
files where the background is predominantly black. files where the background is predominantly black.
4 Color: Here, the differences between the two files are computed o n a per-RED, per-GREEN, and per- 4 Color: Here, the differences between the two files are computed o n a per-RED, per-GREEN, and per-
BLUE basis and are shifted and scaled such that unchanged pixels w ill show up as 50% gray. BLUE basis and are shifted and scaled such that unchanged pixels w ill show up as 50% gray.
5 Color (stretched): Again, differences between the two files are c omputed on a per-channel and are 5 Color (stretched): Again, differences between the two files are c omputed on a per-channel and are
shifted that unchanged pixels will show up as 50% gray, but he re the scaling is maximimized to shifted that unchanged pixels will show up as 50% gray, but here t he scaling is maximimized to
emphasize differences. emphasize differences.
NOTES NOTES
The pdfidiff utility uses pdftocairo or gs to convert both input files in The pdfidiff utility uses pdftocairo or gs to convert both input files i
to a series of PNG image files. nto a series of PNG image files.
These files are then compared using imagdiff, and the resulting image These files are then compared using imagdiff, and the resulting image "de
"deltas" are reassemblied into a ltas" are reassemblied into a
final PDF file using img2pdf. final PDF file using img2pdf.
CAVEATS CAVEATS
Because the input files are converted from PDF to PNG and are manipulated Because the input files are converted from PDF to PNG and are manipulate
as bitmaps, the final PDF out- d as bitmaps, the final PDF out-
put will not contains any searchable string information, even if the put will not contains any searchable string information, even if the inpu
input files did. If you need to t files did. If you need to
compare the text found in two different PDF files, you may have better lu compare the text found in two different PDF files, you may have better
ck with an alternate tool such luck with an alternate tool such
as diffpdf or pdf-diff. as diffpdf or pdf-diff.
SEE ALSO SEE ALSO
gs(1), img2pdf(1), parallel(1), imagdiff(1), diffpdf(1), pdf-diff(1), pdf tocairo(1) gs(1), img2pdf(1), parallel(1), imagdiff(1), diffpdf(1), pdf-diff(1), pdf tocairo(1)
COPYRIGHT COPYRIGHT
Copyright (C) 2018-2021 by Brian Lindholm. This program is free softwa Copyright (C) 2018-2021 by Brian Lindholm. This program is free software;
re; you can use it, redistribute you can use it, redistribute
it, and/or modify it under the terms of the GNU General Public License as it, and/or modify it under the terms of the GNU General Public License a
published by the Free Software s published by the Free Software
Foundation; either version 3, or (at your option) any later version. Foundation; either version 3, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WI This program is distributed in the hope that it will be useful, but WITHO
THOUT ANY WARRANTY; without even UT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPO the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURP
SE. See the GNU General Public OSE. See the GNU General Public
License for more details. License for more details.
littleutils 2021 Jan 15 PDFIDIFF(1) littleutils 2021 Mar 28 PDFIDIFF(1)
 End of changes. 13 change blocks. 
45 lines changed or deleted 47 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)