Bezeichnung
CreateGradientBGPic -- erstellt ein neues Hintergrundbild mit einem Farbverlauf (V2.0)
Früherer name
CreateRainbowBGPic (V1.0 - V1.9)

Übersicht
[id] = CreateGradientBGPic(id, type, startcolor, endcolor[, width,
                           height, angle, table])
Beschreibung
Dieser Befehl kann verwendet werden, um ein neues Hintergrundbild mit einem Farbverlauf zu erstellen. Wenn Sie Nil als id angeben, wird automatisch eine ID für dieses Hintergrundbild ausgewählt und in id zurückgegeben. type gibt die Art des Farbverlaufs an, den Sie verwenden möchten. Die folgenden Verlaufstypen sind derzeit verfügbar: #LINEAR, #RADIAL und #CONICAL. Wenn width (Breite) und height (Höhe) nicht angegeben werden, ist die Abmessungen dieselbe wie die Dimensionen des aktuellen Displays. angle (Winkel) ermöglicht es Ihnen, einen Drehwinkel in Grad für den Verlauf anzugeben. Dieses Winkelargument wird nur durch die Verlaufstypen #LINEAR und #CONICAL unterstützt. Radialfarbverläufe können nicht gedreht werden.

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)

Eingaben
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
Rückgabewerte
id
optional: Identifikator des BGPic; Wird nur zurückgegeben werden, wenn Sie Nil als Argument 1 angegeben haben (siehe oben)
Beispiel
CreateGradientBGPic(2, #LINEAR, #BLACK, #BLUE)
DisplayBGPic(2)
Erstellt einen von oben nach unten gehender Verlauf, welcher als Hintergrundbild 2 mit der Farbe Schwarz verblassend ins blaue zeigt.


CreateGradientBGPic(2, #LINEAR, 0, 0, 640, 480, 0, {Colors = {#RED, 0,
    #BLUE, 0.25, #GREEN, 0.5, #YELLOW, 0.75, #BLACK, 1}})
DisplayBGPic(2)
Der Code erstellt einen Verlauf mit mehreren Farben. Dieser Verlauf versucht, das Aussehen der berühmten Amiga Kupferstäbe zu replizieren.

Navigation zeigen