AddPathEllipse()

Syntax

AddPathEllipse(x.d, y.d, RadiusX.d, RadiusY.d [, StartWinkel.d, EndWinkel.d [, Flags]])

Fügt eine Ellipse (oder eine Teilellipse) zum Vektorzeichnen-Pfad hinzu.

Standardmäßig beendet diese Funktion die aktuelle Figur im Pfad und fügt die Ellipse als eine unverbundene Figur zum Pfad hinzu (volle Ellipsen werden als geschlossen markiert). Dieses Verhalten kann mit den entsprechenden Flags geändert werden.

Parameter

x.d, y.d	Geben den Mittelpunkt der Ellipse an.
RadiusX.d, RadiusY.d	Geben den Radius der Ellipse in die X- und Y-Richtung an.
StartWinkel.d, EndWinkel.d (optional)	Geben den Winkel (in Grad) für Beginn und Ende der Ellipse an. Der Winkel 0 befindet sich an der positiven X-Achse. Die Standardwerte lauten 0 bzw. 360 Grad.
Flags (optional)	Dies kann eine Kombination der folgenden Werte sein: #PB_Path_Default : Kein spezielles Verhalten (Standardwert) #PB_Path_Relative : Die Positionen sind relativ zur letzten Cursor-Position. #PB_Path_Connected : Der Kreis ist mit dem existierenden Pfad durch eine Linie verbunden und nicht automatisch eine geschlossene Figur. #PB_Path_CounterClockwise: Die Zeichenrichtung zwischen den Start-/End-Winkeln verläuft gegen den Uhrzeigersinn.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

Diese Funktion zeichnet eine Ellipsenform mit einem definierten Radius an der X- und Y-Achse des aktuellen Koordinatensystems. Um eine Ellipse mit einer abweichenden Drehung zu zeichnen, drehen Sie das Koordinatensystem um den Mittelpunkt der Ellipse, bevor Sie die Ellipse hinzufügen (wie im Beispiel unten gezeigt). Das aktuelle Koordinatensystem kann mit SaveVectorState() und RestoreVectorState() konserviert werden.

Beispiel

  If OpenWindow(0, 0, 0, 400, 200, "VectorDrawing", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    CanvasGadget(0, 0, 0, 400, 200)

    If StartVectorDrawing(CanvasVectorOutput(0))

      ; regular ellipse
      AddPathEllipse(100, 100, 80, 30)
      
      ; rotated ellipse
      SaveVectorState()
        RotateCoordinates(300, 100, 45)
        AddPathEllipse(300, 100, 80, 30)
      RestoreVectorState()
      
      VectorSourceColor(RGBA(255, 0, 0, 255))
      StrokePath(10)
    
      StopVectorDrawing()
    EndIf
    
    Repeat
      Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow
  EndIf

Siehe auch

MovePathCursor(), AddPathLine(), AddPathArc(), AddPathBox(), AddPathCircle(), AddPathCurve()

Unterstützte OS

Alle