--- exactimage-0.7.4.orig/debian/php5-exactimage.install +++ exactimage-0.7.4/debian/php5-exactimage.install @@ -0,0 +1,2 @@ +/usr/lib/php*/*/ExactImage.so +/usr/lib/php*/*/ExactImage.php /usr/share/doc/php5-exactimage/examples --- exactimage-0.7.4.orig/debian/exactimage-perl.install +++ exactimage-0.7.4/debian/exactimage-perl.install @@ -0,0 +1 @@ +/usr/lib/perl* --- exactimage-0.7.4.orig/debian/exactimage.docs +++ exactimage-0.7.4/debian/exactimage.docs @@ -0,0 +1 @@ +TODO --- exactimage-0.7.4.orig/debian/changelog +++ exactimage-0.7.4/debian/changelog @@ -0,0 +1,95 @@ +exactimage (0.7.4-2ubuntu1) karmic; urgency=low + + * Merge from debian unstable, Ubuntu remaining changes: + - debian/rules: + + Add dpatch support. + + Build with Python 2.6 properly. + - debian/patches/10-python26_ready.dpatch: Fix api/python/Makefile to + build with Python 2.6. + - debian/control: + + Remove duplicated "section" source fields. + + Adjust exactimage-dbg long description. + - debian/python-exactimage.install: Fix modules installation path. + - debian/manpages/empty-page.1: Don't use hyphen as minus sign. + * Bump python-support build-dependency as per New Python Policy. + + -- Alessio Treglia Fri, 28 Aug 2009 11:46:50 +0200 + +exactimage (0.7.4-2) unstable; urgency=low + + * Updating package to standards version 3.8.3. + * Removing vcs fields. + * Orphaning package. + + -- Daniel Baumann Thu, 27 Aug 2009 07:15:20 +0200 + +exactimage (0.7.4-1ubuntu1) karmic; urgency=low + + * Merge from debian unstable, Ubuntu remaining changes: + - debian/rules: + + Add dpatch support. + + Build with Python 2.6 properly. + - debian/python-exactimage.install: Use wildcard to make the modules + available to all supported Python versions. + - debian/patches/10-python26_ready.dpatch: Fix api/python/Makefile to + build with Python 2.6. + * debian/manpages/empty-page.1: + - Fix hyphen-used-as-minus-sign lintian warning. + * debian/control: + - Binary exactimage duplicates source field "section", fixed to make + lintian happy. + - Change exactimage-dbg long description, it contains debug symbols. + + -- Alessio Treglia Tue, 07 Jul 2009 10:04:33 +0200 + +exactimage (0.7.4-1) unstable; urgency=low + + * Using correct rfc-2822 date formats in changelog. + * Merging upstream version 0.7.4. + * Updating standards version to 3.8.2. + + -- Daniel Baumann Mon, 06 Jul 2009 14:36:40 +0200 + +exactimage (0.7.3-1ubuntu1) karmic; urgency=low + + * Adjust debian/rules, debian/python-exactimage.install to install all the + python stuffs properly. + * Add dpatch support. + * Add debian/patches/10-python26_ready.dpatch to build with Python 2.6. + + -- Alessio Treglia Tue, 05 May 2009 11:30:06 +0200 + +exactimage (0.7.3-1) unstable; urgency=low + + * Merging upstream version 0.7.3. + + -- Daniel Baumann Sun, 03 May 2009 12:25:00 +0200 + +exactimage (0.7.2-1) unstable; urgency=low + + * Updating section of debug packages. + * Merging upstream version 0.7.2. + * Tidy rules file. + + -- Daniel Baumann Sun, 26 Apr 2009 11:08:00 +0200 + +exactimage (0.7.1-1) unstable; urgency=low + + * Merging upstream version 0.7.1. + * Updating to standards version 3.8.1. + * Adding alternatives to phpapi depends. + * Correcting permissions of ExactImage.py. + + -- Daniel Baumann Sun, 22 Mar 2009 14:23:00 +0100 + +exactimage (0.7.0-1) unstable; urgency=low + + * Merging upstream version 0.7.0. + + -- Daniel Baumann Sun, 22 Mar 2009 13:50:00 +0100 + +exactimage (0.6.9-1) unstable; urgency=low + + * Initial release (Closes: #502183). + + -- Daniel Baumann Sat, 07 Feb 2009 14:45:00 +0100 --- exactimage-0.7.4.orig/debian/python-exactimage.install +++ exactimage-0.7.4/debian/python-exactimage.install @@ -0,0 +1 @@ +/usr/lib/python*/*-packages --- exactimage-0.7.4.orig/debian/exactimage.install +++ exactimage-0.7.4/debian/exactimage.install @@ -0,0 +1 @@ +/usr/bin --- exactimage-0.7.4.orig/debian/python-exactimage.examples +++ exactimage-0.7.4/debian/python-exactimage.examples @@ -0,0 +1 @@ +examples/*.py --- exactimage-0.7.4.orig/debian/exactimage-perl.examples +++ exactimage-0.7.4/debian/exactimage-perl.examples @@ -0,0 +1 @@ +examples/*.pl --- exactimage-0.7.4.orig/debian/control +++ exactimage-0.7.4/debian/control @@ -0,0 +1,77 @@ +Source: exactimage +Section: graphics +Priority: optional +Maintainer: Ubuntu Developers +XSBC-Original-Maintainer: Debian QA Group +Build-Depends: + debhelper (>= 7), libexpat-dev, libfreetype6-dev, libgif-dev, libjasper-dev, + libjpeg-dev, liblcms1-dev, libtiff-dev, libopenexr-dev, libperl-dev, + libpng12-dev, libx11-dev, php5-dev, pkg-config, python, python-all-dev, + python-support (>= 0.5.3), swig, dpatch +Standards-Version: 3.8.3 +Homepage: http://www.exactcode.de/site/open_source/exactimage/ + +Package: exactimage +Architecture: any +Depends: ${shlibs:Depends}, ${misc:Depends} +Description: fast image manipulation programs + ExactImage is a fast C++ image processing library. Unlike ImageMagick, it + allows operation in several color spaces and bit depths natively, resulting in + much lower memory and computational requirements. Some optimized algorithms + operate in 1/20 of the time ImageMagick requires, and displaying large images + can be as fast as 1/10 of the time the "display" program takes. + . + This package contains the utilities. + +Package: exactimage-dbg +Section: debug +Priority: extra +Architecture: any +Depends: exactimage (= ${binary:Version}), exactimage-perl (= ${binary:Version}), php5-exactimage (= ${binary:Version}), python-exactimage (= ${binary:Version}) +Description: fast image manipulation programs (utilities) + ExactImage is a fast C++ image processing library. Unlike ImageMagick, it + allows operation in several color spaces and bit depths natively, resulting in + much lower memory and computational requirements. Some optimized algorithms + operate in 1/20 of the time ImageMagick requires, and displaying large images + can be as fast as 1/10 of the time the "display" program takes. + . + This package contains the debug symbols needed by gdb. + +Package: exactimage-perl +Section: perl +Architecture: any +Depends: ${shlibs:Depends}, ${misc:Depends}, ${perl:Depends} +Description: fast image manipulation programs (Perl bindings) + ExactImage is a fast C++ image processing library. Unlike ImageMagick, it + allows operation in several color spaces and bit depths natively, resulting in + much lower memory and computational requirements. Some optimized algorithms + operate in 1/20 of the time ImageMagick requires, and displaying large images + can be as fast as 1/10 of the time the "display" program takes. + . + This package contains the Perl bindings. + +Package: php5-exactimage +Section: php +Architecture: any +Depends: ${shlibs:Depends}, ${misc:Depends}, ${php:Depends} +Description: fast image manipulation programs (PHP bindings) + ExactImage is a fast C++ image processing library. Unlike ImageMagick, it + allows operation in several color spaces and bit depths natively, resulting in + much lower memory and computational requirements. Some optimized algorithms + operate in 1/20 of the time ImageMagick requires, and displaying large images + can be as fast as 1/10 of the time the "display" program takes. + . + This package contains the PHP bindings. + +Package: python-exactimage +Section: python +Architecture: any +Depends: ${shlibs:Depends}, ${misc:Depends}, ${python:Depends} +Description: fast image manipulation programs (Python bindings) + ExactImage is a fast C++ image processing library. Unlike ImageMagick, it + allows operation in several color spaces and bit depths natively, resulting in + much lower memory and computational requirements. Some optimized algorithms + operate in 1/20 of the time ImageMagick requires, and displaying large images + can be as fast as 1/10 of the time the "display" program takes. + . + This package contains the Python bindings. --- exactimage-0.7.4.orig/debian/pyversions +++ exactimage-0.7.4/debian/pyversions @@ -0,0 +1 @@ +2.4- --- exactimage-0.7.4.orig/debian/compat +++ exactimage-0.7.4/debian/compat @@ -0,0 +1 @@ +7 --- exactimage-0.7.4.orig/debian/exactimage.manpages +++ exactimage-0.7.4/debian/exactimage.manpages @@ -0,0 +1 @@ +debian/manpages/* --- exactimage-0.7.4.orig/debian/pycompat +++ exactimage-0.7.4/debian/pycompat @@ -0,0 +1 @@ +2 --- exactimage-0.7.4.orig/debian/copyright +++ exactimage-0.7.4/debian/copyright @@ -0,0 +1,208 @@ +Author: Rene Rebe +Download: http://dl.exactcode.de/oss/exact-image/ + +Files: * +Copyright: + (C) 2000-2008 Rene Rebe + (C) 2000-2008 Valentin Ziegler + (C) 2007-2008 Lars Kuhtz + (C) 2007-2008 Susanne Klaus + (C) 2006-2008 ExactCODE GmbH + (C) 2006-2008 Archivista GmbH +License: GPL-2 + This program is free software; you can redistribute it and/or + modify it under the terms of the GNU General Public License + as published by the Free Software Foundation; version 2 of the License. + . + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + . + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + . + On Debian systems, the complete text of the GNU General Public License + can be found in /usr/share/common-licenses/GPL-2 file. + +Files: agg-*/*, codecs/agg* +Copyight: (C) 2002-2005 Maxim Shemanarev +License: BSD | other + The Anti-Grain Geometry library is dual-licensed under the BSD license and + its own license. + . + In Debian, the Anti-Grain Geometry library is distributed under BSD. + . + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + . + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + . + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + . + 3. The name of the author may not be used to endorse or promote + products derived from this software without specific prior + written permission. + . + THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, + INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR + SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, + STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + +Files: + codecs/agg_svg_parser.cc, codecs/agg_svg_parser.hh, + codecs/agg_svg_path_renderer.cc, codecs/agg_svg_path_tokenizer.cc +Copyight: + (C) 2002-2005 Maxim Shemanarev + (C) 2008 Rene Rebe +License: BSD | other + The Anti-Grain Geometry library is dual-licensed under the BSD license and + its own license. + . + In Debian, the Anti-Grain Geometry library is distributed under BSD. + . + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + . + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + . + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + . + 3. The name of the author may not be used to endorse or promote + products derived from this software without specific prior + written permission. + . + THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, + INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR + SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, + STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + +Files: codecs/dcraw.h +Copyright: (C) 1997-2008 Dave Coffin +License: GPL-2+ | other + The Dave Coffin's raw photo decoder is dual-licensed under the + GNU General Public License (GPL), and its own license. + . + In Debian, the Anti-Grain Geometry library is distributed under BSD. + . + This program is free software; you can redistribute it and/or + modify it under the terms of the GNU General Public License + as published by the Free Software Foundation; either version 2 + of the License, or (at your option) any later version. + . + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + . + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + . + On Debian systems, the complete text of the GNU General Public License + can be found in /usr/share/common-licenses/GPL-2 file. + +Files: codecs/jinclude.h, codecs/jpegint.h, codecs/transupp.* +Copyright: (C) 1991-1994, Thomas G. Lane +License: other + This file is part of the Independent JPEG Group's free JPEG software, + in Debian packaged as libjpeg6b. + . + LEGAL + ===== + . + In plain English: + . + 1. We don't promise that this software works. (But if you find any bugs, + please let us know!) + . + 2. You can use this software for whatever you want. You don't have to pay us. + . + 3. You may not pretend that you wrote this software. If you use it in a + program, you must acknowledge somewhere in your documentation that + you've used the IJG code. + . + In legalese: + . + The authors make NO WARRANTY or representation, either express or implied, + with respect to this software, its quality, accuracy, merchantability, or + fitness for a particular purpose. This software is provided "AS IS", and you, + its user, assume the entire risk as to its quality and accuracy. + . + This software is copyright (C) 1991-1998, Thomas G. Lane. + All Rights Reserved except as specified below. + . + Permission is hereby granted to use, copy, modify, and distribute this + software (or portions thereof) for any purpose, without fee, subject to these + conditions: + . + (1) If any part of the source code for this software is distributed, then this + README file must be included, with this copyright and no-warranty notice + unaltered; and any additions, deletions, or changes to the original files + must be clearly indicated in accompanying documentation. + . + (2) If only executable code is distributed, then the accompanying + documentation must state that "this software is based in part on the work of + the Independent JPEG Group". + . + (3) Permission for use of this software is granted only if the user accepts + full responsibility for any undesirable consequences; the authors accept + NO LIABILITY for damages of any kind. + . + These conditions apply to any software derived from or based on the IJG code, + not just to the unmodified library. If you use our work, you ought to + acknowledge us. + . + Permission is NOT granted for the use of any IJG author's name or company name + in advertising or publicity relating to this software or products derived from + it. This software may be referred to only as "the Independent JPEG Group's + software". + . + We specifically permit and encourage the use of this software as the basis of + commercial products, provided that all warranty or liability claims are + assumed by the product vendor. + +Files: debian/* +Copyright: (C) 2008-2009 Daniel Baumann +License: GPL-2+ + This program is free software; you can redistribute it and/or + modify it under the terms of the GNU General Public License + as published by the Free Software Foundation; either version 2 + of the License, or (at your option) any later version. + . + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + . + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + . + On Debian systems, the complete text of the GNU General Public License + can be found in /usr/share/common-licenses/GPL-2 file. --- exactimage-0.7.4.orig/debian/rules +++ exactimage-0.7.4/debian/rules @@ -0,0 +1,67 @@ +#!/usr/bin/make -f + +include /usr/share/dpatch/dpatch.make + +PHPAPI = $(shell php-config5 --phpapi) + +clean: unpatch + dh_testdir + dh_testroot + rm -f build-stamp + + [ ! -f config.make ] || $(MAKE) clean + rm -f config.* conftest.* + + dh_clean + +config.status: patch-stamp configure + dh_testdir + + ./configure --prefix=/usr --with-evas=no --with-libagg=no --with-ruby=no + +build: build-stamp +build-stamp: config.status + dh_testdir + + $(MAKE) + + touch build-stamp + +install: build + dh_testdir + dh_testroot + dh_prep + + $(MAKE) prefix=$(CURDIR)/debian/tmp/usr install + + mkdir debian/tmp/usr/lib/php5 + mv debian/tmp/usr/lib/php debian/tmp/usr/lib/php5/$(PHPAPI) + + echo "php:Depends=php5-cli | php5-cgi | phpapi-$(PHPAPI)" >> debian/php5-exactimage.substvars + + chmod 0644 debian/tmp/usr/lib/python*/*-packages/ExactImage.py + +binary: binary-arch + +binary-arch: install + dh_testdir + dh_testroot + dh_installchangelogs + dh_installdocs + dh_installexamples + dh_install --fail-missing --sourcedir=debian/tmp + dh_installman + dh_strip --dbg-package=exactimage-dbg + dh_compress + dh_fixperms + dh_perl + dh_pysupport + dh_installdeb + dh_shlibdeps + dh_gencontrol + dh_md5sums + dh_builddeb + +binary-indep: + +.PHONY: clean build install binary binary-arch binary-indep --- exactimage-0.7.4.orig/debian/php5-exactimage.examples +++ exactimage-0.7.4/debian/php5-exactimage.examples @@ -0,0 +1 @@ +examples/*.php --- exactimage-0.7.4.orig/debian/README.source +++ exactimage-0.7.4/debian/README.source @@ -0,0 +1,38 @@ +This package uses dpatch to manage all modifications to the upstream +source. Changes are stored in the source package as diffs in +debian/patches and applied during the build. + +To get the fully patched source after unpacking the source package, cd +to the root level of the source package and run: + + debian/rules patch + +Removing a patch is as simple as removing its entry from the +debian/patches/00list file, and please also remove the patch file +itself. + +Creating a new patch is done with "dpatch-edit-patch patch XX_patchname" +where you should replace XX with a new number and patchname with a +descriptive shortname of the patch. You can then simply edit all the +files your patch wants to edit, and then simply "exit 0" from the shell +to actually create the patch file. + +To tweak an already existing patch, call "dpatch-edit-patch XX_patchname" +and replace XX_patchname with the actual filename from debian/patches +you want to use. + +To clean up afterwards again, "debian/rules unpatch" will do the +work for you - or you can of course choose to call +"fakeroot debian/rules clean" all together. + + +--- + +this documentation is part of dpatch package, and may be used by +packages using dpatch to comply with policy on README.source. This +documentation is meant to be useful to users who are not proficient in +dpatch in doing work with dpatch-based packages. Please send any +improvements to the BTS of dpatch package. + +original text by Gerfried Fuchs, edited by Junichi Uekawa +10 Aug 2008. --- exactimage-0.7.4.orig/debian/manpages/edentify.1 +++ exactimage-0.7.4/debian/manpages/edentify.1 @@ -0,0 +1,54 @@ +.TH EDENTIFY 1 "2008\-12\-01" "0.6.7" "fast image manipulation programs" + +.SH NAME +edentify \- Image identification module of the ExactImage library + +.SH SYNOPSIS +\fBedentify\fR [\-f|\-\-format \fIFORMAT\fR] [\-v|\-\-verbose] +.PP +\fBedentify\fR \-\-help + +.SH DESCRIPTION +ExactImage is a fast C++ image processing library. Unlike ImageMagick, it allows operation in several color spaces and bit depths natively, resulting in much lower memory and computational requirements. Some optimized algorithms operate in 1/20 of the time ImageMagick requires, and displaying large images can be as fast as 1/10 of the time the "display" program takes. +.PP +edentify is is a command line frontend for the image processing library and mimicks Imagemagick's identify. +.PP +Edentify is used to identify images, that is print the codec, pixel dimensions, resolution and physical sizes (if any resolution is specified in the image data) as well as the color space. +.PP +It is also supported to specify a identify a-like custom format string. + +.SH OPTIONS +.IP "\-f|\-\-format \fIFORMAT\fR" 4 +User defined format string. +.IP "\-v|\-\-verbose" 4 +More verbose output. +.IP "\-\-help" 4 +Displays help text and exits. + +.SH EXAMPLES +$\ edentify lenea.tiff +.br +lenea.tiff: TIFF 512x512 24 bits, 3 channels + +.SH SEE ALSO +\fIexactimage\fR(7) +.PP +\fIbardecode\fR(1) +.PP +\fIe2mtiff\fR(1) +.PP +\fIeconvert\fR(1) +.PP +\fIempty\-page\fR(1) +.PP +\fIhocr2pdf\fR(1) +.PP +\fIoptimize2bw\fR(1) + +.SH HOMEPAGE +More information about edentify and the ExactImage project can be found at <\fIhttp://www.exactcode.de/site/open_source/exactimage/\fR>. + +.SH AUTHOR +ExactImage was written by ExactCODE GmbH <\fIhttp://www.exactcode.de/\fR>. +.PP +This manual page was written by Daniel Baumann <\fIdaniel@debian.org\fR>, for the Debian project (but may be used by others). --- exactimage-0.7.4.orig/debian/manpages/e2mtiff.1 +++ exactimage-0.7.4/debian/manpages/e2mtiff.1 @@ -0,0 +1,43 @@ +.TH E2MTIFF 1 "2008\-12\-01" "0.6.7" "fast image manipulation programs" + +.SH NAME +e2mtiff \- any to multi-page TIFF converter of the ExactImage library + +.SH SYNOPSIS +\fBe2mtiff\fR [\-o|\-\-output \fIOUTPUT\fR] \fIFILE\fR...\fIFILE\fR +.PP +\fBe2mtiff\fR \-\-help + +.SH DESCRIPTION +ExactImage is a fast C++ image processing library. Unlike ImageMagick, it allows operation in several color spaces and bit depths natively, resulting in much lower memory and computational requirements. Some optimized algorithms operate in 1/20 of the time ImageMagick requires, and displaying large images can be as fast as 1/10 of the time the "display" program takes. +.PP +FIXME + +.SH OPTIONS +.IP "\-o|\-\-output \fIOUTPUT\fR" 4 +Output file. +.IP "\-\-help" 4 +Displays help text and exits. + +.SH SEE ALSO +\fIexactimage\fR(7) +.PP +\fIbardecode\fR(1) +.PP +\fIeconvert\fR(1) +.PP +\fIedentify\fR(1) +.PP +\fIempty\-page\fR(1) +.PP +\fIhocr2pdf\fR(1) +.PP +\fIoptimize2bw\fR(1) + +.SH HOMEPAGE +More information about e2mtiff and the ExactImage project can be found at <\fIhttp://www.exactcode.de/site/open_source/exactimage/\fR>. + +.SH AUTHOR +ExactImage was written by ExactCODE GmbH <\fIhttp://www.exactcode.de/\fR>. +.PP +This manual page was written by Daniel Baumann <\fIdaniel@debian.org\fR>, for the Debian project (but may be used by others). --- exactimage-0.7.4.orig/debian/manpages/hocr2pdf.1 +++ exactimage-0.7.4/debian/manpages/hocr2pdf.1 @@ -0,0 +1,70 @@ +.TH HOCR2PDF 1 "2008\-12\-01" "0.6.7" "fast image manipulation programs" + +.SH NAME +hocr2pdf \- hOCR to PDF converter of the ExactImage library + +.SH SYNOPSIS +\fBhocr2pdf\fR [\-c|\-\-concurrent\-lines \fINUMBER\fR] [\-d|\-\-directions \fIBITFIELD\fR] [\-s|\-\-line\-skip \fINUMBER\fR] [\-t|\-\-threshold \fIVALUE\fR] \fIFILE\fR...\fIFILE\fR +.PP +\fBhocr2pdf\fR \-\-help + +.SH DESCRIPTION +ExactImage is a fast C++ image processing library. Unlike ImageMagick, it allows operation in several color spaces and bit depths natively, resulting in much lower memory and computational requirements. Some optimized algorithms operate in 1/20 of the time ImageMagick requires, and displaying large images can be as fast as 1/10 of the time the "display" program takes. +.PP +\fBhocr2pdf\fR is a command line front-end for the image processing library to create perfectly layouted, searchable PDF files from hOCR, annotated HTML, input obtained from an OCR system. + +.SH OPTIONS +.IP "\-i|\-\-input \fIFILE\fR" 4 +Input image filename. +.IP "\-o|\-\-output \fIFILE\fR" 4 +Output PDF filename. +.IP "\-n|\-\-no\-image" 4 +Do not place the image over the text. +.IP "\-r|\-\-resolution \fIRESOLUTION\fR" 4 +Resolution overwrite. +.IP "\-s|\-\-sloppy\-text" 4 +Sloppily place text, group words, do not draw single glyphs. +.IP "\-t|\-\-text" 4 +Extract text, including trying to remove hyphens. +.IP "\-h|\-\-help" 4 +Show summary of options. + +.SH EXAMPLES +\fBCreating a Searchable PDF from hOCR input\fR +.PP +hOCR, annotated HTML, input must be provided to STDIN, and the image data is read using the filename from the \-i or \-\-input argument. For example: +.PP +$\ hocr2pdf \-i scan.tiff \-o test.pdf < cuneiform\-out.hocr +.PP +By default the text layer is hidden by the real image data. Including image data can be disabled via the \-n, \-\-no\-image, so that just the recognized text from the OCR is visible \- e.g. for debugging or to save storage space: +.PP +$\ hocr2pdf \-i scan.tiff \-n \-o test.pdf < cuneiform\-out.hocr + +\fBToo many gabs between letters in individual words\fR +.PP +This might be a problem with imprecise OCR data or justified text with huge gabs. ExactImage includes a special mode activated with the command line argument \-s, \-\-sloppy\-text, to group glyphs between whitespace to words which can help PDF viewers to produce better results while cut and pasting text: +.PP +$\ hocr2pdf \-i scan.tiff \-s \-o test.pdf < cuneiform\-out.hocr + +.SH SEE ALSO +\fIexactimage\fR(7) +.PP +\fIbardecode\fR(1) +.PP +\fIe2mtiff\fR(1) +.PP +\fIeconvert\fR(1) +.PP +\fIedentify\fR(1) +.PP +\fIempty\-page\fR(1) +.PP +\fIoptimize2bw\fR(1) + +.SH HOMEPAGE +More information about hocr2pdf and the ExactImage project can be found at <\fIhttp://www.exactcode.de/site/open_source/exactimage/\fR>. + +.SH AUTHOR +ExactImage was written by ExactCODE GmbH <\fIhttp://www.exactcode.de/\fR>. +.PP +This manual page was written by Daniel Baumann <\fIdaniel@debian.org\fR>, for the Debian project (but may be used by others). --- exactimage-0.7.4.orig/debian/manpages/optimize2bw.1 +++ exactimage-0.7.4/debian/manpages/optimize2bw.1 @@ -0,0 +1,61 @@ +.TH OPTIMIZE2BW 1 "2008\-12\-01" "0.6.7" "fast image manipulation programs" + +.SH NAME +optimize2bw \- optimzed color/gray image to bw conversation + +.SH SYNOPSIS +\fBoptimize2bw\fR [\-n|\-\-denoise] [\-d|\-\-dpi \fIDPI\fR] [\-h|\-\-high \fIVALUE\fR] [\-l|\-\-low \fIVALUE\fR] [\-r|\-\-radius \fIRADIUS\fR] [\-s|\-\-scale \fISCALE\fR] [\-sd|\-\-standard\-deviation \fIDEVIATION\fR] [\-t|\-\-threshold \fIVALUE\fR] \-i|\-\-input \fIFILE\fR \-o|\-\-output \fIFILE\fR +.PP +\fBoptimize2bw\fR \-\-help + +.SH DESCRIPTION +ExactImage is a fast C++ image processing library. Unlike ImageMagick, it allows operation in several color spaces and bit depths natively, resulting in much lower memory and computational requirements. Some optimized algorithms operate in 1/20 of the time ImageMagick requires, and displaying large images can be as fast as 1/10 of the time the "display" program takes. +.PP +\fBoptmize2bw\fR reads shaded, color or gray image files and does perform automatic thresholding and optional scaling on the data. It is useful for long term archiving of documents that have to be stored in sub-byte black and white data to reduce storage requirements. + +.SH OPTIONS +.IP "\-i, \-\-input \fIFILE\fR" 4 +Input file. +.IP "\-o, \-\-output \fIFILE\fR" 4 +Output file. +.IP "\-n, \-\-denoise" 4 +Remove ("denoise") single bit pixel noise. +.IP "\-d, \-\-dpi \fIDPI\fR" 4 +Scale to specified DPI. +.IP "-h value, --high value +High normalization value. +.IP "\-l, \-\-low \fIVALUE\fR" 4 +Low normalization value. +.IP "\-r, \-\-radius \fIRADIUS\fR" 4 +"unsharp mask" radius. +.IP "\-s, \-\-scale \fISCALE\fR" 4 +Scale output by factor. +.IP "\-sd, \-\-standard\-deviation \fIDEVIATION\fR" 4 +Standard deviation for Gaussian distribution. +.IP "\-t, \-\-threshold \fIVALUE\fR" 4 +Threshold value. +.IP "\-\-help" 4 +Show summary of options. + +.SH SEE ALSO +\fIbardecode\fR(1) +.PP +\fIexactimage\fR(7) +.PP +\fIe2mtiff\fR(1) +.PP +\fIeconvert\fR(1) +.PP +\fIedentify\fR(1) +.PP +\fIempty\-page\fR(1) +.PP +\fIhocr2pdf\fR(1) + +.SH HOMEPAGE +More information about optimize2bw and the ExactImage project can be found at <\fIhttp://www.exactcode.de/site/open_source/exactimage/\fR>. + +.SH AUTHOR +ExactImage was written by ExactCODE GmbH <\fIhttp://www.exactcode.de/\fR>. +.PP +This manual page was written by Daniel Baumann <\fIdaniel@debian.org\fR>, for the Debian project (but may be used by others). --- exactimage-0.7.4.orig/debian/manpages/bardecode.1 +++ exactimage-0.7.4/debian/manpages/bardecode.1 @@ -0,0 +1,56 @@ +.TH BARDECODE 1 "2008\-12\-01" "0.6.7" "fast image manipulation programs" + +.SH NAME +bardecode \- barcode recognition module of the ExactImage library + +.SH SYNOPSIS +\fBbardecode\fR [\-c|\-\-concurrent\-lines \fINUMBER\fR] [\-d|\-\-directions \fIBITFIELD\fR] [\-s|\-\-line\-skip \fINUMBER\fR] [\-t|\-\-threshold \fIVALUE\fR] \fIFILE\fR...\fIFILE\fR +.PP +\fBbardecode\fR \-\-help + +.SH DESCRIPTION +ExactImage is a fast C++ image processing library. Unlike ImageMagick, it allows operation in several color spaces and bit depths natively, resulting in much lower memory and computational requirements. Some optimized algorithms operate in 1/20 of the time ImageMagick requires, and displaying large images can be as fast as 1/10 of the time the "display" program takes. + +.SH OPTIONS +.IP "\-c|\-\-concurrent\-lines \fINUMBER\fR" 4 +Number of lines that are scanned concurrently. +.IP "\-d|\-\-directions \fIBITFIELD\fR" 4 +Bitfield of directions to be scanned (0 none,1 left-to-right,2 top-down, 4 right-to-left, 8-down-top, 15 any). +.IP "\-s|\-\-line\-skip \fINUMBER\fR" 4 +Number of lines that are skipped. +.IP "\-t|\-\-threshold \fIVALUE\fR" 4 +Bi-level threshold value. +.IP "\-\-help" 4 +Displays help text and exits. + +.SH EXAMPLES +$\ bardecode files/* +.br +files/1.tif: XDM152EU\-U [type: code39 at: (1094,392)] +.br +files/2.tif: 471186080198 [type: ean13 at: (1148,32)] +.br +files/3.tif: 06396500104997 [type: code128 at: (578,83)] + +.SH SEE ALSO +\fIexactimage\fR(7) +.PP +\fIe2mtiff\fR(1) +.PP +\fIeconvert\fR(1) +.PP +\fIedentify\fR(1) +.PP +\fIempty\-page\fR(1) +.PP +\fIhocr2pdf\fR(1) +.PP +\fIoptimize2bw\fR(1) + +.SH HOMEPAGE +More information about bardecode and the ExactImage project can be found at <\fIhttp://www.exactcode.de/site/open_source/exactimage/\fR>. + +.SH AUTHOR +ExactImage was written by ExactCODE GmbH <\fIhttp://www.exactcode.de/\fR>. +.PP +This manual page was written by Daniel Baumann <\fIdaniel@debian.org\fR>, for the Debian project (but may be used by others). --- exactimage-0.7.4.orig/debian/manpages/exactimage.7 +++ exactimage-0.7.4/debian/manpages/exactimage.7 @@ -0,0 +1,131 @@ +.TH exactimage 7 "2008\-12\-01" "0.6.7" "fast image manipulation programs" + +.SH NAME +exactimage \- fast, modern and generic image processing library + +.SH DESCRIPTION +For a client we had to optimize the insane time ImageMagick spent on certain image processing tasks. After the first code review it became clear that imagemagick was coded for anything but speed. +.PP +We prototyped the needed code in C++, just for speed, and achieved processing times about 1/20 of what ImageMagick consumes. +.PP +In the library we will explore several new algorithms, e.g. for de-screening, de-skewing, data-dependant triangulation scaling, lossless JPEG transforms and others as we see need. You are very much welcome to contribute thrilling state-of-the-art algorithms. +.PP +The included codecs take C++ STL std::istreams and std::ostreams allowing library users to implement their own data sources and destinations, such as in memory locations or network transfers. +.PP +It is intended to become a modern, generic (template) based C++ library, as time permits. - Hopefully a viable alternative to ImageMagick. +.PP +Since the 0.6 release series ExactImage comes with a completely rewritten PDF codec, which is not only capable of dumping image data into a PDF container, but offers complete support for arbitrary vector data, vector font writing support as well as multi-page documents. Based on the new PDF codec a new command line front-end named "hocr2pdf" is included which allows creating searchable PDFs out of hOCR annotated HTML as obtained from some OCR engines. +.PP +Since the 0.5 release series ExactImage comes with the first open-source, GPL, barcode recognition support ever, an additional, high-performance image pixel iteration, code generation facility was added, providing an additional speed boost over the former, pre-0.5 Image iteration implementation. All algorithms converted to the new iterator can profit from up to 10x acceleration. Support for writing non-RGB BMP files, as well as EPS, PS and PDF files and rendering some SVG files was added. Additionally, language bindings for PHP, Python and Lua can be generated by the build system (pre-0.5 only a Perl bindings was generated). +.PP +Since the 0.4 release series ExactImage supports drawing vector graphic thru the Anti Grain Geometry rendering engine as well as image segmentation and fuzzy image pattern matching. +.PP +Since the 0.3 release series ExactImage supports per-codec acceleration of rotation, flipping, scaling and color-space conversion (for JPEG, ala jpegtran) as well as on-demand decoding. +.PP +Since the 0.2 release series ExactImage comes with a stable, simple and easy to use external API including SWIG support, thus allowing the use out of any SWIG supported scripting language, such as Perl, PHP, Python, Ruby or LUA. + +.SH IMAGE FORMATS +\fBSupported image formats\fR +.PP +ExactImage currently already supports most wide-spread image formats. We plan to add at least one new format with each major version release. Currently supported: +.PP +.IP "BMP:" 4 +Internal C++ library in absence of an external one. +.IP "Digital Camera RAW:" 4 +Via incooperated dcraw code, might use libopenraw in the future. +.IP "GIF:" 4 +Via libungif. +.IP "JPEG:" 4 +Via libjpeg, including lossless transformations. +.IP "JPEG2000:" 4 +Via jasper, might use openjpeg in the future. +.IP "OpenEXR:" 4 +Via the official libOpenEXR. +.IP "PNG:" 4 +Via libpng. +.IP "PBM:" 4 +Internal C++ code as netpbm does not support arbitrary source and destination. +.IP "RAW:" 4 +Internal C++ code to be able to decode in-memory RAW data. +.IP "TIFF:" 4 +Via libtiff and it's C++ binding. +.IP "XPM:" 4 +Internal C++ code. +.IP "SVG:" 4 +Internal C++ code via Agg, read-only. +.IP "PDF:" 4 +Internal C++ code, write-only, allows embedding JPEG and JPEG2000, as well as vector geometry & fonts and write multiple pages. +.IP "PS:" 4 +Internal C++ code, write-only, allows embedding JPEG. +.IP "EPS:"4 +Internal C++ code, write-only, allows embedding JPEG. +.PP + +\fBNext to implement\fR +.PP +Apple Icon Image, Windows Icon Image file format, PCX, Targa, JBIG, Fax files, sgi, Sun, DJVU, ... +.PP +If you miss a format important for you do not hesitate to contact us. + +.SH API +Since version 0.2 ExactImage includes script binding generated through SWIG. This API is supposed to be stable and if changes are done backward compatibility is guaranteed to be preserved. +.PP +We decided to be that strong with the external API stability even in this early stage of development, because ever changing APIs just annoy any serious programmer away and ExactImage is deployed in production solutions by partner companies. +.PP +Incrementally over version 0.3, and 0.4 the external API was extended with functionality as required by partner companies and build for the Perl language by default. +.PP +Since version 0.5 ExactImage comes with built-in support to generate not only the Perl, but additionally PHP, Python and Lua laguange bindings - if the specific language support is detected and requested during configuration. +.PP +In the future we will provide API documentation at this place as well as in-depth introduction and examples. + +.SH LOSSLESS JPEG +The JPEG format is based on the Discrete Cosine Transform (DCT) performed on equally sized blocks of the pixel image data. With this in mind one can conclude that it is possible to perform some transformations on the image data directly on these DCT coefficients by just moving and transforming the coefficients. +.PP +As just working on the DCT coefficients is less expensive (in terms of CPU cycles) as the decoding and re-encoding process is skipped, it saving a lot time and additionally prevents new compression artefacts. +.PP +Lossless JPEG transformations where first implemented in the Open Source jpegtran program - a companion application of the JPEG library, but as using a different tool or library for every image format is a bit unhandy. Support for these transformations based on the jpegtran code was added to ExactImage version 0.3.0. +.PP +ExactImage 0.3.0 supports lossless: +.br +* orthogonal rotations (90, 180, 270 degree) +.br +* flipping the image data on the X and Y axis +.PP +ExactImage 0.3.1 further introduced: +.br +* fast color image to gray conversion +.br +* fast down-scaling by partial decoding DCT coefficients +.PP +ExactImage 0.4.1 further introduced: +.br +* cropping +.PP +Common with all this operations is that they are way faster than performing the pixel-level algorithm on the decoded image data and (aside down-scaling) do not introduce new artefacts. +.PP +Fast down-scaling is also implemented by Enlightenment's EPEG library explicitly and we should mention that EPEG is slightly faster, but with cost to image quality - mostly because it does just nearest neighbor scaling of the residual scaling applied on top of the partial DCT decoding: +.PP +A trick how to get a few percent faster down-scaling is outlined in the econvert examples section of \fIeconvert\fR(1). + +.SH SEE ALSO +\fIbardecode\fR(1) +.PP +\fIe2mtiff\fR(1) +.PP +\fIeconvert\fR(1) +.PP +\fIedentify\fR(1) +.PP +\fIempty\-page\fR(1) +.PP +\fIhocr2pdf\fR(1) +.PP +\fIoptimize2bw\fR(1) + +.SH HOMEPAGE +More information about the ExactImage project can be found at <\fIhttp://www.exactcode.de/site/open_source/exactimage/\fR>. + +.SH AUTHOR +ExactImage was written by ExactCODE GmbH <\fIhttp://www.exactcode.de/\fR>. +.PP +This manual page was written by Daniel Baumann <\fIdaniel@debian.org\fR>, for the Debian project (but may be used by others). --- exactimage-0.7.4.orig/debian/manpages/empty-page.1 +++ exactimage-0.7.4/debian/manpages/empty-page.1 @@ -0,0 +1,54 @@ +.TH EMPTY\-PAGE 1 "2008\-12\-01" "0.6.7" "fast image manipulation programs" + +.SH NAME +empty-page \- Empty page detector of the ExactImage library + +.SH SYNOPSIS +\fBempty\-page\fR [\-i|\-\-input \fIINPUT\fR] [\-m|\-\-margin \fIMARGIN\fR] [\-p|\-\-percentage \fIPERCENTAGE\fR] +.PP +\fBempty-page\fR \-\-help + +.SH DESCRIPTION +ExactImage is a fast C++ image processing library. Unlike ImageMagick, it allows operation in several color spaces and bit depths natively, resulting in much lower memory and computational requirements. Some optimized algorithms operate in 1/20 of the time ImageMagick requires, and displaying large images can be as fast as 1/10 of the time the "display" program takes. +.PP +empty-page counts the dark pixels of a black and white TIFF and decides with a threshold whether the page is most probably empty, and thus can be removed from the image processing stream. + +.SH OPTIONS +.IP "\-i|\-\-input \fIINPUT\fR" 4 +Input file. +.IP "\-m|\-\-margin \fIMARGIN\fR" 4 +Border margin to skip. +.IP "\-p|\-\-percentage \fIPERCENTAGE\fR" 4 +Coverate for non\-empty page. +.IP "\-\-help" 4 +Displays help text and exits. + +.SH EXAMPLES +$\ empty-page \-i test.tif +.br +The image has 75461 dark pixels from a total of 1060992 (7.11231%). +.br +non-empty + +.SH SEE ALSO +\fIexactimage\fR(7) +.PP +\fIbardecode\fR(1) +.PP +\fIe2mtiff\fR(1) +.PP +\fIeconvert\fR(1) +.PP +\fIedentify\fR(1) +.PP +\fIhocr2pdf\fR(1) +.PP +\fIoptimize2bw\fR(1) + +.SH HOMEPAGE +More information about bardecode and the ExactImage project can be found at <\fIhttp://www.exactcode.de/site/open_source/exactimage/\fR>. + +.SH AUTHOR +ExactImage was written by ExactCODE GmbH <\fIhttp://www.exactcode.de/\fR>. +.PP +This manual page was written by Daniel Baumann <\fIdaniel@debian.org\fR>, for the Debian project (but may be used by others). --- exactimage-0.7.4.orig/debian/manpages/econvert.1 +++ exactimage-0.7.4/debian/manpages/econvert.1 @@ -0,0 +1,168 @@ +.TH ECONVERT 1 "2008\-12\-01" "0.6.7" "fast image manipulation programs" + +.SH NAME +econvert \- Image converter of the ExactImage library + +.SH SYNOPSIS +\fBeconvert\fR [\-\-background] [\-\-bicubic-scale] [\-\-bilinear-scale] [\-\-blur] [\-\-box-scale] [\-\-brightness] [\-\-colorspace] [\-\-compress] [\-\-contrast] [\-\-convolve] [\-\-crop] [\-\-ddt\-scale] [\-\-decompress] [\-\-deinterlace] [\-\-deskew] [\-\-edge] [\-\-fast-auto-crop] [\-\-flip] [\-\-flop] [\-\-floyd-steinberg] [\-\-foreground] [\-\-gamma] [\-\-hue] [\-i|\-\-input \fIINPUT\fR] [\-\-lightness] [\-\-line] [\-\-nearest\-scale] [\-\-negate] [\-\-normalize] [\-o|\-\-output \fIOUTPUT\fR] [\-\-quality] [\-\-resolution] [\-\-riemersma] [\-\-rotate] [\-\-saturation] [\-\-scale] [\-\-size] [\-\-split] [\-\-text] +.PP +\fBeconvert\fR \-\-help + +.SH DESCRIPTION +ExactImage is a fast C++ image processing library. Unlike ImageMagick, it allows operation in several color spaces and bit depths natively, resulting in much lower memory and computational requirements. Some optimized algorithms operate in 1/20 of the time ImageMagick requires, and displaying large images can be as fast as 1/10 of the time the "display" program takes. +.PP +\fBeconvert\fR is a command line frontend for the image processing library and mimicks Imagemagick's convert. However since some aspects of the convert arguments are too limited (e.g. even now we have two ditherizers to select from) or annoying (colorspace conversion is quite unintuitive to control with Imagemagick and the data is often blown up to an more generic colorspace) the econvert syntax never will be 1:1 compatible with convert. Also because those options only start with one dash (\-) ... or are named density rather than resolution and so on. + +.SH OPTIONS +.IP "\-\-background" 4 +Background color used for operations. +.IP "\-\-bicubic-scale" 4 +Scale image data with bi-cubic filter. +.IP "\-\-bilinear-scale" 4 +Scale image data with bi-linear filter. +.IP "\-\-blur" 4 +Gaussian blur. +.IP "\-\-box-scale" 4 +(Down)scale image data with box filter. +.IP "\-\-brightness" 4 +Change image brightness. +.IP "\-\-colorspace" 4 +Convert image colorspace (BW, BILEVEL, GRAY, GRAY1, GRAY2, GRAY4, RGB, YUV, CYMK). +.IP "\-\-compress" 4 +Compression method for writing images (e.g. G3, G4, Zip, ...) depending on the output format, a reasonable setting by default. +.IP "\-\-contrast" 4 +Change image contrast. +.IP "\-\-convolve" 4 +Convolution matrix. +.IP "\-\-crop" 4 +Crop an area out of an image: x,y,w,h. +.IP "\-\-ddt\-scale" 4 +Scale image data with data dependant triangulation. +.IP "\-\-decompress" 4 +Decompression method for reading images (e.g. thumb) depending on the input format, allowing to read partial data. +.IP "\-\-deinterlace" 4 +Shuffleg every 2nd line. +.IP "\-\-deskew" 4 +Deskew digitalized paper. +.IP "\-\-edge" 4 +Edge detect filter. +.IP "\-\-fast-auto-crop" 4 +Fast auto crop. +.IP "\-\-flip" 4 +Flip the image vertically. +.IP "\-\-flop" 4 +Flip the image horizontally. +.IP "\-\-floyd-steinberg" 4 +Floyd Steinberg dithering using n shades. +.IP "\-\-foreground" 4 +Foreground color used for operations. +.IP "\-\-gamma" 4 +Change image gamma. +.IP "\-\-hue" 4 +Change image hue. +.IP "\-i|\-\-input \fIINPUT\fR" 4 +Input file or '\-' for stdin, optionally prefixed with format: e.g: jpg:\- or raw:rgb8\-dump. +.IP "\-\-lightness" 4 +Change image lightness. +.IP "\-\-line" 4 +Draw a line: x1, y1, x2, y2. +.IP "\-\-nearest\-scale" 4 +Scale image data to nearest neighbour. +.IP "\-\-negate" 4 +Negates the image. +.IP "\-\-normalize" 4 +Transform the image to span the full color range. +.IP "\-o|\-\-output \fIOUTPUT\fR" 4 +Output file or '\-' for stdout, optinally prefix with format: e.g. jpg:\- or raw:rgb8\-dump. +.IP "\-\-quality" 4 +Quality setting used for writing compressed images integer range 0\-100, the default is 75. +.IP "\-\-resolution" 4 +Set meta data resolution in dpi to x[xy] e.g. 200 or 200x400. +.IP "\-\-riemersma" 4 +Riemersma dithering using n shades. +.IP "\-\-rotate" 4 +Rotation angle. +.IP "\-\-saturation" 4 +Change image saturation. +.IP "\-\-scale" 4 +Scale image data using a method suitable for specified factor. +.IP "\-\-size" 4 +Width and height of raw images whose dimensions are unknown. +.IP "\-\-split" 4 +Filenames to save the images split in Y\-direction into n parts. +.IP "\-\-text" 4 +Draw text: x1, y1, height, text. +.IP "\-\-help" 4 +Displays help text and exits. + +.SH EXAMPLES +\fBBasics\fR +.PP +First image data must be read using \-i or \-\-input, processing routines are selected by their name with two leading dashes (e.g. \-\-rotate) and at any point the data might be written into a file with \-o or \-\-output, for example: +.PP +$\ econvert \-i lenea.tiff \-\-box\-scale 0.5 \-o medium.png \-\-box\-scale 0.5 \-o little.png +.PP +Since version 0.3 the library tries to delay image decoding as much as possible and provides lossless and accelerated algorithms to work on compressed data (such as JPEGs) directly: +.PP +$\ econvert \-i AV220\-Scan.JPG \-\-resolution 300x300 \-o 1.jpg \-\-rotate 90 \-o 2.jpg \-\-rotate 180 \-o 3.jpg \-\-rotate \-90 \-o 4.jpg \-\-flip \-o 5.jpg \-\-flop \-o 6.jpg \-\-scale 0.25 \-o thumb.jpg +.PP +In this example 1.jpg will be created from the original JPEG DCT coefficients, those coefficients will be rearranged and 2.jpg, 3.jpg, 4.jpg, 5.jpg and 6.jpg will be written without any additional loss in precision (no new JPEG artefacts) and with outstanding speed. Only at the end, for image thumb.jpg, the DCT will actually be decoded \- but due to the accelerated JPEG scaling only partially! The whole chain of operations applied to an 8 bit RGB JPEG only takes 0.99s on 2GHz Intel Core2. +.PP + +\fBThumbnails of black and white (bi\-level) images\fR +.PP +When 1 bit, black and white, images are scaled down the output often might look pretty awful. The box scaling algorithm usually does a pretty good job thumbnailing b/w images, however as the ExactImage algorithms always operate in the color\-space the image data is stored in the colorspace must be changed (e.g. to 8 bit gray) before applying the box scaler. At the end the result might be converted back to just a few shades of gray such as 2 or 4 bit: +.PP +$\ econvert \-i avision\-bw\-scan.pbm \-\-colorspace gray8 \-\-box\-scale 0.125 \-\-colorspace gray2 \-o thumb.png +.PP + +\fBSlightly faster JPEG down\-scaling\fR +.PP +As outlined in the lossless JPEG page, ExactImage is slightly slower than EPEG, though with noticeable higher output quality. If you do not care about quality, only about bare thruput (maybe in an web application?) you can force nearest neighbor scaling by just specifing a scale factor the JPEG decoder can accellerate (1/2, 1/4, or 1/8) and apply the remaining scalling manually. To archive a faster scaling with the effective factor 0.33: +.PP +$\ econvert \-i big.jpg \-\-scale .5 \-\-nearest\-scale 0.66 \-o thumb.jpg +.PP + +\fBWorking with digital camera RAW data\fR +.PP +Digital still camera raw images differ from model to model and are sometimes even obfuscated to prevent loading by third parties. However, ExactImage supports a wide range of RAW formats thanks to the embedded dcraw code (we had to embed a copy of dcraw as the orignal project is only available as a command line program and not in form of a library \- ExactImage needs to have some more control about how the image data is passed around, e.g. in memory and not by pipes). +.PP +Usually decoding of RAW data should be transparent and automatic, however some formats also are valid TIFF files and the embedded thumbnail might be picked by ExactImage's TIFF support in favour of the actual RAW content. This this cases the dcraw backend decoder can explicitly be request with the decoder prefix of the input parameter: +.PP +$\ econvert \-i dcraw:img_0123.cr2 ... +.PP +As of version 0.6.5 ExactImage also allows to quickly extract the embedded thumbnail preview, if any, by specifing "thumb"(nail) as decompress argument before the image is loaded: +.PP +$\ econvert \-\-decompress thumb \-i dcraw:img_0123.cr2 ... +.PP +This usually just takes parts of a second and is useful to generate previews, galleries, etc. +.PP + +\fBLoading real raw data\fR +.PP +While working on algorithms, dumping frame\-buffer content or doing low\-level driver development it often is handy to also load arbitrary RAW pixel data. Via the "raw:" codec specification this is possible in econvert. As econvert does use the current color\-depth (colorspace) and size for the raw data they have to be specified before loading the image like this: +.PP +$\ econvert \-\-size 1696x32 \-\-colorspace rgb8 \-i raw:data\-file ... + +.SH SEE ALSO +\fIexactimage\fR(7) +.PP +\fIbardecode\fR(1) +.PP +\fIe2mtiff\fR(1) +.PP +\fIedentify\fR(1) +.PP +\fIempty\-page\fR(1) +.PP +\fIhocr2pdf\fR(1) +.PP +\fIoptimize2bw\fR(1) + +.SH HOMEPAGE +More information about econvert and the ExactImage project can be found at <\fIhttp://www.exactcode.de/site/open_source/exactimage/\fR>. + +.SH AUTHOR +ExactImage was written by ExactCODE GmbH <\fIhttp://www.exactcode.de/\fR>. +.PP +This manual page was written by Daniel Baumann <\fIdaniel@debian.org\fR>, for the Debian project (but may be used by others). --- exactimage-0.7.4.orig/debian/patches/10-python26_ready.dpatch +++ exactimage-0.7.4/debian/patches/10-python26_ready.dpatch @@ -0,0 +1,19 @@ +#! /bin/sh /usr/share/dpatch/dpatch-run +## 10-python26_ready.dpatch by Alessio Treglia +## +## All lines beginning with `## DP:' are a description of the patch. +## DP: Description: Patch to install all python modules in to Python 2.6 path. +## DP: Author: Alessio Treglia + +@DPATCH@ +diff -urNad exactimage-0.7.3~/api/python/Makefile exactimage-0.7.3/api/python/Makefile +--- exactimage-0.7.3~/api/python/Makefile 2008-10-18 11:11:43.000000000 +0200 ++++ exactimage-0.7.3/api/python/Makefile 2009-05-05 12:05:15.572178932 +0200 +@@ -20,5 +20,5 @@ + all:: $($(X_MODULE)_BINARY) + install:: $($(X_MODULE)_BINARY) + $(Q)echo "INSTALL PYTHON module $^" +- $(Q)mkdir -p $(DESTDIR)$(libdir)/python2.5/site-packages/ +- $(Q)install $(dir $^)/ExactImage.py $^ $(DESTDIR)$(libdir)/python2.5/site-packages/ ++ $(Q)mkdir -p $(DESTDIR)$(libdir)/python2.6/dist-packages/ ++ $(Q)install $(dir $^)/ExactImage.py $^ $(DESTDIR)$(libdir)/python2.6/dist-packages/ --- exactimage-0.7.4.orig/debian/patches/00list +++ exactimage-0.7.4/debian/patches/00list @@ -0,0 +1 @@ +10-python26_ready