Bezeichnung
CreateBGPic -- erzeugt ein leeres Hintergrundbild (V1.5)
Übersicht
[id] = CreateBGPic(id, width, height[[, color], table])
Beschreibung
Dieser Befehl erzeugt ein neues Hintergrundbild mit der angegebenen Höhe height und Breite width und füllt es mit der in color angegebenen Farbe. Wenn keine Farbe übergeben wurde, wird das Hintergrundbild schwarz gefüllt. Wenn Sie beim Argument id Nil angeben, wird CreateBGPic() für dieses Hintergrundbild automatisch eine Zahl wählen und Ihnen übergeben.

Ab Hollywood 9.0 gibt es ein optionales Tabellenargument, mit dem Sie weitere Optionen angeben können. Die folgenden Tabellen-Tags werden derzeit unterstützt:

Palette:
Wenn dieser Tag auf den Identifikator einer Palette gesetzt ist, erstellt Hollywood ein Palettenhintergrundbild für Sie. Paletten können mit Befehlen wie CreatePalette() oder LoadPalette() erstellt werden. Alternativ können Sie diesen Tag auch auf eine von Hollywoods integrierten Paletten setzen, z.B. #PALETTE_AGA. Siehe SetStandardPalette für eine Liste der integrierten Paletten.

FillPen:
Wenn der Tag Palette gesetzt ist (siehe oben), können Sie mit diesem Tag den Stift einstellen, mit dem der Hintergrund des Hintergrundbildes ausgefüllt werden soll. Beachten Sie, dass der Parameter color, der an CreateBGPic() übergeben wird, ignoriert wird, wenn Palette True ist. Aus diesem Grund können Sie mit diesem Tag einen Stift angeben, der beim Initialisieren der Pixel des Hintergrundbildes verwendet wird. Voreingestellt ist 0.

TransparentPen:
Wenn Palette auf True gesetzt ist, kann mit diesem Tag ein Stift angegeben werden, der im neuen Hintergrundbild transparent gemacht werden soll. Der Standardwert ist #NOPEN, was bedeutet, dass kein transparenter Stift vorhanden sein soll.

Eingaben
id
Identifikator des neuen Hintergrundbildes
width
Breite des Hintergrundbildes
height
Höhe des Hintergrundbildes
color
optional: RGB-Farbe für die Füllung (voreingestellt ist #BLACK)
table
optional: Tabelle mit weiteren Optionen (siehe oben) (V9.0)
Rückgabewerte
id
optional: Identifikator des BGPic; wird nur zurück gegeben, wenn Sie als erstes Argument Nil angegeben haben.
Beispiel
CreateBGPic(2, 640, 480, #RED)
Diese Zeile erzeugt ein neues rotes Hintergrundbild mit der ID 2 und den Abmessungen 640x480.
Navigation zeigen