picture erstellt ein HTML-Dokument das zwei Inline-Images enthält, die sensitiv sind. Je nachdem mit welchen Parametern (in QUERY_STRING) picture gestartet wird, wird entweder ein vergrößerter Quadrant vom Atrium- oder Ventricle-Gel dargestellt. In diesem Quadranten ist ein bestimmter Bereich (hier: Spot) durch ein Rechteck farbig markiert. Zusätzlich ist ein weiteres Bild enthalten, das das gesamte Gel in verkleinerter Form zeigt. In diesem Bild ist der selektierte Quadrant markiert.
Der Benutzer kann in das verkleinerte Gesamtbild klicken, um einen anderen Quadranten zu selektieren; in das Quadrantenbild klicken, um eine Spotinformation zu erhalten bzw. um einen anderen Quadranten zu wählen.
Neben den beiden Bildern enthält das generierte Dokument eine Liste, die beschreibt, welche Aktionen der Benutzer ausführen kann:
Parameterübergabe
Das Gel (Atrium, Ventricle), dessen Quadrant angezeigt, und der Bereich (Spot), der markiert werden soll, wird dem Skript in der Environment-Variable QUERY_STRING mitgeteilt. QUERY_STRING muß dazu folgende Form besitzen (Angaben in eckigen Klammern [] sind optional):QUERY_STRING = w=bild&k=x1,y1,x2,y2[&link=url][&c=r,g,b][&text=string][&trans=bool]
- bild
-
Kann den Wert atr oder ven
haben. Bei w=atr wird ein Quadrant
des Atrium-Gels, bei w=ven ein Quadrant des
Ventricle-Gels angezeigt. Die Auswahl, welcher
Quadrant angezeigt werden muß, trifft
picture mittels der übergebenen Werte
x1,y1,x2,y2.
- x1,y1,x2,y2
-
Geben die Eck-Koordinaten des Rechteckes an,
das den Bereich (Spot)
markiert. (x1,y1) ist die obere linke
Ecke und (x2,y2) die rechte untere Ecke
des Rechtecks. x1, y1, x2 und
y2 sind durch Zahlen zu ersetzen.
- url
-
In die oben beschriebene Liste wird von
picture ein Verweis als Listenelement
aufgenommen. Der Verweis zeigt auf den
angegebenen url. Der Link wird
eingebettet in den Text:
go back to protein-information
Sollen innerhalb des URLs url Sonderzeichen Verwendung finden, dann müssen diese ggf. gemäß der URL-Spezifikation kodiert werden. Die Angabe von link=url ist optional.
- r,g,b
-
Zeichnet das Rechteck in der angegebenen
Farbe. r,g und b sind numerische
Werte, die den Rot-, Grün- bzw. Blauanteil
angegeben. Sie müssen im Bereich [0;255]
liegen. Die Angabe einer Farbe ist optional,
als Zeichenfarbe ist rot voreingestellt.
- string
-
Wird text=string angegeben, so erhält das
Dokument die Überschrift:
Position of protein on gel:
- string
Zusätzlich gibt string den Text an, mit dem das gezeichnete Rechteck versehen werden soll. Die Angabe ist optional. Sollen innerhalb string Sonderzeichen Verwendung finden, dann müssen diese gemäß der URL-Spezifikation kodiert werden. Unter anderem muß ' ' (SPACE) durch '+' kodiert werden!
- bool
-
bool kann den Wert true oder
false annehmen. Wird der Eintrag
trans=bool nicht angegeben, so nimmt
picture den Wert false als
Voreinstellung an.
Im Fall trans=false wird der ausgegebene Text string mit einem schwarzen Untergrund versehen. Dies ist die Voreinstellung. Wirkt der Schriftuntergrund störend, dann kann er durch trans=true abgeschaltet werden.
Die oben beschriebene Liste, die dem Benutzer beschreibt, welche Aktionen er ausführen kann, und die einige Verweise enthält, besitzt einen speziellen Eintrag. Dieser ermöglicht auf leichte Art und Weise den Wert für trans zwischen true und false hinundherzuschalten.
- Beispiel:
- QUERY_STRING = w=atr&k=20,20,130,140&text=Markierung&c=0,255,0
WWW-Schnittstelle
picture wird nicht vom Benutzer selbst, sondern von einem WWW-Server als CGI-Skript gestartet, wenn von einem WWW-Client eine entsprechende Anfrage in Form eines URLs kommt. Der Server setzt die Environment-Variable QUERY_STRING anhand des URLs. Der URL liefert die Information, welches Gel (Atrium, Ventricle) und welcher Bereich angezeigt werden soll. Damit QUERY_STRING, wie unter «Parameterübergabe» beschrieben, gesetzt wird, muß der URL die Form haben (die Angaben in eckigen Klammern [] sind optional):
-
http://host/cgi-verzeichnis/picture?w=bild&k=x1,y1,x2,y2[&link=url][&c=r,g,b][&text=string][&trans=bool]
- host
- Name des Rechners auf dem der WWW-Server läuft.
- cgi-verzeichnis
- Verzeichnis in dem sich die CGI-Skripte des
Servers befinden. Der Server muß dazu passend
konfiguriert sein.
- bild
-
Kann den Wert atr oder ven
haben. Bei w=atr wird ein Quadrant
des Atrium-Gels, bei w=ven ein Quadrant des
Ventricle-Gels angezeigt. Die Auswahl welcher
Quadrant angezeigt werden muß, trifft
picture mittels der übergebenen Werte
x1,y1,x2,y2.
- x1,y1,x2,y2
-
Geben die Eck-Koordinaten des Rechteckes an,
das den Bereich (Spot)
markiert. (x1,y1) ist die obere linke
Ecke und (x2,y2) die rechte untere Ecke
des Rechtecks. x1, y1, x2 und
y2 sind durch Zahlen zu ersetzen.
- url
-
In die oben beschriebene Liste wird von
picture ein Verweis als Listenelement
aufgenommen. Der Verweis zeigt auf den
angegebenen url. Der Link wird
eingebettet in den Text:
go back to protein-information
Sollen innerhalb des URLs url Sonderzeichen Verwendung finden, dann müssen diese ggf. gemäß der URL-Spezifikation kodiert werden. Die Angabe von link=url ist optional.
- r,g,b
-
Zeichnet das Rechteck in der angegebenen
Farbe. r,g und b sind numerische
Werte, die den Rot-, Grün- bzw. Blauanteil
angegeben. Sie müssen im Bereich [0;255]
liegen. Die Angabe einer Farbe ist optional,
als Zeichenfarbe ist rot voreingestellt.
- string
-
Wird text=string angegeben, so erhält das
Dokument die Überschrift:
Position of protein on gel:
- string
Zusätzlich gibt string den Text an, mit dem das gezeichnete Rechteck versehen werden soll. Die Angabe ist optional. Sollen innerhalb string Sonderzeichen Verwendung finden, dann müssen diese gemäß der URL-Spezifikation kodiert werden. Unter anderem muß ' ' (SPACE) durch '+' kodiert werden!
- bool
-
bool kann den Wert true oder
false annehmen. Wird der Eintrag
trans=bool nicht angegeben, so nimmt
picture den Wert false als
Voreinstellung an.
Im Fall trans=false wird der ausgegebene Text string mit einem schwarzen Untergrund versehen. Dies ist die Voreinstellung. Wirkt der Schriftuntergrund störend, dann kann er durch trans=true abgeschaltet werden.
Die oben beschriebene Liste, die dem Benutzer beschreibt, welche Aktionen er ausführen kann, und die einige Verweise enthält, besitzt einen speziellen Eintrag. Dieser ermöglicht auf leichte Art und Weise den Wert für trans zwischen true und false hinundherzuschalten.
- Beispiel:
-
http://www.chemie.fu-berlin.de/cgi-bin/dhzb/picture?w=atr&k=20,20,130,140&text=Markierung&c=0,255,0
Funktionsweise
Das von picture generierte HTML-Dokument hat folgenden Aufbau:
- Es enthält zuerst eine Überschrift, die in Abhängigkeit vom
Parameter text=string in QUERY_STRING erstellt
wird. Siehe dazu «Parameterübergabe».
- Es folgt eine Liste, deren Aufbau von den
Parametern w, trans
und link bestimmt wird. Die Listenelemente
liefern Informationen zu möglichen Aktionen und
enthalten Verweise:
Der Benutzer kann das gesamte Gelbild abrufen. Der Bereich x1,y1,x2,y2 wird auch dort markiert. Dazu existiert ein Link auf picture.lg.
Ein weiterer Verweis erlaubt das Hinundherschalten zwischen der Darstellungsweise des an das Rechteck geschriebenen Textes string. Der Text kann mit oder ohne schwarzen Hintergrund ausgegeben werden. Dieses Verhalten wird erreicht, indem das Skript einen Verweis auf sich selbst erzeugt. Der Verweis wird so gestaltet, daß er die aktuellen Parameter erhält, mit denen picture gestartet wurde. Lediglich der Eintrag für trans wird "invertiert". Aus trans=true wird trans=false und aus trans=false wird trans=true. Das Fehlen des Eintrages trans wird genauso wie das Vorhandensein des Eintrags trans=false behandelt.
Beispiel:
- Wurde picture gestartet durch den URL:
- http://www.chemie.fu-berlin.de/cgi-bin/dhzb/picture?w=atr&k=20,20,130,140&text=Markierung&c=0,255,0
- Dann wird folgender Verweis im HTML-Dokument erzeugt:
- <A HREF =
"/cgi-bin/dhzb/picture?w=atr&k=20,20,130,140&text=Markierung&c=0,255,0&trans=true">
switch transparency of protein name on
</A> - Der fehlende Teil
"http://www.chemie.fu-berlin.de" wird vom Browser
bei Aktivierung des Links ergänzt.
- Wurde picture gestartet durch den URL:
- Als nächstes folgt die Einbindung eines sensitiven
Inline-Bildes. Es stellt das gesamte Gel-Bild in
verkleinerter Form dar. Der selektierte
Quadrant ist markiert. Das Bild wird durch das
CGI-Skript
markquadrant
erstellt. Dem Skript werden dazu entsprechende
Parameter übergeben.
Das Bild ist sensitiv. Als das den Mausklick auswertende CGI-Skript wird imagemap verwendet. Die Mapdatei ist atrium.sml.map für das Atrium-Gel bzw. ventricle.sml.map für das Ventricle-Gel.
Wird picture mit dem Parameter w=atr gestartet, so wird folgender Eintrag erzeugt:
<A HREF = "/cgi-bin/dhzb/imagemap/atrium.sml">
<IMG SRC = "/cgi-bin/dhzb/markquadrant?w=atr&q=quadrant">
</A>quadrant wird von picture anhand der Koordinaten x1,y1,x2,y2 und der Bildgröße des Atrium-Gels bzw. Ventricle-Gels errechnet.
- Dann wird ein sensitives Bild eingetragen, das
einen vergrößerten Quadranten des Atrium- bzw.
Ventricle-Gels zeigt; gesteuert durch w=atr
bzw. w=ven. Das Bild wird vom CGI-Skript
nph-startgifcrossxy
erstellt. Es zeichnet in das Quadrantenbild das
Rechteck ein, das den Bereich (Spot) markiert.
Das Quadrantenbild ist sensitiv. Als auswertendes CGI-Skript wird startimagemap.lg verwendet. startimagemap.lg führt zunächst eine Koordinatentransformation durch und startet dann imagemap. Näheres dazu ist in der Beschreibung zu startimagemap.lg zu finden.
Wird picture mit den Parametern w=atr, k=x1,y1,x2,y2, text=string und trans=true gestartet, so wird folgender Eintrag im HTML-Dokument erzeugt:
<A HREF = "/cgi-bin/dhzb/startimagemap.lg/atrquadrant">
<IMG SRC = "/cgi-bin/dhzb/nph-startgifcrossxy?w=atr&k=nx1,ny1,nx2,ny2&q=quadrant&text=string&trans=true">
</A>quadrant und nx1,ny1,nx2,ny2 werden von picture anhand der Koordinaten x1,y1,x2,y2 und der Bildgröße des Atrium-Gels bzw. Ventricle-Gels errechnet.