PathGradientBrush.SetSigmaBellShape Methode

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v9.0.0-preview.5.24306.5

Erstellt einen Farbverlaufsfall zwischen der Mittelfarbe und der ersten umgebenden Farbe basierend auf einer glockenförmigen Kurve.

Überlädt

SetSigmaBellShape(Single)	Erstellt einen Farbverlaufpinsel, der die Farbe von der Mitte des Pfads nach außen in die Grenze des Pfads ändert. Der Übergang von einer Farbe zu einer anderen basiert auf einer glockenförmigen Kurve.
SetSigmaBellShape(Single, Single)	Erstellt einen Farbverlaufpinsel, der die Farbe von der Mitte des Pfads nach außen in die Grenze des Pfads ändert. Der Übergang von einer Farbe zu einer anderen basiert auf einer glockenförmigen Kurve.

SetSigmaBellShape(Single)

Quelle:

PathGradientBrush.cs

Erstellt einen Farbverlaufpinsel, der die Farbe von der Mitte des Pfads nach außen in die Grenze des Pfads ändert. Der Übergang von einer Farbe zu einer anderen basiert auf einer glockenförmigen Kurve.

public:
 void SetSigmaBellShape(float focus);

public void SetSigmaBellShape (float focus);

member this.SetSigmaBellShape : single -> unit

Public Sub SetSigmaBellShape (focus As Single)

Parameter

focus

Single

Ein Wert von 0 bis 1, der angibt, wo entlang eines radialen Bereichs von der Mitte des Pfads zur Grenze des Pfads die mittlere Farbe angibt. Ein Wert von 1 (Standardeinstellung) platziert die höchste Intensität in der Mitte des Pfads.

Beispiele

Ein Beispiel finden Sie unter SetSigmaBellShape.

Hinweise

Wenn im SurroundColors Array mehr als eine Farbe vorhanden ist, wird die erste Farbe im Array für die Endfarbe verwendet. Die in diesem Array angegebenen Farben sind Farben, die für diskrete Punkte auf dem Begrenzungspfad des Pinsels verwendet werden.

Wenn Sie von der Grenze eines Pfadverlaufs zum Mittelpunkt wechseln, ändert sich die Farbe standardmäßig schrittweise von der Begrenzungsfarbe in die Mittelfarbe. Sie können die Positionierung und Vermischung der Begrenzungs- und Mittelfarben anpassen, indem Sie diese Methode aufrufen.

SetSigmaBellShape(Single, Single)

Quelle:

PathGradientBrush.cs

Erstellt einen Farbverlaufpinsel, der die Farbe von der Mitte des Pfads nach außen in die Grenze des Pfads ändert. Der Übergang von einer Farbe zu einer anderen basiert auf einer glockenförmigen Kurve.

public:
 void SetSigmaBellShape(float focus, float scale);

public void SetSigmaBellShape (float focus, float scale);

member this.SetSigmaBellShape : single * single -> unit

Public Sub SetSigmaBellShape (focus As Single, scale As Single)

Parameter

focus

Single

Ein Wert von 0 bis 1, der angibt, wo entlang eines radialen Bereichs von der Mitte des Pfads zur Grenze des Pfads die mittlere Farbe angibt. Ein Wert von 1 (Standardeinstellung) platziert die höchste Intensität in der Mitte des Pfads.

scale

Single

Ein Wert von 0 bis 1, der die maximale Intensität der Mittelfarbe angibt, die mit der Begrenzungsfarbe vermischt wird. Ein Wert von 1 verursacht die höchste mögliche Intensität der Mittelfarbe und ist der Standardwert.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, ein OnPaint-Ereignisobjekt. Der Code führt die folgenden Aktionen aus:

• Erstellt einen Grafikpfad und fügt ihr ein Rechteck hinzu.

• Erstellt eine PathGradientBrush aus den Pfadpunkten (in diesem Beispiel bilden die Punkte ein Rechteck, aber es kann sich um eine beliebige Form handeln).

• Legt die Mittelfarbe auf Rot und die umgebende Farbe auf Blau fest.

• Zeichnet die PathGradientBrush vor dem Anwenden der Blendtransformation auf den Bildschirm.

• Wendet die Blendtransformation mithilfe der SetSigmaBellShape-Methode auf den Pinsel an.

• Ruft die TranslateTransform-Methode auf, um das Pinselrechteck so zu verschieben, dass es das zuvor auf dem Bildschirm gezeichnete nicht überlagert.

• Zeichnet das transformierte Pinselrechteck auf den Bildschirm.

Beachten Sie, dass sich die maximale Mittelfarbe (Rot) halb vom Mittelpunkt des Pfads zur Pfadgrenze befindet.

