ImageAttributes.SetThreshold Méthode

Définition

Espace de noms:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

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) pour 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 Paint gestionnaire d’événements. Le code effectue les actions suivantes :

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

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

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 soit défini sur 0,7 et que vous restituiez une couleur dont les composants rouge, vert et bleu sont respectivement 230, 50 et 220. Le composant rouge (230) étant supérieur à 0,7 x 255, le composant rouge sera remplacé par 255 (pleine intensité). Le composant vert (50) étant inférieur à 0,7 x 255, le composant vert sera remplacé par 0. Le composant bleu (220) étant supérieur à 0,7 x 255, le composant bleu sera remplacé par 255.

Un ImageAttributes objet 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 un seuil différent pour la catégorie de stylet.

Les paramètres d’ajustement des couleurs 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) pour 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 qui est utilisée comme point d'arrêt pour trier des 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 SetThreshold(Single) méthode .

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 soit défini sur 0,7 et que vous restituiez une couleur dont les composants rouge, vert et bleu sont respectivement 230, 50 et 220. Le composant rouge (230) étant supérieur à 0,7 x 255, le composant rouge sera remplacé par 255 (pleine intensité). Le composant vert (50) étant inférieur à 0,7 x 255, le composant vert sera remplacé par 0. Le composant bleu (220) étant supérieur à 0,7 x 255, le composant bleu sera remplacé par 255.

Un ImageAttributes objet 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 un seuil différent pour la catégorie de stylet.

Les paramètres d’ajustement des couleurs 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 de réglage 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 pour la catégorie de stylet en passant Pen à la SetThreshold méthode , aucun des paramètres d’ajustement par défaut ne s’applique aux stylets.