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