Bezeichnung
InsertLayer -- fügt eine neue Ebene ein (V1.5)
Übersicht
InsertLayer(pos, type, id, x, y[, hidden])
Beschreibung
Dieser Befehl fügt eine neue Ebene des in type angegebenen Typs und dem Identifikator id an der Ebenenposition pos ein. Alle folgenden Ebenen werden verschoben und erhalten deshalb eine neue Kennung. Die neue Ebene wird außerdem an der durch x und y bestimmten Position angezeigt. Geben Sie in pos 0 als Position an, wird sie als letzte Ebene angehängt.

Folgende Objekttypen werden zur Zeit unterstützt:

#BRUSH
Fügt den in id angegebenen Pinsel bei x/y ein

#TEXTOBJECT
Fügt das in id angegebene Textobjekt bei x/y ein

#ANIM
Fügt die in id angegebene Animation bei x/y ein (V2.0)

#VIDEO
Fügt das in id angegebene Video bei x/y ein (V6.0)

Seit Hollywood 1.9 können Sie das optionale Argument hidden angeben, welches eine verborgene Ebene einsetzen wird, die Sie mit dem Befehl ShowLayer() oder ShowLayerFX() anzeigen können.

Sie müssen Ebenen aktivieren, bevor Sie diesen Befehl benutzen können. Um mehr über Hollywoods Ebenen zu erfahren, lesen Sie bitte die Einführung in die Ebenentechnik.

Eingaben
pos
gewünschte Position für die Ebene oder 0 als letzte Ebene
type
Objekttyp, den Sie einfügen möchten (siehe Liste oben)
id
Identifikator des Objektes, das Sie einfügen möchten
x
x-Position der neuen Ebene
y
y-Position der neuen Ebene
hidden
optional: True, wenn die neue Ebene verborgen sein soll (voreingestellt ist False) (V1.9)
Beispiel
EnableLayers()
SetFillStyle(#FILLCOLOR)
Box(0, 0, 100, 100, #RED)
Circle(#CENTER, #CENTER, 50, #BLUE)
TextOut(#RIGHT, #BOTTOM, "Hello World")
InsertLayer(1, #BRUSH, 1, #CENTER, #CENTER)
Der obige Code fügt Pinsel 1 als die erste Ebenen ein. Dies bedeutet, dass alle anderen Ebenen neu positioniert werden. Das rote Rechteck erhält jetzt Ebenenposition 2 (war vorher Ebene 1), der blaue Kreis ist jetzt Ebene 3 (war zuvor Ebene 2) und die "Hello World" Textebene wird 4 (war Ebene 3).
Navigation zeigen