ImageAttributes.SetGamma Methode

Definition

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Paket:

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

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 wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Darüber hinaus müssen Sie den Pfad der Bilddatei in einen pfad- und Bildnamen ä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 dessen Gamma auf 2,2 fest, indem die SetGamma -Methode aufgerufen wird.

3. Zeichnet das Bild (eine zweite Kamera) mithilfe des soeben im ImageAttributes-Objekt festgelegten Gammawerts auf den 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 parameter gamma liegen zwischen 1,0 und 2,2; Werte von 0,1 bis 5,0 könnten 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 z. B. einen Gammawert für die Standardkategorie, einen anderen Gammawert für die Bitmapkategorie und dennoch einen anderen Gammawert für die Stiftkategorie angeben.

Die Standardeinstellungen für Farbanpassung und Graustufenanpassung gelten für alle Kategorien, die keine eigenen Anpassungseinstellungen aufweisen. Wenn Sie beispielsweise niemals 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 nützlich sein, die sich in ungewöhnlichen Lichtverhältnissen befinden, z. B. in industriellen Umgebungen oder Fensteranzeigen.

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 wird.

Beispiele

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

Hinweise

Typische Werte für den parameter gamma liegen zwischen 1,0 und 2,2; Werte von 0,1 bis 5,0 könnten 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 z. B. einen Gammawert für die Standardkategorie, einen anderen Gammawert für die Bitmapkategorie und dennoch einen anderen Gammawert für die Stiftkategorie angeben.

Die Standardeinstellungen für Farbanpassung und Graustufenanpassung gelten für alle Kategorien, die keine eigenen Anpassungseinstellungen aufweisen. Wenn Sie beispielsweise niemals 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 Pen an die SetGamma Methode übergeben, gelten keine der Standardanpassungseinstellungen für Stifte.

Gammawerte außerhalb des üblichen Bereichs können für alte CRT-Monitore oder für Monitore nützlich sein, die sich in ungewöhnlichen Lichtverhältnissen befinden, z. B. in industriellen Umgebungen oder Fensteranzeigen.