PathGradientBrush.SetSigmaBellShape Método

Definición

Espacio de nombres:

System.Drawing.Drawing2D

Ensamblado:

System.Drawing.Common.dll

Paquete:

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

Crea una caída degradada entre el color central y el primer color circundante basado en una curva con forma de campana.

Sobrecargas

SetSigmaBellShape(Single)	Crea un pincel degradado que cambia el color a partir del centro de la ruta de acceso hacia fuera hasta el límite de la ruta de acceso. La transición de un color a otro se basa en una curva con forma de campana.
SetSigmaBellShape(Single, Single)	Crea un pincel degradado que cambia el color a partir del centro de la ruta de acceso hacia fuera hasta el límite de la ruta de acceso. La transición de un color a otro se basa en una curva con forma de campana.

SetSigmaBellShape(Single)

Source:

PathGradientBrush.cs

Crea un pincel degradado que cambia el color a partir del centro de la ruta de acceso hacia fuera hasta el límite de la ruta de acceso. La transición de un color a otro se basa en una curva con forma de campana.

public:
 void SetSigmaBellShape(float focus);

public void SetSigmaBellShape (float focus);

member this.SetSigmaBellShape : single -> unit

Public Sub SetSigmaBellShape (focus As Single)

Parámetros

focus

Single

Valor comprendido entre 0 y 1 que especifica dónde, a lo largo de cualquier radial desde el centro de la ruta de acceso hasta el límite de la ruta, el color central estará en su máxima intensidad. Un valor de 1 (valor predeterminado) coloca la intensidad más alta en el centro del trazado.

Ejemplos

Para obtener un ejemplo, vea SetSigmaBellShape.

Comentarios

Si hay más de un color en la matriz de SurroundColors, se usa el primer color de la matriz para el color final. Los colores especificados en esta matriz son colores usados para puntos discretos en la ruta de acceso de límite del pincel.

De forma predeterminada, a medida que se mueve del límite de un degradado de ruta al punto central, el color cambia gradualmente del color del límite al color central. Puede personalizar el posicionamiento y la combinación de los colores de límite y centro llamando a este método.

SetSigmaBellShape(Single, Single)

Source:

PathGradientBrush.cs

Crea un pincel degradado que cambia el color a partir del centro de la ruta de acceso hacia fuera hasta el límite de la ruta de acceso. La transición de un color a otro se basa en una curva con forma de 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)

Parámetros

focus

Single

Valor comprendido entre 0 y 1 que especifica dónde, a lo largo de cualquier radial desde el centro de la ruta de acceso hasta el límite de la ruta, el color central estará en su máxima intensidad. Un valor de 1 (valor predeterminado) coloca la intensidad más alta en el centro del trazado.

scale

Single

Valor comprendido entre 0 y 1 que especifica la intensidad máxima del color central que se mezcla con el color de límite. Un valor de 1 provoca la mayor intensidad posible del color central y es el valor predeterminado.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, un objeto de evento OnPaint. El código realiza las siguientes acciones:

• Crea una ruta de acceso de gráficos y agrega un rectángulo a él.

• Crea un PathGradientBrush a partir de los puntos de ruta de acceso (en este ejemplo, los puntos forman un rectángulo, pero podría ser la mayoría de las formas).

• Establece el color central en rojo y el color circundante en azul.

• Dibuja el PathGradientBrush en la pantalla antes de aplicar la transformación de mezcla.

• Aplica la transformación de mezcla al pincel mediante su método SetSigmaBellShape.

• Llama al método TranslateTransform para mover el rectángulo de pincel de forma que no superponga el dibujado a la pantalla anteriormente.

• Dibuja el rectángulo de pincel transformado en la pantalla.

Observe que el color central máximo (rojo) se encuentra a mitad del centro de la ruta de acceso al límite de la ruta de acceso.

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

Comentarios

Si hay más de un color en la matriz de SurroundColors, se usa el primer color de la matriz para el color final. Los colores especificados en esta matriz son colores usados para puntos discretos en la ruta de acceso de límite del pincel.

De forma predeterminada, a medida que se mueve del límite de un degradado de ruta al punto central, el color cambia gradualmente del color del límite al color central. Puede personalizar el posicionamiento y la combinación de los colores de límite y centro llamando a este método.