ClipOutput()

Syntax

ClipOutput(x, y, Breite, Höhe)

Definiert einen Begrenzungsrahmen ("bounding box"), der die gesamten Zeichenoperationen in der aktuellen Ausgabe eingrenzt. Alle außerhalb dieser "Box" gezeichneten Pixel werden abgeschnitten ("clipped").

Parameter

x, y, Breite, Höhe

Die Position und Größe des Begrenzungsrahmens. Die (x, y) Koordinaten sind immer absolut und werden nicht von SetOrigin() Aufrufen beeinflusst.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

Dieser Befehl hat nur einen Effekt bei Zeichenausgaben, die mittels ImageOutput() oder CanvasOutput() erstellt wurden.

Der Zeichnungsursprung ("drawing origin") wird durch einen Aufruf dieser Funktion nicht verändert. Um alle Zeichenoperationen relativ zur linken oberen Ecke des Begrenzungsrahmens zu machen, muss - wenn dies gewünscht wird - ein separater Aufruf von SetOrigin() erfolgen.

Die Plot() und Point() Befehle führen aus Performancegründen keine Überprüfung der Grenzen durch und sind dadurch von diesem Befehl auch nicht betroffen.

Beispiel

  If OpenWindow(0, 0, 0, 200, 200, "2DDrawing Example", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    If CreateImage(0, 200, 200, 24, $FFFFFF) And StartDrawing(ImageOutput(0))

      ClipOutput(50, 50, 100, 100) ; die gesamten Zeichenoperationen auf diese Region begrenzen
      Circle( 50,  50, 50, $0000FF)  
      Circle( 50, 150, 50, $00FF00)  
      Circle(150,  50, 50, $FF0000)  
      Circle(150, 150, 50, $00FFFF)  
      
      DrawingMode(#PB_2DDrawing_Outlined)
      Box(50, 50, 100, 100, $000000)
         
      StopDrawing() 
      ImageGadget(0, 0, 0, 200, 200, ImageID(0))      
    EndIf
    
    Repeat
      Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow
  EndIf

Siehe auch

UnclipOutput(), SetOrigin(), OutputWidth(), OutputHeight()

Unterstützte OS

Alle