ImageAttributes.SetGamma メソッド

定義

名前空間:

System.Drawing.Imaging

アセンブリ:

System.Drawing.Common.dll

パッケージ:

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

ガンマ値を設定します。

オーバーロード

SetGamma(Single)	既定のカテゴリのガンマ値を設定します。
SetGamma(Single, ColorAdjustType)	指定したカテゴリのガンマ値を設定します。

SetGamma(Single)

ソース:

ImageAttributes.cs

既定のカテゴリのガンマ値を設定します。

public:
 void SetGamma(float gamma);

public void SetGamma (float gamma);

member this.SetGamma : single -> unit

Public Sub SetGamma (gamma As Single)

パラメーター

gamma

Single

ガンマ補正値。

例

次のコード例は Windows フォームで使用できるように設計されており、Paint イベント ハンドラーのパラメーターである PaintEventArgseが必要です。 さらに、イメージ ファイルのパスを、システムで有効なパスとイメージ名に変更する必要があります。 このコードは、次のアクションを実行します。

1. ファイル Camera.jpg を使用する Image を開き、ガンマの既定値を使用して画面に描画します。

2. ImageAttributes オブジェクトを作成し、SetGamma メソッドを呼び出してガンマを 2.2 に設定します。

3. ImageAttributes オブジェクトで設定したガンマ値を使用して、画像 (2 つ目のカメラ) を画面に描画します。

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

注釈

gamma パラメーターの一般的な値は 1.0 から 2.2 です。ただし、0.1 から 5.0 までの値は、状況によっては役に立つことがあります。

ImageAttributes オブジェクトは、既定、ビットマップ、ブラシ、ペン、テキストの 5 つの調整カテゴリの色とグレースケールの設定を維持します。 たとえば、既定のカテゴリのガンマ値、ビットマップ カテゴリに対して異なるガンマ値、ペン カテゴリに対して異なるガンマ値を指定できます。

既定の色調整とグレースケール調整の設定は、独自の調整設定を持たないすべてのカテゴリに適用されます。 たとえば、ペン カテゴリの調整設定を指定しない場合、既定の設定はペン カテゴリに適用されます。

通常の範囲外のガンマ値は、古い CRT モニターや、産業環境やウィンドウ ディスプレイなど、通常とは異なる照明条件にあるモニターに役立つ場合があります。

SetGamma(Single, ColorAdjustType)

ソース:

ImageAttributes.cs

指定したカテゴリのガンマ値を設定します。

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)

パラメーター

gamma

Single

ガンマ補正値。

type

ColorAdjustType

ガンマ値を設定するカテゴリを指定する ColorAdjustType 列挙体の要素。

例

コード例については、SetGamma(Single) メソッドを参照してください。

注釈

gamma パラメーターの一般的な値は 1.0 から 2.2 です。ただし、0.1 から 5.0 までの値は、状況によっては役に立つことがあります。

ImageAttributes オブジェクトは、既定、ビットマップ、ブラシ、ペン、テキストの 5 つの調整カテゴリの色とグレースケールの設定を維持します。 たとえば、既定のカテゴリのガンマ値、ビットマップ カテゴリに対して異なるガンマ値、ペン カテゴリに対して異なるガンマ値を指定できます。

既定の色調整とグレースケール調整の設定は、独自の調整設定を持たないすべてのカテゴリに適用されます。 たとえば、ペン カテゴリの調整設定を指定しない場合、既定の設定はペン カテゴリに適用されます。

特定のカテゴリに対して色調整またはグレースケール調整設定を指定するとすぐに、既定の調整設定がそのカテゴリに適用されなくなります。 たとえば、既定のカテゴリの調整設定のコレクションを指定するとします。 SetGamma メソッドに Pen を渡してペン カテゴリのガンマ値を設定した場合、既定の調整設定はペンに適用されなくなります。

通常の範囲外のガンマ値は、古い CRT モニターや、産業環境やウィンドウ ディスプレイなど、通常とは異なる照明条件にあるモニターに役立つ場合があります。