Lua Scripting Plug-In Referenz

Auf dieser Seite beschreibe ich kurz die Art Weaver-spezifischen Befehle und Funktionen. Quelle ist die englischsprachige Datei Lua Scripting Plug-In Reference.htm, die in C:\Program Files\Artweaver Free 3.0\Help installiert wird.

Gluas API

r,g,b,a = get_rgba(x, y)

Liefert die Werte für Rot, Grün,Balu und Alpha für ein mit x,y angegebenes Pixel. Die Werte werden dem Orginalbild entnommen wenn nicht zuvor flush() ausgeführt wurde.

set_rgba(x, y, r, g, b, a)

Diese Funktion ist das Gegenstück zu r,g,b,a = get_rgba(x, y). Mit ihr werden die Farb- und Alphawerte an der Position x,y gesetzt.

r,g,b = get_rgb(x, y)

Ähnlich wie r,g,b,a = get_rgba(x, y), jedoch ohne Alphawert, liefert also nur die reine Farbinformation

v = get_value(x, y)

Ermittelt Wert der Grau-Skala

set_value(x, y, v)

Setzt Wert der Grau-Skala

Weitere Funktionen

• h,s,l = get_hsl(x, y)
• set_hsl(x, y, h, s, l)
• h,s,v = get_hsv(x, y)
• set_hsv(x, y, h, s, v)
• l,a,b = get_lab(x, y)
• set_lab(x, y, l, a, b)

progress(percentage)

Mit dieser Funktion kann man den Fortschritt des Scriptablaufes in der Statusleiste anzeigen

flush()

Mit dieser Funktion werden die Daten des temporären Ausgabebildspeichers in den Quelldatenspeicher kopiert. Dadurch ist es einfacher, Mehrfachoperationen durchzuführen.

Variablen /Konstanten

Bestimmte Informationen zum Bild werden über Konstanten bereit gestellt. Das sind:

• width: Die Breite des Ausgangsbildes in Pixel
• height: Die Höhe des Ausgangsbildes in Pixel
• bound_x0, bound_y0: Die linke obere Koordinate einer Auswahlbox. Durch das Selektieren kann der Verabreitungsprozess beschleunigt werden
• bound_x1, bound_y1: Die rechte untere Koordinate einer Auswahlbox. Durch das Selektieren kann der Verabreitungsprozess beschleunigt werden.

Artweaver API

r,g,b = get_fcolor()

Liefert die aktuelle Vordergrundfarbe von Artweaver

r,g,b = get_bcolor()

Liefert die aktuelle Hintergrundfarbe von Artweaver

r,g,b = get_pcolor()

Liefert die aktuelle Papierfarbe von Artweaver

m = get_mask(x, y)

RegisterMenuItem(menupath, menucaption)

Fügt einen Menüeintrag zum ArtWeaver Filter Menü hinzu

Dogwaffle API

result = Dog_ValueBox(Title, Prompt, Min, Max, Default)

Erstellt eine einfache Dialogbox, die dem Benutzer die Möglichkeit gibt, aus einem vordefinierten Wertebereich auszuwählen.

Dog_ShellExe(Command_String)

Führt das angegebene externe Kommando (Programm) aus.

n = hex(s)

Konvertiert einen Hexadezimalstring in eine Zahl

r,g,b = decimal2rgb(n)

Konvertiert einen von der GUI Server Colorbox zurückgegebenen Wert