root / pkpgcounter / trunk / man / pkpgcounter.1 @ 557

Revision 557, 3.0 kB (checked in by jerome, 16 years ago)

Updated version number and manual page.

  • Property svn:keywords set to Author Date Id Revision
RevLine 
[329]1.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
[539]2.TH PKPGCOUNTER "1" "December 2007" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
[223]3.SH NAME
[529]4pkpgcounter \- count number of pages required to print various types of documents
[223]5.SH DESCRIPTION
[557]6pkpgcounter v3.50 (c) 2003, 2004, 2005, 2006, 2007 Jerome Alet
[223]7.PP
8pkpgcounter is a generic Page Description Language parser.
9.PP
10pkpgcounter parses any number of input files and/or its standard input
11and outputs the number of pages needed to print these documents.
12.PP
[378]13pkpgcounter can also compute the percent of ink coverage in different
14colorspaces for several file formats.
15.PP
[223]16pkpgcounter currently recognizes the following document formats :
17.IP
18* PostScript (both DSC compliant and binary)
19* PDF
20* PCLXL (aka PCL6)
[528]21* PCL3/4/5
[223]22* DVI
[528]23* OpenDocument (ISO/IEC DIS 26300)
[529]24* Microsoft Word (c) (tm) (r) (etc...)
[419]25* Plain text
[223]26* TIFF
[502]27* Several other image formats
[223]28* ESC/P2
[329]29* Zenographics ZjStream
[386]30* Samsung QPDL (aka SPL2)
[419]31* Samsung SPL1
[476]32* ESC/PageS03
[480]33* Brother HBP
[486]34* Hewlett\-Packard LIDIL (hpijs)
[539]35* Structured Fax
[545]36* Canon BJ/BJC
[549]37* ASCII PNM (Netpbm)
[223]38.PP
[549]39The ten latter ones, as well as some TIFF documents, are currently
[378]40only supported in page counting mode.
41.PP
[223]42command line usage :
43.IP
44pkpgcounter [options] [files]
45.PP
46options :
47.TP
48\fB\-v\fR | \fB\-\-version\fR
49Prints pkpgcounter's version number then exits.
50.TP
51\fB\-h\fR | \fB\-\-help\fR
52Prints this message then exits.
53.TP
54\fB\-d\fR | \fB\-\-debug\fR
55Activate debug mode.
[378]56.TP
57\fB\-cCOLORSPACE\fR, \fB\-\-colorspace\fR=\fICOLORSPACE\fR
58Activate the computation of ink usage, and defines the
[440]59colorspace to use. Supported values are 'BW' (Black),
60\&'RGB', 'CMYK', 'CMY', and 'GC' (Grayscale vs Color).
61\&'GC' is useful if you only need to differentiate
62grayscale pages from coloured pages but don't care
63about ink usage per se.
[378]64.TP
65\fB\-rRESOLUTION\fR, \fB\-\-resolution\fR=\fIRESOLUTION\fR
66The resolution in DPI to use when checking ink usage.
67Lower resolution is faster but less accurate. Default
68is 72 dpi.
[223]69.PP
70examples :
71.IP
72\f(CW$ pkpgcounter file1.ps file2.escp2 file3.pclxl <file4.pcl345\fR
73.IP
74Will launch pkpgcounter and will output the total number of pages
75needed to print all the documents specified.
[378]76.IP
[529]77\f(CW$ pkpgcounter \-\-colorspace bw \-\-resolution 150 file1.ps\fR
[378]78.IP
79Will output the percent of black ink needed on each page of
80the file1.ps file rendered at 150 dpi.
[223]81.PP
[463]82This program is free software: you can redistribute it and/or modify
[223]83it under the terms of the GNU General Public License as published by
[463]84the Free Software Foundation, either version 3 of the License, or
[223]85(at your option) any later version.
86.PP
87This program is distributed in the hope that it will be useful,
88but WITHOUT ANY WARRANTY; without even the implied warranty of
89MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
90GNU General Public License for more details.
91.PP
92You should have received a copy of the GNU General Public License
[463]93along with this program.  If not, see <http://www.gnu.org/licenses/>.
[223]94.PP
95Please e\-mail bugs to: alet@librelogiciel.com
Note: See TracBrowser for help on using the browser.