Name:
picture (CGI-Skript)

Syntax:
picture

Beschreibung:

picture ist ein CGI-Skript, das von einem WWW-Server gestartet wird. Es wird durch die Environment-Variable QUERY_STRING gesteuert. Die Variable wird vom WWW-Server entsprechend einer WWW-Anfrage gesetzt.

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:


Zurück zum Inhaltsverzeichnis

Stefan Sander, sanderst@cs.tu-berlin.de, 10/95