AquaSoft Wiki - Benutzerbeiträge [de]

Bildobjekt

2017-01-06T10:58:31Z

Steffen.binas:

Das Bildobjekt ist vom Typ '''IPicture''' und leitet von '''[[ISlideShowObject]]''' ab.

<code>
IPicture '''inherits from''' [[ISlideShowObject]]
function Filename: [[IFilename]];
function Sound: [[ISound]];
function Content: [[IPictureContent]];
property Properties: TPictureProperties read GetProperties write SetProperties;
end;

TPictureProperties = record
Width, Height: Integer;
Orientation: TImageOrientation;
end;
</code>

= Methoden =

* Objekt Erzeugung
<code>
function CreatePictureObject: IPicture;
</code>

* Ein Bildobjekt benötigt einen Dateinamen zu dem gespeicherten Bild. Dieser ist als '''[[IFilename]]''' im Bild gespeichert:
<code>
function Filename: IFilename;
</code>

* Ein Bildobjekt kann eine Soundspur enthalten. Der Datentyp dieser ist ein '''[[ISound]]'''
<code>
function Sound: ISound;
</code>

* Zugriff auf Inhalt Bildobjekt (also das Bild selbst, ohne Metadaten) vom Typ '''[[IPictureContent]]'''
<code>
function Content: IPictureContent;
</code>

[[Kategorie:Scripting-API]]

Shaderobjekt

2016-09-09T14:18:01Z

Steffen.binas:

Das Bildobjekt ist vom Typ '''IShader''' und leitet von '''[[ISlideShowObject]]''' ab.

<code>
IShader '''inherits from''' [[ISlideShowObject]]
function Filename: [[IFilename]];
procedure SetTechnique(TechniqueName: string);
procedure SetParamInt(ParamName: string; Value: Integer);
procedure SetParamFloat(ParamName: string; Value: Float);
procedure SetParamFloat2(ParamName: string; V1, V2: Single);
procedure SetParamFloat3(ParamName: string; V1, V2, V3: Single);
procedure SetParamFloat4(ParamName: string; V1, V2, V3, V4: Single);
procedure SetParamRangeValue(ParamName: string; Value: IRangeValue);
procedure SetParamRangeValue2(ParamName: string; V1, V2: IRangeValue);
procedure SetParamRangeValue3(ParamName: string; V1, V2, V3: IRangeValue);
procedure SetParamRangeValue4(ParamName: string; V1, V2, V3, V4: IRangeValue);
function GetPostProcessing: Boolean;
procedure SetPostProcessing(const Value: Boolean);
function GetMeshColumns: Integer;
procedure SetMeshColumns(const P: Integer);
function GetMeshRows: Integer;
procedure SetMeshRows(const P: Integer);
procedure SetMesh(const Mesh: TVertexArray; const Indices: TIndexArray);
procedure AddTexture(const Texture: ICanvas);
procedure SetTexture(const TextureIndex: Integer; const Texture: ICanvas);
function GetTexture(const TextureIndex: Integer): ICanvas;
procedure DeleteTexture(const TextureIndex: Integer);
procedure ClearTextures;
function TextureCount: Integer;
property DrawPersistent: Boolean;
</code>

= Methoden =

* Objekt Erzeugung
<code>
function CreateShaderObject: IShader;
</code>

* Der Dateiname des Shaders. Hierbei ist eine konkreter Quelltextdatei eines [[HLSL-Shader|HLSL-Shaders]] für DirectX 9 gemeint (meist *.fx).
<code>
function Filename: [[IFilename]];
</code>

* Falls im Shaderquelltext mehr als eine Shader-Technik enthalten ist, kann sie über SetTechnique gesetzt werden
<code>
procedure SetTechnique(TechniqueName: string);
</code>

* Ein Shader benötigt verschiedene Parameter. Welche das sind und hängt vom tatsächlich verwendeten Shader ab. Über die SetParamXXX-Funktionen können entsprechende Werte an den Shader übergeben werden.
<code>
procedure SetParamInt(ParamName: string; Value: Integer);
procedure SetParamFloat(ParamName: string; Value: Float);
</code>

* DrawPersistent: Damit ein Bildgebendes ShaderObjekt liegen bleibt, muss DrawPersistent = True sein.

= Beispiel =

== Pixelshader-Effekte ==

Verpixeln: Presets\Scripts\Pixelate.sss

== Eigene Geometrie übergeben ==

Vollständiger Code, siehe Toolbox-Objekt "Dreieck": Presets\Scripts\GeometryTriangle.sss
<code>
var Mesh: TVertexArray;

// Dreieck:
//
// (-0.5, 0.5)----(0, 0.5)----(0.5, 0.5)
// | /\ |
// | / \ |
// | / \ |
// | / \ |
// | / (0, 0) \ |
// | / \ |
// | / \ |
// (-0.5, -0.5)--------------(0.5, -0.5)

// Mesh := [Vertex(0, 0.5), Vertex(0.5, 0.5), Vertex(-0.5, 0.5)];
Mesh.SetLength(3);
Mesh[0] := Vertex(0, 0.5);
Mesh[1] := Vertex(0.5, -0.5);
Mesh[2] := Vertex(-0.5, -0.5);
Shader.SetMesh(Mesh, []);
</code>

[[Kategorie:Scripting-API]]

Bildinhalt-Objekt

2016-07-20T15:21:18Z

Steffen.binas:

Das Bildinhalt-Objejt ist vom Typ '''IPictureContent'''. Es leitet vom '''[[ISlideShowObject]]''' ab. Das Bildinhalt ist das konkrete Bild. Während das [[Bildobjekt]] beispielsweise zusätzlich zu seinem Inhalt auch diverse Metadaten, wie den Dateinamen hält, sind mit dem Inhalt die konkreten Bilddaten gemeint. Das [[Collagenobjekt]] wird ebenfalls als ein zusammengefasstes Bild behandelt und hat als solches auch ein Bildinhalt-Objekt.

<code>
IPictureContent '''inherits from''' [[ISlideShowObject]]
procedure AppendEffect (const Item: [[IEffect]]);
procedure SetStretchMode(sm: Integer);
function GetStretchMode: Integer;
procedure SetFillBackground(fillBG: Integer);
function GetFillBackground: Integer;
function GetFace (const Index: Integer): [[IFace]];
function GetFaceCount: Integer;
function GetFillColor: Integer;
function SetFillColor(Value: Integer);
end;
</code>

= Methoden =

* Auf Bildobjekte können Effekte angewendet werden. Diese sind vom Typ '''[[IEffect]]'''
<code>
procedure AppendEffect (const Item: IEffect);
</code>

* Die Anpassung des Bildes an das DiaShow-Bildverhältnis festlegen
** Wert ''0'': Seitenverhältnis des Bildes erhalten
** Wert ''1'': zuschneiden
** Wert ''2'': verzerren
** Wert ''3'': intelligent zuschneiden
<code>
procedure SetStretchMode(sm: Integer);
function GetStretchMode: Integer;
</code>

* Hintergrund füllen: Ausgeschaltet bleiben die vorher gezeichneten Bilder liegen.
** Wert ''0'': Aus
** Wert ''1'': An
** Wert ''2'': Automatisch
<code>
procedure SetFillBackground(fillBG: Integer);
function GetFillBackground: Integer;
</code>

* Auf Bildobjekten können Gesichter erkannt werden. ''GetFace'' gibt das x-te Gesicht als '''[[IFace]]''' zurück
<code>
function GetFace (const Index: Integer): IFace;
</code>

* Die Anzahl der erkannten Gesichter
<code>
function GetFaceCount: Integer;
</code>

[[Kategorie:Scripting-API]]

Gallery

2015-09-22T07:58:18Z

Steffen.binas: /* Beispiel */

''Gallery'' ist eine möglicher Wert, den das '''Type'''-Element des [[Dokumentation der GUI-API|GUI-Strings]] erhalten kann. Es wird eine Bilderanzeige generiert.

Speichert einen Wert des Typs '''String'''.

= Optionen =
* "ImageDir": Pfad zu den einzufügenden Bildern, relativ zum Diashow-Presets-Ordner. Datentyp: String
Das ImageDir kann einen einfachen Ordner angeben, zum Beispiel "MyImagePath". Dann werden einfach alle gefundenen und unterstützten Bilder in die Galerie geladen. Gibt man hingegen "MyImagePath\\*" (Achten Sie auf das doppelte Backslash!) an, dann erstellt die Galerie Unterkategorien aus den Unterordnern. Haben sie also in "MyImagePath" die Ordner "Privates", "Tiere" und "Urlaub", dann sehen Sie in der Galerie die Kategorien "Privates", "Tiere" und "Urlaub", in denen die direkt aus den entsprechenden Ordnern befindlichen Bilder angezeigt werden. Die Galerie arbeitet nicht rekursiv.

* "NonePicture": true/false - lässt die Option "kein Bild" zu bzw. nicht zu
* "OwnPicture": true/false - lässt die Option ein eigenes Bild aus dem Dateisystem auszuwählen zu bzw. nicht zu

= Beispiel =
<code>
{
"Key" : "ImgComboBox1",
"Type" : "ImageComboBox",
"Caption" : "MyImgComboBox",
"Options" :
{
"ImageDir" : "MyImagePath\\*",
"NonePicture": true,
"OwnPicture": true
}
}
</code>

[[Kategorie:Scripting-API]]

Gallery

2015-09-22T07:57:43Z

Steffen.binas: /* Optionen */

Partikelobjekt

2015-08-17T12:59:11Z

Steffen.binas: /* Beispiel */

Das Partikelobjekt ist vom Typ '''IParticle''' und leitet von '''[[ISlideShowObject]]''' ab. Mit diesem Objekt kann man Partikeleffekte erstellen.

