annotate servlet/src/digilib/image/DocuImageImpl.java @ 73:3b8797fc3e90

New servlet version 1.5b. Mostly cleanup. Global parameters for digilib now in DigilibConfiguration, per request parameters are now all in DigilibRequest. The DocuImage implementation can be selected by the configuration docuimage-class. Pixel-by-pixel view implemented with "mo=clip".
author robcast
date Fri, 24 Jan 2003 21:40:59 +0100
parents 0ff3ede32060
children 63c8186455c1
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
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
5 Copyright (C) 2001, 2002 Robert Casties (robcast@mail.berlios.de)
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
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
23 import java.io.*;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
24 import javax.servlet.ServletResponse;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
25
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
26 import digilib.*;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
27 import digilib.io.*;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
28
73
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
29 /** Simple abstract implementation of the <code>DocuImage</code> interface.
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
30 *
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
31 * This implementation provides basic functionality for the utility methods like
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
32 * <code>SetUtils</code>, and <code>getKnownFileTypes</code>. Image methods like
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
33 * <code>loadImage</code>, <code>writeImage</code>, <code>getWidth</code>,
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
34 * <code>getHeight</code> and <code>cropAndScale</code> must be implemented by
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
35 * derived classes.
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
36 */
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
37 public abstract class DocuImageImpl implements DocuImage {
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
38
73
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
39 /** Internal utils object. */
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
40 protected Utils util = null;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
41
73
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
42 /** Default constructor. */
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
43 public DocuImageImpl() {
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
44 util = new Utils();
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
45 }
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
46
73
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
47 /** Contructor taking an utils object.
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
48 *
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
49 * @param u Utils object.
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
50 */
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
51 public DocuImageImpl(Utils u) {
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
52 util = u;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
53 }
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
54
73
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
55 /** Set local Utils object.
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
56 *
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
57 * @param u Utils object.
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
58 */
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
59 public void setUtils(Utils u) {
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
60 util = u;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
61 }
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
62
73
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
63 /** Internal knownFileTypes. */
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
64 protected String[] knownFileTypes = {"jpg", "png", "gif", "tiff"};
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
65
73
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
66 /** Returns the list of image file types known to the DocuImage implementation.
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
67 *
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
68 * @return List of image file types. Strings are standard file extensions.
3b8797fc3e90 New servlet version 1.5b.
robcast
parents: 1
diff changeset
69 */
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
70 public String[] getKnownFileTypes() {
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
71 return knownFileTypes;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
72 }
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
73
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
74
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
75 public abstract void loadImage(File f) throws FileOpException;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
76 public abstract void writeImage(String mt, ServletResponse res) throws FileOpException;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
77 public abstract int getWidth();
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
78 public abstract int getHeight();
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
79 public abstract void cropAndScale(int x_off, int y_off, int width, int height, float scale, int qual) throws ImageOpException;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
80 }