ImageAttributes.SetThreshold Metodo

Definizione

Spazio dei nomi:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Pacchetto:

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

Imposta la soglia (intervallo di trasparenza).

Overload

SetThreshold(Single)	Imposta la soglia (intervallo di trasparenza) per la categoria predefinita.
SetThreshold(Single, ColorAdjustType)	Imposta la soglia (intervallo di trasparenza) per una categoria specificata.

SetThreshold(Single)

Origine:

ImageAttributes.cs

Imposta la soglia (intervallo di trasparenza) per la categoria predefinita.

public:
 void SetThreshold(float threshold);

public void SetThreshold (float threshold);

member this.SetThreshold : single -> unit

Public Sub SetThreshold (threshold As Single)

Parametri

threshold

Single

Numero reale che specifica il valore soglia.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

1. Apre un Image e lo disegna sullo schermo.

2. Crea un oggetto ImageAttributes e ne imposta la soglia utilizzando il metodo SetThreshold.

3. Disegna l'immagine sullo schermo utilizzando la soglia dell'oggetto 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

Commenti

La soglia è un valore compreso tra 0 e 1 che specifica un punto di ritaglio per ogni componente colore. Si supponga, ad esempio, che la soglia sia impostata su 0,7 e si supponga di eseguire il rendering di un colore i cui componenti rosso, verde e blu sono rispettivamente 230, 50 e 220. Il componente rosso (230) è maggiore di 0,7x255, quindi il componente rosso verrà modificato in 255 (intensità intera). Il componente verde (50) è minore di 0,7x255, quindi il componente verde verrà modificato in 0. Il componente blu (220) è maggiore di 0,7x255, quindi il componente blu verrà modificato in 255.

Un oggetto ImageAttributes mantiene le impostazioni di colore e gradazioni di grigio per cinque categorie di regolazione: default, bitmap, brush, pen e text. Ad esempio, è possibile specificare una soglia per la categoria predefinita, una soglia per la categoria bitmap e ancora una soglia diversa per la categoria di penna.

Le impostazioni predefinite per la regolazione del colore e la regolazione della scala di grigi si applicano a tutte le categorie che non dispongono di impostazioni di regolazione personalizzate. Ad esempio, se non si specificano mai impostazioni di regolazione per la categoria della penna, le impostazioni predefinite si applicano alla categoria della penna.

SetThreshold(Single, ColorAdjustType)

Origine:

ImageAttributes.cs

Imposta la soglia (intervallo di trasparenza) per una categoria specificata.

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)

Parametri

threshold

Single

Valore soglia compreso tra 0,0 e 1,0 utilizzato come punto di interruzione per ordinare i colori di cui verrà eseguito il mapping a un valore massimo o minimo.

type

ColorAdjustType

Elemento di ColorAdjustType che specifica la categoria per cui è impostata la soglia di colore.

Esempio

Per un esempio di codice, vedere il metodo SetThreshold(Single).

Commenti

La soglia è un valore compreso tra 0 e 1 che specifica un punto di ritaglio per ogni componente colore. Si supponga, ad esempio, che la soglia sia impostata su 0,7 e si supponga di eseguire il rendering di un colore i cui componenti rosso, verde e blu sono rispettivamente 230, 50 e 220. Il componente rosso (230) è maggiore di 0,7x255, quindi il componente rosso verrà modificato in 255 (intensità intera). Il componente verde (50) è minore di 0,7x255, quindi il componente verde verrà modificato in 0. Il componente blu (220) è maggiore di 0,7x255, quindi il componente blu verrà modificato in 255.

Un oggetto ImageAttributes mantiene le impostazioni di colore e gradazioni di grigio per cinque categorie di regolazione: default, bitmap, brush, pen e text. Ad esempio, è possibile specificare una soglia per la categoria predefinita, una soglia per la categoria bitmap e ancora una soglia diversa per la categoria di penna.

Le impostazioni predefinite per la regolazione del colore e la regolazione della scala di grigi si applicano a tutte le categorie che non dispongono di impostazioni di regolazione personalizzate. Ad esempio, se non si specificano mai impostazioni di regolazione per la categoria della penna, le impostazioni predefinite si applicano alla categoria della penna.

Non appena si specifica un'impostazione di regolazione del colore o di regolazione della scala di grigi per una determinata categoria, le impostazioni di regolazione predefinite non si applicano più a tale categoria. Si supponga, ad esempio, di specificare una raccolta di impostazioni di regolazione per la categoria predefinita. Se si imposta la soglia per la categoria di penna passando Pen al metodo SetThreshold, nessuna delle impostazioni di regolazione predefinite verrà applicata alle penne.