annotate servlet/doc/Scaler.html @ 72:300d5ba8b33b

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 4d0e75042673
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
1 <HTML>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
2 <HEAD>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
3 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
4 <TITLE>JBuilder Project ScaleServlet2.jpx</TITLE>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
5 </HEAD>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
6 <BODY>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
7 <H1>Scaler</H1>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
8
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
9 <p>A Servlet for scaling images.</p>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
10
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
11 <p>Scaler takes parameters in the http request format:
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
12 <code>Scaler/request_path/?param1=value1&param2=value2&...</code></p>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
13
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
14 <p>Recognised parameters:
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
15 <ul>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
16 <li><b>request_path</b> path to file or directory.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
17
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
18 <li><b>fn</b> path to file or directory below <code>/docuserver/images</code>.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
19 This path will be added to the <code>request_path</code> behind the servlet name.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
20 Either parameter can be empty.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
21
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
22 <li><b>pn</b> page number. Index into the (alphabetically sorted) directory
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
23 given by the path. Starts with 1. Ignored if the path points to a file.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
24 Default: 1.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
25
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
26 <li><b>dw</b> destination image width (pixels).
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
27 <li><b>dh</b> destination image height.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
28
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
29 <li><b>wx</b> relative x offset of the image area to be sent (0 &lt;= wx &lt;= 1).
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
30 Default: 0.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
31 <li><b>wy</b> relative y offset of the image area to be sent.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
32 Default: 0.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
33 <li><b>ww</b> relative width of the image area to be sent.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
34 Default: 1.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
35 <li><b>wh</b> relative height of the image area to be sent.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
36 Default: 1.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
37
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
38 <li><b>ws</b> additional scaling factor. The resulting image will have the size
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
39 <code>[ws*dw,ws*dh]</code>. Default: 1.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
40
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
41 <li><b>mo</b> flags for the mode of operation separated by "+".
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
42 <ul>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
43 <li><b>fit</b>: always scale the image to fit <code>[dw,dh]</code>.<br>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
44 <b>file</b>: send the file as-is (may be very large and all sorts of image types!).<br>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
45 If none of these flags is set heuristics is used (send unzoomed GIF as-is).
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
46
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
47 <li><b>errtxt</b>: send error response as HTML.<br>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
48 <b>errimg</b>: response as image (default).
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
49
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
50 <li><b>q0</b>-<b>q2</b>: quality of interpolation in scaling
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
51 (<code>q0</code>: worst, default).
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
52
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
53 <li><b>lores</b>: try to use scaled image (default)<br>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
54 <b>hires</b>: always use unscaled image.<br>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
55 If the image is zoomed (ww, wh &lt; 1) the unscaled image is used in any case.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
56 </ul>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
57
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
58 </ul>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
59 The image will be scaled equally in horizontal and vertical direction such that
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
60 the resulting image does not exceed the rectangle <code>[ww,wh]</code>.
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
61 </p>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
62
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
63 </BODY>
0ff3ede32060 Initial revision
robcast
parents:
diff changeset
64 </HTML>