[id] = CreateClipRegion(id, type, ...) [id] = CreateClipRegion(id, #BOX, x, y, width, height) [id] = CreateClipRegion(id, #SHAPE, id, x, y)
CreateClipRegion() erzeugt eine neue Clip-Region und weist
den Identifikator id zu. Wenn Sie Nil als ID angeben, wird
CreateClipRegion() automatisch eine auswählen und zurückgeben.
Beachten Sie, dass CreateClipRegion() nicht die Clip-Region aktiviert.
Dies muss mit dem Befehl SetClipRegion() erledigt werden.
Clip-Regionen sind nützlich, um den Bereich Ihres Display zu begrenzen, wo Grafiken angezeigt werden können. Z.B. wenn Sie ein Spielbildschirm mit zwei Teilen haben möchten: Den Levelbereich und die Statusleiste (Leben, Munition etc.). Es kann dann sinnvoll sein, eine Clip-Region zu installieren, die mit den Grenzen des Levelbereichs übereinstimmt, so dass Sprites nie außerhalb dieses Bereichs gezogen werden können. Alle Grafikbefehle von Hollywood werden diese Clip-Region respektieren. Somit werden keine Grafiken jemals außerhalb der Grenzen der Clip-Region gezeichnet.
Es gibt zwei verschiedene Clip-Regionstypen: Rechteckige (#BOX)
und benutzerdefiniert geformte Clip-Regionen (#SHAPE). Das
Zeichnen von rechteckigen Clip-Regionen ist in der Regel schneller.
Wenn Sie eine rechteckige Clip-Region installieren möchten,
müssen Sie seine x- und y-Position sowie Breite width und
Höhe height angeben. Eine benutzerdefiniert geformte Clip-Region
kann durch Angabe eines Pinsels installiert werden, dessen
Maske der gewünschten Clip-Region entspricht. Außerdem müssen
Sie die x- und y-Koordinaten , wo auf dem Display die Clip-Region
positioniert wird. Wenn Sie z.B. eine Maske der Größe 320x240
verwenden, aber ein Display der Größe 640x480 haben, können
Sie die Clip-Region auf dem Display zentrieren. Wenn Sie eine
benutzerdefinierte Pinsel mit Maske als Clip-Region installieren,
wird Hollywood in der Lage sein, auf alle sichtbaren Pixel
der Maske zu zeichnen. Bei allen unsichtbaren Pixel der Maske
wird die Grafik abgeschnitten.
Siehe SetClipRegion für mehr Informationen über die Erstellung und Installation von Clip-Regionen.
Wenn Sie eine mit CreateClipRegion() erstellte Clip-Region
aus dem Speicher löschen wollen, benutzen Sie den Befehl FreeClipRegion().
Siehe auch FreeClipRegion() und SetClipRegion().
#BOX, #SHAPE oder #NONEwidth die Breite und height die Höhe des Rechtecks istid angegeben haben (siehe oben)