Das Partikelobjekt enthält unter anderem Eigenschaften des Typs [[IParticleRangeValue]] bzw. [[IParticleRangeValue|IParticleVectorRangeValue]]. Einige dieser Eigenschaften verfügen über Initialwerte (wie ''Size'' und ''InitialSize''). Die Initialwerte geben den Ausgangszustand des Wertes an, die Nicht-Initialwerte geben eine Änderung an. Die Initialwerte bekommen einen Wertebereich. Beim Emittieren eines Partikels wird dem neuen Partikel ein zufälliger Werte innerhalb dieses Bereichs zugewiesen. Initialwerte können sich über die Dauer des Partikelsystems ändern. Die Änderungswerte erhalten ebenfalls einen Bereich. Der Unterschied ist, dass bei ihnen vorher eine Wichtung ermittelt wird. Diese wird benutzt um die Änderungen über die Lebenszeit des Partikels immer gleich gewichtet zu haben (siehe [[#Beispiel|Beispiel]]).

<code>
IParticle '''inherits from''' [[ISlideShowObject]]
function InitialDirection: [[IParticleRangeValue|IParticleVectorRangeValue]]
function Direction: [[IParticleRangeValue|IParticleVectorRangeValue]]
function InitialSpeed: [[IParticleRangeValue]]
function Speed: [[IParticleRangeValue]]
function InitialSize: [[IParticleRangeValue]]
function Size: [[IParticleRangeValue]]
function InitialRotation: [[IParticleRangeValue|IParticleVectorRangeValue]]
function Rotation: [[IParticleRangeValue|IParticleVectorRangeValue]]
function InitialRotationFrequency: [[IParticleRangeValue|IParticleVectorRangeValue]]
function RotationFrequency: [[IParticleRangeValue|IParticleVectorRangeValue]]
function InitialOpacity: [[IParticleRangeValue|IParticleRangeValue]]
function Opacity: [[IParticleRangeValue|IParticleRangeValue]]

property Move: [[TParticleMove]]
function InitialMoveStrength: [[IParticleRangeValue|IParticleVectorRangeValue]]
function MoveStrength: [[IParticleRangeValue|IParticleVectorRangeValue]]
function InitialMoveSineFrequency: [[IParticleRangeValue]]
function MoveSineFrequency: [[IParticleRangeValue]]

function MaxAge: [[IParticleRangeValue]]
function ParticlesPerSecond: [[IParticleRangeValue]]

property SpriteAnimation: [[TParticleSpriteAnimation]]
function InitialSpriteAnimationFrequency: [[IParticleRangeValue|IParticleRangeValue]]
function SpriteAnimationFrequency: [[IParticleRangeValue]]

property Filename: [[IFilename]]
property Clipping: Boolean
property PreWarmTime: Integer

property Emitter: [[TParticleEmitter]]
function EmitterSpread: [[IParticleRangeValue]]
procedure AddEmitterClipRect(const X, Y, Width, Height, AngleZ: Single; const Invert: Boolean);

property Options: [[TParticleOptions]]
property Environment: [[TParticleEnvironment]]

property Seed: Int64
end;
</code>

= Methoden =

== Partikel ==

* Bewegungsrichtung: Die Werte modifizieren einen Bewegungsvektor, der nach rechts zeigt. Die jeweiligen Richtungen geben Winkel an, um die der Vektor gedreht wird. Wichtig ist dabei die Reihenfolge. Als erstes wird der Winkel um die Z-Achse addiert, dann wird der Vektor um die Y-Achse gedreht und dann um die X-Achse.
Die Drehwinkel kann man sich anhand folgender Beispiele herleiten:
** Drehwinkel um X und Y = 0 zeigt der Vektor bei Z = 0 (also der Basisvektor) nach rechts, bei Z = 90 zeigt der Vektor nach unten
** Bei X = 0 und Z = 0, zeigt der Vektor bei Y = 90 nach hinten
** Bei Z = 0 und Y = 90 zeigt der Vektor bei X = 90 nach oben
<code>
function InitialDirection: [[IParticleRangeValue|IParticleVectorRangeValue]];
</code>
* Richtungsänderung über die Zeit: Addition von Winkeln (zB. bei Initialrichtung von 10 und einer Richtung von 10 bekommt das Partikel die Richtung 20).
<code>
function Direction: [[IParticleRangeValue|IParticleVectorRangeValue]];
</code>

* Partikelgeschwindigkeit in Bewegungsrichtung
<code>
function InitialSpeed: [[IParticleRangeValue]];
</code>
* Geschwindigkeitsänderung über die Zeit: Prozent der Initialgeschwindigkeit.
<code>
function Speed: [[IParticleRangeValue]];
</code>

* Partikelgröße. Skaliert das Partikel ohne Verzerrung so, dass die größte Richtung die Partikelgröße wird ("einpassen"). Der Wert versteht sich in Prozent zu seinem Bezugssystem (siehe [[TParticleEnvironment]]):
<code>
function InitialSize: [[IParticleRangeValue]];
</code>
* Größenänderung über die Zeit: Prozent der Initialgröße.
<code>
function Size: [[IParticleRangeValue]];
</code>

* Partikeltransparenz
<code>
function InitialOpacity: [[IParticleRangeValue]];
</code>
* Transparenzänderung über die Zeit: Prozent der Initialtransparenz.
<code>
function Opacity: [[IParticleRangeValue]];
</code>

* Partikeldrehung: Man unterscheidet zwischen der statischen Lage des Partikels und einer beständigen Drehung. Beispielsweise sollen die Partikel beim Emittieren immer zwischen 10 und 20 Grad gedreht sein, die Lage aber behalten. Dafür kommt die Eigenschaft '''Rotation''' in Frage (bei einer Rotationsgeschwindigkeit von 0). Ist jedoch eine permanente Drehung gewünscht, nimmt man die '''Rotationfrequency''' (Rotationsgeschwindigkeit). Lage und Rotationsgeschwindigkeitschließen sich nicht aus. Positive Werte drehen im Uhrzeigersinn, negative entgegengesetzt. Die Werte verstehen sich als Winkeladditionen eines Basisvektoren, der die Standardrichtung angibt. Bei X = 0, Y = 0 und Z = 0 zeigt dieser Basisvektor nach rechts. Als erstes wird um Z rotiert, dann um Y, dann um X.
* Lage des Partikels
<code>
function InitialRotation: [[IParticleRangeValue|IParticleVectorRangeValue]];
</code>
* Lageänderung über die Zeit. Additiv (zB. 10° bei 0ms und 20° bei 1000ms ergibt in der ersten Sekunde eine Drehung um 10°, danach keine weitere).
<code>
function Rotation: [[IParticleRangeValue|IParticleVectorRangeValue]];
</code>
* Rotationsgeschwindigkeit: Gibt die Anzahl der Drehungen in einer Sekunde an.
<code>
function InitialRotationFrequency: [[IParticleRangeValue|IParticleVectorRangeValue]];
</code>
* Geschwindigkeitsänderung die Zeit: Prozent der Initialgeschwindigkeit.
<code>
function RotationFrequency: [[IParticleRangeValue|IParticleVectorRangeValue]];
</code>

* Partikelbewegung: Partikel können neben ihrer eigentlichen Bewegungsrichtung auch von ihrer Bewegung abweichen, zum Beispiel schwingen.
<code>
property Move: [[TParticleMove]];
</code>
* Maximale Stärke der Abweichungsbewegung. Die Stärke ist in Prozent der maximalen Partikelgröße angegeben. Stärke = 100 heißt also, dass ein Partikel nach oben unten so weit ausschlägt, wie es selbst groß ist.
<code>
function InitialMoveStrength: [[IParticleRangeValue|IParticleVectorRangeValue]];
</code>
* Stärkenänderung über die Zeit: Prozent der Initialstärke:
<code>
function MoveStrength: [[IParticleRangeValue|IParticleVectorRangeValue]];
</code>
* Abweichungsfrequenz: Gibt an, wie viele Schwingungen oder Kreisbewegungen in einer Sekunde vollführt werden
<code>
function InitialMoveFrequency: [[IParticleRangeValue]];
</code>
* Frequenzänderung über die Zeit: Prozent der Initialfrequenz:
<code>
function MoveFrequency: [[IParticleRangeValue]];
</code>

* Lebensdauer des Partikels in Millisekunden. 0 heißt, dass das Partikel nie "stirbt".
<code>
function MaxAge: [[IParticleRangeValue]];
</code>

* Emittierrate. Gibt an, wie viele Partikel in einer Sekunde emittiert werden.
<code>
function ParticlesPerSecond: [[IParticleRangeValue]];
</code>

* Partikelanimation. Sind im Partikelsystem mehrere Bilddateien angegeben, können die Partikel ihr Bild während ihrer Lebenszeit ändern.
<code>
property SpriteAnimation: [[TParticleSpriteAnimation]]
</code>
* Animationsgeschwindigkeit: Gibt die Anzahl der Bildwechsel pro Sekunde an
<code>
function InitialSpriteAnimationFrequency: [[IParticleRangeValue]];
</code>
* Geschwindigkeitsänderung über die Zeit: Prozent der Initialgeschwindigkeit.
<code>
function SpriteAnimationFrequency: [[IParticleRangeValue]];
</code>

* Dateinamen der Partikelbilder
<code>
property Filename: [[IFilename]];
</code>

* Partikelsystem auf seine Bounds zuschneiden oder alle Partikel, die hinausragen anzeigen:
<code>
property Clipping: Boolean;
</code>

* Partikelsystem vorsimulieren. Es ist möglich, dass simuliert wird, dass das Partikelsystem bereits eine gewisse Zeit (in Millisekunden) gelaufen war, bevor es wirklich angezeigt wird. Mindestwert = 100ms
<code>
property PreWarmTime: Integer;
</code>

== Emitter ==

* Emitter-Typ:
<code>
property Emitter: [[TParticleEmitter]]
</code>

* Rand am Emitter: Wenn der Emitter vom Typ ''pePoint'' oder ''pePath'' ist, kann er einen Abstand erhalten: Beim Punkt-Emitter werden die Partikel in einem Kreis mit angebenen Abstand emittiert, beim Pfad-Emitter werden die Partikel sowohl oberhalb als auch unterhalb davon abgebildet. Angabe in Prozent des Bildschirms.
<code>
function EmitterSpread: [[IParticleRangeValue]]
</code>

* Flächen, an denen nicht emittiert werden soll: Der Emitter hält eine Liste von gedrehten Rechtecken, an denen nicht emittiert werden darf.
<code>
procedure AddEmitterClipRect(const X, Y, Width, Height, AngleZ: Single; const Exclude: Boolean);
</code>

== Optionen ==

* Partikel-Umgebung: Gibt an, ob die Bounds vom Partikelsystem nur als Positionierung der Partikel beim Emittieren dienen ('''peGlobal'''), oder ob das Partikelsystem Einfluss auf die Partikel hat, die Partikel also mitskalieren und sich mitdrehen, etc. ('''peLocal''')
<code>
property Environment: [[TParticleEnvironment]]
</code>

* Partikeloptionen geben beispielsweise an, wie sich die Partikel bei Drehung des Partikelsystems verhalten oder ob die Animationen abrupt oder durch Alphablending ablaufen. Einige Optionen sind nur für [[TParticleEnvironment|Environment]] = peGlobal sinnvoll:
<code>
property Options: [[TParticleOptions]]
</code>

* Zufallswert (''Seed''), um wiederholbare Zufälle zu generieren. Ist der Wert = 0 werden alle Zufälle in den [[IParticleRangeValue|RangeValues]] wirklich zufällig berechnet, also immer ein eigener Seed generiert. Ansonsten wird der gegebene Seed verwendet.
<code>
property Seed: Int64;
</code>

= Beispiel 1 =

Wird dieses Script einem Partikelobjekt zugeordnet, wird das Partikelsystem wie folgt konfiguriert:

Einem Partikelsystem werden folgende [[IParticleRangeValue|RangeValues]] gegeben:
* InitialSize zwischen 10 und 20.
* Size zwischen 50 und 100 ab 0ms und 0 und 50 ab 1000ms

Partikel 1 bekommt zufällig eine Größe zwischen 10 und 20, zB. 15. Der Size-Wert modifiziert diesen Initialwert, in dem Fall prozentual. Das heißt das Partikel ist zwischen 50% * 15 und 100% * 15 groß ab Sekunde 0 seiner Lebenszeit. Der genaue Wert wird durch die zufällig gewählte Wichtung ermittelt, sagen wir 50%. Die Wichtung legt also die Mitte des Bereichs fest. Demnach ist die Wichtung 75%, also die Mitte zwischen 50 und 100. Daher hat der Partikel zum Zeitpunkt 0ms (also dem Zeitpunkt seines Emittierens) die Größe 75% * 15 = 11,25.
Der Size-Wert ändert sich über die Zeit. Allerdings bleibt die Wichtung pro Partikel gleich. Der Size-Wert sagt, dass die Partikel bei Sekunde 1 nur noch zwischen 0 und 50% des Initialwertes groß sind. Durch die Wichtung von 50% ergibt sich ein Size-Wert von 25%, also der Mitte zwischen 0 und 50%. Daher hat das Partikel zum Zeitpunkt 1000ms die Größe 25% * 15 = 3,75.

Für Partikel 2 wird eine neue Initialgröße vergeben (deren Bereich sich über die Zeit natürlich auch verändern kann). Ebenso wird eine neue Wichtung ermittelt, zB. Initialgröße von 12 und einer Wichtung von 100%. Demnach ist das Partikel 2 zum Zeitpunkt 0ms 12 Einheiten groß und nach einer Sekunde nur noch 6.

<code>
procedure OnExpandSlideShow(SlideShowObject: ISlideShowObject);
begin
var Particle := SlideShowObject as IParticle;
Particle.InitialSize.SetValue(0, 0, 10);
Particle.InitialSize.SetValue(1, 0, 20);
Particle.Size.SetValue(0, 0, 50);
Particle.Size.SetValue(1, 0, 100);
Particle.Size.SetValue(0, 1000, 0);
Particle.Size.SetValue(1, 1000, 50);
end;
</code>

= Beispiel 2 =

Wird dieses Script einem Partikelobjekt zugeordnet, lässt es die Partikel um die X-Achse im 3D-Raum rotieren.

<code>
procedure OnExpandSlideShow(SlideShowObject: ISlideShowObject);
begin
var ParticleObject: IParticle = SlideShowObject as IParticle;

ParticleObject.InitialRotationFrequency.SetValueX(0, 0, 0.8); // Angabe in Hz
end;
</code>

[[Kategorie:Scripting-API]]
[[Kategorie:Partikelsystem]]
[[Kategorie:Language]]

Scriptlets

2015-08-12T09:43:37Z

Steffen.binas: /* Beispiel: Spuren untereinander anordnen */

= Einführung =
Scriptlets sind kleine Erweiterungen des DiaShow-Programms. Sie können selbst kleine Erweiterungen schreiben, die dann als Menüpunkt sichtbar werden.

= Möglichkeiten =

Solche Erweiterungen können z.B. folgende Dinge mit Ihrer Show anstellen:
* EXIF-Daten auslesen
* Dauer und Position verändert
* Bewegungspfad und Kameraschwenk modifizieren
* Gestaltungsvorlagen laden und anwenden
* u.v.m.
* Fehlt Ihnen etwas? [http://support.aquasoft.de Fragen Sie uns], denn entweder geht es bereits oder es lohnt sich vielleicht die API entsprechend zu erweitert.

= Einbinden von Scriptlets =

Damit Scriptlets als Menüeintrag sichtbar werden, können Sie in einem der folgenden Ordner liegen:

* <code>c:\Users\<Benutzername>\AppData\Roaming\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets nur für den aktuellen Nutzer
* <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets die hier liegen, sind für alle Nutzer des gleichen Computers sichtbar
* <code><DiaShowInstallationsverzeichnis>\Presets\Scriptlets</code> - Achtung: Es wird nicht empfohlen hier eigenen Scriptlets zu speichern, denn 1. haben Sie in diesem Ordner normalerweise keine Schreibrechte und 2. verschwinden die Dateien nach jedem Programm-Update

Legen Sie einfach eine Datei mit der Endung .sss (also z.B. MeinScript.sss) in einem der o.g. Ordner an und starten Sie das Programm neu. Nur dann erscheint der Menüeintrag. Falls der Ordner nicht vorhanden ist, legen Sie ihn einfach an.

= Bearbeiten und Debuggen =

Zum Bearbeiten nutzen Sie die integrierte Entwicklungsumgebung die Sie über ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung'' öffnen können, sofern der [[Entwicklermodus]] aktiviert ist. Sie können Scripts hier schreiben, Syntaxfehler ansehen aber auch die Ausführung debuggen, mit Haltepunkten, Schrittweiser ausführung und Werteüberwachung.

= Beispiel: Spuren untereinander anordnen =

Dieses Scriptlet ordnet alle Objekte innerhalb des markierten Kapitels untereinander an.
Speichern Sie diesen Quelltext zum Ausprobieren hier ab: <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\SpurenUntereinander.sss</code>

<code>
//////////////////////////////////////////////////
// GUI
//////////////////////////////////////////////////

// Name und Beschreibung des Menüeintrags
function OnGetGUI: string;
begin
Result := '['
+'{"Caption":"Untereinander anordnen","Type":"title"}'
+',{"Caption":"Platziert alle Objekte eines Containers untereinander.","Type":"description"}'
+']';
end;

//////////////////////////////////////////////////
// Ausführung
//////////////////////////////////////////////////

procedure SetTracks(const SlideShowObject: ISlideShowObject);
begin
if SlideShowObject.Count = 0 then
Exit;

for var i := 0 to SlideShowObject.Count - 1 do
begin
var Item := SlideShowObject[i];
Item.Track := i; // Spurnummer setzen
Item.Offset := 0; // Abstand zum Spuranfang entfernen)
end;
end;

procedure OnExecute(Parameters: [[IParameters]]);
begin
var Item := DocumentController.GetFirstSelected;
while Item <> nil do
begin
SetTracks(Item as ISlideShowObject); // Spuren für alle Kindelemente neu setzen
Item := DocumentController.GetNextSelected(Item); // weiter zum nächsten markierten Eintrag
end;
end;
</code>

= Beispiel: Zugriff auf Parameter =

In diesem Scriptlet definiert die GUI zwei Werte, die vom Anwender eingebbar sind. Hier wird die GUI über die Hilfsfunktion [[GUIControl]] zusammengebaut, was etwas übersichtlicher ist, als direkt einen JSON-Script zu konstruieren.

<code>
//////////////////////////////////////////////////
// GUI
//////////////////////////////////////////////////

// Name und Beschreibung des Menüeintrags
function OnGetGUI: string;
begin
Result := '['
+ GUIControl('', 'Scriptlet-Titel', cGUITitle)
+ ',' + GUIControl('', 'Scriptlet-Beschreibung', cGUIDescription) // verwenden Sie 'Description' anstelle von cGUIDescription, falls die Konstante noch nicht definiert ist.
+ ',' + GUIControl('key1', 'Ein String-Wert', cGUIEdit)
+ ',' + GUIControl('key2', 'Ein anderer Wert', cGUISlider, '"Min":0, "Max":100, "Increment":5, "Center":25, "Unit": "%", "Decimals": 1')
+ ']';
end;

//////////////////////////////////////////////////
// Ausführung
//////////////////////////////////////////////////

procedure OnExecute(Parameters: [[IParameters]]);
begin
var wert1 := Parameters.GetValueAsString('key1');
var wert2 := Parameters.GetValueAsFloat('key2');

// ...
end;
</code>

[[Kategorie:Scripting-API]]

Scriptlets

2015-03-23T16:50:40Z

Steffen.binas: Beispiel für Parameterzugriff hinzugefügt

= Einführung =
Scriptlets sind kleine Erweiterungen des DiaShow-Programms. Sie können selbst kleine Erweiterungen schreiben, die dann als Menüpunkt sichtbar werden.

= Möglichkeiten =

Solche Erweiterungen können z.B. folgende Dinge mit Ihrer Show anstellen:
* EXIF-Daten auslesen
* Dauer und Position verändert
* Bewegungspfad und Kameraschwenk modifizieren
* Gestaltungsvorlagen laden und anwenden
* u.v.m.
* Fehlt Ihnen etwas? [http://support.aquasoft.de Fragen Sie uns], denn entweder geht es bereits oder es lohnt sich vielleicht die API entsprechend zu erweitert.

= Einbinden von Scriptlets =

Damit Scriptlets als Menüeintrag sichtbar werden, können Sie in einem der folgenden Ordner liegen:

* <code>c:\Users\<Benutzername>\AppData\Roaming\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets nur für den aktuellen Nutzer
* <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets die hier liegen, sind für alle Nutzer des gleichen Computers sichtbar
* <code><DiaShowInstallationsverzeichnis>\Presets\Scriptlets</code> - Achtung: Es wird nicht empfohlen hier eigenen Scriptlets zu speichern, denn 1. haben Sie in diesem Ordner normalerweise keine Schreibrechte und 2. verschwinden die Dateien nach jedem Programm-Update

Legen Sie einfach eine Datei mit der Endung .sss (also z.B. MeinScript.sss) in einem der o.g. Ordner an und starten Sie das Programm neu. Nur dann erscheint der Menüeintrag. Falls der Ordner nicht vorhanden ist, legen Sie ihn einfach an.

= Bearbeiten und Debuggen =

Zum Bearbeiten nutzen Sie die integrierte Entwicklungsumgebung die Sie über ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung'' öffnen können, sofern der [[Entwicklermodus]] aktiviert ist. Sie können Scripts hier schreiben, Syntaxfehler ansehen aber auch die Ausführung debuggen, mit Haltepunkten, Schrittweiser ausführung und Werteüberwachung.

= Beispiel: Spuren untereinander anordnen =

Dieses Scriptlet ordnet alle Objekte innerhalb des markierten Kapitels untereinander an.
Speichern Sie diesen Quelltext zum Ausprobieren hier ab: <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\SpurenUntereinander.sss</code>

<code>
//////////////////////////////////////////////////
// GUI
//////////////////////////////////////////////////

// Name und Beschreibung des Menüeintrags
function OnGetGUI: string;
begin
Result := '['
+'{"Caption":"Untereinander anordnen","Type":"Title"}'
+',{"Caption":"Platziert alle Objekte eines Containers untereinander.","Type":"Description"}'
+']';
end;

//////////////////////////////////////////////////
// Ausführung
//////////////////////////////////////////////////

procedure SetTracks(const SlideShowObject: ISlideShowObject);
begin
if SlideShowObject.Count = 0 then
Exit;

for var i := 0 to SlideShowObject.Count - 1 do
begin
var Item := SlideShowObject[i];
Item.Track := i; // Spurnummer setzen
Item.Offset := 0; // Abstand zum Spuranfang entfernen)
end;
end;

procedure OnExecute(Parameters: [[IParameters]]);
begin
var Item := DocumentController.GetFirstSelected;
while Item <> nil do
begin
SetTracks(Item as ISlideShowObject); // Spuren für alle Kindelemente neu setzen
Item := DocumentController.GetNextSelected(Item); // weiter zum nächsten markierten Eintrag
end;
end;
</code>

= Beispiel: Zugriff auf Parameter =

In diesem Scriptlet definiert die GUI zwei Werte, die vom Anwender eingebbar sind. Hier wird die GUI über die Hilfsfunktion [[GUIControl]] zusammengebaut, was etwas übersichtlicher ist, als direkt einen JSON-Script zu konstruieren.

<code>
//////////////////////////////////////////////////
// GUI
//////////////////////////////////////////////////

// Name und Beschreibung des Menüeintrags
function OnGetGUI: string;
begin
Result := '['
+ GUIControl('', 'Scriptlet-Titel', cGUITitle)
+ ',' + GUIControl('', 'Scriptlet-Beschreibung', cGUIDescription) // verwenden Sie 'Description' anstelle von cGUIDescription, falls die Konstante noch nicht definiert ist.
+ ',' + GUIControl('key1', 'Ein String-Wert', cGUIEdit)
+ ',' + GUIControl('key2', 'Ein anderer Wert', cGUISlider, '"Min":0, "Max":100, "Increment":5, "Center":25, "Unit": "%", "Decimals": 1')
+ ']';
end;

//////////////////////////////////////////////////
// Ausführung
//////////////////////////////////////////////////

procedure OnExecute(Parameters: [[IParameters]]);
begin
var wert1 := Parameters.GetValueAsString('key1');
var wert2 := Parameters.GetValueAsFloat('key2');

// ...
end;
</code>

[[Kategorie:Scripting-API]]

IParameters

2015-03-23T16:29:23Z

Steffen.binas: Die Seite wurde neu angelegt: „<code> IParameters procedure SetValueAsString(const Key: String; const Value: String); function GetValueAsString(const Key: String): String; …“

<code>
IParameters
procedure SetValueAsString(const Key: String; const Value: String);
function GetValueAsString(const Key: String): String;

procedure SetValueAsFloat(const Key: String; const Value: Single);
function GetValueAsFloat(const Key: String): Single;

procedure SetValueAsInteger(const Key: String; const Value: Int64);
function GetValueAsInteger(const Key: String): Int64;

procedure SetValueAsBoolean(const Key: String; const Value: Boolean);
function GetValueAsBoolean(const Key: String): Boolean;
end;
</code>

[[Kategorie:Scripting-API]]
[[Kategorie:Language]]

Scriptlets

2015-03-23T16:27:33Z

Steffen.binas: /* Beispiel */

= Einführung =
Scriptlets sind kleine Erweiterungen des DiaShow-Programms. Sie können selbst kleine Erweiterungen schreiben, die dann als Menüpunkt sichtbar werden.

= Möglichkeiten =

Solche Erweiterungen können z.B. folgende Dinge mit Ihrer Show anstellen:
* EXIF-Daten auslesen
* Dauer und Position verändert
* Bewegungspfad und Kameraschwenk modifizieren
* Gestaltungsvorlagen laden und anwenden
* u.v.m.
* Fehlt Ihnen etwas? [http://support.aquasoft.de Fragen Sie uns], denn entweder geht es bereits oder es lohnt sich vielleicht die API entsprechend zu erweitert.

= Einbinden von Scriptlets =

Damit Scriptlets als Menüeintrag sichtbar werden, können Sie in einem der folgenden Ordner liegen:

* <code>c:\Users\<Benutzername>\AppData\Roaming\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets nur für den aktuellen Nutzer
* <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets die hier liegen, sind für alle Nutzer des gleichen Computers sichtbar
* <code><DiaShowInstallationsverzeichnis>\Presets\Scriptlets</code> - Achtung: Es wird nicht empfohlen hier eigenen Scriptlets zu speichern, denn 1. haben Sie in diesem Ordner normalerweise keine Schreibrechte und 2. verschwinden die Dateien nach jedem Programm-Update

Legen Sie einfach eine Datei mit der Endung .sss (also z.B. MeinScript.sss) in einem der o.g. Ordner an und starten Sie das Programm neu. Nur dann erscheint der Menüeintrag. Falls der Ordner nicht vorhanden ist, legen Sie ihn einfach an.

= Bearbeiten und Debuggen =

Zum Bearbeiten nutzen Sie die integrierte Entwicklungsumgebung die Sie über ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung'' öffnen können, sofern der [[Entwicklermodus]] aktiviert ist. Sie können Scripts hier schreiben, Syntaxfehler ansehen aber auch die Ausführung debuggen, mit Haltepunkten, Schrittweiser ausführung und Werteüberwachung.

= Beispiel =

Dieses Scriptlet ordnet alle Objekte innerhalb des markierten Kapitels untereinander an.
Speichern Sie diesen Quelltext zum Ausprobieren hier ab: <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\SpurenUntereinander.sss</code>

<code>
//////////////////////////////////////////////////
// GUI
//////////////////////////////////////////////////

// Name und Beschreibung des Menüeintrags
function OnGetGUI: string;
begin
Result := '['
+'{"Caption":"Untereinander anordnen","Type":"Title"}'
+',{"Caption":"Platziert alle Objekte eines Containers untereinander.","Type":"Description"}'
+']';
end;

//////////////////////////////////////////////////
// Ausführung
//////////////////////////////////////////////////

procedure SetTracks(const SlideShowObject: ISlideShowObject);
begin
if SlideShowObject.Count = 0 then
Exit;

for var i := 0 to SlideShowObject.Count - 1 do
begin
var Item := SlideShowObject[i];
Item.Track := i; // Spurnummer setzen
Item.Offset := 0; // Abstand zum Spuranfang entfernen)
end;
end;

procedure OnExecute(Parameters: [[IParameters]]);
begin
var Item := DocumentController.GetFirstSelected;
while Item <> nil do
begin
SetTracks(Item as ISlideShowObject); // Spuren für alle Kindelemente neu setzen
Item := DocumentController.GetNextSelected(Item); // weiter zum nächsten markierten Eintrag
end;
end;
</code>

[[Kategorie:Scripting-API]]

DiaShow-Objekte

2015-02-27T16:54:49Z

Steffen.binas:

Neben den [http://code.google.com/p/dwscript/wiki/Language Befehlen], die Ihnen die Programmiersprache direkt zur Verfügung stellt, gibt haben Sie Zugriff auf die Objekte der Diashow (sonst wäre das ganze ja auch ziemlich sinnlos). Objekte der DiaShow sind die Bilder, Texte, Videos etc. eben alles aus dem sich eine Diashow zusammensetzen kann.

= Verfügbare DiaShow-Objekte =

* [[IPicture]] - Bilder
* [[IText]] - Text
* [[ISound]] - Sounds
* [[IVideo]] - Videos/Filme
* [[IParticle]] - Partikel
* [[IChapter]] - Kapitel
* [[ICollage]] - Statische Collage
* [[ITransformation]] - Flexi-Collage
* [[IPath]] - Animierter Pfad / Routenanimation
* [[IShader]] - Pixelshadereffekte, die auf der GPU laufen
* [[IBlackboxContainer]] - Kapitelobjekte, die als Kindelemente Container für Effektinhalte dienen

Es gibt für jedes Objekt eine Create-Methode, z.B. so:

<code>
var pic: IPicture;
pic := CreatePicture;
var text: IText;
text := CreateText;
</code>

= Allgemeinere Objekte =
* [[ISlideShowObject]] - DiaShow-Objekt - Basis für alle Objekte.
* [[ICanvas]] - Leinwandobjekt/Zeichenfläche zum Zeichnen bzw. Pixelzugriff auf Bilder
* [[IMoveable]], [[IPanable]] - Zugriff auf Bewegungspfad und Kameraschwenk

= Entwickler-Objekte =

Folgende Objekte stehen in der Toolbox nur zur Verfügung, wenn der Entwicklermodus aktiviert wurde:

* Transparentes Kapitel
* "Laufende Linie"
* Blackbox
* Blackbox, horizontal
* Blackbox, vertikal
* Geometrische Form
* Shader

Diese Objekte haben keine richtige Benutzeroberfläche und sind auf die Steuerung per Script angewiesen bzw. haben selbst steuernde Wirkung. Manche Objekte funktionieren nur in einem ganz bestimmten Kontext. Die Entwickler-Objekte werden nun genauer beschrieben:

== Blackbox ==

Eine Blackbox verhält sich wie eine Flexi-Collage, aber ohne Überblendung und ohne Hintergrundfarbe. Was bleibt ist die Möglichkeit, einen Bewegungspfad und einen Kameraschwenk zuzuweisen. Alle in einer Blackbox befindlichen Objekten erben diesen Pfad und Schwenk, so wie es auch bei Flexi-Collagen der Fall ist.

Eine Blackbox wird normalerweise Container für beliebige weitere Objekte verwendet. Ein an die Blackbox angehängtes Script, manipuliert dann den Inhalt in beliebiger Weise. Meist enthält das Script auch eine [[GUI-API|Benutzeroberfläche]], um den Nutzer verschiedene Parameter zur Verfügung zu stellen.

Im Script ist das Blackbox-Objekt einfach nur ein [[ISlideShowObject]], dass aber die Interfaces [[IMoveable]] und [[IPanable]] implementiert.

== Blackbox, horizontal ==

Wie "Blackbox" nur erlaupt die Timeline es nicht, in diesem Objekt mehrere Spuren anzulegen. Ebenso sind Abstände zwischen den Objekten nicht erlaubt. Dieses Objekt wird z.B. als Container für Bilder innerhalb von "Intelligen Vorlagen" eingesetzt. Hier soll der Nutzer keine komplexen Strukturen ablegen dürfen, da diese in die Vorlagen nicht übernommen werden könnten.

== Blackbox, vertikal ==

Wie "Blackbox" nur werden alle eingefügten Objekte auf die Dauer des vertikalen Blackbox gestreckt und jedes erscheint auf einer eigenen Spur.

== Transparentes Kapitel ([[IBlackboxContainer]]) ==

Ein "Transparentes Kapitel" ist kein Objekt mit Funktion innerhalb der Präsentation, sondern dient als Hilfselement für die Benutzeroberfläche, nämlich zur Beschriftung der Spuren. Es ist dafür ausgelegt innerhalb eines Blackbox-Objekts verwendet zu werden. Außerhalb davon ist die Funktionsweise undefiniert. Ein "Transparentes Kapitel" hat immer mindestens die Dauer seines Elternelements, kann aber selbst größer werden. Ansonsten verhält es sich wie ein normales Kapitel, d.h. es unterstützt beliebig viele Spuren und Abstände zwischen den Objekten. Aus Scriptingsicht ist das Objekt ein [[IBlackboxContainer]].

Als Anwendungsbeispiel dient z.B. die "Dynamische Maske":

[[Datei:TransparentesKapitel.png]]

Dieser Effekt besteht aus einer Blackbox, der ein Script angehängt wurde, und zwei transparenten Kapiteln. Die beiden "Transparenten Kapitel" bieten einfach nur Platz für die zwei unterschiedlichen Funkionen (Maske und Inhalt). Das Script schaut in die beiden "Transparenten Kapitel" und macht damit "etwas".

== Geometrische Form ==

Objekt hat keine Funktion. Es war ursprünglich dafür Gedacht, Dreicke oder andere Formen darzustellen. Dafür kann aber das [[IShader|Shader-Objekt]] verwendet werden.

== Shader ([[IShader]]) ==

Über das Shader-Objekt lassen sich Pixelshader ausführen. Ein Shader-Objekt wird immer per Script angelegt und konfiguriert (ist also niemals in der Timeline zu sehen). Es benötigt zum Wirken mindestens den Dateinamen eines [[HLSL-Shader|Pixelshaders (HLSL)]].

[[Kategorie:Scripting-API]]

Shaderobjekt

2015-02-27T16:52:18Z

Steffen.binas: /* Beispiel */

Das Bildobjekt ist vom Typ '''IShader''' und leitet von '''[[ISlideShowObject]]''' ab.

<code>
IShader '''inherits from''' [[ISlideShowObject]]
function Filename: [[IFilename]];
procedure SetTechnique(TechniqueName: string);
procedure SetParamInt(ParamName: string; Value: Integer);
procedure SetParamFloat(ParamName: string; Value: Float);
procedure SetParamFloat2(ParamName: string; V1, V2: Single);
procedure SetParamFloat3(ParamName: string; V1, V2, V3: Single);
procedure SetParamFloat4(ParamName: string; V1, V2, V3, V4: Single);
procedure SetParamRangeValue(ParamName: string; Value: IRangeValue);
procedure SetParamRangeValue2(ParamName: string; V1, V2: IRangeValue);
procedure SetParamRangeValue3(ParamName: string; V1, V2, V3: IRangeValue);
procedure SetParamRangeValue4(ParamName: string; V1, V2, V3, V4: IRangeValue);
function GetPostProcessing: Boolean;
procedure SetPostProcessing(const Value: Boolean);
function GetMeshColumns: Integer;
procedure SetMeshColumns(const P: Integer);
function GetMeshRows: Integer;
procedure SetMeshRows(const P: Integer);
procedure SetMesh(const Mesh: TVertexArray; const Indices: TIndexArray);
procedure AddTexture(const Texture: ICanvas);
procedure SetTexture(const TextureIndex: Integer; const Texture: ICanvas);
function GetTexture(const TextureIndex: Integer): ICanvas;
procedure DeleteTexture(const TextureIndex: Integer);
procedure ClearTextures;
function TextureCount: Integer;
</code>

= Methoden =

* Objekt Erzeugung
<code>
function CreateShaderObject: IShader;
</code>

* Der Dateiname des Shaders. Hierbei ist eine konkreter Quelltextdatei eines [[HLSL-Shader|HLSL-Shaders]] für DirectX 9 gemeint (meist *.fx).
<code>
function Filename: [[IFilename]];
</code>

* Falls im Shaderquelltext mehr als eine Shader-Technik enthalten ist, kann sie über SetTechnique gesetzt werden
<code>
procedure SetTechnique(TechniqueName: string);
</code>

* Ein Shader benötigt verschiedene Parameter. Welche das sind und hängt vom tatsächlich verwendeten Shader ab. Über die SetParamXXX-Funktionen können entsprechende Werte an den Shader übergeben werden.
<code>
procedure SetParamInt(ParamName: string; Value: Integer);
procedure SetParamFloat(ParamName: string; Value: Float);
</code>

= Beispiel =

== Pixelshader-Effekte ==

Verpixeln: Presets\Scripts\Pixelate.sss

== Eigene Geometrie übergeben ==

Vollständiger Code, siehe Toolbox-Objekt "Dreieck": Presets\Scripts\GeometryTriangle.sss
<code>
var Mesh: TVertexArray;

// Dreieck:
//
// (-0.5, 0.5)----(0, 0.5)----(0.5, 0.5)
// | /\ |
// | / \ |
// | / \ |
// | / \ |
// | / (0, 0) \ |
// | / \ |
// | / \ |
// (-0.5, -0.5)--------------(0.5, -0.5)

// Mesh := [Vertex(0, 0.5), Vertex(0.5, 0.5), Vertex(-0.5, 0.5)];
Mesh.SetLength(3);
Mesh[0] := Vertex(0, 0.5);
Mesh[1] := Vertex(0.5, -0.5);
Mesh[2] := Vertex(-0.5, -0.5);
Shader.SetMesh(Mesh, []);
</code>

[[Kategorie:Scripting-API]]

Shaderobjekt

2015-02-27T16:46:38Z

Steffen.binas:

Das Bildobjekt ist vom Typ '''IShader''' und leitet von '''[[ISlideShowObject]]''' ab.

<code>
IShader '''inherits from''' [[ISlideShowObject]]
function Filename: [[IFilename]];
procedure SetTechnique(TechniqueName: string);
procedure SetParamInt(ParamName: string; Value: Integer);
procedure SetParamFloat(ParamName: string; Value: Float);
procedure SetParamFloat2(ParamName: string; V1, V2: Single);
procedure SetParamFloat3(ParamName: string; V1, V2, V3: Single);
procedure SetParamFloat4(ParamName: string; V1, V2, V3, V4: Single);
procedure SetParamRangeValue(ParamName: string; Value: IRangeValue);
procedure SetParamRangeValue2(ParamName: string; V1, V2: IRangeValue);
procedure SetParamRangeValue3(ParamName: string; V1, V2, V3: IRangeValue);
procedure SetParamRangeValue4(ParamName: string; V1, V2, V3, V4: IRangeValue);
function GetPostProcessing: Boolean;
procedure SetPostProcessing(const Value: Boolean);
function GetMeshColumns: Integer;
procedure SetMeshColumns(const P: Integer);
function GetMeshRows: Integer;
procedure SetMeshRows(const P: Integer);
procedure SetMesh(const Mesh: TVertexArray; const Indices: TIndexArray);
procedure AddTexture(const Texture: ICanvas);
procedure SetTexture(const TextureIndex: Integer; const Texture: ICanvas);
function GetTexture(const TextureIndex: Integer): ICanvas;
procedure DeleteTexture(const TextureIndex: Integer);
procedure ClearTextures;
function TextureCount: Integer;
</code>

= Methoden =

* Objekt Erzeugung
<code>
function CreateShaderObject: IShader;
</code>

* Der Dateiname des Shaders. Hierbei ist eine konkreter Quelltextdatei eines [[HLSL-Shader|HLSL-Shaders]] für DirectX 9 gemeint (meist *.fx).
<code>
function Filename: [[IFilename]];
</code>

* Falls im Shaderquelltext mehr als eine Shader-Technik enthalten ist, kann sie über SetTechnique gesetzt werden
<code>
procedure SetTechnique(TechniqueName: string);
</code>

* Ein Shader benötigt verschiedene Parameter. Welche das sind und hängt vom tatsächlich verwendeten Shader ab. Über die SetParamXXX-Funktionen können entsprechende Werte an den Shader übergeben werden.
<code>
procedure SetParamInt(ParamName: string; Value: Integer);
procedure SetParamFloat(ParamName: string; Value: Float);
</code>

= Beispiel =

Beispiel, um dem Shader eigene Geometrie zu übergeben, siehe Toolbox-Objekt "Dreieck": Presets\Scripts\GeometryTriangle.sss
<code>
var Mesh: TVertexArray;

// Dreieck:
//
// (-0.5, 0.5)----(0, 0.5)----(0.5, 0.5)
// | /\ |
// | / \ |
// | / \ |
// | / \ |
// | / (0, 0) \ |
// | / \ |
// | / \ |
// (-0.5, -0.5)--------------(0.5, -0.5)

// Mesh := [Vertex(0, 0.5), Vertex(0.5, 0.5), Vertex(-0.5, 0.5)];
Mesh.SetLength(3);
Mesh[0] := Vertex(0, 0.5);
Mesh[1] := Vertex(0.5, -0.5);
Mesh[2] := Vertex(-0.5, -0.5);
Shader.SetMesh(Mesh, []);
</code>

[[Kategorie:Scripting-API]]

Datei:TransparentesKapitel.png

2015-02-27T16:18:23Z

Steffen.binas: Steffen.binas lud eine neue Version von „Datei:TransparentesKapitel.png“ hoch

Datei:TransparentesKapitel.png

2015-02-27T16:11:46Z

Steffen.binas:

DiaShow-Objekte

2015-02-27T16:11:12Z

Steffen.binas:

Scriptlets

2014-12-16T19:43:25Z

Steffen.binas: /* Beispiel */

= Einführung =
Scriptlets sind kleine Erweiterungen des DiaShow-Programms. Sie können selbst kleine Erweiterungen schreiben, die dann als Menüpunkt sichtbar werden.

= Möglichkeiten =

Solche Erweiterungen können z.B. folgende Dinge mit Ihrer Show anstellen:
* EXIF-Daten auslesen
* Dauer und Position verändert
* Bewegungspfad und Kameraschwenk modifizieren
* Gestaltungsvorlagen laden und anwenden
* u.v.m.
* Fehlt Ihnen etwas? [http://support.aquasoft.de Fragen Sie uns], denn entweder geht es bereits oder es lohnt sich vielleicht die API entsprechend zu erweitert.

= Einbinden von Scriptlets =

Damit Scriptlets als Menüeintrag sichtbar werden, können Sie in einem der folgenden Ordner liegen:

* <code>c:\Users\<Benutzername>\AppData\Roaming\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets nur für den aktuellen Nutzer
* <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets die hier liegen, sind für alle Nutzer des gleichen Computers sichtbar
* <code><DiaShowInstallationsverzeichnis>\Presets\Scriptlets</code> - Achtung: Es wird nicht empfohlen hier eigenen Scriptlets zu speichern, denn 1. haben Sie in diesem Ordner normalerweise keine Schreibrechte und 2. verschwinden die Dateien nach jedem Programm-Update

Legen Sie einfach eine Datei mit der Endung .sss (also z.B. MeinScript.sss) in einem der o.g. Ordner an und starten Sie das Programm neu. Nur dann erscheint der Menüeintrag. Falls der Ordner nicht vorhanden ist, legen Sie ihn einfach an.

= Bearbeiten und Debuggen =

Zum Bearbeiten nutzen Sie die integrierte Entwicklungsumgebung die Sie über ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung'' öffnen können, sofern der [[Entwicklermodus]] aktiviert ist. Sie können Scripts hier schreiben, Syntaxfehler ansehen aber auch die Ausführung debuggen, mit Haltepunkten, Schrittweiser ausführung und Werteüberwachung.

= Beispiel =

Dieses Scriptlet ordnet alle Objekte innerhalb des markierten Kapitels untereinander an.
Speichern Sie diesen Quelltext zum Ausprobieren hier ab: <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\SpurenUntereinander.sss</code>

<code>
//////////////////////////////////////////////////
// GUI
//////////////////////////////////////////////////

// Name und Beschreibung des Menüeintrags
function OnGetGUI: string;
begin
Result := '['
+'{"Caption":"Untereinander anordnen","Type":"Title"}'
+',{"Caption":"Platziert alle Objekte eines Containers untereinander.","Type":"Description"}'
+']';
end;

//////////////////////////////////////////////////
// Ausführung
//////////////////////////////////////////////////

procedure SetTracks(const SlideShowObject: ISlideShowObject);
begin
if SlideShowObject.Count = 0 then
Exit;

for var i := 0 to SlideShowObject.Count - 1 do
begin
var Item := SlideShowObject[i];
Item.Track := i; // Spurnummer setzen
Item.Offset := 0; // Abstand zum Spuranfang entfernen)
end;
end;

procedure OnExecute(Parameters: IParameters);
begin
var Item := DocumentController.GetFirstSelected;
while Item <> nil do
begin
SetTracks(Item as ISlideShowObject); // Spuren für alle Kindelemente neu setzen
Item := DocumentController.GetNextSelected(Item); // weiter zum nächsten markierten Eintrag
end;
end;
</code>

[[Kategorie:Scripting-API]]

Scriptlets

2014-09-12T17:21:54Z

Steffen.binas: /* Einbinden von Scriptlets */

= Einführung =
Scriptlets sind kleine Erweiterungen des DiaShow-Programms. Sie können selbst kleine Erweiterungen schreiben, die dann als Menüpunkt sichtbar werden.

= Möglichkeiten =

Solche Erweiterungen können z.B. folgende Dinge mit Ihrer Show anstellen:
* EXIF-Daten auslesen
* Dauer und Position verändert
* Bewegungspfad und Kameraschwenk modifizieren
* Gestaltungsvorlagen laden und anwenden
* u.v.m.
* Fehlt Ihnen etwas? [http://support.aquasoft.de Fragen Sie uns], denn entweder geht es bereits oder es lohnt sich vielleicht die API entsprechend zu erweitert.

= Einbinden von Scriptlets =

Damit Scriptlets als Menüeintrag sichtbar werden, können Sie in einem der folgenden Ordner liegen:

* <code>c:\Users\<Benutzername>\AppData\Roaming\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets nur für den aktuellen Nutzer
* <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets die hier liegen, sind für alle Nutzer des gleichen Computers sichtbar
* <code><DiaShowInstallationsverzeichnis>\Presets\Scriptlets</code> - Achtung: Es wird nicht empfohlen hier eigenen Scriptlets zu speichern, denn 1. haben Sie in diesem Ordner normalerweise keine Schreibrechte und 2. verschwinden die Dateien nach jedem Programm-Update

Legen Sie einfach eine Datei mit der Endung .sss (also z.B. MeinScript.sss) in einem der o.g. Ordner an und starten Sie das Programm neu. Nur dann erscheint der Menüeintrag. Falls der Ordner nicht vorhanden ist, legen Sie ihn einfach an.

= Bearbeiten und Debuggen =

Zum Bearbeiten nutzen Sie die integrierte Entwicklungsumgebung die Sie über ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung'' öffnen können, sofern der [[Entwicklermodus]] aktiviert ist. Sie können Scripts hier schreiben, Syntaxfehler ansehen aber auch die Ausführung debuggen, mit Haltepunkten, Schrittweiser ausführung und Werteüberwachung.

= Beispiel =

Dieses Scriptlet ordnet alle Objekte innerhalb des markierten Kapitels untereinander an.
Speichern Sie diesen Quelltext zum Ausprobieren hier ab: <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\SpurenUntereinander.sss</code>

<code>
//////////////////////////////////////////////////
// GUI
//////////////////////////////////////////////////

// Name und Beschreibung des Menüeintrags
function OnGetGUI: string;
begin
Result := '['
+'{"Caption":"Untereinander anordnen","Type":"Title"}'
+',{"Caption":"Platziert alle Objekte eines Containers untereinander.","Type":"Description"}'
+']';
end;

//////////////////////////////////////////////////
// Ausführung
//////////////////////////////////////////////////

procedure SetTracks(const SlideShowObject: ISlideShowObject);
begin
if SlideShowObject.Count = 0 then
Exit;

for var i := 0 to SlideShowObject.Count - 1 do
begin
var Item := SlideShowObject[i];
Item.Track := i;
Item.Offset := 0;
end;
end;

procedure OnExecute(Parameters: IParameters);
begin
if DocumentController.GetFirstSelected = nil then
Exit;

var Item := DocumentController.GetFirstSelected;
while Item <> nil do
begin
SetTracks((Item as ISlideShowObject)); // Spuren für alle Kindelemente neu setzen
Item := DocumentController.GetNextSelected(Item); // weiter zum nächsten markierten Eintrag
end;
end;
</code>

[[Kategorie:Scripting-API]]

Scriptlets

2014-09-12T12:47:06Z

Steffen.binas: /* Einbinden von Scriptlets */

= Einführung =
Scriptlets sind kleine Erweiterungen des DiaShow-Programms. Sie können selbst kleine Erweiterungen schreiben, die dann als Menüpunkt sichtbar werden.

= Möglichkeiten =

Solche Erweiterungen können z.B. folgende Dinge mit Ihrer Show anstellen:
* EXIF-Daten auslesen
* Dauer und Position verändert
* Bewegungspfad und Kameraschwenk modifizieren
* Gestaltungsvorlagen laden und anwenden
* u.v.m.
* Fehlt Ihnen etwas? [http://support.aquasoft.de Fragen Sie uns], denn entweder geht es bereits oder es lohnt sich vielleicht die API entsprechend zu erweitert.

= Einbinden von Scriptlets =

Damit Scriptlets als Menüeintrag sichtbar werden, können Sie in einem der folgenden Ordner liegen:

* <code>c:\Users\<Benutzername>\AppData\Roaming\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets nur für den aktuellen Nutzer
* <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets die hier liegen, sind für alle Nutzer des gleichen Computers sichtbar
* <code><DiaShowInstallationsverzeichnis>\Presets\Scriptlets</code> - Achtung: Es wird nicht empfohlen hier eigenen Scriptlets zu speichern, denn 1. haben Sie in diesem Ordner normalerweise keine Schreibrechte und 2. verschwinden die Dateien nach jedem Programm-Update

Legen Sie einfach eine Datei mit der Endung .sss (also z.B. MeinScript.sss) in einem der o.g. Ordner an und starten Sie das Programm neu. Nur dann erscheint der Menüeintrag. Falls Ordner nicht vorhanden ist, legen Sie ihn einfach an.

= Bearbeiten und Debuggen =

Zum Bearbeiten nutzen Sie die integrierte Entwicklungsumgebung die Sie über ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung'' öffnen können, sofern der [[Entwicklermodus]] aktiviert ist. Sie können Scripts hier schreiben, Syntaxfehler ansehen aber auch die Ausführung debuggen, mit Haltepunkten, Schrittweiser ausführung und Werteüberwachung.

= Beispiel =

Dieses Scriptlet ordnet alle Objekte innerhalb des markierten Kapitels untereinander an.
Speichern Sie diesen Quelltext zum Ausprobieren hier ab: <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\SpurenUntereinander.sss</code>

<code>
//////////////////////////////////////////////////
// GUI
//////////////////////////////////////////////////

// Name und Beschreibung des Menüeintrags
function OnGetGUI: string;
begin
Result := '['
+'{"Caption":"Untereinander anordnen","Type":"Title"}'
+',{"Caption":"Platziert alle Objekte eines Containers untereinander.","Type":"Description"}'
+']';
end;

//////////////////////////////////////////////////
// Ausführung
//////////////////////////////////////////////////

procedure SetTracks(const SlideShowObject: ISlideShowObject);
begin
if SlideShowObject.Count = 0 then
Exit;

for var i := 0 to SlideShowObject.Count - 1 do
begin
var Item := SlideShowObject[i];
Item.Track := i;
Item.Offset := 0;
end;
end;

procedure OnExecute(Parameters: IParameters);
begin
if DocumentController.GetFirstSelected = nil then
Exit;

var Item := DocumentController.GetFirstSelected;
while Item <> nil do
begin
SetTracks((Item as ISlideShowObject)); // Spuren für alle Kindelemente neu setzen
Item := DocumentController.GetNextSelected(Item); // weiter zum nächsten markierten Eintrag
end;
end;
</code>

[[Kategorie:Scripting-API]]

Scriptlets

2014-09-12T12:44:36Z

Steffen.binas: /* Einbinden von Scriptlets */

= Einführung =
Scriptlets sind kleine Erweiterungen des DiaShow-Programms. Sie können selbst kleine Erweiterungen schreiben, die dann als Menüpunkt sichtbar werden.

= Möglichkeiten =

Solche Erweiterungen können z.B. folgende Dinge mit Ihrer Show anstellen:
* EXIF-Daten auslesen
* Dauer und Position verändert
* Bewegungspfad und Kameraschwenk modifizieren
* Gestaltungsvorlagen laden und anwenden
* u.v.m.
* Fehlt Ihnen etwas? [http://support.aquasoft.de Fragen Sie uns], denn entweder geht es bereits oder es lohnt sich vielleicht die API entsprechend zu erweitert.

= Einbinden von Scriptlets =

Damit Scriptlets als Menüeintrag sichtbar werden, können Sie in einem der folgenden Ordner liegen:

* <code>c:\Users\<Benutzername>\AppData\Roaming\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets nur für den aktuellen Nutzer
* <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets die hier liegen, sind für alle Nutzer des gleichen Computers sichtbar
* <code><DiaShowInstallationsverzeichnis>\Presets\Scriptlets</code> - Achtung: Es wird nicht empfohlen hier eigenen Scriptlets zu speichern, denn 1. haben Sie in diesem Ordner normalerweise keine Schreibrechte und 2. verschwinden die Dateien nach jedem Programm-Update

Legen Sie einfach eine Datei mit der Endung .sss (also z.B. MeinScript.sss) in einem der o.g. Ordner an und starten Sie das Programm neu. Nur dann erscheint der Menüeintrag.

= Bearbeiten und Debuggen =

Zum Bearbeiten nutzen Sie die integrierte Entwicklungsumgebung die Sie über ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung'' öffnen können, sofern der [[Entwicklermodus]] aktiviert ist. Sie können Scripts hier schreiben, Syntaxfehler ansehen aber auch die Ausführung debuggen, mit Haltepunkten, Schrittweiser ausführung und Werteüberwachung.

= Beispiel =

Dieses Scriptlet ordnet alle Objekte innerhalb des markierten Kapitels untereinander an.
Speichern Sie diesen Quelltext zum Ausprobieren hier ab: <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\SpurenUntereinander.sss</code>

<code>
//////////////////////////////////////////////////
// GUI
//////////////////////////////////////////////////

// Name und Beschreibung des Menüeintrags
function OnGetGUI: string;
begin
Result := '['
+'{"Caption":"Untereinander anordnen","Type":"Title"}'
+',{"Caption":"Platziert alle Objekte eines Containers untereinander.","Type":"Description"}'
+']';
end;

//////////////////////////////////////////////////
// Ausführung
//////////////////////////////////////////////////

procedure SetTracks(const SlideShowObject: ISlideShowObject);
begin
if SlideShowObject.Count = 0 then
Exit;

for var i := 0 to SlideShowObject.Count - 1 do
begin
var Item := SlideShowObject[i];
Item.Track := i;
Item.Offset := 0;
end;
end;

procedure OnExecute(Parameters: IParameters);
begin
if DocumentController.GetFirstSelected = nil then
Exit;

var Item := DocumentController.GetFirstSelected;
while Item <> nil do
begin
SetTracks((Item as ISlideShowObject)); // Spuren für alle Kindelemente neu setzen
Item := DocumentController.GetNextSelected(Item); // weiter zum nächsten markierten Eintrag
end;
end;
</code>

[[Kategorie:Scripting-API]]

Entwicklermodus

2014-09-12T07:22:44Z

Steffen.binas: /* Performance */

Im Entwicklermodus bietet die DiaShow zusätzliche Bearbeitungsmöglichkeiten, die insbesondere der Erstellung von Vorlagen dienen.

= Achtung =

Der Entwicklermodus ist nicht für den täglichen Gebrauch bestimmt und kein "offizieller" Teil des Programms. Bei auftretende Problemen und Fragen können wir Ihnen keinen Support anbieten.

= Entwicklermodus aktivieren =

Sie aktivieren den Entwicklermodus über den Menüpunkt: ''Hilfe / Entwicklermodus''

= Features des Entwicklermodus =

* neues "Entwickler"-Tab bei den Objekt-Eigenschaften
* Scripting-Entwicklungsumgebung: ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung'' (siehe auch: [[Dokumentation der Scripting-API]])
* Vorlagen-Editor im DiaShow-Manager aktiviert
* Eine neue Kategorie namens "Developer" steht in der Toolbox zur Verfügung. Diese Objekte sind nur im Zusammenhang mit Scripts sinnvoll nutzbar.

= Performance =

Im Entwicklermodus sind einige wenige Optimierungsmaßnahmen ausgeschaltet, sodass die Arbeit mit dem Programm etwas langsamer ist als bei deaktiviertem Entwicklermodus.

* Deaktivierter Cache beim Ausführen von Scripts
* Deaktivierter Cache für Pixelshader

Nur so ist es möglich, dass Änderungen an Scripts oder Shadern gleich Auswirkungen beim nächsten Abspielen haben. Mit aktivierten Caches müsste sonst das Programm neu gestartet werden.

[[Kategorie:Scripting-API]]

Scriptlets

2014-09-12T07:09:48Z

Steffen.binas:

= Einführung =
Scriptlets sind kleine Erweiterungen des DiaShow-Programms. Sie können selbst kleine Erweiterungen schreiben, die dann als Menüpunkt sichtbar werden.

= Möglichkeiten =

Solche Erweiterungen können z.B. folgende Dinge mit Ihrer Show anstellen:
* EXIF-Daten auslesen
* Dauer und Position verändert
* Bewegungspfad und Kameraschwenk modifizieren
* Gestaltungsvorlagen laden und anwenden
* u.v.m.
* Fehlt Ihnen etwas? [http://support.aquasoft.de Fragen Sie uns], denn entweder geht es bereits oder es lohnt sich vielleicht die API entsprechend zu erweitert.

= Einbinden von Scriptlets =

Damit Scriptlets als Menüeintrag sichtbar werden, können Sie in einem der folgenden Ordner liegen:

* <code>c:\Users\steffen.binas\AppData\Roaming\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets nur für den aktuellen Nutzer
* <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\</code> - Scriptlets die hier liegen, sind für alle Nutzer des gleichen Computers sichtbar
* <code><DiaShowInstallationsverzeichnis>\Presets\Scriptlets</code> - Achtung: Es wird nicht empfohlen hier eigenen Scriptlets zu speichern, denn 1. haben Sie in diesem Ordner normalerweise keine Schreibrechte und 2. verschwinden die Dateien nach jedem Programm-Update

Legen Sie einfach eine Datei mit der Endung .sss (also z.B. MeinScript.sss) in einem der o.g. Ordner an und starten Sie das Programm neu. Nur dann erscheint der Menüeintrag.

= Bearbeiten und Debuggen =

Zum Bearbeiten nutzen Sie die integrierte Entwicklungsumgebung die Sie über ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung'' öffnen können, sofern der [[Entwicklermodus]] aktiviert ist. Sie können Scripts hier schreiben, Syntaxfehler ansehen aber auch die Ausführung debuggen, mit Haltepunkten, Schrittweiser ausführung und Werteüberwachung.

= Beispiel =

Dieses Scriptlet ordnet alle Objekte innerhalb des markierten Kapitels untereinander an.
Speichern Sie diesen Quelltext zum Ausprobieren hier ab: <code>c:\ProgramData\AquaSoft\DiaShow9\Scriptlets\SpurenUntereinander.sss</code>

<code>
//////////////////////////////////////////////////
// GUI
//////////////////////////////////////////////////

// Name und Beschreibung des Menüeintrags
function OnGetGUI: string;
begin
Result := '['
+'{"Caption":"Untereinander anordnen","Type":"Title"}'
+',{"Caption":"Platziert alle Objekte eines Containers untereinander.","Type":"Description"}'
+']';
end;

//////////////////////////////////////////////////
// Ausführung
//////////////////////////////////////////////////

procedure SetTracks(const SlideShowObject: ISlideShowObject);
begin
if SlideShowObject.Count = 0 then
Exit;

for var i := 0 to SlideShowObject.Count - 1 do
begin
var Item := SlideShowObject[i];
Item.Track := i;
Item.Offset := 0;
end;
end;

procedure OnExecute(Parameters: IParameters);
begin
if DocumentController.GetFirstSelected = nil then
Exit;

var Item := DocumentController.GetFirstSelected;
while Item <> nil do
begin
SetTracks((Item as ISlideShowObject)); // Spuren für alle Kindelemente neu setzen
Item := DocumentController.GetNextSelected(Item); // weiter zum nächsten markierten Eintrag
end;
end;
</code>

[[Kategorie:Scripting-API]]

Scriptlets

2014-09-12T07:04:24Z

Steffen.binas:

Scriptlets

2014-09-12T06:54:28Z

Steffen.binas: Die Seite wurde neu angelegt: „= Einführung = Scriptlets sind kleine Erweiterungen des DiaShow-Programms. Sie können selbst kleine Erweiterungen schreiben, die dann als Menüpunkt sichtbar…“

Installation/Deinstallation

2014-08-19T17:47:00Z

Steffen.binas: /* Unvollständige Deinstallation */

Diese Seite wird Hinweise zur Installation und Deinstallation von AquaSoft-Produkten enthalten.

= Problemfälle =

== Unvollständige Deinstallation ==

Führt man das Setup eines AquaSoft-Produktes aus, dessen Vorversion bereits auf dem selben Rechner installiert ist, so wird als erstes deren Deinstallation ausgeführt. 

Gelegentlich machen Anwender dabei die Erfahrung, dass sie zum Ende der Deinstallation eine Benachrichtigung erhalten mit dem Wortlaut:
''"Das Installationspaket für AquaSoft <Produktname> stimmt nicht mehr mit dm Clientpaket überein. Wiederholen Sie die Installation mit einer gültigen Kopie des Installationspaketes 'Setup.msi'."''

Als Ursache für diese Meldung und die im Anschluss daran erfolglosen Versuche, die neue Version zu installieren, hat sich das Löschen von für die Deinstallation der Vorversion benötigten Dateien herausgestellt. Sei es durch manuellen Eingriff durch den Anwender oder die Benutzung diverser Festplattenreinigungstools, diese wichtigen Ordner fallen des Öfteren dem Papierkorb anheim. Sie befinden sich unter Windows XP unter ''\Dokumente und Einstellungen\All Users\Anwendungsdaten\ ''und haben Bezeichnungen wie ''{5B8B7FD2-53B4-4000-88F2-B89FBBAA0C48}''. Wenn solch ein Ordner Dateien enthält, sollte er nicht gelöscht werden. Leider lässt es sich nicht verhindern, dass das doch hin und wieder passiert.

'''Wenn Sie das zuletzt installierte Installationspaket aufbewahrt haben, können Sie damit zuerst eine nochmalige Installation versuchen. Nach erfolgreichem Durchlauf wird im Anschluss auch das neue Setup funktionieren.'''

Für den Fall, dass das nicht funktioniert, enthält jedes AquaSoft-Produkt einen Support-Ordner und dieser eine Datei mit dem Namen '''Uninstall_<Programmname>.bat'''. Führt man diese Datei aus, werden überflüssige installationsspezifische Einträge aus der Registry gelöscht, und einer Neuinstallations ist der Weg geebnet. Es ist jedoch der Fall, dass zu dem Zeitpunkt, da die oben genannte Meldung auftaucht, der Installationsordner, und somit auch der Support-Ordner, bereits von der Festplatte entfernt sind und nur die hinderlichen Registrierungseinträge zurückgeblieben sind. D.h., es gibt keinen Zugriff auf die '''Uninstall_<Programmname>.bat''' mehr. 

 

Als Lösung zu diesem Problem bieten wir zu jedem Programm auch einen kleinen Download an, der die '''Uninstall_<Programmname>.bat''' und eine Datei namens '''RegTool.exe''' enthält. Es ist jeweil eine ZIP-Datei, die entpackt werden muss, bevor die '''Uninstall_<Programmname>.bat''' gestartet werden kann. 
Wichtig ist, dass Sie die .bat-Datei '''mit Administratorrechten starten''' , weil sonst nicht alle Registryeinträge entfernt werden können.

Es folgt eine Liste von Links zu den jeweiligen Downloads: 

*[http://www.aquasoft.de/download/files/diashow8/UninstallDS8Easy.zip] DiaShow Easy 
*[http://www.aquasoft.de/download/files/diashow8/UninstallDS8EasyBeta.zip] DiaShow Easy Beta 
*[http://www.aquasoft.de/download/files/diashow8/UninstallDS8Ultimate.zip] DiaShow 8 Ultimate 
*[http://www.aquasoft.de/download/files/diashow8/UninstallDS8Premium.zip] DiaShow 8 Premium 
*[http://www.aquasoft.de/download/files/diashow7/UninstallDS7BlueNet.zip] DiaShow 7 Blue Net 
*[http://www.aquasoft.de/download/files/diashow7/UninstallDS7Ultimate.zip] DiaShow 7 Ultimate 
*[http://www.aquasoft.de/download/files/diashow7/UninstallDS7UltimateBeta.zip] DiaShow 7 Ultimate Beta 
*[http://www.aquasoft.de/download/files/diashow7/UninstallDS7Premium.zip] DiaShow 7 Premium 
*[http://www.aquasoft.de/download/files/diashow7/UninstallDS7PremiumBeta.zip] DiaShow 7 Premium Beta 
*[http://www.aquasoft.de/download/files/diashow6/UninstallDSStudio6.zip] DiaShow Studio 6 
*[http://www.aquasoft.de/download/files/diashow6/UninstallDSDeluxe6.zip] DiaShow Deluxe 6 
*[http://www.aquasoft.de/download/files/diashow6/UninstallDSYouTube6.zip] DiaShow 6 für YouTube 
*[http://www.aquasoft.de/download/files/discmenu2/UninstallDiscMenu2.zip] DiscMenu 2 
*[http://www.aquasoft.de/download/files/earthpilot/UninstallEarthPilot.zip] Earth Pilot 
*[http://www.aquasoft.de/download/files/photoalbum3/UninstallPhotoAlbum3.zip] PhotoAlbum 3 
*[http://www.aquasoft.de/download/files/photoalbum4/UninstallFotoszumAnfassen.zip] Fotos zum Anfassen 
*[http://www.aquasoft.de/download/files/photokalender3/UninstallPhotoKalender3.zip] PhotoKalender 3 
*[http://www.aquasoft.de/download/files/screenshow3/UninstallScreenShow3.zip] ScreenShow 3 
*[http://www.aquasoft.de/download/files/screenshow4/UninstallScreenShow4.zip] ScreenShow 4 
*[http://www.aquasoft.de/download/files/webshow3/UninstallWebShow3.zip] WebShow 3 

 

[[Category:Allgemeines]]

Vorlagen-Entwicklung

2014-04-14T09:58:46Z

Steffen.binas: /* Einstellungsdialog */

Die AquaSoft DiaShow bietet vielfältige Möglichkeiten, intelligente Vorlagen zu entwickeln. Leider kann man nicht einfach eine beliebige Animation mit einem Klick zu einer wiederverwendbaren Vorlagen machen.

Die grobe Vorgehensweise sieht so aus:
* Eine Vorlage besteht aus einer Benutzeroberfläche (GUI) und der eigentlichen Animation.
* Ein Script, dass der GUI angehängt ist, überträgt die Einstellungen aus der GUI an die Animation.

= Benutzeroberfläche =

Es gibt zwei verschiedene Arten von Benutzeroberflächen in der DiaShow.

== Einstellungsdialog ==
Einen Dialog mit Eingabefeldern und Reglern etc. ist bereits hier beschrieben: [[GUI-API]]

Was über einen solchen Dialog aber nicht realisiert werden kann, ist z.B. das Einfügen von beliebig vielen Bildern.

== Timeline-GUI ==
Damit eine Vorlage Platzhalter zum Einfügen von einzelnen oder beliebig vielen Bildern/Texten/Videos bekommt, wird sie in der Timeline aus Blackbox-Objekten, Bild- und Text-Objekten zusammengesetzt. Um zu verhindern, dass beim Verwenden der Vorlage, versehentlich wichtige Teile gelöscht oder verschoben werden, kann das über den "Entwickler"-Tab in den Objekt-Eigenschaften verhindert werden. Zudem lassen sich weitere Einstellungen machen, die der DiaShow sagen, wie die Vorlage funktioniert.

=== Config-Tags ===

Jedes Objekt kann eine beliebige Anzahl von Config-Tags bekommen. Config-Tags sind Name-Wert-Paare, die entweder vom DiaShow-Programm oder von Scripts ausgewertet werden können.

z.B. Zeichenketten (ohne Anführungszeichen)

Nahrung = Pizza

oder Zahlen (Dezimaltrennzeichen ist immer der Punkt ".")

Wert = 23.7

Mehrere Config-Tags werden mit Semikolon getrennt ";"

Nahrung = Pizza; Wert = 23.7

Eine Sonderform von untergeordneten Werten ist möglich

Rechteck.Breite = 0.3; Rechteck.Höhe = 0.7;

Werden untergeordnete Werte verwendet, ist es nicht möglich den Hauptnamen nocheinmal ohne . zu verwenden (also Rechteck = <Wert>).
==== Standard-Config-Tags ====

Es gibt ein paar vordefinierte Tags, die eine besondere Bedeutung im Programm haben.

{| class="wikitable"
! Tag
! Werte
! Eräuterung
|-
| control
|
| Gibt an, welches Steuerelement in der Programm-Oberfläche verwendet werden soll.
|-
| || textedit || Ein einzeiliges Texteingabefeld (z.B. für die Eingabe einer Überschrift)
|-
| || textmemo || Ein mehrzeiliges Texteingabefeld (z.B. für einen Abspannscroller)
|}

[[Kategorie:Scripting-API]]

Vorlagen-Entwicklung

2014-04-14T09:58:16Z

Steffen.binas: Die Seite wurde neu angelegt: „Die AquaSoft DiaShow bietet vielfältige Möglichkeiten, intelligente Vorlagen zu entwickeln. Leider kann man nicht einfach eine beliebige Animation mit einem …“

Die AquaSoft DiaShow bietet vielfältige Möglichkeiten, intelligente Vorlagen zu entwickeln. Leider kann man nicht einfach eine beliebige Animation mit einem Klick zu einer wiederverwendbaren Vorlagen machen.

Die grobe Vorgehensweise sieht so aus:
* Eine Vorlage besteht aus einer Benutzeroberfläche (GUI) und der eigentlichen Animation.
* Ein Script, dass der GUI angehängt ist, überträgt die Einstellungen aus der GUI an die Animation.

= Benutzeroberfläche =

Es gibt zwei verschiedene Arten von Benutzeroberflächen in der DiaShow.

== Einstellungsdialog ==
Einen Dialog mit Eingabefeldern und Reglern etc. ist bereits hier beschrieben: [[GUI-API]]
Was über einen solchen Dialog aber nicht realisiert werden kann, ist z.B. das Einfügen von beliebig vielen Bildern.

== Timeline-GUI ==
Damit eine Vorlage Platzhalter zum Einfügen von einzelnen oder beliebig vielen Bildern/Texten/Videos bekommt, wird sie in der Timeline aus Blackbox-Objekten, Bild- und Text-Objekten zusammengesetzt. Um zu verhindern, dass beim Verwenden der Vorlage, versehentlich wichtige Teile gelöscht oder verschoben werden, kann das über den "Entwickler"-Tab in den Objekt-Eigenschaften verhindert werden. Zudem lassen sich weitere Einstellungen machen, die der DiaShow sagen, wie die Vorlage funktioniert.

=== Config-Tags ===

Jedes Objekt kann eine beliebige Anzahl von Config-Tags bekommen. Config-Tags sind Name-Wert-Paare, die entweder vom DiaShow-Programm oder von Scripts ausgewertet werden können.

z.B. Zeichenketten (ohne Anführungszeichen)

Nahrung = Pizza

oder Zahlen (Dezimaltrennzeichen ist immer der Punkt ".")

Wert = 23.7

Mehrere Config-Tags werden mit Semikolon getrennt ";"

Nahrung = Pizza; Wert = 23.7

Eine Sonderform von untergeordneten Werten ist möglich

Rechteck.Breite = 0.3; Rechteck.Höhe = 0.7;

Werden untergeordnete Werte verwendet, ist es nicht möglich den Hauptnamen nocheinmal ohne . zu verwenden (also Rechteck = <Wert>).
==== Standard-Config-Tags ====

Es gibt ein paar vordefinierte Tags, die eine besondere Bedeutung im Programm haben.

{| class="wikitable"
! Tag
! Werte
! Eräuterung
|-
| control
|
| Gibt an, welches Steuerelement in der Programm-Oberfläche verwendet werden soll.
|-
| || textedit || Ein einzeiliges Texteingabefeld (z.B. für die Eingabe einer Überschrift)
|-
| || textmemo || Ein mehrzeiliges Texteingabefeld (z.B. für einen Abspannscroller)
|}

[[Kategorie:Scripting-API]]

Installation/Deinstallation

2014-03-14T09:55:15Z

Steffen.binas: /* Unvollständige Deinstallation */

Diese Seite wird Hinweise zur Installation und Deinstallation von AquaSoft-Produkten enthalten.

= Problemfälle =

== Unvollständige Deinstallation ==

Führt man das Setup eines AquaSoft-Produktes aus, dessen Vorversion bereits auf dem selben Rechner installiert ist, so wird als erstes deren Deinstallation ausgeführt. 

Gelegentlich machen Anwender dabei die Erfahrung, dass sie zum Ende der Deinstallation eine Benachrichtigung erhalten mit dem Wortlaut "Das Installationspaket für AquaSoft <Produktname> stimmt nicht mehr mit dm Clientpaket überein. Wiederholen Sie die Installation mit einer gültigen Kopie des Installationspaketes 'Setup.msi'."

Als Ursache für diese Meldung und die im Anschluss daran erfolglosen Versuche, die neue Version zu installieren, hat sich das Löschen von für die Deinstallation der Vorversion benötigten Dateien herausgestellt. Sei es durch manuellen Eingriff durch den Anwender oder die Benutzung diverser Festplattenreinigungstools, diese wichtigen Ordner fallen des Öfteren dem Papierkorb anheim. Sie befinden sich unter Windows XP unter ''\Dokumente und Einstellungen\All Users\Anwendungsdaten\ ''und haben Bezeichnungen wie ''{5B8B7FD2-53B4-4000-88F2-B89FBBAA0C48}''. Wenn solch ein Ordner Dateien enthält, sollte er nicht gelöscht werden. Leider lässt es sich nicht verhindern, dass das doch hin und wieder passiert. Zu diesem Zweck enthält jedes AquaSoft-Produkt einen Support-Ordner und dieser eine Datei mit dem Namen '''Uninstall_<Programmname>.bat'''. Führt man diese Datei aus, werden überflüssige installationsspezifische Einträge aus der Registry gelöscht, und einer Neuinstallations ist der Weg geebnet. Es ist jedoch der Fall, dass zu dem Zeitpunkt, da die oben genannte Meldung auftaucht, der Installationsordner, und somit auch der Support-Ordner, bereits von der Festplatte entfernt sind und nur die hinderlichen Registrierungseinträge zurückgeblieben sind. D.h., es gibt keinen Zugriff auf die '''Uninstall_<Programmname>.bat''' mehr. 

 

Als Lösung zu diesem Problem bieten wir zu jedem Programm einen kleinen Download an, der die '''Uninstall_<Programmname>.bat''' und eine Datei namens '''RegTool.exe''' enthält. Es ist jeweil eine ZIP-Datei, die entpackt werden muss, bevor die '''Uninstall_<Programmname>.bat''' gestartet werden kann. Wichtig ist, dass Sie die .bat-Datei '''mit Administratorrechten starten''', weil sonst nicht alle Registryeinträge entfernt werden können.

Es folgt eine Liste von Links zu den jeweiligen Downloads: 

*[http://www.aquasoft.de/download/files/diashow8/UninstallDS8Ultimate.zip] DiaShow 8 Ultimate 
*[http://www.aquasoft.de/download/files/diashow8/UninstallDS8Premium.zip] DiaShow 8 Premium 
*[http://www.aquasoft.de/download/files/diashow7/UninstallDS7BlueNet.zip] DiaShow 7 Blue Net 
*[http://www.aquasoft.de/download/files/diashow7/UninstallDS7Ultimate.zip] DiaShow 7 Ultimate 
*[http://www.aquasoft.de/download/files/diashow7/UninstallDS7UltimateBeta.zip] DiaShow 7 Ultimate Beta 
*[http://www.aquasoft.de/download/files/diashow7/UninstallDS7Premium.zip] DiaShow 7 Premium 
*[http://www.aquasoft.de/download/files/diashow7/UninstallDS7PremiumBeta.zip] DiaShow 7 Premium Beta 
*[http://www.aquasoft.de/download/files/diashow6/UninstallDSStudio6.zip] DiaShow Studio 6 
*[http://www.aquasoft.de/download/files/diashow6/UninstallDSDeluxe6.zip] DiaShow Deluxe 6 
*[http://www.aquasoft.de/download/files/diashow6/UninstallDSYouTube6.zip] DiaShow 6 für YouTube 
*[http://www.aquasoft.de/download/files/discmenu2/UninstallDiscMenu2.zip] DiscMenu 2 
*[http://www.aquasoft.de/download/files/earthpilot/UninstallEarthPilot.zip] Earth Pilot 
*[http://www.aquasoft.de/download/files/photoalbum3/UninstallPhotoAlbum3.zip] PhotoAlbum 3 
*[http://www.aquasoft.de/download/files/photoalbum4/UninstallFotoszumAnfassen.zip] Fotos zum Anfassen 
*[http://www.aquasoft.de/download/files/photokalender3/UninstallPhotoKalender3.zip] PhotoKalender 3 
*[http://www.aquasoft.de/download/files/screenshow3/UninstallScreenShow3.zip] ScreenShow 3 
*[http://www.aquasoft.de/download/files/screenshow4/UninstallScreenShow4.zip] ScreenShow 4 
*[http://www.aquasoft.de/download/files/webshow3/UninstallWebShow3.zip] WebShow 3 

 

[[Category:Allgemeines]]

ISlideShow

2013-09-04T14:28:58Z

Steffen.binas:

<code>
ISlideShow
function GetCount: Integer;
procedure SetItem(Index: Integer; Item: [[ISlideShowObject]]);
function GetItem(Index: Integer): [[ISlideShowObject]];
function Remove(SlideShowObject: [[ISlideShowObject]]): Boolean;
procedure InsertBefore(BeforeThis, SlideShowObject: [[ISlideShowObject]]; Offset: Integer = 0; AsNewTrack: Boolean = False);
procedure InsertAfter(AfterThis, SlideShowObject: [[ISlideShowObject]]; Offset: Integer = 0; AsNewTrack: Boolean = False);
procedure InsertAsChild(Parent: [[ISlideShowObject]]; SlideShowObject: [[ISlideShowObject]]; Offset: Integer = 0; AsNewTrack: Boolean = False);
procedure CopyContent(SrcContainer, DstContainer: [[ISlideShowObject]]);
procedure MoveContent(SrcContainer, DstContainer: [[ISlideShowObject]]);
procedure Replace(const OldObject, NewObject: [[ISlideShowObject]]);
function LoadASO(const Filename: string): [[ISlideShowObject]];
function ResolveFilename(const RelativeFilename: string): string;
function GetRatioX: Integer;
function GetRatioY: Integer;
end;

var SlideShow: ISlideShow;
</code>

Über ein ISlideShow-Objekt kann eine Diashow bearbeitet werden, d.h. es können Objekte eingefügt, gelöscht, etc. werden.

Über die globale Variable <code>SlideShow</code> steht immer ein SlideShow-Objekt zur Verfügung, dass die aktuelle Diashow referenziert.

= Methoden =

* Anzahl der Toplevel-Objekte der Diashow
<code>
function GetCount: Integer;
</code>

* Seitenverhältnis der Show abfragen (X:Y)
<code>
function GetRatioX: Integer;
function GetRatioY: Integer;
</code>

* Objekte einfügen, Kopieren oder verschieben
<code>
procedure InsertBefore(BeforeThis, SlideShowObject: [[ISlideShowObject]]; Offset: Integer = 0; AsNewTrack: Boolean = False);
procedure InsertAfter(AfterThis, SlideShowObject: [[ISlideShowObject]]; Offset: Integer = 0; AsNewTrack: Boolean = False);
procedure InsertAsChild(Parent: [[ISlideShowObject]]; SlideShowObject: [[ISlideShowObject]]; Offset: Integer = 0; AsNewTrack: Boolean = False);
procedure CopyContent(SrcContainer, DstContainer: [[ISlideShowObject]]);
procedure MoveContent(SrcContainer, DstContainer: [[ISlideShowObject]]);
</code>

* Ein Objekt gegen ein anderes Ersetzen. Das Neue Objekt darf noch nicht Teil der Diashow sein, sondern ist z.B. ein neu erzeugtes oder ein ober LoadASO geladenes.
<code>
procedure Replace(const OldObject, NewObject: [[ISlideShowObject]]);
</code>

* Eine Toolboxanimation laden.
<code>
function LoadASO(const Filename: string): [[ISlideShowObject]];
</code>

* Dateinamen auflösen (relativ nach absolut, wobei das Verzeichnis der Diashow mit einbezogen wird)
<code>
function ResolveFilename(const RelativeFilename: string): string;
</code>

= Beispiel =

* Fügt hinten an die Show ein (leeres) Bildobjekt an
<code>
SlideShow.InsertAfter(nil, CreatePicture);
</code>

* Dieses Beispiel stellt die klassischen Form eine Intelligenten Vorlage dar. Eine ASO-Datei laden, Platzhalterbilder mit richtigen Dateinamen versehen und das aktuelle Objekt der Diashow gegen ASO austauschen. Dazu bedarf es folgender Voraussetzungen:
** Eine beliebige Animation/Collage etc. wird in der DiaShow gestaltet. Das auszutauschende Bild und Text bekommt auch Zugriffsnamen (hier "background_image" und "title"). Diese Animation wird in die Toolbox gezogen, sodass eine ASO-Datei daraus entsteht. Die ASO wird dann an einen Ort kopiert, auf den Scripte Zugriff haben.
** In der DiaShow wird ein Blackbox-Objekt mit z.B. einem Bild und einem Text erzeugt. Bild und Text bekommen einen "Zugriffsnamen" (hier "image" und "text"). Diesem Blackboxobjekt wird das hier gezeigte Script zugeordnet. Auch daraus wird eine ASO-Datei erzeugt. Die Vorlage kann nun durch Einfügen dieser ASO-Datei vom Anwender benutzt werden und stellt die "Benutzeroberfläche" für die Animation dar. Denn hieraus wird nur der Bilddateiname und der Textanteil übernommen und in die eigentliche Animation kopiert.
<code>
procedure OnExpandSlideShow(SlideShowObject: ISlideShowObject);
begin
var ASO: ISlideShowObject = SlideShow.LoadASO('meine_animation.aso');

// SlideShowObject ist das Blackbox-Objekt (also die "Benutzeroberfläche")
// Aufgabe: Übertrage Nutzereingaben aus der "Benutzeroberfläche" in die
// Animation. Die Animation wird durch die ASO repräsentiert.
Inject.Filename.From(SlideShowObject).FindByName('image').To(ASO).FindByName('background_image').Execute;
Inject.Text.From(SlideShowObject).FindByName('text').To(ASO).FindByName('title').Execute;

[...] // weitere "Intelligenz" anwenden, z.B. Timing anpassen, Pfade berechnen etc.

// die nun konfigurierte ASO in die Show einfügen und damit die
// "Benutzeroberfläche" ersetzen.
SlideShow.Replace(SlideShowObject, ASO);
end;
</code>

[[Kategorie:Scripting-API]]
[[Kategorie:Language]]

ISlideShow

2013-08-16T07:50:56Z

Steffen.binas: /* Beispiel */

<code>
ISlideShow
function GetCount: Integer;
procedure SetItem(Index: Integer; Item: [[ISlideShowObject]]);
function GetItem(Index: Integer): [[ISlideShowObject]];
function Remove(SlideShowObject: [[ISlideShowObject]]): Boolean;
procedure InsertBefore(BeforeThis, SlideShowObject: [[ISlideShowObject]]; Offset: Integer = 0; AsNewTrack: Boolean = False);
procedure InsertAfter(AfterThis, SlideShowObject: [[ISlideShowObject]]; Offset: Integer = 0; AsNewTrack: Boolean = False);
procedure InsertAsChild(Parent: [[ISlideShowObject]]; SlideShowObject: [[ISlideShowObject]]; Offset: Integer = 0; AsNewTrack: Boolean = False);
procedure CopyContent(SrcContainer, DstContainer: [[ISlideShowObject]]);
procedure MoveContent(SrcContainer, DstContainer: [[ISlideShowObject]]);
procedure Replace(const OldObject, NewObject: [[ISlideShowObject]]);
function LoadASO(const Filename: string): [[ISlideShowObject]];
function GetRatioX: Integer;
function GetRatioY: Integer;
end;

var SlideShow: ISlideShow;
</code>

Über ein ISlideShow-Objekt kann eine Diashow bearbeitet werden, d.h. es können Objekte eingefügt, gelöscht, etc. werden.

Über die globale Variable <code>SlideShow</code> steht immer ein SlideShow-Objekt zur Verfügung, dass die aktuelle Diashow referenziert.

= Methoden =

* Anzahl der Toplevel-Objekte der Diashow
<code>
function GetCount: Integer;
</code>

* Seitenverhältnis der Show abfragen (X:Y)
<code>
function GetRatioX: Integer;
function GetRatioY: Integer;
</code>

* Objekte einfügen, Kopieren oder verschieben
<code>
procedure InsertBefore(BeforeThis, SlideShowObject: [[ISlideShowObject]]; Offset: Integer = 0; AsNewTrack: Boolean = False);
procedure InsertAfter(AfterThis, SlideShowObject: [[ISlideShowObject]]; Offset: Integer = 0; AsNewTrack: Boolean = False);
procedure InsertAsChild(Parent: [[ISlideShowObject]]; SlideShowObject: [[ISlideShowObject]]; Offset: Integer = 0; AsNewTrack: Boolean = False);
procedure CopyContent(SrcContainer, DstContainer: [[ISlideShowObject]]);
procedure MoveContent(SrcContainer, DstContainer: [[ISlideShowObject]]);
</code>

* Ein Objekt gegen ein anderes Ersetzen. Das Neue Objekt darf noch nicht Teil der Diashow sein, sondern ist z.B. ein neu erzeugtes oder ein ober LoadASO geladenes.
<code>
procedure Replace(const OldObject, NewObject: [[ISlideShowObject]]);
</code>

* Eine Toolboxanimation laden.
<code>
function LoadASO(const Filename: string): [[ISlideShowObject]];
</code>

= Beispiel =

* Fügt hinten an die Show ein (leeres) Bildobjekt an
<code>
SlideShow.InsertAfter(nil, CreatePicture);
</code>

* Dieses Beispiel stellt die klassischen Form eine Intelligenten Vorlage dar. Eine ASO-Datei laden, Platzhalterbilder mit richtigen Dateinamen versehen und das aktuelle Objekt der Diashow gegen ASO austauschen. Dazu bedarf es folgender Voraussetzungen:
** Eine beliebige Animation/Collage etc. wird in der DiaShow gestaltet. Das auszutauschende Bild und Text bekommt auch Zugriffsnamen (hier "background_image" und "title"). Diese Animation wird in die Toolbox gezogen, sodass eine ASO-Datei daraus entsteht. Die ASO wird dann an einen Ort kopiert, auf den Scripte Zugriff haben.
** In der DiaShow wird ein Blackbox-Objekt mit z.B. einem Bild und einem Text erzeugt. Bild und Text bekommen einen "Zugriffsnamen" (hier "image" und "text"). Diesem Blackboxobjekt wird das hier gezeigte Script zugeordnet. Auch daraus wird eine ASO-Datei erzeugt. Die Vorlage kann nun durch Einfügen dieser ASO-Datei vom Anwender benutzt werden und stellt die "Benutzeroberfläche" für die Animation dar. Denn hieraus wird nur der Bilddateiname und der Textanteil übernommen und in die eigentliche Animation kopiert.
<code>
procedure OnExpandSlideShow(SlideShowObject: ISlideShowObject);
begin
var ASO: ISlideShowObject = SlideShow.LoadASO('meine_animation.aso');

// SlideShowObject ist das Blackbox-Objekt (also die "Benutzeroberfläche")
// Aufgabe: Übertrage Nutzereingaben aus der "Benutzeroberfläche" in die
// Animation. Die Animation wird durch die ASO repräsentiert.
Inject.Filename.From(SlideShowObject).FindByName('image').To(ASO).FindByName('background_image').Execute;
Inject.Text.From(SlideShowObject).FindByName('text').To(ASO).FindByName('title').Execute;

[...] // weitere "Intelligenz" anwenden, z.B. Timing anpassen, Pfade berechnen etc.

// die nun konfigurierte ASO in die Show einfügen und damit die
// "Benutzeroberfläche" ersetzen.
SlideShow.Replace(SlideShowObject, ASO);
end;
</code>

[[Kategorie:Scripting-API]]
[[Kategorie:Language]]

ISlideShow

2013-08-16T07:32:28Z

Steffen.binas:

ISlideShow

2013-08-16T07:23:03Z

Steffen.binas:

ISlideShow

2013-08-16T06:26:48Z

Steffen.binas:

Scripting-Entwicklungsumgebung

2013-04-25T09:10:27Z

Steffen.binas:

Sie finden die Scripting-Entwicklungsumgebung unter ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung''.

Die Scripting-Entwicklungsumgebung ist mehr als ein einfacher Editor. Sie können folgende Funktionen nutzen:

* Scriptdatei einem DiaShow-Objekt zuordnen
* Scripts erstellen (mehrere Editortabs gleichzeitig)
* Ausgabe von Log-Meldungen
* Debugger
** Programm schrittweise ausführen
** Inhalte von Variablen auswerten
* Syntaxvervollständigung (Strg+Leertaste)

Scripting-Entwicklungsumgebung

2013-04-25T09:05:24Z

Steffen.binas: Die Seite wurde neu angelegt: „Sie finden die Scripting-Entwicklungsumgebung unter ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung''.“

Sie finden die Scripting-Entwicklungsumgebung unter ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung''.

Entwicklermodus

2013-04-25T09:04:16Z

Steffen.binas:

Im Entwicklermodus bietet die DiaShow zusätzliche Bearbeitungsmöglichkeiten, die insbesondere der Erstellung von Vorlagen dienen.

= Achtung =

Der Entwicklermodus ist nicht für den täglichen Gebrauch bestimmt und kein "offizieller" Teil des Programms. Bei auftretende Problemen und Fragen können wir Ihnen keinen Support anbieten.

= Entwicklermodus aktivieren =

Sie aktivieren den Entwicklermodus über den Menüpunkt: ''Hilfe / Entwicklermodus''

= Features des Entwicklermodus =

* neues "Entwickler"-Tab bei den Objekt-Eigenschaften
* Scripting-Entwicklungsumgebung: ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung'' (siehe auch: [[Dokumentation der Scripting-API]])
* Vorlagen-Editor im DiaShow-Manager aktiviert
* Eine neue Kategorie namens "Developer" steht in der Toolbox zur Verfügung. Diese Objekte sind nur im Zusammenhang mit Scripts sinnvoll nutzbar.

= Performance =

Im Entwicklermodus sind einige wenige Optimierungsmaßnahmen ausgeschaltet, sodass die Arbeit mit dem Programm etwas langsamer sein könnte als bei deaktiviertem Entwicklermodus.

* Deaktivierter Cache beim Ausführen von Scripts
* Deaktivierter Cache für Pixelshader

Nur so ist es möglich, dass Änderungen an Scripts oder Shadern gleich Auswirkungen beim nächsten Abspielen haben. Mit aktivierten Caches müsste sonst das Programm neu gestartet werden.

[[Kategorie:Scripting-API]]

Entwicklermodus

2013-04-25T09:04:00Z

Steffen.binas: /* Performance */

Im Entwicklermodus bietet die DiaShow zusätzliche Bearbeitungsmöglichkeiten, die insbesondere der Erstellung vor Vorlagen dienen.

= Achtung =

Der Entwicklermodus ist nicht für den täglichen Gebrauch bestimmt und kein "offizieller" Teil des Programms. Bei auftretende Problemen und Fragen können wir Ihnen keinen Support anbieten.

= Entwicklermodus aktivieren =

Sie aktivieren den Entwicklermodus über den Menüpunkt: ''Hilfe / Entwicklermodus''

= Features des Entwicklermodus =

* neues "Entwickler"-Tab bei den Objekt-Eigenschaften
* Scripting-Entwicklungsumgebung: ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung'' (siehe auch: [[Dokumentation der Scripting-API]])
* Vorlagen-Editor im DiaShow-Manager aktiviert
* Eine neue Kategorie namens "Developer" steht in der Toolbox zur Verfügung. Diese Objekte sind nur im Zusammenhang mit Scripts sinnvoll nutzbar.

= Performance =

Im Entwicklermodus sind einige wenige Optimierungsmaßnahmen ausgeschaltet, sodass die Arbeit mit dem Programm etwas langsamer sein könnte als bei deaktiviertem Entwicklermodus.

* Deaktivierter Cache beim Ausführen von Scripts
* Deaktivierter Cache für Pixelshader

Nur so ist es möglich, dass Änderungen an Scripts oder Shadern gleich Auswirkungen beim nächsten Abspielen haben. Mit aktivierten Caches müsste sonst das Programm neu gestartet werden.

[[Kategorie:Scripting-API]]

Entwicklermodus

2013-04-25T09:03:10Z

Steffen.binas: Die Seite wurde neu angelegt: „Im Entwicklermodus bietet die DiaShow zusätzliche Bearbeitungsmöglichkeiten, die insbesondere der Erstellung vor Vorlagen dienen. = Achtung = Der Entwickle…“

Im Entwicklermodus bietet die DiaShow zusätzliche Bearbeitungsmöglichkeiten, die insbesondere der Erstellung vor Vorlagen dienen.

= Achtung =

Der Entwicklermodus ist nicht für den täglichen Gebrauch bestimmt und kein "offizieller" Teil des Programms. Bei auftretende Problemen und Fragen können wir Ihnen keinen Support anbieten.

= Entwicklermodus aktivieren =

Sie aktivieren den Entwicklermodus über den Menüpunkt: ''Hilfe / Entwicklermodus''

= Features des Entwicklermodus =

* neues "Entwickler"-Tab bei den Objekt-Eigenschaften
* Scripting-Entwicklungsumgebung: ''Ansicht / Steuerelemente / Scripting-Entwicklungsumgebung'' (siehe auch: [[Dokumentation der Scripting-API]])
* Vorlagen-Editor im DiaShow-Manager aktiviert
* Eine neue Kategorie namens "Developer" steht in der Toolbox zur Verfügung. Diese Objekte sind nur im Zusammenhang mit Scripts sinnvoll nutzbar.

= Performance =

Im Entwicklermodus sind einige wenige Optimierungsmaßnahmen ausgeschaltet, sodass die Arbeit mit dem Programm etwas langsamer sein könnte als bei deaktiviertem Entwicklermodus.

* Deaktivierter Cache beim Ausführen von Scripts
* Deaktivierter Cache für Pixelshader

Nur so ist es möglich, dass änderungen an Scripts oder Shadern gleich Auswirkungen beim nächsten Abspielen haben. Mit aktivierten Caches müsste sonst das Programm neu gestartet werden.

[[Kategorie:Scripting-API]]

Scripting-API

2013-04-25T08:50:58Z

Steffen.binas:

Die [[DiaShow 8]] führt die Möglichkeit ein, Vorlagen und Effekte für Bilder, Videos und andere Objekte per Skript zu erstellen und zu steuern. Die Entwicklungsumgebung kann nach Einschalten des Entwicklermodus (''Hilfe / Entwicklermodus'') über ''Menü Ansicht/Steuerelemente/Scripting-Entwicklungsumgebung'' aufgerufen werden. Die Skriptsprache ist [http://sourceforge.net/projects/dws/ DelphiWebScript], welche sich stark an Delphi orientiert, aber die Vorteile von Skriptsprachen einbringt.

= Anfügen eines vorgefertigten Skripts an DiaShowObjekte =

= Dokumentation der Script-API =
Eine ausführliche Dokumentation findet man unter [[Dokumentation der Scripting-API]].

[[Kategorie:Scripting-API]]

DiaShow-Objekt

2013-03-13T09:50:11Z

Steffen.binas:

Das DiaShow-Objekt ist die Basis-Klasse für [[DiaShow-Objekte|alle Objekte]], die in der DiaShow Verwendung finden.

<code>
ISlideShowObject
procedure SetItem(Index: Integer; Item: ISlideShowObject);
function GetItem(Index: Integer): ISlideShowObject;
function Text: [[IText]];
function Clone: ISlideShowObject;
function CloneWithChildren: ISlideShowObject;
procedure SetValueAsString(const Key: String; const Value: String);
function GetValueAsString(const Key: String): String;
procedure SetValueAsSingle(const Key: String; const Value: Single);
function GetValueAsSingle(const Key: String): Single;
procedure SetValueAsInteger(const Key: String; const Value: Integer);
function GetValueAsInteger(const Key: String): Integer;
procedure SetValueAsBoolean(const Key: String; const Value: Boolean);
function GetValueAsBoolean(const Key: String): Boolean;
function NameIs(const AName: string): Boolean;
property Name: string;
property Offset: Integer;
property Duration: Integer;
property Parent: ISlideShowObject;
property Count: Integer;
end;
</code>

= Methoden =

* Getter und Setter für Kindelemente. Alle Objekte können andere SlideShowObjekte als Kinder halten. Als herausragendes Beispiel kann man das Kapitel nennen, welches Bilder in sich vereint. Generell geht das aber mit allen anderen Objekten genauso.
<code>
procedure InsertItem(Index: Integer; Item: ISlideShowObject);
procedure AddItem(Item: ISlideShowObject);
procedure SetItem(Index: Integer; Item: ISlideShowObject);
function GetItem(Index: Integer): ISlideShowObject;
</code>

* Gibt die Anzahl der Kindelemente zurück
<code>
property Count: Integer;
</code>

* Gibt das Elternelement zurück
<code>
property Parent: ISlideShowObject;
</code>

* Ein SSO kann Text enthalten und ist vom Typ '''[[IText]]'''
<code>
function Text: IText;
</code>

* Abspiel-/Anzeigedauer eines Objektes in Millisekunden. Achtung, sollte nur in Ausnahmefällen geändert werden!
<code>
property Duration: Integer; // lesen und schreiben
</code>

* Der Offset des Objektes ist der Abstand zum Vorgänger-Objekt in Millisekunden. W
<code>
property Offset: Integer; // lesen und schreiben
</code>

* Kopiert das SSO ohne bzw. mit dessen Kindelemente(n)
<code>
function Clone: ISlideShowObject;
function CloneWithChildren: ISlideShowObject;
</code>

* Getter und Setter für [[GUI-API|GUI]]-Werte. Der '''Key''' gibt an, welches GUI-Element gemeint ist, '''Value''' setzt den entsprechenden Wert. Der Datentyp von Value ist dabei von Komponente zu Komponente unterschiedlich.
<code>
procedure SetValueAsString(const Key: String; const Value: String);
function GetValueAsString(const Key: String): String;

procedure SetValueAsSingle(const Key: String; const Value: Single);
function GetValueAsSingle(const Key: String): Single;

procedure SetValueAsInteger(const Key: String; const Value: Integer);
function GetValueAsInteger(const Key: String): Integer;

procedure SetValueAsBoolean(const Key: String; const Value: Boolean);
function GetValueAsBoolean(const Key: String): Boolean;
</code>

* Objektbenennung: Objekte können im Hauptprogramm einen Zugriffsnamen bekommen. Dieser kann über das "Name"-Propery abgerufen werden.
<code>
property Name: string;
</code>

* Liefert True zurück, wenn der Name des Objekts AName entspricht. Dabei wird Groß-/Kleinschreibung vernachlässigt.
<code>
function NameIs(const AName: string): Boolean;
</code>

= Verwendung =

Ein ISlideShowObject kommt niemals in reiner Form vor, sondern immer als spezielle Variante (z.B. ein [[IPicture|Bild]] oder [[IText|Text]]). Es ist die Basis für [[DiaShow-Objekte|alle Objekte]], die in der DiaShow Verwendung finden. Dementsprechenden leiten alle anderen von ihm ab und können in eine ISlideShowObject umgewandelt (gecastet) werden:

<code>
var Pic: IPicture;
var SSO: ISlideShowObject;
Pic := CreatePicture;
SSO := Pic as ISlideShowObject; // ein Bild lässt sich in das allgemeinere ISlideShowObject casten
</code>

[[Kategorie:Scripting-API]]

DiaShow-Objekt

2013-03-13T09:46:01Z

Steffen.binas:

Das DiaShow-Objekt ist die Basis-Klasse für [[DiaShow-Objekte|alle Objekte]], die in der DiaShow Verwendung finden.

<code>
ISlideShowObject
procedure SetItem(Index: Integer; Item: ISlideShowObject);
function GetItem(Index: Integer): ISlideShowObject;
function GetCount: Integer;
function GetParent: ISlideShowObject;
function Text: [[IText]];
function GetDuration: Integer;
procedure SetDuration(const Value: Integer);
function GetOffset: Integer;
procedure SetOffset(const Value: Integer);
function Clone: ISlideShowObject;
function CloneWithChildren: ISlideShowObject;
procedure SetValueAsString(const Key: String; const Value: String);
function GetValueAsString(const Key: String): String;
procedure SetValueAsSingle(const Key: String; const Value: Single);
function GetValueAsSingle(const Key: String): Single;
procedure SetValueAsInteger(const Key: String; const Value: Integer);
function GetValueAsInteger(const Key: String): Integer;
procedure SetValueAsBoolean(const Key: String; const Value: Boolean);
function GetValueAsBoolean(const Key: String): Boolean;
function NameIs(const AName: string): Boolean;
property Name: string;
end;
</code>

= Methoden =

* Getter und Setter für Kindelemente. Alle Objekte können andere SlideShowObjekte als Kinder halten. Als herausragendes Beispiel kann man das Kapitel nennen, welches Bilder in sich vereint. Generell geht das aber mit allen anderen Objekten genauso.
<code>
procedure InsertItem(Index: Integer; Item: ISlideShowObject);
procedure AddItem(Item: ISlideShowObject);
procedure SetItem(Index: Integer; Item: ISlideShowObject);
function GetItem(Index: Integer): ISlideShowObject;
</code>

* Gibt die Anzahl der Kindelemente zurück
<code>
function GetCount: Integer;
</code>

* Gibt das Elternelement zurück
<code>
function GetParent: ISlideShowObject;
</code>

* Ein SSO kann Text enthalten und ist vom Typ '''[[IText]]'''
<code>
function Text: IText;
</code>

* Abspiel-/Anzeigedauer eines Objektes in Millisekunden. Achtung, sollte nur in Ausnahmefällen geändert werden!
<code>
function GetDuration: Integer;
procedure SetDuration(const Value: Integer);
</code>

* Der Offset des Objektes ist der Abstand zum Vorgänger-Objekt in Millisekunden
<code>
function GetOffset: Integer;
procedure SetOffset(const Value: Integer);
</code>

* Kopiert das SSO ohne bzw. mit dessen Kindelemente(n)
<code>
function Clone: ISlideShowObject;
function CloneWithChildren: ISlideShowObject;
</code>

* Getter und Setter für [[GUI-API|GUI]]-Werte. Der '''Key''' gibt an, welches GUI-Element gemeint ist, '''Value''' setzt den entsprechenden Wert. Der Datentyp von Value ist dabei von Komponente zu Komponente unterschiedlich.
<code>
procedure SetValueAsString(const Key: String; const Value: String);
function GetValueAsString(const Key: String): String;

procedure SetValueAsSingle(const Key: String; const Value: Single);
function GetValueAsSingle(const Key: String): Single;

procedure SetValueAsInteger(const Key: String; const Value: Integer);
function GetValueAsInteger(const Key: String): Integer;

procedure SetValueAsBoolean(const Key: String; const Value: Boolean);
function GetValueAsBoolean(const Key: String): Boolean;
</code>

* Objektbenennung: Objekte können im Hauptprogramm einen Zugriffsnamen bekommen. Dieser kann über das "Name"-Propery abgerufen werden.
<code>
property Name: string;
</code>

* Liefert True zurück, wenn der Name des Objekts AName entspricht. Dabei wird Groß-/Kleinschreibung vernachlässigt.
<code>
function NameIs(const AName: string): Boolean;
</code>

= Verwendung =

Ein ISlideShowObject kommt niemals in reiner Form vor, sondern immer als spezielle Variante (z.B. ein [[IPicture|Bild]] oder [[IText|Text]]). Es ist die Basis für [[DiaShow-Objekte|alle Objekte]], die in der DiaShow Verwendung finden. Dementsprechenden leiten alle anderen von ihm ab und können in eine ISlideShowObject umgewandelt (gecastet) werden:

<code>
var Pic: IPicture;
var SSO: ISlideShowObject;
Pic := CreatePicture;
SSO := Pic as ISlideShowObject; // ein Bild lässt sich in das allgemeinere ISlideShowObject casten
</code>

[[Kategorie:Scripting-API]]

ISlideShow

2013-02-24T15:06:37Z

Steffen.binas:

Shaderobjekt

2012-11-27T13:06:30Z

Steffen.binas:

DiaShow-Objekt

2012-09-15T20:29:50Z

Steffen.binas:

Das DiaShow-Objekt ist die Basis-Klasse für [[DiaShow-Objekte|alle Objekte]], die in der DiaShow Verwendung finden.

<code>
ISlideShowObject
procedure SetItem(Index: Integer; Item: ISlideShowObject);
function GetItem(Index: Integer): ISlideShowObject;
function GetCount: Integer;
function GetParent: ISlideShowObject;
function Text: [[IText]];
function GetDuration: Integer;
procedure SetDuration(const Value: Integer);
function GetOffset: Integer;
procedure SetOffset(const Value: Integer);
function Clone: ISlideShowObject;
function CloneWithChildren: ISlideShowObject;
procedure SetValueAsString(const Key: String; const Value: String);
function GetValueAsString(const Key: String): String;
procedure SetValueAsSingle(const Key: String; const Value: Single);
function GetValueAsSingle(const Key: String): Single;
procedure SetValueAsInteger(const Key: String; const Value: Integer);
function GetValueAsInteger(const Key: String): Integer;
procedure SetValueAsBoolean(const Key: String; const Value: Boolean);
function GetValueAsBoolean(const Key: String): Boolean;
end;
</code>

= Methoden =

* Getter und Setter für Kindelemente. Alle Objekte können andere SlideShowObjekte als Kinder halten. Als herausragendes Beispiel kann man das Kapitel nennen, welches Bilder in sich vereint. Generell geht das aber mit allen anderen Objekten genauso.
<code>
procedure InsertItem(Index: Integer; Item: ISlideShowObject);
procedure AddItem(Item: ISlideShowObject);
procedure SetItem(Index: Integer; Item: ISlideShowObject);
function GetItem(Index: Integer): ISlideShowObject;
</code>

* Gibt die Anzahl der Kindelemente zurück
<code>
function GetCount: Integer;
</code>

* Gibt das Elternelement zurück
<code>
function GetParent: ISlideShowObject;
</code>

* Ein SSO kann Text enthalten und ist vom Typ '''[[IText]]'''
<code>
function Text: IText;
</code>

* Abspiel-/Anzeigedauer eines Objektes in Millisekunden. Achtung, sollte nur in Ausnahmefällen geändert werden!
<code>
function GetDuration: Integer;
procedure SetDuration(const Value: Integer);
</code>

* Der Offset des Objektes ist der Abstand zum Vorgänger-Objekt in Millisekunden
<code>
function GetOffset: Integer;
procedure SetOffset(const Value: Integer);
</code>

* Kopiert das SSO ohne bzw. mit dessen Kindelemente(n)
<code>
function Clone: ISlideShowObject;
function CloneWithChildren: ISlideShowObject;
</code>

* Getter und Setter für [[GUI-API|GUI]]-Werte. Der '''Key''' gibt an, welches GUI-Element gemeint ist, '''Value''' setzt den entsprechenden Wert. Der Datentyp von Value ist dabei von Komponente zu Komponente unterschiedlich.
<code>
procedure SetValueAsString(const Key: String; const Value: String);
function GetValueAsString(const Key: String): String;

procedure SetValueAsSingle(const Key: String; const Value: Single);
function GetValueAsSingle(const Key: String): Single;

procedure SetValueAsInteger(const Key: String; const Value: Integer);
function GetValueAsInteger(const Key: String): Integer;

procedure SetValueAsBoolean(const Key: String; const Value: Boolean);
function GetValueAsBoolean(const Key: String): Boolean;
</code>

= Verwendung =

Ein ISlideShowObject kommt niemals in reiner Form vor, sondern immer als spezielle Variante (z.B. ein [[IPicture|Bild]] oder [[IText|Text]]). Es ist die Basis für [[DiaShow-Objekte|alle Objekte]], die in der DiaShow Verwendung finden. Dementsprechenden leiten alle anderen von ihm ab und können in eine ISlideShowObject umgewandelt (gecastet) werden:

<code>
var Pic: IPicture;
var SSO: ISlideShowObject;
Pic := CreatePicture;
SSO := Pic as ISlideShowObject; // ein Bild lässt sich in das allgemeinere ISlideShowObject casten
</code>

[[Kategorie:Scripting-API]]

ISlideShow

2012-09-15T20:21:39Z

Steffen.binas:

ISlideShow

2012-09-15T20:11:04Z

Steffen.binas:

ISlideShow

2012-09-15T19:59:56Z

Steffen.binas: Die Seite wurde neu angelegt: „<code> ISlideShow function GetCount: Integer; procedure SetItem(Index: Integer; Item: ISlideShowObject); function GetItem(Index: Integer): [[ISl…“

DiaShow-Objekt

2012-09-15T19:44:28Z

Steffen.binas: /* Methoden */

Das DiaShow-Objekt, eigentlich ''SlideShowObject'' vom Typ '''ISlideShowObject''' (Abk. SSO), bildet die Basis-Klasse für alle Objekte, die in der DiaShow Verwendung finden. Dementsprechenden leiten alle anderen von ihm ab und enthalten deshalb alle Methoden dessen.

<code>
ISlideShowObject
procedure SetItem(Index: Integer; Item: ISlideShowObject);
function GetItem(Index: Integer): ISlideShowObject;
function GetCount: Integer;
function GetParent: ISlideShowObject;
function Text: [[IText]];
function GetDuration: Integer;
procedure SetDuration(const Value: Integer);
function GetOffset: Integer;
procedure SetOffset(const Value: Integer);
function Clone: ISlideShowObject;
function CloneWithChildren: ISlideShowObject;
procedure SetValueAsString(const Key: String; const Value: String);
function GetValueAsString(const Key: String): String;
procedure SetValueAsSingle(const Key: String; const Value: Single);
function GetValueAsSingle(const Key: String): Single;
procedure SetValueAsInteger(const Key: String; const Value: Integer);
function GetValueAsInteger(const Key: String): Integer;
procedure SetValueAsBoolean(const Key: String; const Value: Boolean);
function GetValueAsBoolean(const Key: String): Boolean;
end;
</code>

= Methoden =

* Getter und Setter für Kindelemente. Alle Objekte können andere SlideShowObjekte als Kinder halten. Als herausragendes Beispiel kann man das Kapitel nennen, welches Bilder in sich vereint. Generell geht das aber mit allen anderen Objekten genauso.
<code>
procedure InsertItem(Index: Integer; Item: ISlideShowObject);
procedure AddItem(Item: ISlideShowObject);
procedure SetItem(Index: Integer; Item: ISlideShowObject);
function GetItem(Index: Integer): ISlideShowObject;
</code>

* Gibt die Anzahl der Kindelemente zurück
<code>
function GetCount: Integer;
</code>

* Gibt das Elternelement zurück
<code>
function GetParent: ISlideShowObject;
</code>

* Ein SSO kann Text enthalten und ist vom Typ '''[[IText]]'''
<code>
function Text: IText;
</code>

* Abspiel-/Anzeigedauer eines Objektes in Millisekunden. Achtung, sollte nur in Ausnahmefällen geändert werden!
<code>
function GetDuration: Integer;
procedure SetDuration(const Value: Integer);
</code>

* Der Offset des Objektes ist der Abstand zum Vorgänger-Objekt in Millisekunden
<code>
function GetOffset: Integer;
procedure SetOffset(const Value: Integer);
</code>

* Kopiert das SSO ohne bzw. mit dessen Kindelemente(n)
<code>
function Clone: ISlideShowObject;
function CloneWithChildren: ISlideShowObject;
</code>

* Getter und Setter für [[GUI-API|GUI]]-Werte. Der '''Key''' gibt an, welches GUI-Element gemeint ist, '''Value''' setzt den entsprechenden Wert. Der Datentyp von Value ist dabei von Komponente zu Komponente unterschiedlich.
<code>
procedure SetValueAsString(const Key: String; const Value: String);
function GetValueAsString(const Key: String): String;

procedure SetValueAsSingle(const Key: String; const Value: Single);
function GetValueAsSingle(const Key: String): Single;

procedure SetValueAsInteger(const Key: String; const Value: Integer);
function GetValueAsInteger(const Key: String): Integer;

procedure SetValueAsBoolean(const Key: String; const Value: Boolean);
function GetValueAsBoolean(const Key: String): Boolean;
</code>

[[Kategorie:Scripting-API]]

GUI-API

2012-09-15T19:28:38Z

Steffen.binas: /* Einfügen der GUI */

Es ist manchmal notwendig, dass für Vorlagen und Effekte Einstellungen und Eingaben vom Benutzer gebraucht werden. Daher bietet die [[Scripting-API]] die Möglichkeit, einfache [https://de.wikipedia.org/wiki/Grafische_Benutzeroberfl%C3%A4che Grafische Benutzeroberflächen] (GUI) zu gestalten.

= Einfügen der GUI =
Die Gestaltung geschieht innerhalb der vordefinierten Funktion (dem "Hook") '''GetGUI''', die irgendwo im betreffenden Skript eingefügt sein muss:
<code>
function OnGetGUI(SlideShowObject: ISlideShowObject): string;
begin
Result := ''''''';
end;
</code>
Diese Funktion hält einen Parameter '''SlideShowObject'''. Dieses ist eine Referenz auf das Objekt, welches das Skript ausführt. Das ist in der Regel das Effekt- bzw. das BlackBox-Objekt selbst.

Die Definition der GUI erfolgt mittels [https://de.wikipedia.org/wiki/JSON JSON]-Syntax. Die Funktion liefert also einen JSON-String zurück.

= Struktur des JSON-Strings =
== Allgemeiner Aufbau ==
Das JSON-Objekt ist ein Array aus Komponenten-Objekten:
<code>
[
{
# Komponente 1
},
{
# Komponente 2
}
]

</code>
Jede Komponente benötigt das '''Key'''-Element, das '''Caption'''-Element und das '''Type'''-Element. Alle diese Elemente sind vom Datentyp ''String''.
* ''Key'': Eindeutige Kennung der Komponente, seine ID
* ''Type'': Art der Komponente. Kann folgende Werte annehmen:
** ''[[Title]]'': Title der Vorlage oder des Effekts
** ''[[Edit]]'': Eingabefeld
** ''[[ListBox]]'': Listenelement, enthält Strings
** ''[[ComboBox]]'': Aufklappbarer Auswahldialog, enthält Strings
** ''[[CheckBox]]'': Kästchen zur binären Auswahl
** ''[[ImageComboBox]]'': Aufklappbarer Auswahldialog, enthält Bilder
** ''[[SpinEdit]]'': Eingabefeld für Ganzzahlen, liefert Integer-Werte
** ''[[Slider]]'': auch unter '''TrackBar''' bekannt, Schieberegler, liefert Integer-Werte
* ''Caption'': Beschriftung der Komponente, kann leer sein.

== Optionen ==
Zusätzlich gibt es das optionale '''Options'''-Objekt, welches bei Bedarf bestimmte Zusatzinformationen enthalten kann - je nach Type.
<code>
# Beispiel für ein Edit-Feld und ein beschränktes Spin-Edit mit Optionen
[
{
"Key" : "Edit1",
"Type" : "Edit",
"Caption" : "Dies ist eine Edit-Feld"
},
{
"Key" : "Spin1",
"Type" : "SpinEdit",
"Caption" : "Dies ist ein SpinEdit-Feld",
"Options" :
{
"Min" : 1,
"Max" : 10
}
}
]
</code>

== Layout ==
Standardmäßig werden die im Array aufgezählten Komponenten untereinander angeordnet und über die gesamte Breite des Eigenschaften-Fensters gezogen. Ist eine Caption angegegeben, erscheint diese vor der eigentlichen Komponente als Beschriftung.

=== Schachtelung ===
Es ist möglich, Komponenten auch nebeneinander anzuordnen. Dafür müssen sich diese innerhalb eines Unterarrays befinden:
<code>
# JSON-Array für die GUI
[
{<Ein Objekt in Zeile 1>},
[{<Ein Objekt in Zeile 2>}, {<Noch ein Objekt in Zeile 2>}],
{<Ein Objekt in Zeile 3>}
]
</code>
Generell ist eine beliebige Schachtelung von Komponenten erlaubt. Jedes Unterarray wechselt das Layout von Horizontal zu Vertikal. Das erlaubt das Erstellen auch von komplizierteren Tabellenlayouts.

=== Beispiel ===
<code>
[
{
"Key" : "Edit1",
"Type" : "Edit",
"Caption" : "Name:"
},
[
[
{
"Key" : "Edit2",
"Type" : "Edit",
"Caption" : "Anschrift Teil 1:"
},
{
"Key" : "Edit3",
"Type" : "Edit",
"Caption" : "Anschrift Teil 2:"
}
],
[
{
"Key" : "Combo1",
"Type" : "ComboBox",
"Caption": "Kontaktmöglichkeit:",
"Options":
{
"Items" : ["eMail", "Telefon", "Rauchzeichen"]
}
},
{
"Key" : "Edit4",
"Type" : "Edit",
"Caption" : "Eingabe Kontakt:"
}
]
]
</code>

Dieses Beispiel könnte zur Eingabe von Adressschemata geeignet sein - der Anwendungsfall für die konkrete DiaShow sei hierbei einmal vernachlässigt. Dieses Layout ergibt ein breites Edit-Feld (der Name), und darunter eine kleine 2x2-Tabelle (links untereinander die Anschrift mit Edit-Feldern und rechts untereinander die Combobox und das Edit-Feld für die Kontaktdaten).

[[Kategorie:Scripting-API]]

Hooks

2012-09-15T19:28:30Z

Steffen.binas: /* Benutzeroberfläche */

= Hooks =
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 '''ISlideShowObject'''. So kann direkt auf das Objekt zugegriffen werden, dem die Skript-Datei angehängt ist.

== Abspielen / Player ==

<code>
procedure [[OnExpandSlideShow]](SlideShowObject: ISlideShowObject);
procedure [[Render]](SlideShowObject: ISlideShowObject; Bitmap: ICanvas);
procedure [[OnConfigureShader]](SlideShowObject: ISlideShowObject; const Progress: Float);
</code>

== Benutzeroberfläche ==

<code>
function [[OnInsertPreset]](SlideShowObject: ISlideShowObject): Boolean;
function [[OnCreateContextMenu]](SlideShowObject: ISlideShowObject): string;
function [[OnGetGUI]](SlideShowObject: ISlideShowObject): string;
procedure [[OnInitDesigner]](SlideShowObject: ISlideShowObject; Context: IDesignerContext);

</code>

[[Kategorie:Scripting-API]]