NAME

       pkpgcounter - count number of pages required to print various types of documents

DESCRIPTION

       pkpgcounter v3.50 (c) 2003, 2004, 2005, 2006, 2007 Jerome Alet

       pkpgcounter is a generic Page Description Language parser.

       pkpgcounter  parses  any  number of input files and/or its standard input and outputs the number of pages
       needed to print these documents.

       pkpgcounter can also compute the percent of ink  coverage  in  different  colorspaces  for  several  file
       formats.

       pkpgcounter currently recognizes the following document formats :

              *  PostScript  (both  DSC  compliant  and  binary)  *  PDF  *  PCLXL (aka PCL6) * PCL3/4/5 * DVI *
              OpenDocument (ISO/IEC DIS 26300) * Microsoft Word (c) (tm) (r) (etc...)  * Plain  text  *  TIFF  *
              Several  other  image formats * ESC/P2 * Zenographics ZjStream * Samsung QPDL (aka SPL2) * Samsung
              SPL1 * ESC/PageS03 * Brother HBP * Hewlett-Packard LIDIL (hpijs) * Structured Fax * Canon BJ/BJC *
              ASCII PNM (Netpbm)

       The ten latter ones, as well as some TIFF documents, are currently only supported in page counting mode.

       command line usage :

              pkpgcounter [options] [files]

       options :

       -v | --version
              Prints pkpgcounter's version number then exits.

       -h | --help
              Prints this message then exits.

       -d | --debug
              Activate debug mode.

       -cCOLORSPACE, --colorspace=COLORSPACE
              Activate the computation of ink usage, and defines the colorspace to  use.  Supported  values  are
              'BW'  (Black),  'RGB',  'CMYK',  'CMY', and 'GC' (Grayscale vs Color).  'GC' is useful if you only
              need to differentiate grayscale pages from coloured pages but don't care about ink usage per se.

       -rRESOLUTION, --resolution=RESOLUTION
              The resolution in DPI to use when checking  ink  usage.   Lower  resolution  is  faster  but  less
              accurate. Default is 72 dpi.

       examples :

              $ pkpgcounter file1.ps file2.escp2 file3.pclxl <file4.pcl345

              Will  launch  pkpgcounter  and  will  output  the  total  number  of pages needed to print all the
              documents specified.

              $ pkpgcounter --colorspace bw --resolution 150 file1.ps

              Will output the percent of black ink needed on each page of the file1.ps file rendered at 150 dpi.

       This program is free software: you can redistribute it and/or modify  it  under  the  terms  of  the  GNU
       General  Public License as published by the Free Software Foundation, either version 3 of the License, 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 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
       License for more details.

       You should have received a copy of the GNU General Public License along with this program.  If  not,  see
       <http://www.gnu.org/licenses/>.

       Please e-mail bugs to: alet@librelogiciel.com

C@LL - Conseil Internet & Logiciels Libres        December 2007                                   PKPGCOUNTER(1)