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

Revision 529, 3.0 kB (checked in by jerome, 17 years ago)

Finalized support for MS documents.

  • 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 \- count number of pages required to print various types of documents
5.SH DESCRIPTION
6pkpgcounter v3.40 (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
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.PP
36The seven latter ones, as well as some TIFF documents, are currently
37only supported in page counting mode.
38.PP
39command line usage :
40.IP
41pkpgcounter [options] [files]
42.PP
43options :
44.TP
45\fB\-v\fR | \fB\-\-version\fR
46Prints pkpgcounter's version number then exits.
47.TP
48\fB\-h\fR | \fB\-\-help\fR
49Prints this message then exits.
50.TP
51\fB\-d\fR | \fB\-\-debug\fR
52Activate debug mode.
53.TP
54\fB\-cCOLORSPACE\fR, \fB\-\-colorspace\fR=\fICOLORSPACE\fR
55Activate the computation of ink usage, and defines the
56colorspace to use. Supported values are 'BW' (Black),
57\&'RGB', 'CMYK', 'CMY', and 'GC' (Grayscale vs Color).
58\&'GC' is useful if you only need to differentiate
59grayscale pages from coloured pages but don't care
60about ink usage per se.
61.TP
62\fB\-rRESOLUTION\fR, \fB\-\-resolution\fR=\fIRESOLUTION\fR
63The resolution in DPI to use when checking ink usage.
64Lower resolution is faster but less accurate. Default
65is 72 dpi.
66.PP
67examples :
68.IP
69\f(CW$ pkpgcounter file1.ps file2.escp2 file3.pclxl <file4.pcl345\fR
70.IP
71Will launch pkpgcounter and will output the total number of pages
72needed to print all the documents specified.
73.IP
74\f(CW$ pkpgcounter \-\-colorspace bw \-\-resolution 150 file1.ps\fR
75.IP
76Will output the percent of black ink needed on each page of
77the file1.ps file rendered at 150 dpi.
78.PP
79This program is free software: you can redistribute it and/or modify
80it under the terms of the GNU General Public License as published by
81the Free Software Foundation, either version 3 of the License, or
82(at your option) any later version.
83.PP
84This program is distributed in the hope that it will be useful,
85but WITHOUT ANY WARRANTY; without even the implied warranty of
86MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
87GNU General Public License for more details.
88.PP
89You should have received a copy of the GNU General Public License
90along with this program.  If not, see <http://www.gnu.org/licenses/>.
91.PP
92Please e\-mail bugs to: alet@librelogiciel.com
Note: See TracBrowser for help on using the browser.