SetClipRegion(id)

Wenn eine Clip-Region installiert ist, wird dies auch Auswirkungen auf die speziellen Koordinatenkonstanten von Hollywood haben, z.B. #RIGHT bedeutet dann die rechte Seite der Clip-Region. Randeinstellungen werden ebenfalls angepasst.

Sie können auch einen Clip-Region installieren, während SelectBrush() aktiv ist. Diese Clip-Region wird dann deaktiviert, wenn EndSelect() aufgerufen wird.

Wenn Sie eine Clip-Region auf dem Hauptbildschirm installieren und Sie rufen einen Hintergrundbildschirm-Wiedergabebefehl (Off-Screen-Rendering) auf (zum Beispiel SelectBrush()), wird die Clip-Region vorübergehend deaktiviert. Sie wird aber wiederhergestellt, sobald Sie den Befehl EndSelect() aufrufen.

Wenn Ebenen aktiv sind, kann jede Ebene ihre private Clip-Region haben. Falls die Ebene transformiert (skaliert oder rotiert) wird, wird auch ihre Clip-Region transformiert. Die Standard-Clip-Region einer Ebene ist die Clip-Region, welche aktiv war, als die Ebene erzeugt wurde. Sie können mit dem Stilelement ClipRegion des Befehls SetLayerStyle() die Clip-Region einer Ebene ändern.

Ausnahmen: Sie können SetClipRegion() nicht verwenden, wenn...

• – das aktuelle Ausgabeziel ein Alphakanal ist, das heißt SelectAlphaChannel() ist aktiv
• – das aktuelle Ausgabeziel eine Maske ist, das heißt SelectMask() ist aktiv

Siehe CreateClipRegion für Details.

Siehe auch FreeClipRegion().

id

Identifikator der installierten Clip-Region; benutzen Sie den Befehl CreateClipRegion(), um eine Clip-Region zu erstellen

CreateClipRegion(1, #BOX, #CENTER, #CENTER, 320, 240)
SetClipRegion(1)
Circle(0, 0, 100, #RED)
Circle(439, 0, 100, #RED)
Circle(439, 279, 100, #RED)
Circle(0, 279, 100, #RED)