annotate servlet/src/digilib/image/DocuImage.java @ 71:d493563ef672

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 3b8797fc3e90 9cedd170b581
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
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
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
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
23 import javax.servlet.*;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
24 import javax.servlet.http.*;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
25 import java.io.*;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
26 import java.util.*;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
27
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
28 import java.awt.image.*;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
29 import java.awt.image.renderable.*;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
30
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
31 import digilib.*;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
32 import digilib.io.*;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
33
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
34 public interface DocuImage {
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
35
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
36 public String[] getKnownFileTypes();
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
37
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
38 /**
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
39 * send an image file as-is
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
40 */
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
41 public void sendFile(File f, ServletResponse res) throws FileOpException;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
42
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
43 /**
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
44 * load image file
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
45 */
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
46 public void loadImage(File f) throws FileOpException;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
47
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
48 /**
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
49 * write image with mime type mt to Stream
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
50 */
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
51 public void writeImage(String mt, ServletResponse res) throws FileOpException;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
52
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
53 /**
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
54 * get the image height and width
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
55 */
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
56 public int getWidth();
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
57 public int getHeight();
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
58
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
59 /**
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
60 * crop and scale image
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
61 * take rectangle width,height at position x_off,y_off
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
62 * and scale by scale with interpolation quality qual (0=worst)
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
63 */
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
64 public void cropAndScale(
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
65 int x_off, int y_off,
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
66 int width, int height,
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
67 float scale, int qual) throws ImageOpException;
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
68 }