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

annotate servlet/src/digilib/image/DocuImage.java @ 86:997ba69afb81

New version 1.8b1. With directory and file information cache. With enhanceRGB method for color correction.

author	robcast
date	Sun, 09 Mar 2003 21:37:27 +0100
parents	4e6757e8ccd4
children	78f52a1876fe

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
0ff3ede32060 Initial revision robcast parents: diff changeset	17 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
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;
73 3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	24 import java.io.File;
86 997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	25 import java.io.IOException;
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	26 import java.io.OutputStream;
73 3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	27
86 997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	28 import digilib.io.DocuFile;
73 3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	29 import digilib.io.FileOpException;
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 basic class for the representation of a digilib image.
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	32 *
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	33 * The actual image object is hidden in the class, only methods for loading,
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	34 * manipulation, and saving are exported. This strategy enables implementations
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	35 * using different toolkits that rely on different image base classes (like
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	36 * JIMI, Java2D and JAI).
3b8797fc3e90 New servlet version 1.5b. robcast parents: 1 diff changeset	37 */
1 0ff3ede32060 Initial revision robcast parents: diff changeset	38 public interface DocuImage {
0ff3ede32060 Initial revision robcast parents: diff changeset	39
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	40 /** 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	41 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	42 * @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	43 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	44 public String[] getKnownFileTypes();
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 /** Loads an image file into the Object.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	47 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	48 * @param f Image File.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	49 * @throws FileOpException Exception thrown if any error occurs.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	50 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	51 public void loadImage(File f) throws FileOpException;
1 0ff3ede32060 Initial revision robcast parents: diff changeset	52
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	53 /** This DocuImage support the loadSubImage operation.
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	54 *
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	55 * @return boolean
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	56 */
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	57 public boolean isSubimageSupported();
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	58
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	59 /** Load only a subsampled region of the image file.
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	60 *
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	61 * @param f
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	62 * @param region
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	63 * @param subsample
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	64 * @throws FileOpException
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	65 */
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	66 public void loadSubimage(File f, Rectangle region, int subsample)
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	67 throws FileOpException;
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	68
86 997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	69 /** Checks the size and type of the DocuFile f.
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	70 *
86 997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	71 * The image size and type of the DocuFile f is determined and stored in
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	72 * the DocuFile object. Returns true if successfull.
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	73 *
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	74 * @param f DocuFile to be checked.
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	75 * @return boolean true if check was successfull.
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	76 * @throws FileOpException Exception thrown on error.
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	77 */
86 997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	78 public boolean checkFile(DocuFile f) throws IOException;
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	79
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	80 /** Writes the current image to a ServletResponse.
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 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	83 * stream of the <code>ServletResponse</code> <code>res</code>.
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 * 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	86 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	87 * @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	88 * @param res ServletResponse where the image is sent.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	89 * @throws FileOpException Exception thrown on any error.
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 void writeImage(String mt, OutputStream ostream)
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	92 throws FileOpException;
1 0ff3ede32060 Initial revision robcast parents: diff changeset	93
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	94 /** The width of the current image in pixel.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	95 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	96 * @return Image width in pixels.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	97 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	98 public int getWidth();
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	99
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	100 /** The height of the current image in pixel.
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 * @return Image height in pixels.
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 public int getHeight();
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	105
86 997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	106 /** The mime-type of the current image.
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	107 *
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	108 * @return String the mime-type of this image.
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	109 */
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	110 public String getMimetype();
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	111
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	112 /** Crops the current image.
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 * 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	115 * 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	116 * and replaces the current image with the result.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	117 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	118 * @param xoff X offset of crop region
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	119 * @param yoff Y offset of crop region
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	120 * @param width width of crop region
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	121 * @param height height of crop region
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	122 * @throws ImageOpException
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 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	125 throws ImageOpException;
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	126
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	127 /** Scales the current image.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	128 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	129 * 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	130 * <code>scale</code>.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	131 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	132 * @param scale scaling factor
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	133 * @throws ImageOpException
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	134 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	135 public void scale(double scale) throws ImageOpException;
1 0ff3ede32060 Initial revision robcast parents: diff changeset	136
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	137 /** Crops and scales the current image.
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 * 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	140 * <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	141 * 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	142 * interpolation quality <code>qual</code> (0=worst).
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	143 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	144 * @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	145 * @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	146 * @param width width of the crop rectangle in pixel.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	147 * @param height height of the crop rectangle in pixel.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	148 * @param scale scaling factor.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	149 * @param qual interpolation quality (0=worst).
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	150 * @throws ImageOpException exception thrown on any error.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	151 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	152 public void cropAndScale(
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	153 int x_off,
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	154 int y_off,
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	155 int width,
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	156 int height,
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	157 double scale,
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	158 int qual)
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	159 throws ImageOpException;
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	160
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	161 /** Rotates the current image.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	162 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	163 * Replaces the current image with a rotated image. The image is rotated
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	164 * around the point <code>x</code>,<code>y</code> by <code>angle</code>
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	165 * given in degrees [0, 360] clockwise.
4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	166 * 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	167 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	168 * @param angle rotation angle in degree
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	169 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	170 public void rotate(double angle) throws ImageOpException;
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	171
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	172 /** Mirrors the current image.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	173 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	174 * 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	175 * 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	176 * degrees. Currently only horizontal and vertical mirroring (0 and 90
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	177 * degree) are supported.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	178 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	179 * @param angle angle of mirror axis
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 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	182 public void mirror(double angle) throws ImageOpException;
85 4e6757e8ccd4 New enhanced ImageLoader stuff. robcast parents: 79 diff changeset	183
86 997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	184 /** Enhances brightness and contrast of the current image.
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	185 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	186 * 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	187 * 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	188 * <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	189 * <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	190 *
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	191 * @param mult multiplicative constant for contrast enhancement
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	192 * @param add additive constant for brightness enhancement
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	193 * @throws ImageOpException
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	194 */
86 997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	195 public void enhance(float mult, float add) throws ImageOpException;
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	196
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	197 /** Manipulates the colors of the current image.
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	198 *
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	199 * Replaces the current image with a color modified image.
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	200 * For the red, green and blue color channels all pixel values are multiplied
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	201 * by the constant
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	202 * <code>m</code> and added to the constant
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	203 * <code>a</code>. Operation: p1 = (p0*m)+a.
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	204 *
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	205 * @param rgbm multiplicative constants for red, green, blue
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	206 * @param rgba additive constant for red, green, blue
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	207 * @throws ImageOpException
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	208 */
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	209 public void enhanceRGB(float[] rgbm, float[] rgba)
997ba69afb81 New version 1.8b1. robcast parents: 85 diff changeset	210 throws ImageOpException;
1 0ff3ede32060 Initial revision robcast parents: diff changeset	211
79 63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	212 /**
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	213 * Returns the interpolation quality.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	214 * @return int
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	215 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	216 public int getQuality();
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	217
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	218 /**
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	219 * Sets the interpolation quality.
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	220 * @param quality The quality to set
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	221 */
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	222 public void setQuality(int quality);
63c8186455c1 Servlet version 1.6b. Further cleanup and new functionality: robcast parents: 73 diff changeset	223
1 0ff3ede32060 Initial revision robcast parents: diff changeset	224 }

Mercurial > hg > digilib-old

annotate servlet/src/digilib/image/DocuImage.java @ 86:997ba69afb81