PathGradientBrush.SetSigmaBellShape Metodo

Definizione

Spazio dei nomi:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Pacchetto:

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

Crea un falloff sfumato tra il colore centrale e il primo colore circostante in base a una curva a forma di campana.

Overload

SetSigmaBellShape(Single)	Crea un pennello sfumato che cambia colore a partire dal centro del percorso verso l'esterno del limite del percorso. La transizione da un colore a un altro si basa su una curva a forma di campana.
SetSigmaBellShape(Single, Single)	Crea un pennello sfumato che cambia colore a partire dal centro del percorso verso l'esterno del limite del percorso. La transizione da un colore a un altro si basa su una curva a forma di campana.

SetSigmaBellShape(Single)

Origine:

PathGradientBrush.cs

Crea un pennello sfumato che cambia colore a partire dal centro del percorso verso l'esterno del limite del percorso. La transizione da un colore a un altro si basa su una curva a forma di campana.

public:
 void SetSigmaBellShape(float focus);

public void SetSigmaBellShape (float focus);

member this.SetSigmaBellShape : single -> unit

Public Sub SetSigmaBellShape (focus As Single)

Parametri

focus

Single

Valore compreso tra 0 e 1 che specifica dove, lungo qualsiasi radiale dal centro del percorso al limite del percorso, il colore centrale sarà alla massima intensità. Il valore 1 (impostazione predefinita) posiziona l'intensità più alta al centro del percorso.

Esempio

Per un esempio, vedere SetSigmaBellShape.

Commenti

Se nella matrice SurroundColors sono presenti più colori, il primo colore della matrice viene usato per il colore finale. I colori specificati in questa matrice sono colori utilizzati per i punti discreti nel percorso limite del pennello.

Per impostazione predefinita, quando si passa dal limite di una sfumatura di percorso al punto centrale, il colore cambia gradualmente dal colore del limite al colore centrale. È possibile personalizzare il posizionamento e la fusione dei colori del limite e del centro chiamando questo metodo.

SetSigmaBellShape(Single, Single)

Origine:

PathGradientBrush.cs

Crea un pennello sfumato che cambia colore a partire dal centro del percorso verso l'esterno del limite del percorso. La transizione da un colore a un altro si basa su una curva a forma di campana.

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)

Parametri

focus

Single

Valore compreso tra 0 e 1 che specifica dove, lungo qualsiasi radiale dal centro del percorso al limite del percorso, il colore centrale sarà alla massima intensità. Il valore 1 (impostazione predefinita) posiziona l'intensità più alta al centro del percorso.

scale

Single

Valore compreso tra 0 e 1 che specifica l'intensità massima del colore centrale che viene miscelato con il colore limite. Un valore pari a 1 determina la massima intensità possibile del colore centrale ed è il valore predefinito.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, un oggetto evento OnPaint. Il codice esegue le azioni seguenti:

• Crea un percorso grafico e aggiunge un rettangolo.

• Crea un PathGradientBrush dai punti del percorso ,in questo esempio i punti formano un rettangolo, ma potrebbero essere la maggior parte di qualsiasi forma.

• Imposta il colore centrale sul rosso e sul colore circostante su blu.

• Disegna il PathGradientBrush sullo schermo prima di applicare la trasformazione di fusione.

• Applica la trasformazione blend al pennello usando il relativo metodo di SetSigmaBellShape.

• Chiama il metodo TranslateTransform per spostare il rettangolo del pennello in modo che non sovrappone quello disegnato in precedenza allo schermo.

• Disegna il rettangolo del pennello trasformato sullo schermo.

Si noti che il colore centrale massimo (rosso) si trova a metà strada dal centro del percorso al limite del percorso.

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

Commenti

Se nella matrice SurroundColors sono presenti più colori, il primo colore della matrice viene usato per il colore finale. I colori specificati in questa matrice sono colori utilizzati per i punti discreti nel percorso limite del pennello.

Per impostazione predefinita, quando si passa dal limite di una sfumatura di percorso al punto centrale, il colore cambia gradualmente dal colore del limite al colore centrale. È possibile personalizzare il posizionamento e la fusione dei colori del limite e del centro chiamando questo metodo.