Untitled Document

Das Projekt Digital Document Library hat zum Ziel, "Dokumente"mit + Heilfe eines Web-Browsers anschauen zu können. Diese Dokumente sind hochaufgelöste + Bilddateien, die auf einem Server gespeichert sind. Um der Benutzerin, dem Benutzer + die Möglichkeit einer raschen Konsultation der Daten liefern zu können, + müssen diese Bilddaten auf eine vernünftige Grösse verkleinert + und an die Anfragenden geschickt werden. Weiter sollen den Usern Hilfsmittel + zur Verfügung stehen um in diesen Seiten zu navigieren. Diese Hilfsmittel + bestehen aus Funktionen um zwischen verschiedenen Seiten hin und her zu wechseln, + Ausschnitte aus einem Bild zu zoomen und der Möglichkeit Markierungen zu + setzen. Ein weiter wichtiges Feature dieses Programms ist es, Referenzen von + Seiten (inkl. Ausschnitte und Markierungen) verfügbar zu machen, die dann + in beliebiegen anderen Dokumenten eingebaut werden können. Sofern die Lesenden + dieser Dokumente dann über einen Anschluss ins Internet verfügen, + können diese Referenzen direkt konsultiert werden und so die Digital Document + Library als grosse Quelltextsammlung gebraucht werden.

2. Filestruktur

Die Digital Document Library ist als Client/Server-Modell aufgebaut, wobei + an dieser Stelle hauptsächlich die Clientseite beschrieben wird. Zu einem + besseren Verständnis ist nun folgend eine Skizze mit den verschiedenen + Files und Verzeichnissen anfügt.

Da JavaScript auf den verschiedenen verfügbaren Browsern + nicht genau gleich implementiert wurde und Digilib auf dieser Scriptsprache + aufsetzt, ist es wichtig in digilib.html eine geeignete Version von navigation_XX.js + zu finden. Das XX wird als Variable für unterschiedliche Anpassungen an + die Browser. Momentan sind Netscape 4 (navigation_n4.js) und Netscape 6 (navigation_n6.js) + unterstützt.
+ Beim Erstellen der Struktur wurde darauf geachtet, dass das Layout und die tatsächliche + Funktionalität voneinander getrennt sind. Dies ermöglicht eine besstmögliche + Portabilität des Codes, so dass es möglich ist, Digilib für spezielle + Anwendungen anzupassen (vgl. Compago, Universität Bern).

3. Files

3.1 digilib.html

Dies ist die Schnittstelle zwischen Layout und Funktion von Digilib. Die Aufgaben + dieser Datei sind, das Laden der richtigen navigation_XX.js-Datei und das Anpassen + des Layouts. Hauptaufgabe jedoch ist das Lesen der Parameter aus der URL. digilib.html + ist so aufgebaut, dass ein Bild (inkl. Ausschnitte und Markierungen) vollständig + über Parameter in der URL angegeben werden kann. Nun folgend ist eine Liste + mit allen möglichen Parametern, wobei nur gerade der erste gegeben sein + muss - alle andern haben Defaultwerte, die in Klammern angegeben sind:

Diese Parameter werden von digilib.html als ein Block gelesen und an navigation_XX + weitergeleitet, wo dieser Block dann auseinander genommen und im richitgen Format + gespeichert wird.

3.2 navigation.html

Diese Datei lädt fw_menu.js, mit Funktionen für Events bei den Knöpfen + und Menus. Weiter ist hier das Layout der Navigationsleiste festgelegt und die + Texte für die Kontexthilfe sind hier gespeichert.

3.3 fw_menu.js

In dieser von Fireworks generierten JavaScript-Datei werden die Events abgearbeitet, + die bei Mausbewegungen und -klicks über den Knöpfen gesendet werden. + In dieser Datei ist auch eine Funktion für die kantextsensitive Hilfe der + einzelnen Knöpfe gespeichert. Wenn sie eingeschaltet ist, dann wird beim + Überfahren der Knöpfe ein kleines Fenster geöffnet, in dem kurz + die Funktion und der Gebrauch dieses Knopfes erläutert.
+

