ImageAttributes.SetThreshold Metoda

Definicja

Przestrzeń nazw:

System.Drawing.Imaging

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v9.0.0-rc.1.24451.1

Ustawia próg (zakres przezroczystości).

Przeciążenia

SetThreshold(Single)	Ustawia próg (zakres przezroczystości) dla kategorii domyślnej.
SetThreshold(Single, ColorAdjustType)	Ustawia próg (zakres przezroczystości) dla określonej kategorii.

SetThreshold(Single)

Źródło:

ImageAttributes.cs

Ustawia próg (zakres przezroczystości) dla kategorii domyślnej.

public:
 void SetThreshold(float threshold);

public void SetThreshold (float threshold);

member this.SetThreshold : single -> unit

Public Sub SetThreshold (threshold As Single)

Parametry

threshold

Single

Liczba rzeczywista określająca wartość progową.

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z formularzami Systemu Windows i wymaga PaintEventArgse, który jest parametrem programu obsługi zdarzeń Paint. Kod wykonuje następujące akcje:

1. Otwiera Image i rysuje go na ekranie.

2. Tworzy obiekt ImageAttributes i ustawia jego próg przy użyciu metody SetThreshold.

3. Rysuje obraz na ekranie przy użyciu progu obiektu 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

Uwagi

Próg jest wartością z zakresu od 0 do 1, która określa punkt odcięcia dla każdego składnika koloru. Załóżmy na przykład, że próg jest ustawiony na 0,7 i załóżmy, że renderujesz kolor, którego czerwone, zielone i niebieskie składniki to odpowiednio 230, 50 i 220. Czerwony składnik (230) jest większy niż 0,7x255, więc czerwony składnik zostanie zmieniony na 255 (pełna intensywność). Zielony składnik (50) jest mniejszy niż 0,7x255, więc zielony składnik zostanie zmieniony na 0. Niebieski składnik (220) jest większy niż 0,7x255, więc niebieski składnik zostanie zmieniony na 255.

Obiekt ImageAttributes zachowuje ustawienia koloru i skali szarości dla pięciu kategorii korekty: domyślne, mapy bitowej, pędzla, pióra i tekstu. Można na przykład określić próg dla kategorii domyślnej, próg kategorii mapy bitowej i nadal inny próg dla kategorii pióra.

Domyślne ustawienia korekty kolorów i korekty skali szarości mają zastosowanie do wszystkich kategorii, które nie mają własnych ustawień korekty. Jeśli na przykład nigdy nie określisz żadnych ustawień korekty dla kategorii pióra, ustawienia domyślne będą stosowane do kategorii pióra.

SetThreshold(Single, ColorAdjustType)

Źródło:

ImageAttributes.cs

Ustawia próg (zakres przezroczystości) dla określonej kategorii.

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)

Parametry

threshold

Single

Wartość progowa z zakresu od 0,0 do 1,0, która jest używana jako punkt przerwania do sortowania kolorów, które zostaną zamapowane na maksymalną lub minimalną wartość.

type

ColorAdjustType

Element ColorAdjustType określający kategorię, dla której ustawiono próg koloru.

Przykłady

Aby zapoznać się z przykładem kodu, zobacz metodę SetThreshold(Single).

Uwagi

Próg jest wartością z zakresu od 0 do 1, która określa punkt odcięcia dla każdego składnika koloru. Załóżmy na przykład, że próg jest ustawiony na 0,7 i załóżmy, że renderujesz kolor, którego czerwone, zielone i niebieskie składniki to odpowiednio 230, 50 i 220. Czerwony składnik (230) jest większy niż 0,7x255, więc czerwony składnik zostanie zmieniony na 255 (pełna intensywność). Zielony składnik (50) jest mniejszy niż 0,7x255, więc zielony składnik zostanie zmieniony na 0. Niebieski składnik (220) jest większy niż 0,7x255, więc niebieski składnik zostanie zmieniony na 255.

Obiekt ImageAttributes zachowuje ustawienia koloru i skali szarości dla pięciu kategorii korekty: domyślne, mapy bitowej, pędzla, pióra i tekstu. Można na przykład określić próg dla kategorii domyślnej, próg kategorii mapy bitowej i nadal inny próg dla kategorii pióra.

Domyślne ustawienia korekty kolorów i korekty skali szarości mają zastosowanie do wszystkich kategorii, które nie mają własnych ustawień korekty. Jeśli na przykład nigdy nie określisz żadnych ustawień korekty dla kategorii pióra, ustawienia domyślne będą stosowane do kategorii pióra.

Gdy tylko określisz ustawienie korekty kolorów lub korekty skali szarości dla określonej kategorii, domyślne ustawienia korekty nie będą już stosowane do tej kategorii. Załóżmy na przykład, że określisz kolekcję ustawień korekty dla kategorii domyślnej. Jeśli ustawisz próg dla kategorii pióra, przekazując Pen do metody SetThreshold, żadne z domyślnych ustawień korekty nie będzie miało zastosowania do piór.