ImageAttributes.SetGamma Methode

Definition

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Legt den Gammawert fest.

Überlädt

SetGamma(Single)	Legt den Gammawert für die Standardkategorie fest.
SetGamma(Single, ColorAdjustType)	Legt den Gammawert für eine angegebene Kategorie fest.

SetGamma(Single)

Quelle:

ImageAttributes.cs

Legt den Gammawert für die Standardkategorie fest.

public:
 void SetGamma(float gamma);

public void SetGamma (float gamma);

member this.SetGamma : single -> unit

Public Sub SetGamma (gamma As Single)

Parameter

gamma

Single

Der Gammakorrekturwert.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Darüber hinaus müssen Sie den Imagedateipfad in einen Pfad und image-Namen ändern, der auf Ihrem System gültig ist. Der Code führt die folgenden Aktionen aus:

1. Öffnet eine Image , die die Datei Camera.jpg verwendet, und zeichnet sie mithilfe des Standardwerts für Gamma auf den Bildschirm.

2. Erstellt ein ImageAttributes -Objekt und legt sein Gamma auf 2.2 fest, indem die SetGamma -Methode aufgerufen wird.

3. Zeichnet das Bild (eine zweite Kamera) mithilfe des soeben im Objekt festgelegten Gammawerts auf den ImageAttributes Bildschirm.

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

Hinweise

Typische Werte für den gamma Parameter sind 1,0 bis 2,2. Werte von 0,1 bis 5,0 können sich jedoch unter bestimmten Umständen als nützlich erweisen.

Ein ImageAttributes Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Sie können beispielsweise einen Gammawert für die Standardkategorie, einen anderen Gammawert für die Bitmapkategorie und noch einen anderen Gammawert für die Stiftkategorie angeben.

Die Standardeinstellungen für Farbanpassung und Graustufenanpassung gelten für alle Kategorien, die keine eigenen Anpassungseinstellungen haben. Wenn Sie beispielsweise nie Anpassungseinstellungen für die Stiftkategorie angeben, gelten die Standardeinstellungen für die Stiftkategorie.

Gammawerte außerhalb des üblichen Bereichs können für alte CRT-Monitore oder für Monitore in ungewöhnlichen Lichtverhältnissen wie Industrieumgebungen oder Fensteranzeigen nützlich sein.

SetGamma(Single, ColorAdjustType)

Quelle:

ImageAttributes.cs

Legt den Gammawert für eine angegebene Kategorie fest.

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)

Parameter

gamma

Single

Der Gammakorrekturwert.

type

ColorAdjustType

Ein Element der ColorAdjustType-Enumeration, das die Kategorie angibt, für die der Gammawert festgelegt ist.

Beispiele

Ein Codebeispiel finden Sie in der SetGamma(Single) -Methode.

Hinweise

Typische Werte für den gamma Parameter sind 1,0 bis 2,2. Werte von 0,1 bis 5,0 können sich jedoch unter bestimmten Umständen als nützlich erweisen.

Ein ImageAttributes Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Sie können beispielsweise einen Gammawert für die Standardkategorie, einen anderen Gammawert für die Bitmapkategorie und noch einen anderen Gammawert für die Stiftkategorie angeben.

Die Standardeinstellungen für Farbanpassung und Graustufenanpassung gelten für alle Kategorien, die keine eigenen Anpassungseinstellungen haben. Wenn Sie beispielsweise nie Anpassungseinstellungen für die Stiftkategorie angeben, gelten die Standardeinstellungen für die Stiftkategorie.

Sobald Sie eine Farbanpassungs- oder Graustufenanpassungseinstellung für eine bestimmte Kategorie angeben, gelten die Standardeinstellungseinstellungen nicht mehr für diese Kategorie. Angenommen, Sie geben eine Sammlung von Anpassungseinstellungen für die Standardkategorie an. Wenn Sie den Gammawert für die Stiftkategorie festlegen, indem Sie an die SetGamma -Methode übergebenPen, gilt keine der Standardanpassungseinstellungen für Stifte.

Gammawerte außerhalb des üblichen Bereichs können für alte CRT-Monitore oder für Monitore in ungewöhnlichen Lichtverhältnissen wie Industrieumgebungen oder Fensteranzeigen nützlich sein.