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

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

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