Bezeichnung
CreateGradientBrush -- erstellt einen Pinsel mit Farbverlauf (V5.0)
Übersicht
[id] = CreateGradientBrush(id, width, height, type, startcolor,
                           endcolor[, angle, table])
Beschreibung
Dieser Befehl kann verwendet werden, um einen neuen Pinsel mit einem Farbverlauf zu erstellen. Wenn Sie beim Argument id Nil angeben, wird CreatBrush() für den Pinsel automatisch eine Zahl auswählen und Ihnen übergeben. Die gewünschte Abmessung geben Sie mit width (Breite) und height (Höhe) an. Mit type können Sie die Art des Farbverlaufs angeben. Folgende Farbverläufe stehen zur Zeit zur Verfügung: #LINEAR, #RADIAL und #CONICAL. Den Drehwinkel (in Grad) des Verlaufs geben Sie in angle an, welcher nur durch die beiden Arten #LINEAR und #CONICAL unterstützt werden. Der Farbverlauf #RADIAL kann nicht gedreht werden.

Das optionale Argument table kann verwendet werden, um erweiterte Optionen anzugeben:

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, welches keinen Rahmen bedeutet.

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 bei der Erstellung eines zweifarbigen Farbverlaufs verwendet wird. Bei der Erstellung eines mehrfarbigen Farbverlaufs mit Hilfe der Tabelle Colors wird Balance ignoriert, da Sie mit der Tabelle Colors die Farben im Farbverlauf über Farbstopps individuell ausgleichen können.

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 diese Felder angeben, werden die Farben in den Argumenten startcolor und endcolor ignoriert und Hollywood wird nur die in diesem Tag angegebenen Farben verwenden. (V5.0)

Siehe auch CreateBrush().

Eingaben
id
ID des neuen Farbverlaufspinsel oder Nil für die automatische ID-Zuweisung
width
Breite des Pinsels
height
Höhe des Pinsels
type
Typ des Farbverlaufs; siehe oben für die verschiedenen Typen
startcolor
RGB-Wert für die Startfarbe
endcolor
RGB-Wert als Endfarbe
angle
Drehwinkel für den Farbverlauf (Voreingestellt ist 0)
table
Tabelle, welche weitere Optionen ermöglicht; siehe oben für eine Beschreibung der verfügbaren Optionen
Rückgabewerte
id
optional: Identifikator des Pinsels; Wird nur zurückgegeben werden, wenn Sie Nil als Argument 1 angegeben haben (siehe oben)
Beispiel
Siehe CreateGradientBGPic

Navigation zeigen