ImageAttributes.SetGamma Método

Definición

Espacio de nombres:

System.Drawing.Imaging

Ensamblado:

System.Drawing.Common.dll

Paquete:

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

Establece el valor gamma.

Sobrecargas

SetGamma(Single)	Establece el valor gamma de la categoría predeterminada.
SetGamma(Single, ColorAdjustType)	Establece el valor gamma de una 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 controlador de eventos Paint. 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 que usa el archivo Camera.jpg y lo dibuja en la pantalla con el valor predeterminado para gamma.

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

3. Dibuja la imagen (una segunda cámara) en la pantalla con el valor gamma que acaba de establecerse en el 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

Comentarios

Los valores típicos del parámetro gamma 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 objeto ImageAttributes 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 valores 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 inusuales de iluminación, como entornos industriales o pantallas de ventana.

SetGamma(Single, ColorAdjustType)

Source:

ImageAttributes.cs

Establece el valor gamma de una 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 la enumeración ColorAdjustType que especifica la categoría para la que se establece el valor gamma.

Ejemplos

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

Comentarios

Los valores típicos del parámetro gamma 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 objeto ImageAttributes 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 valores 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 determinada categoría, 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 método SetGamma, ninguna de las opciones de ajuste predeterminadas 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 inusuales de iluminación, como entornos industriales o pantallas de ventana.