[id] = CreateGradientBGPic(id, type, startcolor, endcolor[, width,
                           height, angle, table])

Das optionale Tabellenargument table kann für weitere Optionen verwendet werden. Die folgenden Tags sind derzeit verfügbar:

CenterX, CenterY:

Diese beiden Tags können verwendet werden, um den Mittelpunkt des Farbverlaufs anzugeben. Lineare Verläufe haben keinen Mittelpunkt, darum werden diese beiden Variablen nur dann berücksichtigt, wenn Sie Farbverläufe vom Typ #RADIAL oder #CONICAL verwenden. Der Mittelpunkt muss als Fließkommawert angegeben werden, der zwischen 0.0 (linke/obere Ecke) und 1.0 (rechts/unten Ecke) ist. Wenn nichts angegeben wurde, wird als Standard 0.5 genommen, so dass der Mittelpunkt des Verlaufes in der Mitte des Bildes ist. (V5.0)

Border:

Dieser Tag kann verwendet werden, um die Rahmengröße für den Verlauf des Typs #RADIAL einzustellen. Für die anderen Verlaufstypen wird dieser Tag ignoriert. Die Rahmengröße des radialen Verlaufs muss ein Fließkommawert zwischen 0.0 und 1.0 sein. Voreingestellt ist 0.0, das keinen Rahmen bedeutet. (V5.0)

Balance:

Dieser Tag kann verwendet werden, um den Gleichgewichtspunkt für den Verlauf des Typs #CONICAL einzustellen. Für die anderen Verlaufstypen wird dieser Tag ignoriert. Der Gleichgewichtspunkt des konischen Verlaufes muss ein Fließkommawert zwischen 0.0 und 1.0 sein. Der Standardwert ist 0.5. Beachten Sie, dass dies nur beim Erstellen eines zweifarbigen Farbverlaufs verwendet wird. Wenn Sie einen mehrfarbigen Farbverlauf mit der Tabelle Colors erstellen, wird Balance ignoriert, da Sie mit der Tabelle Colors die Farben im Farbverlauf mithilfe von Farbstopps individuell ausgleichen können. (V5.0)

Colors:

Mit diesem Tag können Sie Verläufe erstellen, die mehrere Farben enthalten. Dieser Tag ist eine Tabelle, die eine Folge von abwechselnden Farben und Stoppwerte enthält. Die Farben müssen im RGB-Format angegeben werden. Der Stoppwert ist ein Fließkommawert zwischen 0.0 und 1.0 und definiert die Position, wo die entsprechende Farben in dem Verlauf verschmolzen werden. Eine Position von 0.0 bedeutet die Startposition des Verlaufs und eine Position von 1.0 ist die Endposition. Bitte beachten Sie, dass die Stoppositionen in aufsteigender Reihenfolge sortiert werden müssen, das heißt von 0.0 bis 1.0. Wenn Sie diesen Tag angeben, werden die Farben in den Argumenten startcolor und endcolor ignoriert und Hollywood wird nur die in diesem Tag angegebenen Farben verwenden. (V5.0)

id

ID des neuen BGPic oder Nil für die automatische ID-Zuweisung

type

Typ des Farbverlaufs; siehe oben für die verschiedenen Typen

startcolor

RGB-Wert für die Startfarbe

endcolor

RGB-Wert als Endfarbe

width

optional: gewünschte Breite für das Hintergrundbild (Standard: aktuelle Displaybreite)

height

optional: gewünschte Höhe für das Hintergrundbild (Standard: aktuelle Displayhöhe)

angle

optional: Drehwinkel für den Farbverlauf (Voreingestellt ist 0)

table

optional: Tabelle, welche weitere Optionen ermöglicht; siehe oben für eine Beschreibung der verfügbaren Optionen

id

optional: Identifikator des BGPic; Wird nur zurückgegeben werden, wenn Sie Nil als Argument 1 angegeben haben (siehe oben)

CreateGradientBGPic(2, #LINEAR, #BLACK, #BLUE)
DisplayBGPic(2)

CreateGradientBGPic(2, #LINEAR, 0, 0, 640, 480, 0, {Colors = {#RED, 0,
    #BLUE, 0.25, #GREEN, 0.5, #YELLOW, 0.75, #BLACK, 1}})
DisplayBGPic(2)