annotate servlet/src/digilib/image/DocuImageImpl.java @ 566:50f291d808b1 digilibPDF

starting stream support
author robcast
date Mon, 20 Dec 2010 11:57:55 +0100
parents 4c51d71aef13
children beeedf90cb81
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
533
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
23 import java.awt.Image;
85
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
24 import java.awt.Rectangle;
462
03ff7238c9d4 second try for flashpix support (doesn't work currently...)
robcast
parents: 278
diff changeset
25 import java.io.IOException;
533
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
26 import java.io.OutputStream;
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;
afe7ff98bb71 Servlet version 1.18b1
robcast
parents: 159
diff changeset
32
afe7ff98bb71 Servlet version 1.18b1
robcast
parents: 159
diff changeset
33 import digilib.io.FileOpException;
159
e743b853efca servlet version 1.16a4
robcast
parents: 149
diff changeset
34 import digilib.io.ImageFile;
566
50f291d808b1 starting stream support
robcast
parents: 564
diff changeset
35 import digilib.io.ImageInput;
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
562
baaa5bab5e16 trying to reduce use of ImageOps
robcast
parents: 561
diff changeset
40 * <code>getKnownFileTypes</code>. Image methods like
73
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
564
4c51d71aef13 more reshuffling of classes
robcast
parents: 562
diff changeset
75 /** Crop and scale the current image.
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
76 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
77 * 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
78 * 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
79 * interpolation quality qual (0=worst).
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
80 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
81 * @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
82 * @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
83 * @param width Width of the crop rectangle in pixel.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
84 * @param height Height of the crop rectangle in pixel.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
85 * @param scale Scaling factor.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
86 * @param qual Interpolation quality (0=worst).
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
87 * @throws ImageOpException Exception thrown on any error.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
88 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
89 public void cropAndScale(
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
90 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
91 throws ImageOpException {
562
baaa5bab5e16 trying to reduce use of ImageOps
robcast
parents: 561
diff changeset
92 // default implementation: first crop, then scale
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
93 setQuality(qual);
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
94 crop(x_off, y_off, width, height);
149
04ad64b2137a Servlet version 1.14b1
robcast
parents: 122
diff changeset
95 scale(scale, scale);
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
96 }
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
97
86
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
98 public String getMimetype() {
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
99 return mimeType;
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
100 }
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
101
564
4c51d71aef13 more reshuffling of classes
robcast
parents: 562
diff changeset
102 /* (non-Javadoc)
4c51d71aef13 more reshuffling of classes
robcast
parents: 562
diff changeset
103 * @see digilib.image.DocuImage#identify(digilib.io.ImageFile)
4c51d71aef13 more reshuffling of classes
robcast
parents: 562
diff changeset
104 */
566
50f291d808b1 starting stream support
robcast
parents: 564
diff changeset
105 public ImageInput identify(ImageFile imgf) throws IOException {
564
4c51d71aef13 more reshuffling of classes
robcast
parents: 562
diff changeset
106 // just a do-nothing implementation
4c51d71aef13 more reshuffling of classes
robcast
parents: 562
diff changeset
107 return null;
4c51d71aef13 more reshuffling of classes
robcast
parents: 562
diff changeset
108 }
4c51d71aef13 more reshuffling of classes
robcast
parents: 562
diff changeset
109
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
110 public void rotate(double angle) throws ImageOpException {
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
111 // just a do-nothing implementation
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
112 }
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
113
79
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
114 public void mirror(double angle) throws ImageOpException {
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
115 // just a do-nothing implementation
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
116 }
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents: 73
diff changeset
117
86
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
118 public void enhance(float mult, float add) throws ImageOpException {
85
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
119 // just a do-nothing implementation
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
120 }
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
121
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
122 public boolean isSubimageSupported() {
86
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
123 // partial loading not supported per default
85
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
124 return false;
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
125 }
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
126
159
e743b853efca servlet version 1.16a4
robcast
parents: 149
diff changeset
127 public void loadSubimage(ImageFile f, Rectangle region, int subsample)
85
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
128 throws FileOpException {
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
129 // empty implementation
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
130 }
4e6757e8ccd4 New enhanced ImageLoader stuff.
robcast
parents: 79
diff changeset
131
86
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
132 public void enhanceRGB(float[] rgbm, float[] rgba)
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
133 throws ImageOpException {
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
134 // emtpy implementation
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
135 }
997ba69afb81 New version 1.8b1.
robcast
parents: 85
diff changeset
136
207
1a65d8e43620 Servlet version 1.18b9 -- cleanup and bugfixes
robcast
parents: 185
diff changeset
137 public void dispose() {
464
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
138 // emtpy implementation
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
139 }
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
140
531
9cedd170b581 * PDF generation works now even with subdirectories
robcast
parents: 1
diff changeset
141 public Iterator<String> getSupportedFormats() {
9cedd170b581 * PDF generation works now even with subdirectories
robcast
parents: 1
diff changeset
142 List<String> empty = new LinkedList<String>();
464
f1f710ff14ad Servlet version 1.10b
robcast
parents: 462
diff changeset
143 return empty.iterator();
207
1a65d8e43620 Servlet version 1.18b9 -- cleanup and bugfixes
robcast
parents: 185
diff changeset
144 }
533
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
145
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
146 public void crop(int xoff, int yoff, int width, int height)
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
147 throws ImageOpException {
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
148 // TODO Auto-generated method stub
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
149 }
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
150
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
151 public Image getAwtImage() {
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
152 // TODO Auto-generated method stub
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
153 return null;
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
154 }
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
155
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
156 public int getHeight() {
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
157 // TODO Auto-generated method stub
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
158 return 0;
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
159 }
207
1a65d8e43620 Servlet version 1.18b9 -- cleanup and bugfixes
robcast
parents: 185
diff changeset
160
533
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
161 public int getWidth() {
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
162 // TODO Auto-generated method stub
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
163 return 0;
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
164 }
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
165
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
166 public void loadImage(ImageFile f) throws FileOpException {
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
167 // TODO Auto-generated method stub
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
168
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
169 }
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
170
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
171 public void scale(double scaleX, double scaleY) throws ImageOpException {
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
172 // TODO Auto-generated method stub
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
173
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
174 }
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
175
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
176 public void writeImage(String mt, OutputStream ostream)
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
177 throws FileOpException {
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
178 // TODO Auto-generated method stub
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
179 }
87cb3dc2aa12 improved pdf generation (not done yet)
robcast
parents: 531
diff changeset
180
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
181 }