ImageAttributes.SetGamma メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ガンマ値を設定します。
オーバーロード
| 名前 | 説明 |
|---|---|
| SetGamma(Single) |
既定のカテゴリのガンマ値を設定します。 |
| SetGamma(Single, ColorAdjustType) |
指定したカテゴリのガンマ値を設定します。 |
SetGamma(Single)
既定のカテゴリのガンマ値を設定します。
public:
void SetGamma(float gamma);public void SetGamma(float gamma);member this.SetGamma : single -> unitPublic Sub SetGamma (gamma As Single)パラメーター
- gamma
- Single
ガンマ補正値。
例
次のコード例は、Windows フォームで使用するように設計されており、PaintEventArgse が必要です。これは、Paint イベント ハンドラーのパラメーターです。 さらに、イメージ ファイルのパスを、システムで有効なパスとイメージ名に変更する必要があります。 コードは次のアクションを実行します。
ファイル Camera.jpg を使用する Image を開き、ガンマの既定値を使用して画面に描画します。
ImageAttributes メソッドを呼び出して、SetGamma オブジェクトを作成し、そのガンマを 2.2 に設定します。
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)
指定したカテゴリのガンマ値を設定します。
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 -> unitPublic 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 つの調整カテゴリの色とグレースケールの設定を維持します。 たとえば、既定のカテゴリのガンマ値、ビットマップ カテゴリに対して異なるガンマ値、ペン カテゴリに対して異なるガンマ値を指定できます。
既定の色調整とグレースケール調整の設定は、独自の調整設定を持たないすべてのカテゴリに適用されます。 たとえば、ペン カテゴリの調整設定を指定しない場合、既定の設定はペン カテゴリに適用されます。
特定のカテゴリに対して色調整またはグレースケール調整設定を指定するとすぐに、既定の調整設定がそのカテゴリに適用されなくなります。 たとえば、既定のカテゴリの調整設定のコレクションを指定するとします。 Pen メソッドにSetGammaを渡してペン カテゴリのガンマ値を設定した場合、既定の調整設定はペンに適用されなくなります。
通常の範囲外のガンマ値は、古い CRT モニターや、産業環境やウィンドウ ディスプレイなど、通常とは異なる照明条件にあるモニターに役立つ場合があります。