public:
   void SetSigmaBellShapeExample( PaintEventArgs^ e )
   {
      // Create a graphics path and add a rectangle.
      GraphicsPath^ myPath = gcnew GraphicsPath;
      Rectangle rect = Rectangle(100,20,100,50);
      myPath->AddRectangle( rect );

      // Get the path's array of points.
      array<PointF>^myPathPointArray = myPath->PathPoints;

      // Create a path gradient brush.
      PathGradientBrush^ myPGBrush = gcnew PathGradientBrush( myPathPointArray );

      // Set the color span.
      myPGBrush->CenterColor = Color::Red;
      array<Color>^ mySurroundColor = {Color::Blue};
      myPGBrush->SurroundColors = mySurroundColor;

      // Draw the brush to the screen prior to blend.
      e->Graphics->FillRectangle( myPGBrush, 10, 10, 200, 200 );

      // Set the Blend factors and transform the brush.
      myPGBrush->SetSigmaBellShape( 0.5f, 1.0f );

      // Move the brush down by 100 by applying the translate
      // transform to the brush.
      myPGBrush->TranslateTransform( 0, 100, MatrixOrder::Append );

      // Draw the brush to the screen again after setting the
      // blend and applying the transform.
      e->Graphics->FillRectangle( myPGBrush, 10, 10, 300, 300 );
   }

public void SetSigmaBellShapeExample(PaintEventArgs e)
{
             
    // Create a graphics path and add a rectangle.
    GraphicsPath myPath = new GraphicsPath();
    Rectangle rect = new Rectangle(100, 20, 100, 50);
    myPath.AddRectangle(rect);
             
    // Get the path's array of points.
    PointF[] myPathPointArray = myPath.PathPoints;
             
    // Create a path gradient brush.
    PathGradientBrush myPGBrush = new
        PathGradientBrush(myPathPointArray);
             
    // Set the color span.
    myPGBrush.CenterColor = Color.Red;
    Color[] mySurroundColor = {Color.Blue};
    myPGBrush.SurroundColors = mySurroundColor;
             
    // Draw the brush to the screen prior to blend.
    e.Graphics.FillRectangle(myPGBrush, 10, 10, 200, 200);
             
    // Set the Blend factors and transform the brush.
    myPGBrush.SetSigmaBellShape(0.5f, 1.0f);
             
    // Move the brush down by 100 by applying the translate
    // transform to the brush.
    myPGBrush.TranslateTransform(0, 100, MatrixOrder.Append);
             
    // Draw the brush to the screen again after setting the
    // blend and applying the transform.
    e.Graphics.FillRectangle(myPGBrush, 10, 10, 300, 300);
}

Public Sub SetSigmaBellShapeExample(ByVal e As PaintEventArgs)

    ' Create a graphics path and add a rectangle.
    Dim myPath As New GraphicsPath
    Dim rect As New Rectangle(100, 20, 100, 50)
    myPath.AddRectangle(rect)

    ' Get the path's array of points.
    Dim myPathPointArray As PointF() = myPath.PathPoints

    ' Create a path gradient brush.
    Dim myPGBrush As New PathGradientBrush(myPathPointArray)

    ' Set the color span.
    myPGBrush.CenterColor = Color.Red
    Dim mySurroundColor As Color() = {Color.Blue}
    myPGBrush.SurroundColors = mySurroundColor

    ' Draw the brush to the screen prior to blend.
    e.Graphics.FillRectangle(myPGBrush, 10, 10, 200, 200)

    ' Set the Blend factors.
    myPGBrush.SetSigmaBellShape(0.5F, 1.0F)

    ' Move the brush down by 100 by applying the translate
    ' transform to the brush.
    myPGBrush.TranslateTransform(0, 100, MatrixOrder.Append)

    ' Draw the brush to the screen again after setting the
    ' blend and applying the transform.
    e.Graphics.FillRectangle(myPGBrush, 10, 10, 300, 300)
End Sub

Hinweise

Wenn im SurroundColors Array mehr als eine Farbe vorhanden ist, wird die erste Farbe im Array für die Endfarbe verwendet. Die in diesem Array angegebenen Farben sind Farben, die für diskrete Punkte auf dem Begrenzungspfad des Pinsels verwendet werden.

Wenn Sie von der Grenze eines Pfadverlaufs zum Mittelpunkt wechseln, ändert sich die Farbe standardmäßig schrittweise von der Begrenzungsfarbe in die Mittelfarbe. Sie können die Positionierung und Vermischung der Begrenzungs- und Mittelfarben anpassen, indem Sie diese Methode aufrufen.