VectorSourceLinearGradient()

Syntax

VectorSourceLinearGradient(x1.d, y1.d, x2.d, y2.d)

Wählt einen linearen Farbverlauf (englisch "color gradient") als Quelle für Vektorzeichnen-Operationen wie FillPath() oder StrokePath(). Anfänglich ist der Farbverlauf durchgängig schwarz. "Farbstopps" müssen nach dieser Funktion mittels VectorSourceGradientColor() hinzugefügt werden.

Parameter

x1.d, y1.d	Geben den Punkt an, welcher den Start (Position 0.0) des Farbverlaufs repräsentiert. Die Koordinaten werden in Bezug auf das #PB_Coordinate_Source Koordinatensystem angegeben.
x2.d, y2.d	Geben den Punkt an, welcher das Ende (Position 1.0) des Farbverlaufs repräsentiert. Die Koordinaten werden in Bezug auf das #PB_Coordinate_Source coordinate System angegeben.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

Siehe den Vektorzeichnen Überblick für eine Einführung in die verschiedenen Koordinatensysteme.

Der Farbverlauf wird nur im Bereich zwischen den (x1, y1) und (x2, y2) Punkten definiert. Außerhalb dieser Punkte hängt die verwendete Quellfarbe vom Betriebssystem ab, so dass Zeichenoperationen außerhalb der Fläche des definierten Farbverlaufs vermieden werden sollten.

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))

      VectorSourceLinearGradient(50, 0, 350, 0)
      VectorSourceGradientColor(RGBA(255, 0, 0, 255), 0.0)
      VectorSourceGradientColor(RGBA(0, 255, 0, 255), 0.5)
      VectorSourceGradientColor(RGBA(0, 0, 255, 255), 1.0)
      
      AddPathBox(50, 25, 300, 150)
      FillPath()
    
      StopVectorDrawing()
    EndIf
    
    Repeat
      Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow
  EndIf

Siehe auch

VectorSourceGradientColor(), VectorSourceCircularGradient(), VectorSourceColor(), VectorSourceImage()

Unterstützte OS

Alle