annotate servlet/src/digilib/image/DocuImageImpl.java @ 469:11e11fe4d680

Improved performance of JAIDocuImage for large images - simulated subsampling by scaling
author robcast
date Wed, 15 Feb 2006 00:09:50 +0100
parents f1f710ff14ad
children 1760b19df530
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
1 /* DocuImage -- General image interface class implementation
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
2
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
3 Digital Image Library servlet components
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
4
85
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
5 Copyright (C) 2001, 2002, 2003 Robert Casties (robcast@mail.berlios.de)
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
6
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
7 This program is free software; you can redistribute it and/or modify it
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
8 under the terms of the GNU General Public License as published by the
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
9 Free Software Foundation; either version 2 of the License, or (at your
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
10 option) any later version.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
11
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
12 Please read license.txt for the full details. A copy of the GPL
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
13 may be found at http://www.gnu.org/copyleft/lgpl.html
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
14
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
15 You should have received a copy of the GNU General Public License
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
16 along with this program; if not, write to the Free Software
73
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
17 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
18
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
19 */
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
20
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
21 package digilib.image;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
22
85
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
23 import java.awt.Rectangle;
462
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
24 import java.io.File;
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
25 import java.io.IOException;
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
26 import java.io.RandomAccessFile;
464
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
27 import java.util.Iterator;
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
28 import java.util.LinkedList;
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
29 import java.util.List;
85
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
30
181
afe7ff98bb71 Servlet version 1.18b1
robcast
parents: 159
diff changeset
31 import org.apache.log4j.Logger;
464
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
32 import org.marcoschmidt.image.ImageInfo;
181
afe7ff98bb71 Servlet version 1.18b1
robcast
parents: 159
diff changeset
33
afe7ff98bb71 Servlet version 1.18b1
robcast
parents: 159
diff changeset
34 import digilib.io.FileOpException;
159
e743b853efca servlet version 1.16a4
robcast
parents: 149
diff changeset
35 import digilib.io.ImageFile;
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
36
73
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
37 /** Simple abstract implementation of the <code>DocuImage</code> interface.
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
38 *
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
39 * This implementation provides basic functionality for the utility methods like
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
40 * <code>SetUtils</code>, and <code>getKnownFileTypes</code>. Image methods like
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
41 * <code>loadImage</code>, <code>writeImage</code>, <code>getWidth</code>,
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
42 * <code>getHeight</code>, <code>crop</code> and <code>scale</code> must be
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
43 * implemented by derived classes.
73
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
44 */
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
45 public abstract class DocuImageImpl implements DocuImage {
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
46
181
afe7ff98bb71 Servlet version 1.18b1
robcast
parents: 159
diff changeset
47 /** logger */
469
11e11fe4d680 Improved performance of JAIDocuImage for large images
robcast
parents: 464
diff changeset
48 protected static final Logger logger = Logger.getLogger(DocuImage.class);
181
afe7ff98bb71 Servlet version 1.18b1
robcast
parents: 159
diff changeset
49
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
50 /** Interpolation quality. */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
51 protected int quality = 0;
85
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
52
86
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
53 /** epsilon for float comparisons. */
85
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
54 public final double epsilon = 1e-5;
86
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
55
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
56 /** image mime-type */
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
57 protected String mimeType = null;
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
58
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
59 /**
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
60 * Returns the quality.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
61 * @return int
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
62 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
63 public int getQuality() {
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
64 return quality;
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
65 }
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
66
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
67 /**
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
68 * Sets the quality.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
69 * @param quality The quality to set
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
70 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
71 public void setQuality(int quality) {
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
72 this.quality = quality;
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
73 }
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
74
462
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
75 /** Check image size and type and store in ImageFile f */
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
76 public boolean identify(ImageFile imgf) throws IOException {
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
77 // fileset to store the information
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
78 File f = imgf.getFile();
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
79 if (f == null) {
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
80 throw new IOException("File not found!");
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
81 }
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
82 RandomAccessFile raf = new RandomAccessFile(f, "r");
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
83 // set up ImageInfo object
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
84 ImageInfo iif = new ImageInfo();
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
85 iif.setInput(raf);
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
86 iif.setCollectComments(false);
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
87 iif.setDetermineImageNumber(false);
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
88 logger.debug("identifying (ImageInfo) " + f);
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
89 // try with ImageInfo first
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
90 if (iif.check()) {
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
91 ImageSize d = new ImageSize(iif.getWidth(), iif.getHeight());
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
92 imgf.setSize(d);
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
93 imgf.setMimetype(iif.getMimeType());
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
94 //logger.debug(" format:"+iif.getFormatName());
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
95 raf.close();
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
96 logger.debug("image size: " + imgf.getSize());
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
97 return true;
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
98 }
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
99 return false;
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
100 }
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
101
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
102 /** Crop and scale the current image.
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
103 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
104 * The current image is cropped to a rectangle of width, height at position
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
105 * x_off, y_off. The resulting image is scaled by the factor scale using the
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
106 * interpolation quality qual (0=worst).
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
107 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
108 * @param x_off X offset of the crop rectangle in pixel.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
109 * @param y_off Y offset of the crop rectangle in pixel.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
110 * @param width Width of the crop rectangle in pixel.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
111 * @param height Height of the crop rectangle in pixel.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
112 * @param scale Scaling factor.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
113 * @param qual Interpolation quality (0=worst).
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
114 * @throws ImageOpException Exception thrown on any error.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
115 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
116 public void cropAndScale(
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
117 int x_off, int y_off, int width, int height, double scale, int qual)
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
118 throws ImageOpException {
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
119
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
120 setQuality(qual);
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
121 crop(x_off, y_off, width, height);
149
04ad64b2137a Servlet version 1.14b1
robcast
parents: 122
diff changeset
122 scale(scale, scale);
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
123 }
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
124
86
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
125 public String getMimetype() {
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
126 return mimeType;
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
127 }
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
128
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
129 public void rotate(double angle) throws ImageOpException {
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
130 // just a do-nothing implementation
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
131 }
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
132
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
133 public void mirror(double angle) throws ImageOpException {
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
134 // just a do-nothing implementation
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
135 }
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
136
86
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
137 public void enhance(float mult, float add) throws ImageOpException {
85
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
138 // just a do-nothing implementation
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
139 }
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
140
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
141 public boolean isSubimageSupported() {
86
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
142 // partial loading not supported per default
85
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
143 return false;
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
144 }
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
145
159
e743b853efca servlet version 1.16a4
robcast
parents: 149
diff changeset
146 public void loadSubimage(ImageFile f, Rectangle region, int subsample)
85
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
147 throws FileOpException {
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
148 // empty implementation
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
149 }
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
150
86
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
151 public void enhanceRGB(float[] rgbm, float[] rgba)
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
152 throws ImageOpException {
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
153 // emtpy implementation
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
154 }
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
155
207
1a65d8e43620 Servlet version 1.18b9 -- cleanup and bugfixes
robcast
parents: 185
diff changeset
156 public void dispose() {
464
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
157 // emtpy implementation
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
158 }
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
159
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
160 public Iterator getSupportedFormats() {
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
161 List empty = new LinkedList();
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
162 return empty.iterator();
207
1a65d8e43620 Servlet version 1.18b9 -- cleanup and bugfixes
robcast
parents: 185
diff changeset
163 }
1a65d8e43620 Servlet version 1.18b9 -- cleanup and bugfixes
robcast
parents: 185
diff changeset
164
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
165 }