manpagez: man pages & more
man pdfquant(1)
Home | html | info | man
pdfquant(1)                                                        pdfquant(1)




NAME

       pdfquant  -  reduces  the  size  of  the colormap used by bitmap images
       embedded in PDF files.


SYNOPSIS

       pdfquant  [-f(loyd-steinberg)]  [-h(elp)]  [-n  colors]   [-o(ptimize)]
       [-q(uiet)] [-s(ingle_threaded)] file...


DESCRIPTION

       pdfquant extracts the main bitmap images from one or more PDF files and
       writes out new PDF files that contain alternate versions of the bitmaps
       with  reduced  colormaps.   This is accomplished using the pdfseparate,
       pdfimages, pngquant, img2pdf,and tempname utilities.  It is targeted at
       PDF files generated by document scanning software.


OPTIONS

       -f     Use  Floyd-Steinberg  dithering  instead  of  ordered dithering.
              This significantly improves the appearance of color images,  but
              also increases the size of the output files substantially.

       -h     Print help and quit.

       -n colors
              Reduce the number of colors used on each page to the value spec-
              ified.  Only a number between 2 and 256 can  be  used,  and  the
              default value is 8.

       -o     Use  opt-pdf  to minimize the filesize of intermediate PNG files
              (using opt-png) before assembling the final PDF file.  This sig-
              nificantly increases computation time.

       -q     Cause  pdfquant to silence the progress information that is nor-
              mally printed during operation.

       -s     The pdfquant utility will  normally  utilize  GNU  parallel  (if
              present  on  the  system)  to  perform operations in parallel to
              reduce computation time.  Using this option will  force  single-
              threaded operation.


CAVEATS

       The  pdfquant  utility  only uses the first bitmap image extracted from
       each page of the PDF file.  It does not extract text or  vector  graph-
       ics,  nor  does it utilize any additional bitmaps extracted.  Generally
       speaking, the only PDF files that contain a single  whole-page  bitmaps
       on each page are those generated by document scanning software.  If you
       use pdfquant on PDF files exported from office  suites,  CAD  packages,
       desktop  publishing software, etc., you will almost certainly be disap-
       pointed.


SEE ALSO

       img2pdf(1), parallel(1), pdfimages(1), pdfseparate(1), pngquant(1)


COPYRIGHT

       Copyright (C) 2021 by Brian Lindholm. This program  is  free  software;
       you  can  use  it, redistribute it, and/or modify it under the terms of
       the GNU General Public License as published by the Free Software  Foun-
       dation; either version 3, or (at your option) any later version.

       This  program  is  distributed  in the hope that it will be useful, but
       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER-
       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
       Public License for more details.



littleutils                       2021 Mar 28                      pdfquant(1)

littleutils 1.2.5 - Generated Thu Nov 4 13:28:30 CDT 2021
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.