ImageAttributes.SetGamma Método

Definição

Define o valor gama.Sets the gamma value.

Sobrecargas

SetGamma(Single)

Define o valor de gama para a categoria padrão.Sets the gamma value for the default category.

SetGamma(Single, ColorAdjustType)

Define o valor gama para uma categoria especificada.Sets the gamma value for a specified category.

SetGamma(Single)

Define o valor de gama para a categoria padrão.Sets the gamma value for the default category.

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 de correção gama.The gamma correction value.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms, e ele requer PaintEventArgs e , que é um parâmetro do Paint manipulador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Além disso, você precisa alterar o caminho do arquivo de imagem para um caminho e o nome da imagem válidos no sistema.In addition, you need to change the image file path to a path and image name valid on your system. O código executa as seguintes ações:The code performs the following actions:

  1. Abre um Image que usa o arquivo Camera.jpg e o desenha na tela usando o valor padrão para gama.Opens an Image that uses the file Camera.jpg and draws it to the screen using the default value for gamma.

  2. Cria um ImageAttributes objeto e define seu gama como 2,2 chamando o SetGamma método.Creates an ImageAttributes object and sets its gamma to 2.2 by calling the SetGamma method.

  3. Desenha a imagem (uma segunda câmera) na tela usando o valor de gama apenas definido no ImageAttributes objeto.Draws the image (a second camera) to the screen using the gamma value just set in the ImageAttributes object.

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 para o gamma parâmetro são de 1,0 a 2,2; no entanto, os valores de 0,1 a 5,0 podem ser úteis em algumas circunstâncias.Typical values for the gamma parameter are from 1.0 to 2.2; however, values from 0.1 to 5.0 could prove useful in some circumstances.

Um ImageAttributes objeto mantém as configurações de cor e escala de cinza para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto.An ImageAttributes object maintains color and grayscale settings for five adjustment categories: default, bitmap, brush, pen, and text. Por exemplo, você pode especificar um valor de gama para a categoria padrão, um valor de gama diferente para a categoria de bitmap e ainda um valor de gama diferente para a categoria de caneta.For example, you can specify a gamma value for the default category, a different gamma value for the bitmap category, and still a different gamma value for the pen category.

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 suas próprias configurações de ajuste.The default color-adjustment and grayscale-adjustment settings apply to all categories that do not have adjustment settings of their own. Por exemplo, se você nunca especificar configurações de ajuste para a categoria de caneta, as configurações padrão serão aplicadas à categoria caneta.For example, if you never specify any adjustment settings for the pen category, the default settings apply to the pen category.

Os valores de gama fora do intervalo usual 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.Gamma values outside the usual range may be useful for old CRT monitors or for monitors that are in unusual lighting conditions, such as industrial environments or window displays.

Aplica-se a

SetGamma(Single, ColorAdjustType)

Define o valor gama para uma categoria especificada.Sets the gamma value for a specified category.

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 de correção gama.The gamma correction value.

type
ColorAdjustType

Um elemento da enumeração ColorAdjustType que especifica a categoria para a qual o valor gama é definido.An element of the ColorAdjustType enumeration that specifies the category for which the gamma value is set.

Exemplos

Para obter um exemplo de código, consulte o SetGamma(Single) método.For a code example, see the SetGamma(Single) method.

Comentários

Os valores típicos para o gamma parâmetro são de 1,0 a 2,2; no entanto, os valores de 0,1 a 5,0 podem ser úteis em algumas circunstâncias.Typical values for the gamma parameter are from 1.0 to 2.2; however, values from 0.1 to 5.0 could prove useful in some circumstances.

Um ImageAttributes objeto mantém as configurações de cor e escala de cinza para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto.An ImageAttributes object maintains color and grayscale settings for five adjustment categories: default, bitmap, brush, pen, and text. Por exemplo, você pode especificar um valor de gama para a categoria padrão, um valor de gama diferente para a categoria de bitmap e ainda um valor de gama diferente para a categoria de caneta.For example, you can specify a gamma value for the default category, a different gamma value for the bitmap category, and still a different gamma value for the pen category.

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 suas próprias configurações de ajuste.The default color-adjustment and grayscale-adjustment settings apply to all categories that do not have adjustment settings of their own. Por exemplo, se você nunca especificar configurações de ajuste para a categoria de caneta, as configurações padrão serão aplicadas à categoria caneta.For example, if you never specify any adjustment settings for the pen category, the default settings apply to the pen category.

Assim que você especificar uma configuração de ajuste de cor ou de escala de cinza para uma determinada categoria, as configurações de ajuste padrão não se aplicarão mais a essa categoria.As soon as you specify a color-adjustment or grayscale-adjustment setting for a certain category, the default adjustment settings no longer apply to that category. Por exemplo, suponha que você especifique uma coleção de configurações de ajuste para a categoria padrão.For example, suppose you specify a collection of adjustment settings for the default category. Se você definir o valor de gama para a categoria de caneta passando Pen para o SetGamma método, nenhuma das configurações de ajuste padrão será aplicada às canetas.If you set the gamma value for the pen category by passing Pen to the SetGamma method, none of the default adjustment settings will apply to pens.

Os valores de gama fora do intervalo usual 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.Gamma values outside the usual range may be useful for old CRT monitors or for monitors that are in unusual lighting conditions, such as industrial environments or window displays.

Aplica-se a