ImageAttributes.SetGamma Método

Definición

Espacio de nombres:

System.Drawing.Imaging

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Establece el valor gamma.

Sobrecargas

SetGamma(Single)	Establece el valor gamma de la categoría predeterminada.
SetGamma(Single, ColorAdjustType)	Establece el valor gamma de la categoría especificada.

SetGamma(Single)

Source:

ImageAttributes.cs

Establece el valor gamma de la categoría predeterminada.

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

Valor de corrección gamma.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del Paint controlador de eventos. Además, debe cambiar la ruta de acceso del archivo de imagen a una ruta de acceso y un nombre de imagen válidos en el sistema. El código realiza las siguientes acciones:

1. Abre un Image objeto que usa el archivo Camera.jpg y lo dibuja en la pantalla con el valor predeterminado para gamma.

2. Crea un ImageAttributes objeto y establece su gamma en 2.2 llamando al SetGamma método .

3. Dibuja la imagen (una segunda cámara) en la pantalla utilizando el valor gamma que se acaba de establecer en el ImageAttributes objeto .

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

Comentarios

Los valores típicos del gamma parámetro son de 1,0 a 2,2; sin embargo, los valores de 0,1 a 5,0 podrían resultar útiles en algunas circunstancias.

Un ImageAttributes objeto mantiene la configuración de color y escala de grises para cinco categorías de ajuste: predeterminado, mapa de bits, pincel, lápiz y texto. Por ejemplo, puede especificar un valor gamma para la categoría predeterminada, un valor gamma diferente para la categoría de mapa de bits y un valor gamma diferente para la categoría de lápiz.

La configuración predeterminada de ajuste de color y ajuste de escala de grises se aplica a todas las categorías que no tienen ajustes de ajuste propios. Por ejemplo, si nunca especifica ninguna configuración de ajuste para la categoría de lápiz, la configuración predeterminada se aplica a la categoría de lápiz.

Los valores gamma fuera del rango habitual pueden ser útiles para monitores CRT antiguos o para monitores que se encuentran en condiciones de iluminación inusuales, como entornos industriales o pantallas de ventana.

SetGamma(Single, ColorAdjustType)

Source:

ImageAttributes.cs

Establece el valor gamma de la categoría 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

Valor de corrección gamma.

type

ColorAdjustType

Elemento de ColorAdjustType que especifica la categoría cuyo valor gamma se establece.

Ejemplos

Para obtener un ejemplo de código, vea el SetGamma(Single) método .

Comentarios

Los valores típicos del gamma parámetro son de 1,0 a 2,2; sin embargo, los valores de 0,1 a 5,0 podrían resultar útiles en algunas circunstancias.

Un ImageAttributes objeto mantiene la configuración de color y escala de grises para cinco categorías de ajuste: predeterminado, mapa de bits, pincel, lápiz y texto. Por ejemplo, puede especificar un valor gamma para la categoría predeterminada, un valor gamma diferente para la categoría de mapa de bits y un valor gamma diferente para la categoría de lápiz.

La configuración predeterminada de ajuste de color y ajuste de escala de grises se aplica a todas las categorías que no tienen ajustes de ajuste propios. Por ejemplo, si nunca especifica ninguna configuración de ajuste para la categoría de lápiz, la configuración predeterminada se aplica a la categoría de lápiz.

En cuanto especifique un ajuste de color o ajuste de escala de grises para una categoría determinada, la configuración de ajuste predeterminada ya no se aplica a esa categoría. Por ejemplo, supongamos que especifica una colección de opciones de ajuste para la categoría predeterminada. Si establece el valor gamma para la categoría de lápiz pasando Pen al SetGamma método , ninguno de los ajustes de ajuste predeterminados se aplicará a los lápices.

Los valores gamma fuera del rango habitual pueden ser útiles para monitores CRT antiguos o para monitores que se encuentran en condiciones de iluminación inusuales, como entornos industriales o pantallas de ventana.