ImageAttributes.SetThreshold Méthode

Définition

Espace de noms:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v9.0.0-preview.5.24306.5

Définit le seuil (plage de transparence).

Surcharges

SetThreshold(Single)	Définit le seuil (plage de transparence) pour la catégorie par défaut.
SetThreshold(Single, ColorAdjustType)	Définit le seuil (plage de transparence) d’une catégorie spécifiée.

SetThreshold(Single)

Source:

ImageAttributes.cs

Définit le seuil (plage de transparence) pour la catégorie par défaut.

public:
 void SetThreshold(float threshold);

public void SetThreshold (float threshold);

member this.SetThreshold : single -> unit

Public Sub SetThreshold (threshold As Single)

Paramètres

threshold

Single

Nombre réel qui spécifie la valeur de seuil.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

1. Ouvre un Image et le dessine à l’écran.

2. Crée un objet ImageAttributes et définit son seuil à l’aide de la méthode SetThreshold.

3. Dessine l’image à l’écran à l’aide du seuil de l’objet 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

Remarques

Le seuil est une valeur comprise entre 0 et 1 qui spécifie un point de coupure pour chaque composant de couleur. Par exemple, supposons que le seuil est défini sur 0,7 et que vous affichez une couleur dont les composants rouges, verts et bleus sont respectivement 230, 50 et 220. Le composant rouge (230) est supérieur à 0,7 x 255, de sorte que le composant rouge sera remplacé par 255 (intensité totale). Le composant vert (50) est inférieur à 0,7x255. Le composant vert est donc remplacé par 0. Le composant bleu (220) est supérieur à 0,7 x 255, de sorte que le composant bleu sera remplacé par 255.

Un objet ImageAttributes conserve les paramètres de couleur et de nuances de gris pour cinq catégories d’ajustement : par défaut, bitmap, pinceau, stylet et texte. Par exemple, vous pouvez spécifier un seuil pour la catégorie par défaut, un seuil pour la catégorie bitmap, et toujours un seuil différent pour la catégorie de stylet.

Les paramètres d’ajustement de couleur et d’ajustement des nuances de gris par défaut s’appliquent à toutes les catégories qui n’ont pas de paramètres d’ajustement propres. Par exemple, si vous ne spécifiez jamais de paramètres d’ajustement pour la catégorie de stylet, les paramètres par défaut s’appliquent à la catégorie de stylet.

SetThreshold(Single, ColorAdjustType)

Source:

ImageAttributes.cs

Définit le seuil (plage de transparence) d’une catégorie spécifiée.

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)

Paramètres

threshold

Single

Valeur de seuil comprise entre 0.0 et 1.0 utilisée comme point d’arrêt pour trier les couleurs qui seront mappées à une valeur maximale ou minimale.

type

ColorAdjustType

Élément de ColorAdjustType qui spécifie la catégorie pour laquelle le seuil de couleur est défini.

Exemples

Pour obtenir un exemple de code, consultez la méthode SetThreshold(Single).

Remarques

Le seuil est une valeur comprise entre 0 et 1 qui spécifie un point de coupure pour chaque composant de couleur. Par exemple, supposons que le seuil est défini sur 0,7 et que vous affichez une couleur dont les composants rouges, verts et bleus sont respectivement 230, 50 et 220. Le composant rouge (230) est supérieur à 0,7 x 255, de sorte que le composant rouge sera remplacé par 255 (intensité totale). Le composant vert (50) est inférieur à 0,7x255. Le composant vert est donc remplacé par 0. Le composant bleu (220) est supérieur à 0,7 x 255, de sorte que le composant bleu sera remplacé par 255.

Un objet ImageAttributes conserve les paramètres de couleur et de nuances de gris pour cinq catégories d’ajustement : par défaut, bitmap, pinceau, stylet et texte. Par exemple, vous pouvez spécifier un seuil pour la catégorie par défaut, un seuil pour la catégorie bitmap, et toujours un seuil différent pour la catégorie de stylet.

Les paramètres d’ajustement de couleur et d’ajustement des nuances de gris par défaut s’appliquent à toutes les catégories qui n’ont pas de paramètres d’ajustement propres. Par exemple, si vous ne spécifiez jamais de paramètres d’ajustement pour la catégorie de stylet, les paramètres par défaut s’appliquent à la catégorie de stylet.

Dès que vous spécifiez un paramètre d’ajustement de couleur ou d’ajustement des nuances de gris pour une certaine catégorie, les paramètres d’ajustement par défaut ne s’appliquent plus à cette catégorie. Par exemple, supposons que vous spécifiez une collection de paramètres d’ajustement pour la catégorie par défaut. Si vous définissez le seuil de la catégorie de stylet en passant Pen à la méthode SetThreshold, aucun des paramètres d’ajustement par défaut ne s’applique aux stylets.