Mercurial > hg > digilib-old
annotate servlet/src/digilib/image/DocuImageImpl.java @ 573:beeedf90cb81 stream
Merge from HEAD
fd2ef7e461198ef4a9d9a02459be2057038d600d
| author | robcast |
|---|---|
| date | Wed, 22 Dec 2010 09:54:34 +0100 |
| parents | 50f291d808b1 fd2ef7e46119 |
| children | aee436f0549d |
| rev | line source |
|---|---|
| 1 | 1 /* DocuImage -- General image interface class implementation |
| 2 | |
| 3 Digital Image Library servlet components | |
| 4 | |
| 85 | 5 Copyright (C) 2001, 2002, 2003 Robert Casties (robcast@mail.berlios.de) |
| 1 | 6 |
| 7 This program is free software; you can redistribute it and/or modify it | |
| 8 under the terms of the GNU General Public License as published by the | |
| 9 Free Software Foundation; either version 2 of the License, or (at your | |
| 10 option) any later version. | |
| 11 | |
| 12 Please read license.txt for the full details. A copy of the GPL | |
| 13 may be found at http://www.gnu.org/copyleft/lgpl.html | |
| 14 | |
| 15 You should have received a copy of the GNU General Public License | |
| 16 along with this program; if not, write to the Free Software | |
| 73 | 17 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| 1 | 18 |
| 19 */ | |
| 20 | |
| 21 package digilib.image; | |
| 22 | |
| 533 | 23 import java.awt.Image; |
| 85 | 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 | 26 import java.io.OutputStream; |
| 464 | 27 import java.util.Iterator; |
| 28 import java.util.LinkedList; | |
| 29 import java.util.List; | |
| 85 | 30 |
| 570 | 31 import javax.servlet.ServletException; |
| 32 | |
| 181 | 33 import org.apache.log4j.Logger; |
| 34 | |
| 35 import digilib.io.FileOpException; | |
| 159 | 36 import digilib.io.ImageFile; |
| 566 | 37 import digilib.io.ImageInput; |
| 1 | 38 |
| 73 | 39 /** Simple abstract implementation of the <code>DocuImage</code> interface. |
| 40 * | |
| 41 * This implementation provides basic functionality for the utility methods like | |
| 562 | 42 * <code>getKnownFileTypes</code>. Image methods like |
| 73 | 43 * <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
|
44 * <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
|
45 * implemented by derived classes. |
| 73 | 46 */ |
| 1 | 47 public abstract class DocuImageImpl implements DocuImage { |
| 48 | |
| 181 | 49 /** logger */ |
|
469
11e11fe4d680
Improved performance of JAIDocuImage for large images
robcast
parents:
464
diff
changeset
|
50 protected static final Logger logger = Logger.getLogger(DocuImage.class); |
| 181 | 51 |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
52 /** Interpolation quality. */ |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
53 protected int quality = 0; |
| 85 | 54 |
| 86 | 55 /** epsilon for float comparisons. */ |
| 85 | 56 public final double epsilon = 1e-5; |
| 86 | 57 |
| 58 /** image mime-type */ | |
| 59 protected String mimeType = null; | |
| 1 | 60 |
| 570 | 61 /** image size */ |
| 62 protected ImageSize imgSize = null; | |
| 63 | |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
64 /** |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
65 * Returns the quality. |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
66 * @return int |
|
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 public int getQuality() { |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
69 return quality; |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
70 } |
| 1 | 71 |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
72 /** |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
73 * Sets the quality. |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
74 * @param quality The quality to set |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
75 */ |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
76 public void setQuality(int quality) { |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
77 this.quality = quality; |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
78 } |
| 1 | 79 |
| 564 | 80 /** Crop and scale the current image. |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
81 * |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
82 * 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
|
83 * 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
|
84 * interpolation quality qual (0=worst). |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
85 * |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
86 * @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
|
87 * @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
|
88 * @param width Width of the crop rectangle in pixel. |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
89 * @param height Height of the crop rectangle in pixel. |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
90 * @param scale Scaling factor. |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
91 * @param qual Interpolation quality (0=worst). |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
92 * @throws ImageOpException Exception thrown on any error. |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
93 */ |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
94 public void cropAndScale( |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
95 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
|
96 throws ImageOpException { |
| 562 | 97 // default implementation: first crop, then scale |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
98 setQuality(qual); |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
99 crop(x_off, y_off, width, height); |
| 149 | 100 scale(scale, scale); |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
101 } |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
102 |
| 86 | 103 public String getMimetype() { |
| 104 return mimeType; | |
| 105 } | |
| 106 | |
| 564 | 107 /* (non-Javadoc) |
| 108 * @see digilib.image.DocuImage#identify(digilib.io.ImageFile) | |
| 109 */ | |
| 566 | 110 public ImageInput identify(ImageFile imgf) throws IOException { |
| 564 | 111 // just a do-nothing implementation |
| 112 return null; | |
| 113 } | |
| 114 | |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
115 public void rotate(double angle) throws ImageOpException { |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
116 // just a do-nothing implementation |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
117 } |
| 1 | 118 |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
119 public void mirror(double angle) throws ImageOpException { |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
120 // just a do-nothing implementation |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
121 } |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
122 |
| 86 | 123 public void enhance(float mult, float add) throws ImageOpException { |
| 85 | 124 // just a do-nothing implementation |
| 125 } | |
| 126 | |
| 127 public boolean isSubimageSupported() { | |
| 86 | 128 // partial loading not supported per default |
| 85 | 129 return false; |
| 130 } | |
| 131 | |
| 159 | 132 public void loadSubimage(ImageFile f, Rectangle region, int subsample) |
| 85 | 133 throws FileOpException { |
| 134 // empty implementation | |
| 135 } | |
| 136 | |
| 86 | 137 public void enhanceRGB(float[] rgbm, float[] rgba) |
| 138 throws ImageOpException { | |
| 139 // emtpy implementation | |
| 140 } | |
| 141 | |
| 207 | 142 public void dispose() { |
| 464 | 143 // emtpy implementation |
| 144 } | |
| 145 | |
| 531 | 146 public Iterator<String> getSupportedFormats() { |
| 147 List<String> empty = new LinkedList<String>(); | |
| 464 | 148 return empty.iterator(); |
| 207 | 149 } |
| 533 | 150 |
| 151 public void crop(int xoff, int yoff, int width, int height) | |
| 152 throws ImageOpException { | |
| 153 // TODO Auto-generated method stub | |
| 154 } | |
| 155 | |
| 156 public Image getAwtImage() { | |
| 157 // TODO Auto-generated method stub | |
| 158 return null; | |
| 159 } | |
| 160 | |
| 161 public int getHeight() { | |
| 570 | 162 ImageSize is = getSize(); |
| 163 if (is != null) { | |
| 164 return is.getHeight(); | |
| 165 } | |
| 533 | 166 return 0; |
| 167 } | |
| 207 | 168 |
| 533 | 169 public int getWidth() { |
| 570 | 170 ImageSize is = getSize(); |
| 171 if (is != null) { | |
| 172 return is.getWidth(); | |
| 173 } | |
| 533 | 174 return 0; |
| 175 } | |
| 176 | |
| 570 | 177 public ImageSize getSize() { |
| 178 return imgSize; | |
| 179 } | |
| 180 | |
| 533 | 181 public void loadImage(ImageFile f) throws FileOpException { |
| 182 // TODO Auto-generated method stub | |
| 183 | |
| 184 } | |
| 185 | |
| 186 public void scale(double scaleX, double scaleY) throws ImageOpException { | |
| 187 // TODO Auto-generated method stub | |
| 188 | |
| 189 } | |
| 190 | |
| 191 public void writeImage(String mt, OutputStream ostream) | |
| 570 | 192 throws ServletException, ImageOpException { |
| 533 | 193 // TODO Auto-generated method stub |
| 194 } | |
| 195 | |
| 1 | 196 } |