ImageAttributes.SetGamma Metodo

Definizione

Spazio dei nomi:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Imposta il valore gamma.

Overload

SetGamma(Single)	Imposta il valore gamma per la categoria predefinita.
SetGamma(Single, ColorAdjustType)	Imposta il valore gamma per una categoria specificata.

SetGamma(Single)

Origine:

ImageAttributes.cs

Imposta il valore gamma per la categoria predefinita.

public:
 void SetGamma(float gamma);

public void SetGamma (float gamma);

member this.SetGamma : single -> unit

Public Sub SetGamma (gamma As Single)

Parametri

gamma

Single

Valore di correzione gamma.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgse, che è un parametro del Paint gestore eventi. Inoltre, è necessario modificare il percorso del file di immagine in un percorso e un nome di immagine validi nel sistema. Il codice esegue le azioni seguenti:

1. Apre un Image oggetto che usa il file Camera.jpg e lo disegna sullo schermo usando il valore predefinito per gamma.

2. Crea un ImageAttributes oggetto e imposta la gamma su 2.2 chiamando il SetGamma metodo .

3. Disegna l'immagine (una seconda fotocamera) sullo schermo usando il valore gamma appena impostato nell'oggetto 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

Commenti

I valori tipici per il gamma parametro sono compresi tra 1,0 e 2,2; tuttavia, i valori compresi tra 0,1 e 5,0 potrebbero risultare utili in alcune circostanze.

Un ImageAttributes oggetto mantiene le impostazioni di colore e gradazioni di grigio per cinque categorie di regolazione: default, bitmap, brush, pen e text. Ad esempio, è possibile specificare un valore gamma per la categoria predefinita, un valore gamma diverso per la categoria bitmap e ancora un valore gamma diverso per la categoria della penna.

Le impostazioni predefinite di regolazione dei colori e di regolazione della scala di grigi si applicano a tutte le categorie che non dispongono di impostazioni di regolazione personalizzate. Ad esempio, se non si specificano mai impostazioni di regolazione per la categoria della penna, le impostazioni predefinite si applicano alla categoria della penna.

I valori gamma al di fuori dell'intervallo consueto possono essere utili per i vecchi monitor CRT o per i monitor in condizioni di illuminazione insolite, ad esempio ambienti industriali o schermi finestra.

SetGamma(Single, ColorAdjustType)

Origine:

ImageAttributes.cs

Imposta il valore gamma per una categoria specificata.

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)

Parametri

gamma

Single

Valore di correzione gamma.

type

ColorAdjustType

Elemento dell'enumerazione ColorAdjustType da cui viene specificata la categoria per la quale viene impostato il valore gamma.

Esempio

Per un esempio di codice, vedere il SetGamma(Single) metodo .

Commenti

I valori tipici per il gamma parametro sono compresi tra 1,0 e 2,2; tuttavia, i valori compresi tra 0,1 e 5,0 potrebbero risultare utili in alcune circostanze.

Un ImageAttributes oggetto mantiene le impostazioni di colore e gradazioni di grigio per cinque categorie di regolazione: default, bitmap, brush, pen e text. Ad esempio, è possibile specificare un valore gamma per la categoria predefinita, un valore gamma diverso per la categoria bitmap e ancora un valore gamma diverso per la categoria della penna.

Le impostazioni predefinite di regolazione dei colori e di regolazione della scala di grigi si applicano a tutte le categorie che non dispongono di impostazioni di regolazione personalizzate. Ad esempio, se non si specificano mai impostazioni di regolazione per la categoria della penna, le impostazioni predefinite si applicano alla categoria della penna.

Non appena si specifica un'impostazione di regolazione del colore o di regolazione della scala di grigi per una determinata categoria, le impostazioni di regolazione predefinite non si applicano più a tale categoria. Si supponga, ad esempio, di specificare una raccolta di impostazioni di regolazione per la categoria predefinita. Se si imposta il valore gamma per la categoria di penna passando Pen al SetGamma metodo , nessuna delle impostazioni di regolazione predefinite verrà applicata alle penne.

I valori gamma al di fuori dell'intervallo consueto possono essere utili per i vecchi monitor CRT o per i monitor in condizioni di illuminazione insolite, ad esempio ambienti industriali o schermi finestra.