ImageAttributes.SetThreshold Método

Definição

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Define o limite (intervalo de transparência).

Sobrecargas

SetThreshold(Single)	Define o limite (intervalo de transparência) para a categoria padrão.
SetThreshold(Single, ColorAdjustType)	Define o limite (intervalo de transparência) para uma categoria especificada.

SetThreshold(Single)

Define o limite (intervalo de transparência) para a categoria padrão.

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

Um número real que especifica o valor limite.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

1. Abre um Image e desenha-o para a tela.

2. Cria um ImageAttributes objeto e define seu limite usando o SetThreshold método .

3. Desenha a imagem para a tela usando o limite do ImageAttributes objeto .

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

Comentários

O limite é um valor de 0 a 1 que especifica um ponto de corte para cada componente de cor. Por exemplo, suponha que o limite seja definido como 0,7 e suponha que você esteja renderizando uma cor cujos componentes vermelho, verde e azul são 230, 50 e 220, respectivamente. O componente vermelho (230) é maior que 0,7x255, portanto, o componente vermelho será alterado para 255 (intensidade total). O componente verde (50) é menor que 0,7x255, portanto, o componente verde será alterado para 0. O componente azul (220) é maior que 0,7x255, portanto, o componente azul será alterado para 255.

Um ImageAttributes objeto mantém as configurações de cor e escala de cinza para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto. Por exemplo, você pode especificar um limite para a categoria padrão, um limite para a categoria bitmap e ainda um limite diferente para a categoria de caneta.

As configurações padrão de ajuste de cor e ajuste de escala de cinza se aplicam a todas as categorias que não têm configurações de ajuste próprias. Por exemplo, se você nunca especificar nenhuma configuração de ajuste para a categoria de caneta, as configurações padrão se aplicarão à categoria de caneta.

SetThreshold(Single, ColorAdjustType)

Define o limite (intervalo de transparência) para uma categoria 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

Um valor de limite de 0.0 a 1.0 que é usado como um ponto de interrupção para classificar cores que serão mapeadas para um valor mínimo ou máximo.

type

ColorAdjustType

Um elemento de ColorAdjustType que especifica a categoria para a qual o limite de cor é definido.

Exemplos

Para obter um exemplo de código, consulte o SetThreshold(Single) método .

Comentários

O limite é um valor de 0 a 1 que especifica um ponto de corte para cada componente de cor. Por exemplo, suponha que o limite seja definido como 0,7 e suponha que você esteja renderizando uma cor cujos componentes vermelho, verde e azul são 230, 50 e 220, respectivamente. O componente vermelho (230) é maior que 0,7x255, portanto, o componente vermelho será alterado para 255 (intensidade total). O componente verde (50) é menor que 0,7x255, portanto, o componente verde será alterado para 0. O componente azul (220) é maior que 0,7x255, portanto, o componente azul será alterado para 255.

Um ImageAttributes objeto mantém as configurações de cor e escala de cinza para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto. Por exemplo, você pode especificar um limite para a categoria padrão, um limite para a categoria bitmap e ainda um limite diferente para a categoria de caneta.

As configurações padrão de ajuste de cor e ajuste de escala de cinza se aplicam a todas as categorias que não têm configurações de ajuste próprias. Por exemplo, se você nunca especificar nenhuma configuração de ajuste para a categoria de caneta, as configurações padrão se aplicarão à categoria de caneta.

Assim que você especificar uma configuração de ajuste de cor ou ajuste de escala de cinza para uma determinada categoria, as configurações de ajuste padrão não se aplicam mais a essa categoria. Por exemplo, suponha que você especifique uma coleção de configurações de ajuste para a categoria padrão. Se você definir o limite para a categoria de caneta passando Pen para o SetThreshold método , nenhuma das configurações de ajuste padrão se aplicará a canetas.