ImageAttributes.SetGamma Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit la valeur gamma.
Surcharges
SetGamma(Single) |
Définit la valeur gamma de la catégorie par défaut. |
SetGamma(Single, ColorAdjustType) |
Définit la valeur gamma d’une catégorie spécifiée. |
SetGamma(Single)
- Source:
- ImageAttributes.cs
- Source:
- ImageAttributes.cs
- Source:
- ImageAttributes.cs
- Source:
- ImageAttributes.cs
- Source:
- ImageAttributes.cs
Définit la valeur gamma de 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 gestionnaire d’événements Paint. En outre, vous devez modifier le chemin d’accès du fichier image en chemin d’accès et le nom de l’image valides sur votre système. Le code effectue les actions suivantes :
Ouvre un Image qui utilise le fichier Camera.jpg et le dessine à l’écran à l’aide de la valeur par défaut pour gamma.
Crée un objet ImageAttributes et définit son gamma sur 2.2 en appelant la méthode SetGamma.
Dessine l’image (une deuxième caméra) à l’écran à l’aide de la valeur gamma définie 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 classiques du paramètre gamma
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 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 une valeur gamma pour la catégorie par défaut, une autre valeur gamma pour la catégorie bitmap, et toujours une valeur gamma différente 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.
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, telles que des environnements industriels ou des écrans de fenêtre.
S’applique à
SetGamma(Single, ColorAdjustType)
- Source:
- ImageAttributes.cs
- Source:
- ImageAttributes.cs
- Source:
- ImageAttributes.cs
- Source:
- ImageAttributes.cs
- Source:
- ImageAttributes.cs
Définit la valeur gamma d’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 méthode SetGamma(Single).
Remarques
Les valeurs classiques du paramètre gamma
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 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 une valeur gamma pour la catégorie par défaut, une autre valeur gamma pour la catégorie bitmap, et toujours une valeur gamma différente 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 la valeur gamma de la catégorie de stylet en passant Pen à la méthode SetGamma, aucun des paramètres d’ajustement par défaut ne s’applique aux stylos.
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, telles que des environnements industriels ou des écrans de fenêtre.