annotate servlet/doc/Scaler.html @ 1:0ff3ede32060

Initial revision
author robcast
date Thu, 17 Jan 2002 15:25:46 +0100
parents
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>