root / pkpgcounter / trunk / bin / pkpgcounter @ 3474

Revision 3474, 3.5 kB (checked in by jerome, 13 years ago)

Changed copyright years.

  • Property svn:executable set to *
  • Property svn:keywords set to Auth Date Id Rev
Line 
1#! /usr/bin/env python
2# -*- coding: utf-8 -*-
3#
4# pkpgcounter : a generic Page Description Language parser
5#
6# (c) 2003-2009 Jerome Alet <alet@librelogiciel.com>
7# This program is free software: you can redistribute it and/or modify
8# it under the terms of the GNU General Public License as published by
9# the Free Software Foundation, either version 3 of the License, or
10# (at your option) any later version.
11#
12# This program is distributed in the hope that it will be useful,
13# but WITHOUT ANY WARRANTY; without even the implied warranty of
14# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15# GNU General Public License for more details.
16#
17# You should have received a copy of the GNU General Public License
18# along with this program.  If not, see <http://www.gnu.org/licenses/>.
19#
20# $Id$
21#
22#
23
24import sys
25from pkpgpdls.version import __version__, __author__, __authoremail__, \
26                                __years__, __gplblurb__
27from pkpgpdls import analyzer
28
29__doc__ = """pkpgcounter v%(__version__)s (c) %(__years__)s %(__author__)s
30
31pkpgcounter is a generic Page Description Language parser.
32
33pkpgcounter parses any number of input files and/or its standard input
34and outputs the number of pages needed to print these documents.
35
36pkpgcounter can also compute the percent of ink coverage in different
37colorspaces for several file formats.
38
39pkpgcounter currently recognizes the following document formats :
40
41    * PostScript (both DSC compliant and binary)
42    * PDF
43    * PCLXL (aka PCL6)
44    * PCL3/4/5
45    * DVI
46    * OpenDocument (ISO/IEC DIS 26300)
47    * Microsoft Word (c) (tm) (r) (etc...)
48    * Plain text
49    * TIFF
50    * Several other image formats
51    * ESC/P2
52    * Zenographics ZjStream
53    * Samsung QPDL (aka SPL2)
54    * Samsung SPL1
55    * ESC/PageS03
56    * Brother HBP
57    * Hewlett-Packard LIDIL (hpijs)
58    * Structured Fax
59    * Canon BJ/BJC
60    * ASCII PNM (Netpbm)
61
62The ten latter ones, as well as some TIFF documents, are currently
63only supported in page counting mode.
64
65command line usage :
66
67  pkpgcounter [options] [files]
68
69options :
70
71  -v | --version        Prints pkpgcounter's version number then exits.
72  -h | --help           Prints this message then exits.
73
74  -d | --debug          Activate debug mode.
75
76  -cCOLORSPACE, --colorspace=COLORSPACE
77                        Activate the computation of ink usage, and defines the
78                        colorspace to use. Supported values are 'BW' (Black),
79                        'RGB', 'CMYK', 'CMY', and 'GC' (Grayscale vs Color).
80                        'GC' is useful if you only need to differentiate
81                        grayscale pages from coloured pages but don't care
82                        about ink usage per se.
83
84  -rRESOLUTION, --resolution=RESOLUTION
85                        The resolution in DPI to use when checking ink usage.
86                        Lower resolution is faster but less accurate. Default
87                        is 72 dpi.
88
89examples :
90
91  $ pkpgcounter file1.ps file2.escp2 file3.pclxl <file4.pcl345
92
93  Will launch pkpgcounter and will output the total number of pages
94  needed to print all the documents specified.
95
96  $ pkpgcounter --colorspace bw --resolution 150 file1.ps
97
98  Will output the percent of black ink needed on each page of
99  the file1.ps file rendered at 150 dpi.
100
101%(__gplblurb__)s
102
103Please e-mail bugs to: %(__authoremail__)s"""
104
105if __name__ == "__main__" :
106    if (len(sys.argv) >= 2) and (sys.argv[1] in ("-h", "--help")) :
107        sys.stdout.write("%s\n" % (__doc__ % globals()))
108    else :
109        analyzer.main()
Note: See TracBrowser for help on using the browser.