GroupLayer(group$, layer1[, layer2, ...])
group$ angegebenen Ebenengruppe hinzuzufügen. Wenn
die durch group$ angegebene Ebenengruppe noch nicht existiert,
wird sie automatisch von GroupLayer() erstellt. Ebenengruppen
werden einfach durch eine Namenszeichenkette referenziert, die
beliebige Zeichen enthalten kann, solange der Name der Gruppe
nicht bereits von einer Ebene verwendet wird. Die Ebene(n), die
der Gruppe hinzugefügt werden sollen, müssen durch ihre ID in
den Parametern nach group$ angegeben werden. Sie können diesem
Befehl eine unbegrenzte Anzahl von Ebenen übergeben.
Wenn Sie Ihre Ebenen gruppiert haben, können Sie den Namen der Gruppe an die meisten Befehle übergeben, die sich mit Ebenen befassen, z.B. könnten Sie eine Gruppe von Ebenen anzeigen, indem Sie einfach den Namen Ihrer Ebenengruppe an ShowLayer() übergeben. Sie können auch alle Ebenen einer Ebenengruppe auf einmal verschieben, indem Sie die Ebenengruppe an MoveLayer() übergeben usw.
Beachten Sie, dass beim Übergeben von Gruppen anstelle von einzelnen Ebenen an Befehlen der Ebenenbibliothek, diese Befehle die Ebenengruppe nicht als eigene Entität behandeln, sondern einfach die entsprechende Operation auf alle Ebenen anwenden, die Teil der Gruppe sind. Wenn Sie beispielsweise MoveLayer() für eine Ebenengruppe aufrufen und 100:100 als neue Position übergeben, verschiebt Hollywood nicht die Gruppe als Ganzes auf Position 100:100, sondern alle Ebenen der Gruppe einzeln auf 100:100, so dass nach dem Aufruf alle Ebenen, die Teil der Gruppe sind, bei der Position 100:100 erscheinen, d.h. sie alle an der gleichen Position sind, was möglicherweise nicht das ist, was Sie erwartet haben. Wenn Sie Ebenen verschieben möchten, die Teil einer Gruppe sind, und ihre individuelle Position innerhalb der Gruppe beibehalten möchten, müssen Sie stattdessen TranslateLayer() aufrufen, da dies das Verschieben von Ebenen relativ zu ihrer aktuellen Position ermöglicht. Siehe TranslateLayer für Details.
Ebenen können auch direkt bei ihrer Erstellung zu einer Gruppe
hinzugefügt werden, indem der Name der Gruppe im Tag Group
der Standard-Tags zum Zeichnen übergeben
wird, die von allen Hollywood-Befehlen verwendet werden, die
eine Ebene hinzufügen. Siehe Standard-Tags zum Zeichnen für Details.
Um eine Ebene aus einer Gruppe zu entfernen, verwenden Sie den Befehl UngroupLayer(). Siehe UngroupLayer für Details. Sobald einer Gruppe keine Ebene mehr zugeordnet ist, wird sie automatisch gelöscht.
Eine weitere Möglichkeit, Ebenen zu gruppieren, besteht darin, sie zusammenzuführen. Im Vergleich zum Gruppieren von Ebenen bedeutet das Zusammenführen von Ebenen, dass sie zu einer einzigen Ebene werden. Ein Vorteil zusammengeführter Ebenen besteht darin, dass sie als Ganzes behandelt werden, beispielsweise wenn sie mithilfe von Übergangseffekten ein- oder ausgeblendet werden. Bei gruppierten Ebenen hingegen werden Übergangseffekte für jede Ebene in der Gruppe einzeln angezeigt. Siehe MergeLayers für Details.
Sie müssen Ebenen aktivieren bevor Sie diesen Befehl nutzen können. Siehe Einführung in die Ebenentechnik für Details.
EnableLayers
SetFillStyle(#FILLCOLOR)
Box(0, 0, 100, 100, #RED, {Hidden = True})
Box(100, 0, 100, 100, #GREEN, {Hidden = True})
Box(200, 0, 100, 100, #BLUE, {Hidden = True})
GroupLayer("mygroup", 1, 2, 3)
TranslateLayer("mygroup", 170, 190)
ShowLayerFX("mygroup", #SCROLLSOUTH)
Der obige Code erstellt drei ausgeblendete 100x100-Rechtecke,
gruppiert sie und verschiebt dann die Gruppe in die Mitte der
640x480-Displays und scrollt sie von Süden her ein.