digilib-old: servlet/src/digilib/image/DocuImage.java annotate

annotate servlet/src/digilib/image/DocuImage.java @ 273:d4c0c4d858a9

Servlet version 1.21b3 - searching in directories got faster (real binarySearch now!) - cached file lists get disposed - some code cleaning (Map types instead of HashMap)

author	robcast
date	Tue, 12 Oct 2004 16:06:43 +0200
parents	1a65d8e43620
children	d5fe845db95f

rev	line source
1 0ff3ede32060 Initial revision robcast parents: diff changeset	1 /* DocuImage -- General image interface class
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
149 04ad64b2137a Servlet version 1.14b1 robcast parents: 122 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;
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	24 import java.io.OutputStream;
73 3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	25
159 e743b853efca servlet version 1.16a4 robcast parents: 149 diff changeset	26 import digilib.io.ImageFile;
73 3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	27 import digilib.io.FileOpException;
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	28
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	29 /** The basic class for the representation of a digilib image.
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	30 *
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	31 * The actual image object is hidden in the class, only methods for loading,
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	32 * manipulation, and saving are exported. This strategy enables implementations
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	33 * using different toolkits that rely on different image base classes (like
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	34 * JIMI, Java2D and JAI).
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	35 */
1 0ff3ede32060 Initial revision robcast parents: diff changeset	36 public interface DocuImage {
0ff3ede32060 Initial revision robcast parents: diff changeset	37
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	38 /** Returns the list of image file types known to the DocuImage implementation.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	39 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	40 * @return List of image file types. Strings are standard file extensions.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	41 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	42 public String[] getKnownFileTypes();
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	43
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	44 /** Loads an image file into the Object.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	45 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	46 * @param f Image File.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	47 * @throws FileOpException Exception thrown if any error occurs.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	48 */
159 e743b853efca servlet version 1.16a4 robcast parents: 149 diff changeset	49 public void loadImage(ImageFile f) throws FileOpException;
1 0ff3ede32060 Initial revision robcast parents: diff changeset	50
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	51 /** This DocuImage support the loadSubImage operation.
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	52 *
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	53 * @return boolean
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	54 */
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	55 public boolean isSubimageSupported();
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	56
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	57 /** Load only a subsampled region of the image file.
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	58 *
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	59 * @param f
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	60 * @param region
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	61 * @param subsample
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	62 * @throws FileOpException
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	63 */
159 e743b853efca servlet version 1.16a4 robcast parents: 149 diff changeset	64 public void loadSubimage(ImageFile f, Rectangle region, int subsample)
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	65 throws FileOpException;
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	66
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	67 /** Writes the current image to a ServletResponse.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	68 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	69 * The image is encoded to the mime-type <code>mt</code> and sent to the output
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	70 * stream of the <code>ServletResponse</code> <code>res</code>.
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 * Currently only mime-types "image/jpeg" and "image/png" are supported.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	73 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	74 * @param mt mime-type of the image to be sent.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	75 * @param res ServletResponse where the image is sent.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	76 * @throws FileOpException Exception thrown on any error.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	77 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	78 public void writeImage(String mt, OutputStream ostream)
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	79 throws FileOpException;
1 0ff3ede32060 Initial revision robcast parents: diff changeset	80
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	81 /** The width of the current image in pixel.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	82 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	83 * @return Image width in pixels.
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 public int getWidth();
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	86
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	87 /** The height of the current image in pixel.
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 * @return Image height in pixels.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	90 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	91 public int getHeight();
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	92
86 997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	93 /** The mime-type of the current image.
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	94 *
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	95 * @return String the mime-type of this image.
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	96 */
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	97 public String getMimetype();
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	98
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	99 /** Crops the current image.
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 * Cuts out a region of the size <code>width</code> x <code>height</code> at
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	102 * the offset <code>xoff</code>, <code>yoff</code> from the current image
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	103 * and replaces the current image with the result.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	104 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	105 * @param xoff X offset of crop region
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	106 * @param yoff Y offset of crop region
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	107 * @param width width of crop region
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	108 * @param height height of crop region
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	109 * @throws ImageOpException
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	110 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	111 public void crop(int xoff, int yoff, int width, int height)
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	112 throws ImageOpException;
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	113
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	114 /** Scales the current image.
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 * Replaces the current image with an image scaled by the factor
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	117 * <code>scale</code>.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	118 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	119 * @param scale scaling factor
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	120 * @throws ImageOpException
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	121 */
149 04ad64b2137a Servlet version 1.14b1 robcast parents: 122 diff changeset	122 public void scale(double scaleX, double scaleY) throws ImageOpException;
1 0ff3ede32060 Initial revision robcast parents: diff changeset	123
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	124 /** Crops and scales the current image.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	125 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	126 * The current image is cropped to a rectangle of <code>width</code>,
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	127 * <code>height</code> at position <code>x_off</code>, <code>y_off</code>. The
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	128 * resulting image is scaled by the factor <code>scale</code> using the
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	129 * interpolation quality <code>qual</code> (0=worst).
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	130 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	131 * @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	132 * @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	133 * @param width width of the crop rectangle in pixel.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	134 * @param height height of the crop rectangle in pixel.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	135 * @param scale scaling factor.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	136 * @param qual interpolation quality (0=worst).
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	137 * @throws ImageOpException exception thrown on any error.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	138 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	139 public void cropAndScale(
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	140 int x_off,
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	141 int y_off,
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	142 int width,
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	143 int height,
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	144 double scale,
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	145 int qual)
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	146 throws ImageOpException;
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	147
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	148 /** Rotates the current image.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	149 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	150 * Replaces the current image with a rotated image. The image is rotated
101 78f52a1876fe digilib V1.9b1 robcast parents: 86 diff changeset	151 * around the center by the <code>angle</code>
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	152 * given in degrees [0, 360] clockwise.
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	153 * Image size and aspect ratio are likely to change.
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	154 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	155 * @param angle rotation angle in degree
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	156 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	157 public void rotate(double angle) throws ImageOpException;
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	158
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	159 /** Mirrors the current image.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	160 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	161 * Replaces the current image with a mirrored image. The mirror axis goes
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	162 * through the center of the image and is rotated by <code>angle</code>
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	163 * degrees. Currently only horizontal and vertical mirroring (0 and 90
101 78f52a1876fe digilib V1.9b1 robcast parents: 86 diff changeset	164 * degree) are supported.
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	165 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	166 * @param angle angle of mirror axis
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	167 * @throws ImageOpException
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	168 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	169 public void mirror(double angle) throws ImageOpException;
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	170
86 997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	171 /** Enhances brightness and contrast of the current image.
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	172 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	173 * Replaces the current image with a brightness and contrast enhanced image.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	174 * Contrast is enhanced by multiplying the pixel value with the constant
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	175 * <code>mult</code>. Brightness is enhanced by adding the constant
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	176 * <code>add</code> to the pixel value. Operation: p1 = (p0*mult)+add.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	177 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	178 * @param mult multiplicative constant for contrast enhancement
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	179 * @param add additive constant for brightness enhancement
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	180 * @throws ImageOpException
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	181 */
86 997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	182 public void enhance(float mult, float add) throws ImageOpException;
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	183
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	184 /** Manipulates the colors of the current image.
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	185 *
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	186 * Replaces the current image with a color modified image.
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	187 * For the red, green and blue color channels all pixel values are multiplied
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	188 * by the constant
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	189 * <code>m</code> and added to the constant
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	190 * <code>a</code>. Operation: p1 = (p0*m)+a.
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	191 *
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	192 * @param rgbm multiplicative constants for red, green, blue
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	193 * @param rgba additive constant for red, green, blue
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	194 * @throws ImageOpException
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	195 */
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	196 public void enhanceRGB(float[] rgbm, float[] rgba)
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	197 throws ImageOpException;
1 0ff3ede32060 Initial revision robcast parents: diff changeset	198
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	199 /**
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	200 * Returns the interpolation quality.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	201 * @return int
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	202 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	203 public int getQuality();
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	204
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	205 /**
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	206 * Sets the interpolation quality.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	207 * @param quality The quality to set
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	208 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	209 public void setQuality(int quality);
207 1a65d8e43620 Servlet version 1.18b9 -- cleanup and bugfixes robcast parents: 159 diff changeset	210
1a65d8e43620 Servlet version 1.18b9 -- cleanup and bugfixes robcast parents: 159 diff changeset	211 /** Frees all resources bound to the DocuImage.
1a65d8e43620 Servlet version 1.18b9 -- cleanup and bugfixes robcast parents: 159 diff changeset	212 *
1a65d8e43620 Servlet version 1.18b9 -- cleanup and bugfixes robcast parents: 159 diff changeset	213 * Things that should be freed are image objects and open files.
1a65d8e43620 Servlet version 1.18b9 -- cleanup and bugfixes robcast parents: 159 diff changeset	214 *
1a65d8e43620 Servlet version 1.18b9 -- cleanup and bugfixes robcast parents: 159 diff changeset	215 */
1a65d8e43620 Servlet version 1.18b9 -- cleanup and bugfixes robcast parents: 159 diff changeset	216 public void dispose();
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	217
1 0ff3ede32060 Initial revision robcast parents: diff changeset	218 }

Mercurial > hg > digilib-old

annotate servlet/src/digilib/image/DocuImage.java @ 273:d4c0c4d858a9