Allgemeine Hinweise
|
Es gibt in FixFoto verschiedene Arten von Skripten, für die Skripte erstellt werden können.
Normale FixFoto-Skripte
Diese Skripte funktionieren im gesamten Programm, außer in der Stapelverarbeitung oder beim Einfügen und müssen im Verzeichnis "Script" im FixFoto-Datenverzeichnis liegen. Programmiersprache dieser Skripte kann JScript oder VBScript sein.
Erweiterungsskripte
Erweiterungsskripte erweitern einen bestimmten Bereich innerhalb FixFotos, der nicht über die normalen Skripte abgedeckt werden kann. So gibt es Erweiterungsskripte für die Stapelverarbeitung, die Mehrfach-Automatik oder das Kontextmenü der Computer-Ansicht oder welche, die das Sortieren der Vorschaubilder übernehmen.
Nachfolgend eine Übersicht über die Erweiterungsskripte:
Erweiterungsskripte |
Wirken auf |
Speicherort* |
Sprache |
Präfix |
Weiteres |
Boostskripte |
Batchscript\Boost\ |
JS |
- |
Es gibt es einige Variablen zur Steuerung. |
|
Einfügeskripte |
Funktion "Einfügen" |
\Script\ |
JS/VBS |
PasteScript_ |
- |
Sortierskripte |
\Script\ |
JS/VBS |
SortScript_ |
Übergeben wird die vollständige Liste der Bilder mit LF getrennt, zurückerwartet wird die umsortierte Liste im gleichen Format |
|
Auswahlskripte |
\Script\ |
JS/VBS |
FFCFmt_ |
Übergeben wird die vollständige Liste der Bilder mit LF getrennt, zurückerwartet wird die umsortierte Liste im gleichen Format |
|
Mehrfachautomatik |
\Script\ |
JS/VBS |
- |
Um diese Skripte über die Mehrfachautomatik evtl. konfigurieren zu können, muss ein zusätzliches Skript mit gleichem Namen und dem Suffix "_Setup" im gleichen Verzeichnis existieren |
|
Kontextmenüskripte |
\Script\ |
JS/VBS |
FFCBar_ |
Der jeweilige Bildname wird mit FF_GetParam() ermittelt. |
|
RAW-Skripte |
\Script\ |
JS |
RAWScript_ |
- |
|
Bildinfo-Skripte |
\Script\ |
JS/VBS |
- |
Das Skript erhält den aktuellen Bildschirminhalt sowie den Dateinamen des Bildes als Parameter. |
|
Speicherskripte |
\Script\ |
JS/VBS |
- |
Siehe FF_GetParam() für Übergabeparameter |
* Ausgangsverzeichnis ist der Datenpfad
Alle Erweiterungsskripte können in JScript oder VBScript vorliegen, mit Ausnahme der Boostskripte, welche nur in JScript geschrieben sein dürfen.
Automatische Skriptkonfiguration
Um zu gewährleisten, dass die Skripte mit der automatischen Konfiguration in FixFoto eingebunden werden, sind folgende Zeilen im Kopf des Skriptes einzutragen. Außerdem ist es ratsam, das Skript in eine zip-Datei zu packen, wenn mehrere Dateien oder Unterordner dazu gehören.
//FFSubmenu=... |
Name der Kategorie, in der das Skript eingebunden wird. |
//FFName=... |
Name des Skriptes, welcher innerhalb der festgelegten Kategorie angezeigt wird. |
//FFInclude=scriptname |
Lädt alle angegebenen Bibliotheken zum aktuellen Skript hinzu. Die Bibliotheken müssen sich im FF-Skriptverzeichnis befinden und die gleiche Sprachvariante des aktuellen Skriptes verwenden. |
Für das Skripting sind zusätzlich zu den Standard-Skriptbefehlen, viele fixfotospezifische Befehle verfügbar. Dabei verwendete Datentypen sind:
Datentyp |
Beschreibung |
VT_BSTR |
String |
VT_I4 |
32-Bit Integer (vorzeichenbehaftet) |
VT_UI4 |
32-Bit Integer (vorzeichenlos) |
VT_R8 |
Double |
VT_BOOL |
True/False |
VT_EMPTY |
Leer |
Hinweise
• Fehler in den FF_xxx Skriptfunktionen lösen Ausnahmen aus.
• Beim Aufruf des Speicherskripts wird zusätzlich zur Kompression, durch CRLF getrennt, der Speicherpfad übergeben.
• Da Skripte erhebliches Know-How enthalten können, gibt es auch die Möglichkeit, die Skripte in verschlüsselter Form zu veröffentlichen, Microsoft stellt dazu screnc.exe zur Verfügung (siehe unten).
Weiterführende Links: