ImageAttributes.SetGamma Metoda

Definicja

Przestrzeń nazw:

System.Drawing.Imaging

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v9.0.0-rc.1.24451.1

Ustawia wartość gamma.

Przeciążenia

SetGamma(Single)	Ustawia wartość gamma dla kategorii domyślnej.
SetGamma(Single, ColorAdjustType)	Ustawia wartość gamma dla określonej kategorii.

SetGamma(Single)

Źródło:

ImageAttributes.cs

Ustawia wartość gamma dla kategorii domyślnej.

public:
 void SetGamma(float gamma);

public void SetGamma (float gamma);

member this.SetGamma : single -> unit

Public Sub SetGamma (gamma As Single)

Parametry

gamma

Single

Wartość korekty gamma.

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z formularzami Systemu Windows i wymaga PaintEventArgse, który jest parametrem programu obsługi zdarzeń Paint. Ponadto należy zmienić ścieżkę pliku obrazu na ścieżkę i nazwę obrazu prawidłową w systemie. Kod wykonuje następujące akcje:

1. Otwiera Image, który używa Camera.jpg pliku i rysuje go na ekranie przy użyciu wartości domyślnej gamma.

2. Tworzy obiekt ImageAttributes i ustawia jego gamma na wartość 2.2, wywołując metodę SetGamma.

3. Rysuje obraz (drugi aparat) na ekran przy użyciu wartości gamma ustawionej właśnie w obiekcie 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

Uwagi

Typowe wartości parametru gamma to od 1.0 do 2.2; jednak wartości z zakresu od 0,1 do 5,0 mogą okazać się przydatne w pewnych okolicznościach.

Obiekt ImageAttributes zachowuje ustawienia koloru i skali szarości dla pięciu kategorii korekty: domyślne, mapy bitowej, pędzla, pióra i tekstu. Można na przykład określić wartość gamma dla kategorii domyślnej, inną wartość gamma dla kategorii mapy bitowej i nadal inną wartość gamma dla kategorii pióra.

Domyślne ustawienia korekty kolorów i korekty skali szarości mają zastosowanie do wszystkich kategorii, które nie mają własnych ustawień korekty. Jeśli na przykład nigdy nie określisz żadnych ustawień korekty dla kategorii pióra, ustawienia domyślne będą stosowane do kategorii pióra.

Wartości gamma poza zwykłym zakresem mogą być przydatne dla starych monitorów CRT lub monitorów, które są w nietypowych warunkach oświetleniowych, takich jak środowiska przemysłowe lub wyświetlacze okienne.

SetGamma(Single, ColorAdjustType)

Źródło:

ImageAttributes.cs

Ustawia wartość gamma dla określonej kategorii.

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)

Parametry

gamma

Single

Wartość korekty gamma.

type

ColorAdjustType

Element wyliczenia ColorAdjustType, który określa kategorię, dla której ustawiono wartość gamma.

Przykłady

Aby zapoznać się z przykładem kodu, zobacz metodę SetGamma(Single).

Uwagi

Typowe wartości parametru gamma to od 1.0 do 2.2; jednak wartości z zakresu od 0,1 do 5,0 mogą okazać się przydatne w pewnych okolicznościach.

Obiekt ImageAttributes zachowuje ustawienia koloru i skali szarości dla pięciu kategorii korekty: domyślne, mapy bitowej, pędzla, pióra i tekstu. Można na przykład określić wartość gamma dla kategorii domyślnej, inną wartość gamma dla kategorii mapy bitowej i nadal inną wartość gamma dla kategorii pióra.

Domyślne ustawienia korekty kolorów i korekty skali szarości mają zastosowanie do wszystkich kategorii, które nie mają własnych ustawień korekty. Jeśli na przykład nigdy nie określisz żadnych ustawień korekty dla kategorii pióra, ustawienia domyślne będą stosowane do kategorii pióra.

Gdy tylko określisz ustawienie korekty kolorów lub korekty skali szarości dla określonej kategorii, domyślne ustawienia korekty nie będą już stosowane do tej kategorii. Załóżmy na przykład, że określisz kolekcję ustawień korekty dla kategorii domyślnej. Jeśli ustawisz wartość gamma dla kategorii pióra, przekazując Pen do metody SetGamma, żadne z domyślnych ustawień korekty nie będzie miało zastosowania do piór.

Wartości gamma poza zwykłym zakresem mogą być przydatne dla starych monitorów CRT lub monitorów, które są w nietypowych warunkach oświetleniowych, takich jak środowiska przemysłowe lub wyświetlacze okienne.