Mercurial > hg > digilib-old
comparison webapp/doc/digilib_interop.html @ 903:7779b37d1d05
refactored into maven modules per servlet type.
can build servlet-api 2.3 and 3.0 via profile now!
author | robcast |
---|---|
date | Tue, 26 Apr 2011 20:24:31 +0200 |
parents | client/doc/digilib_interop.html@665f2f4559d0 |
children |
comparison
equal
deleted
inserted
replaced
902:89ba3ffcf552 | 903:7779b37d1d05 |
---|---|
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | |
2 <html> | |
3 <head> | |
4 <meta http-equiv="Content-Type" content="text/html;charset=utf-8"> | |
5 <title>digilib toolbar interoperability</title> | |
6 </head> | |
7 <body> | |
8 <h1>Interoperability of digilib HTML pages with the Alcatraz toolbar</h1> | |
9 | |
10 <p>A toolbar-friendly digilib page must define a Javascript variable | |
11 <b><code>toolbarEnabledURL</code></b> whose value is a HTTP URL that | |
12 produces a <em>toolbar-enabled</em> page. The toolbar should present a | |
13 button to "take over" the page design by replacing | |
14 the current page with the page from the given URL.</p> | |
15 | |
16 <h2>Toolbar-enabled page</h2> | |
17 | |
18 <p>A <em>toolbar-enabled</em> page must offer the following Javascript functions:</p> | |
19 | |
20 <h3>Identification</h3> | |
21 | |
22 <ul> | |
23 <li><b><code>dlScriptVersion</code></b>: a String variable that contains the version number of the Javascript code (e.g. "1.12b3")<br> | |
24 The existence of this variable can be used to test for a <em>toolbar-enabled</em> page</li> | |
25 </ul> | |
26 | |
27 <h3>Interactive operations</h3> | |
28 | |
29 <ul> | |
30 <li><b><code>setMark()</code></b>: lets the user click and sets a mark at the clicked location</li> | |
31 <li><b><code>zoomArea()</code></b>: lets the user click to select an area and zooms to the selected area</li> | |
32 <li><b><code>moveCenter()</code></b>: lets the user click and recenters the image around the clicked location</li> | |
33 </ul> | |
34 | |
35 <h3>Page operations</h3> | |
36 | |
37 <ul> | |
38 <li><b><code>getRef()</code></b>: returns a String with a URL reference to the current document</li> | |
39 <li><b><code>removeMark()</code></b>: removes the last mark</li> | |
40 <li><b><code>zoomBy(float factor)</code></b>: magnifies the image by the given factor around the current center</li> | |
41 <li><b><code>zoomFullpage()</code></b>: zooms out so that the whole image is visible</li> | |
42 <li><b><code>display(int prio)</code></b>: reloads the page with the current parameters</li> | |
43 </ul> | |
44 | |
45 <h3>Parameter operations</h3> | |
46 | |
47 <ul> | |
48 <li><b><code>newParameter(String name, String defaultValue, int prio)</code></b>: declares a new parameter with name, default value (can be of any type) and priority</li> | |
49 <li><b><code>getParameter(String name)</code></b>: returns the value of the parameter with the name <code>name</code></li> | |
50 <li><b><code>setParameter(String name, String value)</code></b>: sets the value of the named parameter (value can be of any type)</li> | |
51 <li><b><code>getAllParameters(int prio)</code></b>: returns a String of all parameters in HTTP request format (name=value) below the given priority</li> | |
52 <li><b><code>addMark(Position pos)</code></b>: adds a mark with the given Position</li> | |
53 <li><b><code>deleteMark()</code></b>: removes the last mark form the list</li> | |
54 <li><b><code>getAllMarks()</code></b>: returns a String with all current marks in digilib format (for parameter "mk")</li> | |
55 <li><b><code>addFlag(String name)</code></b>: adds a digilib mode flag with the given name</li> | |
56 <li><b><code>hasFlag(String name)</code></b>: returns if the given flag is currently set</li> | |
57 <li><b><code>removeFlag(String name)</code></b>: removes the given flag</li> | |
58 <li><b><code>toggleFlag(String name)</code></b>: toggles the given flag</li> | |
59 <li><b><code>getAllFlags()</code></b>: returns a String with all current flags in digilib format (for parameter "mo")</li> | |
60 </ul> | |
61 | |
62 </body> | |
63 </html> |