3QuarksAppletsMetamorphoseParameter
English
Das Applet Metamorphose kann über insgesamt zwölf Parameter an verschiedene Anforderungen angepaßt werden, wobei insbesondere die Oberfläche des Applets und der Schieberegler zum Bewegen des Panoramabildes frei gestaltet werden kann. In diesem Beispiel werden zehn der zwölf Parameter verwendet. Die beiden hier nicht aufgeführten Parameter werden auf der Seite "Platonisches Universum - Parameter" näher beschrieben, mit ihnen können Einzelbilder und Animationen in das Panorama eingefügt werden.


Metamorphose Background


  <applet code=Metamorphose.class width=540 height=298>
    <param name=BackgroundColor value="#515F60">
    <param name=BackgroundImage value="Background.jpg">
    <param name=PanoramaRect    value="10,10,520,241">
    <param name=PanoramaTile    value="PanoramaTile.gif">
    <param name=PanoramaImage   value="Metamorphose#.jpg,20">
    <param name=PanoramaSize    value="5000,241">
    <param name=PanoramaMessage value="lade Panoramabild # von 20">
    <param name=ScrollerRect    value="34,265,144,20">
    <param name=ScrollerThumb   value="Thumb.gif">
    <param name=Delay           value="50">
  </applet>
ParameterBackgroundColor
  <param name=BackgroundColor value="#515F60">
  <param name=BackgroundColor value="81,95,96">


Mit dem Parameter "BackgroundColor" wird die Hintergrundfarbe des Applets bestimmt. Die Farbe wird entweder im hexadezimalen HTML-Format "#rrggbb" oder durch Kommata getrennt mit ihrem Rot-, Grün-, und Blauanteil angegeben. Beim Start des Applets wird der Hintergrund so schnell wie möglich mit dieser Farbe gefüllt. Auch wenn das Applet ein Hintergrundbild verwendet, sollte immer eine Hintergrundfarbe angegeben werden. Anderenfalls erscheint zuerst der bei Java-Applets übliche hellgraue Hintergrund.
ParameterBackgroundColor
  <param name=BackgroundImage value="Background.jpg">

Das Hintergrundbild des Applets wird mit dem Parameter "BackgroundImage" bestimmt. Der übergebene Wert gibt den Dateinamen des Hintergrundbildes an, das im GIF- oder JPG-Format vorliegen muß. Ist das Bild kleiner als das Applet, dann wird es im Applet zentriert. Ist das Bild größer, dann wird es rechts bzw. unten abgeschnitten.
Background
Background.jpg, 540 × 298 Pixel
ParameterPanoramaRect
  <param name=PanoramaRect value="10,10,520,241">

Mit dem Parameter "PanoramaRect" bestimmen Sie einen rechteckigen Ausgabebereich für das Panorama. Die ersten beiden Werte legen die Position des Bereichs relativ zur linken oberen Ecke des Applets fest. Die letzten beiden Werte bestimmen die Breite und Höhe des Rechtecks. Wird der Parameter "PanoramaRect" nicht verwendet, dann wird das gesamte Applet zum Ausgabebereich. Wenn das Panorama höher als der Ausgabebereich ist, dann kann es vom Anwender mit der Maus vertikal verschoben werden. Ist es dagegen kleiner, dann bleibt unten ein Randbereich zurück, der mit einem Hintergundmuster gefüllt wird. In diesem Beispiel wird ein 520 Pixel breites und 241 Pixel hohes Rechteck an der Position (10, 10) als Ausgabebereich definiert.
ParameterPanoramaTile
  <param name=PanoramaTile value="PanoramaTile.gif">

Der optionale Parameter "PanoramaTile" bestimmt das Hintergrundmuster für den Ausgabebereich. Dieses Muster wird beim Laden der Panoramabilder als Platzhalter für die noch fehlenden Einzelbilder verwendet. Es wird zudem benutzt, wenn der Ausgabebereich höher als das Panoramabild ist. In diesem Fall wird der verbleibende untere Rand mit dem Muster gefüllt. Das Hintergrundmuster wird im Ausgabebereich gekachelt und sollte als so genannte nahtlose Kachel vorliegen. Die Größe des Musters bzw. der Kachel kann dabei frei gewählt werden, allerdings sollte die Gesamtbreite des Panoramas ein Vielfaches der Musterbreite betragen. Wird dieser Parameter nicht benutzt, dann wird die Hintergrundfarbe des Applets zum Füllen der beschriebenen Bereiche verwendet.
PanoramaTile PanoramaTile.gif
48 × 48 Pixel
ParameterPanoramaImage
  <param name=PanoramaImage value="Metamorphose#.jpg,20">

Ein Panorama setzt sich in der Regel aus einer Reihe von Einzelbildern zusammen. Der erste Wert des Parameters - hier "Metamorphose#.jpg" - bestimmt das Muster für die Dateinamen diese Einzelbilder. Das Zeichen "#" im übergebenen Wert dient dabei als Platzhalter für eine zweistellige Nummer, mit der die Bilder beginnend mit "01" durchnumeriert werden. In diesem Beispiel wird das Panorama aus zwanzig Einzelbildern, mit den Namen "Metamorphose01.jpg", "Metamorphose02.jpg" ... "Metamorphose20.jpg" zusammengesetzt. Der zweite Wert - in diesem Beispiel "20" - bestimmt die Anzahl der Einzelbilder.

