ImageAttributes.SetGamma Metodo

Definizione

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)

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 PaintEventArgs e , 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 oggetto Image che usa il file Camera.jpg e lo disegna sullo schermo usando il valore predefinito per gamma.

  2. Crea un ImageAttributes oggetto e ne 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' ImageAttributes oggetto.

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 da 0,1 a 5,0 potrebbero risultare utili in alcune circostanze.

Un ImageAttributes oggetto mantiene le impostazioni relative ai colori e alle gradazioni di grigio per cinque categorie di regolazione: predefinita, bitmap, pennello, penna e testo. 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 Pen.

Le impostazioni predefinite per la regolazione del colore e la regolazione delle gradazioni di grigio si applicano a tutte le categorie per le quali non sono disponibili impostazioni di regolazione. Se, ad esempio, non si specificano mai impostazioni di regolazione per la categoria Pen, le impostazioni predefinite verranno applicate alla categoria Pen.

I valori gamma al di fuori dell'intervallo usuale possono essere utili per i monitoraggi CRT precedenti o per i monitoraggi che si trovano in condizioni di illuminazione insolite, ad esempio ambienti industriali o schermi di finestra.

Si applica a

SetGamma(Single, ColorAdjustType)

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 da 0,1 a 5,0 potrebbero risultare utili in alcune circostanze.

Un ImageAttributes oggetto mantiene le impostazioni relative ai colori e alle gradazioni di grigio per cinque categorie di regolazione: predefinita, bitmap, pennello, penna e testo. 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 Pen.

Le impostazioni predefinite per la regolazione del colore e la regolazione delle gradazioni di grigio si applicano a tutte le categorie per le quali non sono disponibili impostazioni di regolazione. Se, ad esempio, non si specificano mai impostazioni di regolazione per la categoria Pen, le impostazioni predefinite verranno applicate alla categoria Pen.

Non appena si specifica un'impostazione di regolazione del colore o di regolazione delle gradazioni di grigio per una determinata categoria, le impostazioni di regolazione predefinite non sono più valide per 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 Pen passando Pen al SetGamma metodo, nessuna delle impostazioni di regolazione predefinite si applicherà alle penne.

I valori gamma al di fuori dell'intervallo usuale possono essere utili per i monitoraggi CRT precedenti o per i monitoraggi che si trovano in condizioni di illuminazione insolite, ad esempio ambienti industriali o schermi di finestra.

Si applica a