Dokumentation der Scripting-API - Versionsgeschichte

Steffen.binas am 15. September 2012 um 18:58 Uhr

2012-09-15T18:58:05Z

Steffen.binas am 15. September 2012 um 18:28 Uhr

2012-09-15T18:28:19Z

Steffen.binas am 15. September 2012 um 18:05 Uhr

2012-09-15T18:05:06Z

Mark.lorenz: /* Hooks */

2012-08-15T12:54:28Z

Hooks

Mark.lorenz: /* spezielle Hooks */

2012-08-15T08:38:45Z

spezielle Hooks

Mark.lorenz: /* spezielle Hooks */

2012-08-15T08:38:27Z

spezielle Hooks

Mark.lorenz: /* Hooks */

2012-08-14T13:22:57Z

Hooks

Mark.lorenz: /* Hooks */

2012-08-14T13:06:17Z

Hooks

Mark.lorenz: /* Hooks */

2012-08-14T13:04:46Z

Hooks

Mark.lorenz: /* Hooks */

2012-08-14T13:02:37Z

Hooks

@@ Zeile 24: / Zeile 24: @@
      if Moveable = nil then
        Exit; // Abbrechen, denn Objekt hat keinen Bewegungspfad
-−
      Moveable.SetDefault; // bestehenden Pfad komplett entfernen
      var Item: [[ITimeRect]];
-−
      // Erster Pfadpunkt (ist immer vorhanden)
      Item := Moveable[0];
      Item.SetBounds(DoubleRect(0.25, 0.25, 0.75, 0.75); // Halber Bildschirm
-−
      // Zweiten Pfadpunkt hinzufügen
      Item := Moveable.AddItem;

@@ Zeile 12: / Zeile 12: @@
 * [[Scripting-Entwicklungsumgebung]] - Wie werden Scripts erstellt, getestet und debuggt.
 * [[GUI-API]] - Wie kann eine Benutzeroberfläche erstellt werden
-* [[Kategorie:Scripting-API]] - Alle Seiten zur ScriptingAPI
+* [[:Kategorie:Scripting-API|Alle Seiten zur ScriptingAPI]]
 = Beispiel =

@@ Zeile 1: / Zeile 1: @@
-= Hooks =
+Die DiaShow lässt sich mit Scripts stark erweitern. Scripts können sowohl auf das Abspielen Einfluss nehmen aber auch die Benutzeroberfläche erweitern.
-Alle Hooks haben als Parameter das aktuelle [[DiaShow-Objekt]] vom Typ '''ISlideShowObject'''. So kann direkt auf das Objekt zugegriffen werden, dem die Skript-Datei angehängt ist.
+Eines vorneweg: Hier geht es tief in die "Eingeweide" der DiaShow. Sie sollten bereits einfache Programmierkenntnisse mitbringen, um mit dieser Funktionalität etwas anfangen zu können.
-== allgemeine Hooks ==
+= Wie benutze ich Scripts? =
-* Vor dem Abspielen der Show
+= Weiterführende Informationen =
-<code>
+* [[Hooks]] - Wo/Wann kann ein Script etwas beeinflussen
-  procedure OnExpandSlideShow(SlideShowObject: ISlideShowObject);
+* [[DiaShow-Objekte]] - Welche Elemente der Diashow lassen sich erstellen und ändern
-</code>
+* [http://code.google.com/p/dwscript/wiki/Language Sprachreferenz (DelphiWebScript)] - Welche Befehle stellt die Scripting-Programmiersprache bereit
-* Beim Einfügen aus der Toolbox; Wird ausgeführt, bevor das Objekt in der Timeline oder dem Storyboard erstellt wurde; Gibt die Funktion TRUE zurück, dann wird das Objekt endgültig eingefügt.
+Ein ganz einfaches Beispiel eines Scripts könnte so aussehen. Dieses Beispiel definiert einen Bewegungspfad für z.B. ein Bild oder Text:
 <code>
-   //Beispiel eines möglichen Kontextmenü-Eintrags
+   procedure OnExpandSlideShow(SlideShowObject: [[ISlideShowObject]])
    begin
-     Result := '[' +
+     var Moveable = SlideShowObject as [[IMoveable]];
-                '{' +
+    if Moveable = nil then
-                  '"Caption": "Text des Eintrags",' +
+      Exit; // Abbrechen, denn Objekt hat keinen Bewegungspfad
-* Erstellen der GUI, siehe dazu [[GUI-API]]
+    // Erster Pfadpunkt (ist immer vorhanden)
-* Bei Anwenden des Effekts [[Effektobjekt|Bildeffekte]]
+    // Zweiten Pfadpunkt hinzufügen
-** Parameter '''Bitmap''': Das [[Leinwandobjekt]], auf das gezeichnet wird
+    Item := Moveable.AddItem;
-<code>
+    Item.SetBounds(DoubleRect(0.0, 0.0, 1.0, 1.0);  // Ganzer Bildschirm
-  procedure Render(SlideShowObject: ISlideShowObject; Bitmap: ICanvas);
+    Item.SetTime(SlideShowObject.Duration div 2); // Zeitpunkt, wann der zweite Punkt erreicht sein soll
 </code>
 [[Kategorie:Scripting-API]]

@@ Zeile 2: / Zeile 2: @@
 Hooks, also Haken, sind vordefinierte Stellen, die genutzt werden, um ein Skript an die DiaShow zu koppeln. Sie bestimmen, wann welcher Code ausgeführt wird. Code, der in die Prozedur ''OnExpandSlideShow'' geschrieben wird, wird beispielsweise direkt vor dem Abspielen der Show ausgeführt. Hooks brauchen nicht definiert zu werden, die Skript-Engine kennt diese speziellen Methoden und reagiert entsprechend darauf.
-Alle Hooks haben als Parameter das aktuelle [[DiaShow-Objekt]] vom Typ '''ISlideShow'''. So kann direkt auf das Objekt zugegriffen werden, dem die Skript-Datei angehängt ist.
+Alle Hooks haben als Parameter das aktuelle [[DiaShow-Objekt]] vom Typ '''ISlideShowObject'''. So kann direkt auf das Objekt zugegriffen werden, dem die Skript-Datei angehängt ist.
 == allgemeine Hooks ==

@@ Zeile 33: / Zeile 33: @@
    end;
 </code>
 * Erstellen der GUI, siehe dazu [[GUI-API]]

@@ Zeile 35: / Zeile 35: @@
 * Erstellen der GUI, siehe dazu [[GUI-API]]
-* Render für [[Effektobjekt|Bildeffekte]]???
 = Unterstützte DiaShow-Objekte =