ImageAttributes.SetGamma メソッド

定義

ガンマ値を設定します。

オーバーロード

SetGamma(Single)

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

SetGamma(Single, ColorAdjustType)

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

SetGamma(Single)

ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs
ソース:
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
ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs
ソース:
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 モニターや、産業環境やウィンドウ ディスプレイなど、通常とは異なる照明条件にあるモニターに役立つ場合があります。

適用対象