| 1 | .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. |
|---|
| 2 | .TH PKPGCOUNTER "1" "January 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" |
|---|
| 3 | .SH NAME |
|---|
| 4 | pkpgcounter \- count number of pages required to print various types of documents |
|---|
| 5 | .SH DESCRIPTION |
|---|
| 6 | pkpgcounter v3.51alpha (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet |
|---|
| 7 | .PP |
|---|
| 8 | pkpgcounter is a generic Page Description Language parser. |
|---|
| 9 | .PP |
|---|
| 10 | pkpgcounter parses any number of input files and/or its standard input |
|---|
| 11 | and outputs the number of pages needed to print these documents. |
|---|
| 12 | .PP |
|---|
| 13 | pkpgcounter can also compute the percent of ink coverage in different |
|---|
| 14 | colorspaces for several file formats. |
|---|
| 15 | .PP |
|---|
| 16 | pkpgcounter 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 |
|---|
| 39 | The ten latter ones, as well as some TIFF documents, are currently |
|---|
| 40 | only supported in page counting mode. |
|---|
| 41 | .PP |
|---|
| 42 | command line usage : |
|---|
| 43 | .IP |
|---|
| 44 | pkpgcounter [options] [files] |
|---|
| 45 | .PP |
|---|
| 46 | options : |
|---|
| 47 | .TP |
|---|
| 48 | \fB\-v\fR | \fB\-\-version\fR |
|---|
| 49 | Prints pkpgcounter's version number then exits. |
|---|
| 50 | .TP |
|---|
| 51 | \fB\-h\fR | \fB\-\-help\fR |
|---|
| 52 | Prints this message then exits. |
|---|
| 53 | .TP |
|---|
| 54 | \fB\-d\fR | \fB\-\-debug\fR |
|---|
| 55 | Activate debug mode. |
|---|
| 56 | .TP |
|---|
| 57 | \fB\-cCOLORSPACE\fR, \fB\-\-colorspace\fR=\fICOLORSPACE\fR |
|---|
| 58 | Activate the computation of ink usage, and defines the |
|---|
| 59 | colorspace 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 |
|---|
| 62 | grayscale pages from coloured pages but don't care |
|---|
| 63 | about ink usage per se. |
|---|
| 64 | .TP |
|---|
| 65 | \fB\-rRESOLUTION\fR, \fB\-\-resolution\fR=\fIRESOLUTION\fR |
|---|
| 66 | The resolution in DPI to use when checking ink usage. |
|---|
| 67 | Lower resolution is faster but less accurate. Default |
|---|
| 68 | is 72 dpi. |
|---|
| 69 | .PP |
|---|
| 70 | examples : |
|---|
| 71 | .IP |
|---|
| 72 | \f(CW$ pkpgcounter file1.ps file2.escp2 file3.pclxl <file4.pcl345\fR |
|---|
| 73 | .IP |
|---|
| 74 | Will launch pkpgcounter and will output the total number of pages |
|---|
| 75 | needed to print all the documents specified. |
|---|
| 76 | .IP |
|---|
| 77 | \f(CW$ pkpgcounter \-\-colorspace bw \-\-resolution 150 file1.ps\fR |
|---|
| 78 | .IP |
|---|
| 79 | Will output the percent of black ink needed on each page of |
|---|
| 80 | the file1.ps file rendered at 150 dpi. |
|---|
| 81 | .PP |
|---|
| 82 | This program is free software: you can redistribute it and/or modify |
|---|
| 83 | it under the terms of the GNU General Public License as published by |
|---|
| 84 | the Free Software Foundation, either version 3 of the License, or |
|---|
| 85 | (at your option) any later version. |
|---|
| 86 | .PP |
|---|
| 87 | This program is distributed in the hope that it will be useful, |
|---|
| 88 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
|---|
| 89 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|---|
| 90 | GNU General Public License for more details. |
|---|
| 91 | .PP |
|---|
| 92 | You should have received a copy of the GNU General Public License |
|---|
| 93 | along with this program. If not, see <http://www.gnu.org/licenses/>. |
|---|
| 94 | .PP |
|---|
| 95 | Please e\-mail bugs to: alet@librelogiciel.com |
|---|