3.4 navigation_XX.js

Diese Datei bildet das Kernstück des Digilib-Clients. Hier werden die + Funktionen angeboten um Seiten zu wechseln, Makierungen zu setzen, Referenzen + zu erzeugen und Ausschnitte zu zoomen. Weiter werden hier die Parameter aus + digilib.html überprüft und gespeichert, die Anfrage ans Servlet gemacht, + wenn ein neuer Ausschnitt bzw ein neues Bild gewünscht wird und dieses + wird dann ebenfalls von dieser Datei aus im Browser ausgegeben.
+ Es gibt zwei wichtige globale Variablen in dieser Datei:

-Tags) umgehen kann. Nachstehend ist ganz +kurz erläutert, welche Funktionen in navigation3XXX.js welche Aufgaben erfüllen: + +- genString(detail) + +Anhand von 'detail' generiert diese Funktion die Parameterliste für einen Aufruf +eines neuen Bildes, eines Ausschnittes oder des Strings für eine +Referenzabfrage. 'detail' wird gebraucht, um die Anzahl der nötigen Parameter +für das Ausführen der aufrufenden Funktion zu bestimmen. Diese Funktion wird +immer indirekt, d.h. in anderen Funktionen von navigation3XXX.js aufgrufen und +liefert eine Stringrückgabe. + +- Backpage(), Nextpage(), Page() + +Diese Funktionen handeln die Navigation durch die Seiten eines Verzeichnisses. +Diese Funktionen werden mit einem Klick auf die Navigationsbuttons aufgerufen +und Laden eine neue Seite. + +- Ref(refselect) + +Hier wird ein PopUp-Fenster erzeugt, das die komplette URL der momentanen Seite +zurückgibt. Mit 'refselect' wird bestimmt, ob die Formatierung der Ausgabe in +HTML- oder LaTeX-Form sein soll. Diese Funktion wird mit dem "Ref"-Button +aufgerufen. + +- Mark() + +Diese Funktion plaziert eine Markierung auf dem Bild, wobei sie zuerst nur die +Maus-koordinaten bei einem Klick auf das Bild abfängt und dann die Funktion +'setmark()' aufruft. Es können bis zu fünf Markierungen auf ein Bild gesetzt +werden. Auch diese Funktion wird direkt über die Navbuttons aufgerufen. + +- Zoomrect(), Zoomin(), Zoomout() + +Direkt aufgerufene Funktionen die sich mit dem Zoomen innerhalb eines Bildes +beschäftigen. Die Rückgabe ist bei allen drei Funktionen ein Aufruf eines neuen +Bildes. + +- Moveto() + +Diese Funktion verändert das Zentrum bei einem schon gezoomten Bild. Die +geklickten Koordinaten entsprechen dann dem Zenrum des neuen Bildes bei gleicher +Vergrösserung. Dieses Feature wird in Zeichnungsprogrammen oft mit 'Pan' +betitelt. Direkter Aufruf und Aufruf des neuen Bildes sind gleich wie bei den +Zoom-Funktionen. + +- Scaledef(scaledef) + +Mit Scaledef wird die Bildgrösse im Vegleich zur in ScaleServlet.java +angegebenen Standardgrösse verändert. Der Parameter 'scaledef' gibt diesen +Faktor an. Eine Liste der möglichen Werte ist weiter oben angegeben. Auch hier +wird di Funktion direkt über die Auswahlliste im Navigationsframe aufgerufen und +auch hier wird ein neues Bild geladen. + +- setmark() + +Setmark wird indirekt von Mark() oder initScripts() aufgerufen und zeichnet sich +für die Positionierung der Markierungen verantwortlich. Die Funktion extrahiert +aus att[5] die einzelnen Koordinaten und setzt die Punkte. Wenn eine bestimmte +Reihenfolge bei den Punkten eingehalten werden soll, dann müssen sie auch immer +gleich in der Parameterliste aufgerufen werden. Die Funktion setmark gibt nichts +zurück. + +- parseKeypress() + +Diese Funktion dient dem Abfangen von Tastatureingaben, wobei die Tasten "n" für +nächste Seite und "b" für vordere Seite abgefragt werden. parseKeypress wird von +initScripts aufgerufen und hat keinen Rückgabewert. + +- initScripts() + +In dieser Funktion werden Vorkehrungen getroffen, die beim Anzeigen einer neuen +Seite getroffen werden müssen. Deshalb wird diese Funktion automatisch beim +Laden von digilib3.jsp aufgerufen. Insbesondere ruft diese Funktion +parseKeypress und setmark auf, wobei bei verschiedenen Browsertypen auch noch +andere Sachen hinzukommen (bei Netscape 6 wird zum Beispiel auch die +Clientgrösse berechnet und geschaut ob Scrollbalken gemacht werden müssen). + + +4. ScaleServlet.java +-------------------- + +Der Aufruf von ScaleServlet.java erfolgt grundsätzlich von digilib3.jsp und die +Parameterliste hat auch die selben Attribute (ausgenommen ist att[5] mit den +Koordinaten der Markierungspunkte. Bei Fragen über die einzelnen Bedeutungen der +Attribute sie hier also auf Kapitel 2 verwiesen. An dieser Stelle sei aber noch +etwas gesagt, über die Zusammensetzung der Parameterliste. ScaleServlet.java +kennt drei verschiden lange Parameterlisten, mit denen es arbeiten kann, wobei +die korrekte Zusammenstellung der Parameterliste in digilib3.jsp erfolgt. + +- Kurz (att[1] - att[4]) + +Diese vier Parameter geben dem ScaleServlet die Aufgabe, ein Bild (bestimmt mit +att[1] und att[2]) auf die Standardgrösse zu skalieren und an den Client zu +senden. Att[3] gibt zusätzlich den Skalierungsfaktor an und att[4] verhindert +mit einer Zufallszahl, dass das Bild aus dem Browsercache geholt wird. + +- Mittel (att[1] - att[4] + att[6] - att[9]) + +Diese Möglichkeit des Aufrufs wird gebraucht, um bezüglich des in att[8] und +att[9] bestimmten Mittelpunktes einen Ausschnitt zu vergrossen. Um den genannten +Punkt einzuordnen, wird die grösse des momentan angezeigten Bildes mit den +Parametern 6 und 7 mitgegeben. + +- Lang (att[1] - att[4] + att[6]- att[11]) + +Ein Aufruf in dieser Form gibt dem Servlet an, einen Ausschnitt aus einem Bild +zu vergrössern und zurückzusenden. Folgt ein Aufruf in dieser Form, bekommen die +Parameter att[8] und att[9] die Werte der linken oberen Ecke und att[10]/[11] +die Breite/Höhe des Ausschnitts. + + +Aufgrund eines eingebauten Session-Managements im Servlet ist es möglich mit +digilib auch mehrfach in ein Bild hinein zu zoomen. + +(Anm: Auch wenn dieses Session-Management seinen Zweck beim Anschauen der Bilder +sehr gut erfüllt, ist es dem ScaleServlet nicht möglich den Referenz-URLs +anzusehen, ob zuerst mehrfach hineingezoomt wurde und gibt unter Umständen +- eben wenn mehrfach hieingezoomt wurde vor der Generierung der Referenz - einen +falschen Ausschnitt zurück.) + + +---------------------------------------------- \ No newline at end of file

+ Stand: +	+ 27. März 2001 +
+ +	+ +
+ Leitung: +	+ Gerd Grasshoff (gerd.grasshoff@philo.unibe.ch) +
+ Autor: +	+ Christian Luginbühl (luginbuehl@student.unibe.ch) +

Digital Document Library

Stand:

27. März 2001

Leitung:

Gerd Grasshoff (gerd.grasshoff@philo.unibe.ch)

Autor:

Christian Luginbühl (luginbuehl@student.unibe.ch)