Changeset 3436 for pkpgcounter/trunk/README
- Timestamp:
- 10/06/08 00:22:07 (16 years ago)
- Files:
-
- 1 modified
Legend:
- Unmodified
- Added
- Removed
-
pkpgcounter/trunk/README
r3409 r3436 26 26 27 27 - PostScript (both DSC compliant and binary) 28 28 29 29 - PDF 30 30 31 31 - PCL3/4/5 32 32 33 33 - PCLXL (aka PCL6) 34 34 35 35 - DVI 36 36 37 37 - OpenDocument (ISO/IEC DIS 26300) 38 38 39 39 - Microsoft Word (c) (tm) (r) (etc...) 40 40 41 41 - Plain text 42 42 43 43 - TIFF 44 44 45 45 - Several other image formats 46 46 47 47 - ESC/P2 48 48 49 49 - Zenographics ZjStream 50 50 51 51 - Samsung QPDL (aka SPL2) 52 52 53 53 - Samsung SPL1 54 54 55 55 - ESC/PageS03 56 56 57 57 - Brother HBP 58 58 59 59 - Brother XL2HB 60 60 61 61 - Hewlett-Packard Lightweight Imaging Device Interface Language 62 62 63 63 - Structured Fax 64 64 65 65 - Canon BJ/BJC 66 66 67 67 - ASCII PNM (Netpbm) 68 69 The eleven latter ones, as well as some TIFF documents, are currently70 only supported in page counting mode.71 68 72 By default, when launched pkpgcounter prints on its standard output 73 a single integer representing the total number of pages in all the 74 files which filenames you've passed on the command line. 69 The eleven latter ones, as well as some TIFF documents, are currently 70 only supported in page counting mode. 71 72 By default, when launched pkpgcounter prints on its standard output 73 a single integer representing the total number of pages in all the 74 files which filenames you've passed on the command line. 75 75 76 76 With no argument, or with a single dash in non-option arguments, … … 87 87 88 88 0 - Download pkpgcounter from : 89 89 90 90 http://www.pykota.com/software/pkpgcounter/download 91 92 and extract it : 93 91 92 and extract it : 93 94 94 $ tar -zxf pkpgcounter-x.yy.tar.gz 95 95 96 96 where x.yy is pkpgcounter' version number. 97 97 98 98 1 - Run the installation script : 99 99 100 100 $ python setup.py install 101 102 This will usually install the pkpgcounter into /usr/bin and 101 102 This will usually install the pkpgcounter into /usr/bin and 103 103 the library into /usr/lib/python2.?/site-packages/pkpgpdls/ 104 104 105 105 2 - Use pkpgcounter : 106 106 107 107 $ pkpgcounter file1.ps file2.pclxl ... <fileN.escp2 108 108 109 109 pkpgcounter will display the total size in pages of all the files 110 110 passed on the command line. 111 111 112 112 $ pkpgcounter --colorspace bw --resolution 150 file1.ps 113 113 114 114 Will output the percent of black ink needed on each page of 115 115 the file1.ps file rendered at 150 dpi. 116 117 3 - That's all ! 118 116 117 3 - That's all ! 118 119 119 DEPENDENCIES : 120 120 121 121 Most of the time, pkpgcounter only depends on the presence of : 122 122 123 123 - The Python Imaging Library (python-imaging) 124 124 125 125 But, depending on the file formats you plan to work with, and on the 126 126 accounting mode you want to use (pages vs ink), you may need to install 127 127 some or all of the additional software listed below. Usually, if one is 128 needed then pkpgcounter will complain. So your best bet is probably 128 needed then pkpgcounter will complain. So your best bet is probably 129 129 to NOT INSTALL anything until pkpgcounter asks you to do so on its 130 130 standard error stream. Here's the list of software which may be needed … … 132 132 133 133 - GhostScript (gs) 134 134 135 135 - The X Virtual Frame Buffer (xvfb) 136 136 137 137 - The X authority file utility xauth (xbase-clients) 138 138 139 139 - The dvips converter from TeX DVI to PostScript (tetex-bin) 140 140 141 141 - The ImageMagick image manipulation toolkit (imagemagick) 142 142 143 143 - The AbiWord word processor (abiword) 144 144 145 145 - The GhostPCL/GhostPDL's pcl6 converter from PCL to PostScript 146 146 147 147 ============================================================================= 148 148 149 Troubleshooting : 149 Troubleshooting : 150 150 ----------------- 151 151 152 152 If pkpgcounter gives incorrect results to you, please make an incorrectly 153 parsed data file available to us on some website, and tell us which 154 driver was used, how many pages are in the file, and any additional 153 parsed data file available to us on some website, and tell us which 154 driver was used, how many pages are in the file, and any additional 155 155 information you think is relevant. 156 156 157 157 If pkpgcounter complain about your system lacking the Python Psyco module, 158 158 please consider installing it to speedup file parsing. However, don't forget 159 that Psyco currently only runs on the 32 bits x86 platform, so no need to 159 that Psyco currently only runs on the 32 bits x86 platform, so no need to 160 160 install it if you've got another system type. 161 161 162 162 ============================================================================= 163 163 … … 167 167 168 168 http://www.fea.unicamp.br/pclcount/ 169 170 Their software is distributed under either the terms of a BSD-like license, 169 170 Their software is distributed under either the terms of a BSD-like license, 171 171 or the terms of the GNU General Public License of the Free Software Foundation. 172 172 … … 176 176 The old parser was still available until pkpgcounter v2.18 was published, but 177 177 was definitely removed after that, just before pkpgcounter v3.00 was published. 178 179 pkpgcounter's PCLXL (aka PCL6) parser doesn't originate from PCLCount, but 178 179 pkpgcounter's PCLXL (aka PCL6) parser doesn't originate from PCLCount, but 180 180 was written from scratch, just like all the other parsers included in 181 181 pkpgcounter. … … 183 183 ============================================================================= 184 184 185 pkpgcounter's ink coverage algorithm for the CMYK colorspace is a 186 direct Python port from the PrintBill project by Daniel Franklin. 187 PrintBill is distributed under the terms of the GNU General Public 188 License of the Free Software Foundation, version 2 or higher. The 189 algorithms used for the other colorspaces are a complete rewrite of 190 PrintBill's algorithms using both Python and the Python Imaging 191 Library's facilities. 185 pkpgcounter's ink coverage algorithm for the CMYK colorspace is a 186 direct Python port from the PrintBill project by Daniel Franklin. 187 PrintBill is distributed under the terms of the GNU General Public 188 License of the Free Software Foundation, version 2 or higher. The 189 algorithms used for the other colorspaces are a complete rewrite of 190 PrintBill's algorithms using both Python and the Python Imaging 191 Library's facilities. 192 192 193 193 =============================================================================