ImageAttributes.SetThreshold Método

Definição

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Pacote:

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

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)

Origem:

ImageAttributes.cs

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 o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

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

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

3. Desenha a imagem para a tela usando o limite do 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

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 sejam 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 objeto ImageAttributes 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 de 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)

Origem:

ImageAttributes.cs

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 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áximo ou mínimo.

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 método SetThreshold(Single).

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 sejam 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 objeto ImageAttributes 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 de 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 método SetThreshold, nenhuma das configurações de ajuste padrão será aplicada a canetas.