ImageAttributes.SetThreshold Método

public:
 void SetThreshold(float threshold);

public void SetThreshold(float threshold);

member this.SetThreshold : single -> unit

Public Sub SetThreshold (threshold As Single)

Parâmetros

Exemplos

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

1. Abre e Image desenha para o ecrã.

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

3. Atrai a imagem para o ecrã usando o limiar 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

Observações

O limiar é um valor de 0 a 1 que especifica um ponto de corte para cada componente de cor. Por exemplo, suponha que o limiar está definido para 0,7, e suponha que está a renderizar uma cor cujos componentes vermelho, verde e azul são 230, 50 e 220, respetivamente. A componente vermelha (230) é superior a 0,7x255, pelo que a componente vermelha será alterada para 255 (intensidade total). O componente verde (50) é inferior a 0,7x255, por isso o componente verde será alterado para 0. O componente azul (220) é superior a 0,7x255, pelo que o componente azul será alterado para 255.

Um ImageAttributes objeto mantém definições de cor e tons de cinzento para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto. Por exemplo, pode especificar um limiar para a categoria padrão, um limiar para a categoria bitmap e ainda um limiar diferente para a categoria caneta.

As definições padrão de ajuste de cor e de escala de cinzentos aplicam-se a todas as categorias que não tenham definições próprias de ajuste. Por exemplo, se nunca especificares definições de ajuste para a categoria de canetas, as definições padrão aplicam-se à categoria de canetas.

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

Exemplos

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

Observações

O limiar é um valor de 0 a 1 que especifica um ponto de corte para cada componente de cor. Por exemplo, suponha que o limiar está definido para 0,7, e suponha que está a renderizar uma cor cujos componentes vermelho, verde e azul são 230, 50 e 220, respetivamente. A componente vermelha (230) é superior a 0,7x255, pelo que a componente vermelha será alterada para 255 (intensidade total). O componente verde (50) é inferior a 0,7x255, por isso o componente verde será alterado para 0. O componente azul (220) é superior a 0,7x255, pelo que o componente azul será alterado para 255.

Um ImageAttributes objeto mantém definições de cor e tons de cinzento para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto. Por exemplo, pode especificar um limiar para a categoria padrão, um limiar para a categoria bitmap e ainda um limiar diferente para a categoria caneta.

As definições padrão de ajuste de cor e de escala de cinzentos aplicam-se a todas as categorias que não tenham definições próprias de ajuste. Por exemplo, se nunca especificares definições de ajuste para a categoria de canetas, as definições padrão aplicam-se à categoria de canetas.

Assim que especificas uma definição de ajuste de cor ou de escala de cinzentos para uma determinada categoria, as definições de ajuste padrão deixam de se aplicar a essa categoria. Por exemplo, suponha que especifica uma coleção de definições de ajuste para a categoria padrão. Se definires o limiar para a categoria de canetas passando Pen para o SetThreshold método, nenhuma das definições de ajuste padrão se aplicará às canetas.