PKPGCOUNTER(1)							   User Commands						    PKPGCOUNTER(1)

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) * Micro-
	      soft 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 MER-
       CHANTABILITY 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)