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

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

Finalized support for MS documents.

  • Property svn:keywords set to Author Date Id Revision
RevLine 
[329]1.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
[486]2.TH PKPGCOUNTER "1" "November 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
[529]6pkpgcounter v3.40 (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)
[223]35.PP
[528]36The seven latter ones, as well as some TIFF documents, are currently
[378]37only supported in page counting mode.
38.PP
[223]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.
[378]53.TP
54\fB\-cCOLORSPACE\fR, \fB\-\-colorspace\fR=\fICOLORSPACE\fR
55Activate the computation of ink usage, and defines the
[440]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.
[378]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.
[223]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.
[378]73.IP
[529]74\f(CW$ pkpgcounter \-\-colorspace bw \-\-resolution 150 file1.ps\fR
[378]75.IP
76Will output the percent of black ink needed on each page of
77the file1.ps file rendered at 150 dpi.
[223]78.PP
[463]79This program is free software: you can redistribute it and/or modify
[223]80it under the terms of the GNU General Public License as published by
[463]81the Free Software Foundation, either version 3 of the License, or
[223]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
[463]90along with this program.  If not, see <http://www.gnu.org/licenses/>.
[223]91.PP
92Please e\-mail bugs to: alet@librelogiciel.com
Note: See TracBrowser for help on using the browser.