.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
.TH PKPGCOUNTER "1" "January 2007" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
.SH NAME
pkpgcounter \- manual page for pkpgcounter 2.14
.SH DESCRIPTION
pkpgcounter v2.14 (c) 2003, 2004, 2005, 2006, 2007 Jerome Alet
.PP
pkpgcounter is a generic Page Description Language parser.
.PP
pkpgcounter parses any number of input files and/or its standard input
and outputs the number of pages needed to print these documents.
.PP
pkpgcounter can also compute the percent of ink coverage in different
colorspaces for several file formats.
.PP
pkpgcounter currently recognizes the following document formats :
.IP
* PostScript (both DSC compliant and binary)
* PDF
* PCLXL (aka PCL6)
* PCL3/4/5 (mostly)
* DVI
* Plain text
* TIFF
* ESC/P2
* OpenDocument (ISO/IEC DIS 26300)
* Zenographics ZjStream
* Samsung QPDL (aka SPL2)
* Samsung SPL1
.PP
The five latter ones, as well as some TIFF documents, are currently
only supported in page counting mode.
.PP
command line usage :
.IP
pkpgcounter [options] [files]
.PP
options :
.TP
\fB\-v\fR | \fB\-\-version\fR
Prints pkpgcounter's version number then exits.
.TP
\fB\-h\fR | \fB\-\-help\fR
Prints this message then exits.
.TP
\fB\-d\fR | \fB\-\-debug\fR
Activate debug mode.
.TP
\fB\-cCOLORSPACE\fR, \fB\-\-colorspace\fR=\fICOLORSPACE\fR
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.
.TP
\fB\-rRESOLUTION\fR, \fB\-\-resolution\fR=\fIRESOLUTION\fR
The resolution in DPI to use when checking ink usage.
Lower resolution is faster but less accurate. Default
is 72 dpi.
.PP
examples :
.IP
\f(CW$ pkpgcounter file1.ps file2.escp2 file3.pclxl <file4.pcl345\fR
.IP
Will launch pkpgcounter and will output the total number of pages
needed to print all the documents specified.
.IP
\f(CW$ pkpgcounter --colorspace bw --resolution 150 file1.ps\fR
.IP
Will output the percent of black ink needed on each page of
the file1.ps file rendered at 150 dpi.
.PP
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 2 of the License, or
(at your option) any later version.
.PP
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.
.PP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA.
.PP
Please e\-mail bugs to: alet@librelogiciel.com