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

Revision 502, 2.9 kB (checked in by jerome, 17 years ago)

Improved documentation wrt the newly added dependency on ImageMagick?
for the computation of ink usage in image file formats.

  • 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" "November 2007" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
3.SH NAME
4pkpgcounter \- manual page for pkpgcounter 3.30
5.SH DESCRIPTION
6pkpgcounter v3.30 (c) 2003, 2004, 2005, 2006, 2007 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 (mostly)
22* DVI
23* Plain text
24* TIFF
25* Several other image formats
26* ESC/P2
27* OpenDocument (ISO/IEC DIS 26300)
28* Zenographics ZjStream
29* Samsung QPDL (aka SPL2)
30* Samsung SPL1
31* ESC/PageS03
32* Brother HBP
33* Hewlett\-Packard LIDIL (hpijs)
34.PP
35The eight latter ones, as well as some TIFF documents, are currently
36only supported in page counting mode.
37.PP
38command line usage :
39.IP
40pkpgcounter [options] [files]
41.PP
42options :
43.TP
44\fB\-v\fR | \fB\-\-version\fR
45Prints pkpgcounter's version number then exits.
46.TP
47\fB\-h\fR | \fB\-\-help\fR
48Prints this message then exits.
49.TP
50\fB\-d\fR | \fB\-\-debug\fR
51Activate debug mode.
52.TP
53\fB\-cCOLORSPACE\fR, \fB\-\-colorspace\fR=\fICOLORSPACE\fR
54Activate the computation of ink usage, and defines the
55colorspace to use. Supported values are 'BW' (Black),
56\&'RGB', 'CMYK', 'CMY', and 'GC' (Grayscale vs Color).
57\&'GC' is useful if you only need to differentiate
58grayscale pages from coloured pages but don't care
59about ink usage per se.
60.TP
61\fB\-rRESOLUTION\fR, \fB\-\-resolution\fR=\fIRESOLUTION\fR
62The resolution in DPI to use when checking ink usage.
63Lower resolution is faster but less accurate. Default
64is 72 dpi.
65.PP
66examples :
67.IP
68\f(CW$ pkpgcounter file1.ps file2.escp2 file3.pclxl <file4.pcl345\fR
69.IP
70Will launch pkpgcounter and will output the total number of pages
71needed to print all the documents specified.
72.IP
73\f(CW$ pkpgcounter --colorspace bw --resolution 150 file1.ps\fR
74.IP
75Will output the percent of black ink needed on each page of
76the file1.ps file rendered at 150 dpi.
77.PP
78This program is free software: you can redistribute it and/or modify
79it under the terms of the GNU General Public License as published by
80the Free Software Foundation, either version 3 of the License, or
81(at your option) any later version.
82.PP
83This program is distributed in the hope that it will be useful,
84but WITHOUT ANY WARRANTY; without even the implied warranty of
85MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
86GNU General Public License for more details.
87.PP
88You should have received a copy of the GNU General Public License
89along with this program.  If not, see <http://www.gnu.org/licenses/>.
90.PP
91Please e\-mail bugs to: alet@librelogiciel.com
Note: See TracBrowser for help on using the browser.