ImageAttributes.SetThreshold Metodo

Definizione

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
Origine:
ImageAttributes.cs
Origine:
ImageAttributes.cs
Origine:
ImageAttributes.cs
Origine:
ImageAttributes.cs

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

public void SetThreshold (float threshold);

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.

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);    
}

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.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

SetThreshold(Single, ColorAdjustType)

Origine:
ImageAttributes.cs
Origine:
ImageAttributes.cs
Origine:
ImageAttributes.cs
Origine:
ImageAttributes.cs
Origine:
ImageAttributes.cs

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

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

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.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9