ImageAttributes.SetThreshold メソッド

定義

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

オーバーロード

SetThreshold(Single)

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

SetThreshold(Single, ColorAdjustType)

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

SetThreshold(Single)

ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs
ソース:
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
ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs
ソース:
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 を渡してペン カテゴリのしきい値を設定した場合、既定の調整設定はペンに適用されません。

適用対象