ImageAttributes.SetGamma Método

Definição

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Pacote:

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

Define o valor gama.

Sobrecargas

SetGamma(Single)	Define o valor gama para a categoria padrão.
SetGamma(Single, ColorAdjustType)	Define o valor gama para uma categoria especificada.

SetGamma(Single)

Origem:

ImageAttributes.cs

Define o valor gama para a categoria padrão.

public:
 void SetGamma(float gamma);

public void SetGamma (float gamma);

member this.SetGamma : single -> unit

Public Sub SetGamma (gamma As Single)

Parâmetros

gamma

Single

O valor da correção gama.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. Além disso, você precisa alterar o caminho do arquivo de imagem para um caminho e um nome de imagem válido em seu sistema. O código executa as seguintes ações:

1. Abre um Image que usa o arquivo Camera.jpg e o desenha para a tela usando o valor padrão para gama.

2. Cria um objeto ImageAttributes e define seu gama como 2.2 chamando o método SetGamma.

3. Desenha a imagem (uma segunda câmera) para a tela usando o valor gama definido apenas no objeto 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

Comentários

Os valores típicos do parâmetro gamma são de 1,0 a 2,2; no entanto, valores de 0,1 a 5,0 podem ser úteis em algumas circunstâncias.

Um objeto ImageAttributes mantém as configurações de cor e escala de cinza para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto. Por exemplo, você pode especificar um valor gama para a categoria padrão, um valor gama diferente para a categoria bitmap e ainda um valor gama diferente para a categoria de caneta.

As configurações padrão de ajuste de cor e ajuste de escala de cinza se aplicam a todas as categorias que não têm configurações de ajuste próprias. Por exemplo, se você nunca especificar nenhuma configuração de ajuste para a categoria de caneta, as configurações padrão se aplicarão à categoria de caneta.

Valores gama fora do intervalo habitual podem ser úteis para monitores crt antigos ou para monitores que estão em condições de iluminação incomuns, como ambientes industriais ou exibições de janela.

SetGamma(Single, ColorAdjustType)

Origem:

ImageAttributes.cs

Define o valor gama para uma categoria especificada.

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)

Parâmetros

gamma

Single

O valor da correção gama.

type

ColorAdjustType

Um elemento da enumeração ColorAdjustType que especifica a categoria para a qual o valor gama é definido.

Exemplos

Para obter um exemplo de código, consulte o método SetGamma(Single).

Comentários

Os valores típicos do parâmetro gamma são de 1,0 a 2,2; no entanto, valores de 0,1 a 5,0 podem ser úteis em algumas circunstâncias.

Um objeto ImageAttributes mantém as configurações de cor e escala de cinza para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto. Por exemplo, você pode especificar um valor gama para a categoria padrão, um valor gama diferente para a categoria bitmap e ainda um valor gama diferente para a categoria de caneta.

As configurações padrão de ajuste de cor e ajuste de escala de cinza se aplicam a todas as categorias que não têm configurações de ajuste próprias. Por exemplo, se você nunca especificar nenhuma configuração de ajuste para a categoria de caneta, as configurações padrão se aplicarão à categoria de caneta.

Assim que você especificar uma configuração de ajuste de cor ou ajuste de escala de cinza para uma determinada categoria, as configurações de ajuste padrão não se aplicam mais a essa categoria. Por exemplo, suponha que você especifique uma coleção de configurações de ajuste para a categoria padrão. Se você definir o valor gama para a categoria de caneta passando Pen para o método SetGamma, nenhuma das configurações de ajuste padrão será aplicada a canetas.

Valores gama fora do intervalo habitual podem ser úteis para monitores crt antigos ou para monitores que estão em condições de iluminação incomuns, como ambientes industriais ou exibições de janela.