Mercurial > hg > digilib-old
annotate servlet/src/digilib/image/DocuImageImpl.java @ 629:b426efcc8a8e jquery
questions about display()...
| author | robcast |
|---|---|
| date | Tue, 18 Jan 2011 12:51:51 +0100 |
| parents | fd2ef7e46119 |
| children | beeedf90cb81 |
| 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; |
| 1 | 37 |
| 73 | 38 /** Simple abstract implementation of the <code>DocuImage</code> interface. |
| 39 * | |
| 40 * This implementation provides basic functionality for the utility methods like | |
| 562 | 41 * <code>getKnownFileTypes</code>. Image methods like |
| 73 | 42 * <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
|
43 * <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
|
44 * implemented by derived classes. |
| 73 | 45 */ |
| 1 | 46 public abstract class DocuImageImpl implements DocuImage { |
| 47 | |
| 181 | 48 /** logger */ |
|
469
11e11fe4d680
Improved performance of JAIDocuImage for large images
robcast
parents:
464
diff
changeset
|
49 protected static final Logger logger = Logger.getLogger(DocuImage.class); |
| 181 | 50 |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
51 /** Interpolation quality. */ |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
52 protected int quality = 0; |
| 85 | 53 |
| 86 | 54 /** epsilon for float comparisons. */ |
| 85 | 55 public final double epsilon = 1e-5; |
| 86 | 56 |
| 57 /** image mime-type */ | |
| 58 protected String mimeType = null; | |
| 1 | 59 |
| 570 | 60 /** image size */ |
| 61 protected ImageSize imgSize = null; | |
| 62 | |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
63 /** |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
64 * Returns the quality. |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
65 * @return int |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
66 */ |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
67 public int getQuality() { |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
68 return quality; |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
69 } |
| 1 | 70 |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
71 /** |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
72 * Sets the quality. |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
73 * @param quality The quality to set |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
74 */ |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
75 public void setQuality(int quality) { |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
76 this.quality = quality; |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
77 } |
| 1 | 78 |
| 564 | 79 /** Crop and scale the current image. |
|
79
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 * 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
|
82 * 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
|
83 * interpolation quality qual (0=worst). |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
84 * |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
85 * @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
|
86 * @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
|
87 * @param width Width of the crop rectangle in pixel. |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
88 * @param height Height of the crop rectangle in pixel. |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
89 * @param scale Scaling factor. |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
90 * @param qual Interpolation quality (0=worst). |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
91 * @throws ImageOpException Exception thrown on any error. |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
92 */ |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
93 public void cropAndScale( |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
94 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
|
95 throws ImageOpException { |
| 562 | 96 // default implementation: first crop, then scale |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
97 setQuality(qual); |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
98 crop(x_off, y_off, width, height); |
| 149 | 99 scale(scale, scale); |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
100 } |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
101 |
| 86 | 102 public String getMimetype() { |
| 103 return mimeType; | |
| 104 } | |
| 105 | |
| 564 | 106 /* (non-Javadoc) |
| 107 * @see digilib.image.DocuImage#identify(digilib.io.ImageFile) | |
| 108 */ | |
| 109 public ImageFile identify(ImageFile imgf) throws IOException { | |
| 110 // just a do-nothing implementation | |
| 111 return null; | |
| 112 } | |
| 113 | |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
114 public void rotate(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 } |
| 1 | 117 |
|
79
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
118 public void mirror(double angle) throws ImageOpException { |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
119 // just a do-nothing implementation |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
120 } |
|
63c8186455c1
Servlet version 1.6b. Further cleanup and new functionality:
robcast
parents:
73
diff
changeset
|
121 |
| 86 | 122 public void enhance(float mult, float add) throws ImageOpException { |
| 85 | 123 // just a do-nothing implementation |
| 124 } | |
| 125 | |
| 126 public boolean isSubimageSupported() { | |
| 86 | 127 // partial loading not supported per default |
| 85 | 128 return false; |
| 129 } | |
| 130 | |
| 159 | 131 public void loadSubimage(ImageFile f, Rectangle region, int subsample) |
| 85 | 132 throws FileOpException { |
| 133 // empty implementation | |
| 134 } | |
| 135 | |
| 86 | 136 public void enhanceRGB(float[] rgbm, float[] rgba) |
| 137 throws ImageOpException { | |
| 138 // emtpy implementation | |
| 139 } | |
| 140 | |
| 207 | 141 public void dispose() { |
| 464 | 142 // emtpy implementation |
| 143 } | |
| 144 | |
| 531 | 145 public Iterator<String> getSupportedFormats() { |
| 146 List<String> empty = new LinkedList<String>(); | |
| 464 | 147 return empty.iterator(); |
| 207 | 148 } |
| 533 | 149 |
| 150 public void crop(int xoff, int yoff, int width, int height) | |
| 151 throws ImageOpException { | |
| 152 // TODO Auto-generated method stub | |
| 153 } | |
| 154 | |
| 155 public Image getAwtImage() { | |
| 156 // TODO Auto-generated method stub | |
| 157 return null; | |
| 158 } | |
| 159 | |
| 160 public int getHeight() { | |
| 570 | 161 ImageSize is = getSize(); |
| 162 if (is != null) { | |
| 163 return is.getHeight(); | |
| 164 } | |
| 533 | 165 return 0; |
| 166 } | |
| 207 | 167 |
| 533 | 168 public int getWidth() { |
| 570 | 169 ImageSize is = getSize(); |
| 170 if (is != null) { | |
| 171 return is.getWidth(); | |
| 172 } | |
| 533 | 173 return 0; |
| 174 } | |
| 175 | |
| 570 | 176 public ImageSize getSize() { |
| 177 return imgSize; | |
| 178 } | |
| 179 | |
| 533 | 180 public void loadImage(ImageFile f) throws FileOpException { |
| 181 // TODO Auto-generated method stub | |
| 182 | |
| 183 } | |
| 184 | |
| 185 public void scale(double scaleX, double scaleY) throws ImageOpException { | |
| 186 // TODO Auto-generated method stub | |
| 187 | |
| 188 } | |
| 189 | |
| 190 public void writeImage(String mt, OutputStream ostream) | |
| 570 | 191 throws ServletException, ImageOpException { |
| 533 | 192 // TODO Auto-generated method stub |
| 193 } | |
| 194 | |
| 1 | 195 } |