ImageAttributes.SetGamma Metodo

Definizione

Spazio dei nomi:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Pacchetto:

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

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 Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Inoltre, è necessario modificare il percorso del file di immagine in un percorso e un nome di immagine valido nel sistema. Il codice esegue le azioni seguenti:

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

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

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 parametro gamma sono compresi tra 1,0 e 2,2; Tuttavia, i valori compresi tra 0,1 e 5,0 potrebbero rivelarsi utili in alcune circostanze.

Un oggetto ImageAttributes 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 un valore gamma diverso per la categoria di penna.

Le impostazioni predefinite per la regolazione del colore e la 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 che si trovano 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 che specifica la categoria per cui è impostato il valore gamma.

Esempio

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

Commenti

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

Un oggetto ImageAttributes 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 un valore gamma diverso per la categoria di penna.

Le impostazioni predefinite per la regolazione del colore e la 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 metodo SetGamma, 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 che si trovano in condizioni di illuminazione insolite, ad esempio ambienti industriali o schermi finestra.