ImageAttributes.SetGamma Méthode

Définition

Espace de noms:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Définit la valeur gamma.

Surcharges

SetGamma(Single)	Définit la valeur gamma pour la catégorie par défaut.
SetGamma(Single, ColorAdjustType)	Définit la valeur gamma pour une catégorie spécifiée.

SetGamma(Single)

Source:

ImageAttributes.cs

Définit la valeur gamma pour la catégorie par défaut.

public:
 void SetGamma(float gamma);

public void SetGamma (float gamma);

member this.SetGamma : single -> unit

Public Sub SetGamma (gamma As Single)

Paramètres

gamma

Single

Valeur de correction gamma.

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. En outre, vous devez remplacer le chemin du fichier image par un chemin d’accès et un nom d’image valides sur votre système. Le code effectue les actions suivantes :

1. Ouvre un Image qui utilise le fichier Camera.jpg et le dessine à l’écran à l’aide de la valeur par défaut pour gamma.

2. Crée un ImageAttributes objet et définit son gamma sur 2.2 en appelant la SetGamma méthode .

3. Dessine l’image (une deuxième caméra) à l’écran à l’aide de la valeur gamma que vous venez de définir dans l’objet ImageAttributes .

private:
   void SetGammaExample( PaintEventArgs^ e )
   {
      // Create an Image object from the file Camera.jpg, and draw it to
      // the screen.
      Image^ myImage = Image::FromFile( "Camera.jpg" );
      e->Graphics->DrawImage( myImage, 20, 20 );

      // Create an ImageAttributes object and set the gamma to 2.2.
      System::Drawing::Imaging::ImageAttributes^ imageAttr = 
          gcnew System::Drawing::Imaging::ImageAttributes;
      imageAttr->SetGamma( 2.2f );

      // Draw the image with gamma set to 2.2.
      Rectangle rect = Rectangle(250,20,200,200);
      e->Graphics->DrawImage( myImage, rect, 0, 0, 200, 200, GraphicsUnit::Pixel, imageAttr );
   }

private void SetGammaExample(PaintEventArgs e)
{
             
    // Create an Image object from the file Camera.jpg, and draw it to
    // the screen.
    Image myImage = Image.FromFile("Camera.jpg");
    e.Graphics.DrawImage(myImage, 20, 20);
             
    // Create an ImageAttributes object and set the gamma to 2.2.
    System.Drawing.Imaging.ImageAttributes imageAttr = 
           new System.Drawing.Imaging.ImageAttributes();
    imageAttr.SetGamma(2.2f);
             
    // Draw the image with gamma set to 2.2.
    Rectangle rect = new Rectangle(250, 20, 200, 200);
    e.Graphics.DrawImage(myImage, rect, 0, 0, 200, 200, 
        GraphicsUnit.Pixel, imageAttr);    
}

Public Sub SetGammaExample(ByVal e As PaintEventArgs)

    ' Create an Image object from the file Camera.jpg, and draw

    ' it to screen.
    Dim myImage As Image = Image.FromFile("Camera.jpg")
    e.Graphics.DrawImage(myImage, 20, 20)

    ' Create an ImageAttributes object and set the gamma to 2.2.
    Dim imageAttr As New System.Drawing.Imaging.ImageAttributes
    imageAttr.SetGamma(2.2F)

    ' Draw the image with gamma set to 2.2.
    Dim rect As New Rectangle(250, 20, 200, 200)
    e.Graphics.DrawImage(myImage, rect, 0, 0, 200, 200, _
    GraphicsUnit.Pixel, imageAttr)
    ' Image
End Sub

Remarques

Les valeurs typiques du gamma paramètre sont comprises entre 1.0 et 2.2 ; toutefois, les valeurs comprises entre 0.1 et 5.0 peuvent s’avérer utiles dans certaines circonstances.

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 une valeur gamma pour la catégorie par défaut, une autre valeur gamma pour la catégorie bitmap et une valeur gamma différente 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.

Les valeurs gamma en dehors de la plage habituelle peuvent être utiles pour les anciens moniteurs CRT ou pour les moniteurs qui se trouvent dans des conditions d’éclairage inhabituelles, comme des environnements industriels ou des écrans de fenêtre.

SetGamma(Single, ColorAdjustType)

Source:

ImageAttributes.cs

Définit la valeur gamma pour une catégorie spécifiée.

public:
 void SetGamma(float gamma, System::Drawing::Imaging::ColorAdjustType type);

public void SetGamma (float gamma, System.Drawing.Imaging.ColorAdjustType type);

member this.SetGamma : single * System.Drawing.Imaging.ColorAdjustType -> unit

Public Sub SetGamma (gamma As Single, type As ColorAdjustType)

Paramètres

gamma

Single

Valeur de correction gamma.

type

ColorAdjustType

Élément de l'énumération ColorAdjustType qui spécifie la catégorie pour laquelle la valeur gamma est définie.

Exemples

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

Remarques

Les valeurs typiques du gamma paramètre sont comprises entre 1.0 et 2.2 ; toutefois, les valeurs comprises entre 0.1 et 5.0 peuvent s’avérer utiles dans certaines circonstances.

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 une valeur gamma pour la catégorie par défaut, une autre valeur gamma pour la catégorie bitmap et une valeur gamma différente 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 la valeur gamma de la catégorie de stylet en passant Pen à la SetGamma méthode , aucun des paramètres d’ajustement par défaut ne s’applique aux stylets.

Les valeurs gamma en dehors de la plage habituelle peuvent être utiles pour les anciens moniteurs CRT ou pour les moniteurs qui se trouvent dans des conditions d’éclairage inhabituelles, comme des environnements industriels ou des écrans de fenêtre.