ImageAttributes.SetThreshold Método

Definición

Espacio de nombres:

System.Drawing.Imaging

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v9.0.0-rc.1.24451.1

Establece el umbral (intervalo de transparencia).

Sobrecargas

SetThreshold(Single)	Establece el umbral (intervalo de transparencia) para la categoría predeterminada.
SetThreshold(Single, ColorAdjustType)	Establece el umbral (intervalo de transparencia) para una categoría especificada.

SetThreshold(Single)

Source:

ImageAttributes.cs

Establece el umbral (intervalo de transparencia) para la categoría predeterminada.

public:
 void SetThreshold(float threshold);

public void SetThreshold (float threshold);

member this.SetThreshold : single -> unit

Public Sub SetThreshold (threshold As Single)

Parámetros

threshold

Single

Número real que especifica el valor de umbral.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos Paint. El código realiza las siguientes acciones:

1. Abre un Image y lo dibuja en la pantalla.

2. Crea un objeto ImageAttributes y establece su umbral mediante el método SetThreshold.

3. Dibuja la imagen en la pantalla mediante el umbral del objeto ImageAttributes.

void SetThresholdExample( PaintEventArgs^ e )
{
   // Open an Image file, and draw it to the screen.
   Image^ myImage = Image::FromFile( "Camera.jpg" );
   e->Graphics->DrawImage( myImage, 20, 20 );

   // Create an ImageAttributes object, and set its color threshold.
   ImageAttributes^ imageAttr = gcnew ImageAttributes;
   imageAttr->SetThreshold( 0.7f );

   // Draw the image with the colors bifurcated.
   Rectangle rect = Rectangle(300,20,200,200);
   e->Graphics->DrawImage( myImage, rect, 0, 0, 200, 200, GraphicsUnit::Pixel, imageAttr );
}

private void SetThresholdExample(PaintEventArgs e)
{
             
    // Open an Image file, and draw it to the screen.
    Image myImage = Image.FromFile("Camera.jpg");
    e.Graphics.DrawImage(myImage, 20, 20);
             
    // Create an ImageAttributes object, and set its color threshold.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetThreshold(0.7f);
             
    // Draw the image with the colors bifurcated.
    Rectangle rect = new Rectangle(300, 20, 200, 200);
    e.Graphics.DrawImage(myImage, rect, 0, 0, 200, 200, 
        GraphicsUnit.Pixel, imageAttr);    
}

Public Sub SetThresholdExample(ByVal e As PaintEventArgs)

    ' Open an Image file, and draw it to the screen.
    Dim myImage As Image = Image.FromFile("Camera.jpg")
    e.Graphics.DrawImage(myImage, 20, 20)

    ' Create an ImageAttributes object, and set its color threshold.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetThreshold(0.7F)

    ' Draw the image with the colors bifurcated.
    Dim rect As New Rectangle(300, 20, 200, 200)
    e.Graphics.DrawImage(myImage, rect, 0, 0, 200, 200, _
    GraphicsUnit.Pixel, imageAttr)
End Sub

Comentarios

El umbral es un valor comprendido entre 0 y 1 que especifica un punto de corte para cada componente de color. Por ejemplo, supongamos que el umbral se establece en 0,7 y que representa un color cuyos componentes rojo, verde y azul son 230, 50 y 220, respectivamente. El componente rojo (230) es mayor que 0,7x255, por lo que el componente rojo se cambiará a 255 (intensidad completa). El componente verde (50) es menor que 0,7x255, por lo que el componente verde se cambiará a 0. El componente azul (220) es mayor que 0,7x255, por lo que el componente azul se cambiará a 255.

Un objeto ImageAttributes mantiene la configuración de color y escala de grises para cinco categorías de ajuste: predeterminado, mapa de bits, pincel, lápiz y texto. Por ejemplo, puede especificar un umbral para la categoría predeterminada, un umbral para la categoría de mapa de bits y un umbral diferente para la categoría de lápiz.

La configuración predeterminada de ajuste de color y ajuste de escala de grises se aplica a todas las categorías que no tienen valores de ajuste propios. Por ejemplo, si nunca especifica ninguna configuración de ajuste para la categoría de lápiz, la configuración predeterminada se aplica a la categoría de lápiz.

SetThreshold(Single, ColorAdjustType)

Source:

ImageAttributes.cs

Establece el umbral (intervalo de transparencia) para una categoría especificada.

public:
 void SetThreshold(float threshold, System::Drawing::Imaging::ColorAdjustType type);

public void SetThreshold (float threshold, System.Drawing.Imaging.ColorAdjustType type);

member this.SetThreshold : single * System.Drawing.Imaging.ColorAdjustType -> unit

Public Sub SetThreshold (threshold As Single, type As ColorAdjustType)

Parámetros

threshold

Single

Valor de umbral de 0,0 a 1,0 que se usa como punto de interrupción para ordenar los colores que se asignarán a un valor máximo o mínimo.

type

ColorAdjustType

Elemento de ColorAdjustType que especifica la categoría para la que se establece el umbral de color.

Ejemplos

Para obtener un ejemplo de código, consulte el método SetThreshold(Single).

Comentarios

El umbral es un valor comprendido entre 0 y 1 que especifica un punto de corte para cada componente de color. Por ejemplo, supongamos que el umbral se establece en 0,7 y que representa un color cuyos componentes rojo, verde y azul son 230, 50 y 220, respectivamente. El componente rojo (230) es mayor que 0,7x255, por lo que el componente rojo se cambiará a 255 (intensidad completa). El componente verde (50) es menor que 0,7x255, por lo que el componente verde se cambiará a 0. El componente azul (220) es mayor que 0,7x255, por lo que el componente azul se cambiará a 255.

Un objeto ImageAttributes mantiene la configuración de color y escala de grises para cinco categorías de ajuste: predeterminado, mapa de bits, pincel, lápiz y texto. Por ejemplo, puede especificar un umbral para la categoría predeterminada, un umbral para la categoría de mapa de bits y un umbral diferente para la categoría de lápiz.

La configuración predeterminada de ajuste de color y ajuste de escala de grises se aplica a todas las categorías que no tienen valores de ajuste propios. Por ejemplo, si nunca especifica ninguna configuración de ajuste para la categoría de lápiz, la configuración predeterminada se aplica a la categoría de lápiz.

En cuanto especifique un ajuste de color o ajuste de escala de grises para una determinada categoría, la configuración de ajuste predeterminada ya no se aplica a esa categoría. Por ejemplo, supongamos que especifica una colección de opciones de ajuste para la categoría predeterminada. Si establece el umbral de la categoría de lápiz pasando Pen al método SetThreshold, ninguno de los valores de ajuste predeterminados se aplicará a los lápices.