Alle Einzelbilder sollten die gleiche Höhe aufweisen, die dem Applet mit dem Paramter "PanoramaSize" übergeben wird. Die Breite der Bilder können Sie dagegen frei wählen. So ist es auch möglich, verschieden breite Einzelbilder für ein Panorama zu verwenden. Die Bilder werden nacheinander geladen und, falls sie im sichtbaren Bereich des Panoramas liegen, sofort angezeigt. Bewegt der Anwender das Panorama in einen Bereich, für den noch keine Bilder geladen wurden, dann wird an Stelle der Bilder ein Hintergundmuster ausgegeben. Um beim Start des Applets ein gutes Ladeverhalten zu erzielen, sollten die Einzelbilder nicht zu groß gewählt werden. Empfohlen wird eine Dateigröße zwischen zehn und dreizig kByte.

Hier sind die ersten beiden Einzelbilder des zwanzigteiligen Panoramas "Metamorphose II" abgebildet.
Metamorphose01

Metamorphose01.jpg, 250 × 241 Pixel
Metamorphose02

Metamorphose02.jpg, 250 × 241 Pixel
ParameterPanoramaSize
  <param name=PanoramaSize value="5000,241">

Mit dem Parameter "PanoramaSize" wird die Größe des Panoramabildes übergeben. Die beiden Werte sind zwingend und bestimmen die Gesamtbreite und die Höhe des Panoramas, wobei sich die Breite aus der Summe der Einzelbilderbreiten zusammensetzt. Die Gesamtbreite muß größer oder gleich der Breite des Ausgabebereichs sein. In diesem Beispiel setzt sich das Panorama aus zwanzig, jeweils 250 Pixel breiten und 241 Pixel hohen Einzelbildern zusammen, was dann eine Gesamtbreite von 5000 Pixeln ergibt.

Anmerkung: Grundsätzlich könnte auch das Applet die Gesamtbreite des Panoramas aus der Breite der Einzelbilder berechnen. Allerdings stünde dieser Wert erst nach dem Laden aller Einzelbilder zur Verfügung. Der Anwender müßte dann das Ende des Ladevorgangs abwarten, bevor er das Panorama bewegen könnte. Aus diesem Grund wird die Gesamtbreite hier expliziet übergeben.
ParameterPanoramaMessage
  <param name=PanoramaMessage value="lade Panoramabild # von 20">

Mit Hilfe des Parameters "PanoramaMessage" informieren Sie den Anwender über den Vorschritt beim Laden der Panoramabilder, was besonders bei großen Panoramen sinnvoll ist. Dazu übergeben Sie eine Textnachricht, die dann in der Statuszeile des Browsers angezeigt wird. Das Zeichen "#" im übergebenen Text dient als Platzhalter für die Nummer des Bildes, das gerade geladen wird. In diesem Beispiel erscheinen nacheinander die Texte "lade Panoramabild 1 von 20", "lade Panoramabild 2 von 18" ... "lade Panoramabild 20 von 20" in der Statuszeile.
ParameterScrollerRect
  <param name=ScrollerRect value="34,265,144,20">

Mit dem Parameter "ScrollerRect" reservieren Sie einen rechteckigen Bereich für den Schieberegler. Die ersten beiden Werte legen die Position des Bereichs relativ zur linken oberen Ecke des Applets fest. Die letzten beiden Werte bestimmen die Breite und Höhe des Rechtecks. Der Knopf des Schiebereglers kann innerhalb dieses Bereichs horizontal bewegt werden. Beachten Sie bitte, daß der Hintergrund des Schiebereglers direkt auf das Hintergrundbild des Applets gezeichnet wird. Fehlt dieser Parameter, dann wird auch kein Schieberegler im Applet verwendet. Der Anwender kann das Panoramabild dann nur noch mit der Maus bewegen. In diesem Beispiel wird an der Position (34, 265) ein 144 Pixel breiter und 20 Pixel hoher Bereich für den Schieberegler reserviert.
ParameterScrollerThumb
  <param name=ScrollerThumb value="Thumb.gif">

Der Knopf des Schiebereglers wird dem Applet mit dem Parameter "ScrollerThumb" als Bilddatei übergeben. Das Bild muß im JPG- oder GIF-Format vorliegen, wobei transparente GIFs unterstützt werden. Beim Start des Applets oder nach einem Mausklick auf das Panorama wird der Knopf im Bereich des Schiebereglers horizontal zentriert. Dies entspricht der Nullposition des Reglers. Bewegt der Anwender den Schieberegler nach rechts, dann bewegt sich das Panoramabild vorwärts; bewegt er ihn nach links, dann bewegt sich das Bild rückwärts. Fehlt dieser Parameter, dann wird auch kein Schieberegler im Applet verwendet. Der Anwender kann das Panoramabild dann nur noch mit der Maus bewegen.
Thumb Thumb.gif, 9 × 20 Pixel
ParameterDelay
  <param name=Delay value="50">

Der Parameter "Delay" bestimmt die Wartezeit in tausendstel Sekunden, die vor jedem Neuzeichnen des Panoramas eingelegt wird. Zum einen betrifft dies die Bildwiederholfrequenz beim Scrollen des Panoramas und zum anderen die Länge der Wartepausen bei animierten Bildern. Beachten Sie bitte, daß in diesem Beispiel keine Animationen verwendet werden. Auf der Seite "platonisches Universum" finden Sie ein Panorama, das animierte Bilder einsetzt.

Normalerweise brauchen Sie diesen Parameter nicht zu verwenden. Es gilt dann ein voreingestellter Wert von 50 Millisekunden, der für die meisten Anwendungsfälle optimal ist. Damit wird das Panorama beim Scrollen zwanzig mal pro Sekunde neu gezeichnet. Nur wenn der Ausgabebereich sehr groß ist und das Bild beim Scrollen flackert, sollten Sie hier mit größeren Werten experimentieren.
21. Mai 2000