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

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

Updated manual page.

  • Property svn:keywords set to Author Date Id Revision
Line 
1.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
2.TH PKPGCOUNTER "1" "January 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
3.SH NAME
4pkpgcounter \- count number of pages required to print various types of documents
5.SH DESCRIPTION
6pkpgcounter v3.51alpha (c) 2003\-2009 Jerome Alet
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
13pkpgcounter can also compute the percent of ink coverage in different
14colorspaces for several file formats.
15.PP
16pkpgcounter currently recognizes the following document formats :
17.IP
18* PostScript (both DSC compliant and binary)
19* PDF
20* PCLXL (aka PCL6)
21* PCL3/4/5
22* DVI
23* OpenDocument (ISO/IEC DIS 26300)
24* Microsoft Word (c) (tm) (r) (etc...)
25* Plain text
26* TIFF
27* Several other image formats
28* ESC/P2
29* Zenographics ZjStream
30* Samsung QPDL (aka SPL2)
31* Samsung SPL1
32* ESC/PageS03
33* Brother HBP
34* Hewlett\-Packard LIDIL (hpijs)
35* Structured Fax
36* Canon BJ/BJC
37* ASCII PNM (Netpbm)
38.PP
39The ten latter ones, as well as some TIFF documents, are currently
40only supported in page counting mode.
41.PP
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.
56.TP
57\fB\-cCOLORSPACE\fR, \fB\-\-colorspace\fR=\fICOLORSPACE\fR
58Activate the computation of ink usage, and defines the
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.
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.
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.
76.IP
77\f(CW$ pkpgcounter \-\-colorspace bw \-\-resolution 150 file1.ps\fR
78.IP
79Will output the percent of black ink needed on each page of
80the file1.ps file rendered at 150 dpi.
81.PP
82This program is free software: you can redistribute it and/or modify
83it under the terms of the GNU General Public License as published by
84the Free Software Foundation, either version 3 of the License, or
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
93along with this program.  If not, see <http://www.gnu.org/licenses/>.
94.PP
95Please e\-mail bugs to: alet@librelogiciel.com
Note: See TracBrowser for help on using the browser.