ImageAttributes.SetThreshold メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
しきい値 (透明度の範囲) を設定します。
オーバーロード
SetThreshold(Single) |
既定のカテゴリのしきい値 (透明度の範囲) を設定します。 |
SetThreshold(Single, ColorAdjustType) |
指定したカテゴリのしきい値 (透明度の範囲) を設定します。 |
SetThreshold(Single)
既定のカテゴリのしきい値 (透明度の範囲) を設定します。
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
が必要です。 このコードは、次のアクションを実行します。
Image を開き、画面に描画します。
ImageAttributes オブジェクトを作成し、SetThreshold メソッドを使用してそのしきい値を設定します。
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)
指定したカテゴリのしきい値 (透明度の範囲) を設定します。
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 を渡してペン カテゴリのしきい値を設定した場合、既定の調整設定はペンに適用されません。
適用対象
.NET