ImageAttributes.SetThreshold メソッド

定義

名前空間:

System.Drawing.Imaging

アセンブリ:

System.Drawing.Common.dll

パッケージ:

System.Drawing.Common v9.0.0-preview.5.24306.5

しきい値 (透明度の範囲) を設定します。

オーバーロード

SetThreshold(Single)	既定のカテゴリのしきい値 (透明度の範囲) を設定します。
SetThreshold(Single, ColorAdjustType)	指定したカテゴリのしきい値 (透明度の範囲) を設定します。

SetThreshold(Single)

ソース:

ImageAttributes.cs

既定のカテゴリのしきい値 (透明度の範囲) を設定します。

public:
 void SetThreshold(float threshold);

public void SetThreshold (float threshold);

member this.SetThreshold : single -> unit

Public Sub SetThreshold (threshold As Single)

パラメーター

threshold

Single

しきい値を指定する実数。

例

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

1. Image を開き、画面に描画します。

2. ImageAttributes オブジェクトを作成し、SetThreshold メソッドを使用してそのしきい値を設定します。

3. ImageAttributes オブジェクトのしきい値を使用して、画像を画面に描画します。

void SetThresholdExample( PaintEventArgs^ e )
{
   // Open an Image file, and draw it to the screen.
   Image^ myImage = Image::FromFile( "Camera.jpg" );
   e->Graphics->DrawImage( myImage, 20, 20 );

   // Create an ImageAttributes object, and set its color threshold.
   ImageAttributes^ imageAttr = gcnew ImageAttributes;
   imageAttr->SetThreshold( 0.7f );

   // Draw the image with the colors bifurcated.
   Rectangle rect = Rectangle(300,20,200,200);
   e->Graphics->DrawImage( myImage, rect, 0, 0, 200, 200, GraphicsUnit::Pixel, imageAttr );
}

private void SetThresholdExample(PaintEventArgs e)
{
             
    // Open an Image file, and draw it to the screen.
    Image myImage = Image.FromFile("Camera.jpg");
    e.Graphics.DrawImage(myImage, 20, 20);
             
    // Create an ImageAttributes object, and set its color threshold.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetThreshold(0.7f);
             
    // Draw the image with the colors bifurcated.
    Rectangle rect = new Rectangle(300, 20, 200, 200);
    e.Graphics.DrawImage(myImage, rect, 0, 0, 200, 200, 
        GraphicsUnit.Pixel, imageAttr);    
}

Public Sub SetThresholdExample(ByVal e As PaintEventArgs)

    ' Open an Image file, and draw it to the screen.
    Dim myImage As Image = Image.FromFile("Camera.jpg")
    e.Graphics.DrawImage(myImage, 20, 20)

    ' Create an ImageAttributes object, and set its color threshold.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetThreshold(0.7F)

    ' Draw the image with the colors bifurcated.
    Dim rect As New Rectangle(300, 20, 200, 200)
    e.Graphics.DrawImage(myImage, rect, 0, 0, 200, 200, _
    GraphicsUnit.Pixel, imageAttr)
End Sub

注釈

しきい値は、各色コンポーネントのカットオフ ポイントを指定する 0 から 1 までの値です。 たとえば、しきい値が 0.7 に設定されていて、赤、緑、青の各コンポーネントがそれぞれ 230、50、220 である色をレンダリングするとします。 赤の成分 (230) は 0.7x255 より大きいので、赤の成分は 255 (完全な強度) に変更されます。 緑のコンポーネント (50) は 0.7x255 未満であるため、緑のコンポーネントは 0 に変更されます。 青色のコンポーネント (220) は 0.7x255 より大きいので、青色のコンポーネントは 255 に変更されます。

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

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

SetThreshold(Single, ColorAdjustType)

ソース:

ImageAttributes.cs

指定したカテゴリのしきい値 (透明度の範囲) を設定します。

public:
 void SetThreshold(float threshold, System::Drawing::Imaging::ColorAdjustType type);

public void SetThreshold (float threshold, System.Drawing.Imaging.ColorAdjustType type);

member this.SetThreshold : single * System.Drawing.Imaging.ColorAdjustType -> unit

Public Sub SetThreshold (threshold As Single, type As ColorAdjustType)

パラメーター

threshold

Single

最大値または最小値にマップされる色を並べ替えるブレークポイントとして使用される 0.0 から 1.0 までのしきい値。

type

ColorAdjustType

色のしきい値を設定するカテゴリを指定する ColorAdjustType の要素。

例

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

注釈

しきい値は、各色コンポーネントのカットオフ ポイントを指定する 0 から 1 までの値です。 たとえば、しきい値が 0.7 に設定されていて、赤、緑、青の各コンポーネントがそれぞれ 230、50、220 である色をレンダリングするとします。 赤の成分 (230) は 0.7x255 より大きいので、赤の成分は 255 (完全な強度) に変更されます。 緑のコンポーネント (50) は 0.7x255 未満であるため、緑のコンポーネントは 0 に変更されます。 青色のコンポーネント (220) は 0.7x255 より大きいので、青色のコンポーネントは 255 に変更されます。

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

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

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