ImageAttributes.SetThreshold Methode

Definition

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Paket:

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

Legt den Schwellenwert fest (Transparenzbereich).

Überlädt

SetThreshold(Single)	Legt den Schwellenwert (Transparenzbereich) für die Standardkategorie fest.
SetThreshold(Single, ColorAdjustType)	Legt den Schwellenwert (Transparenzbereich) für eine angegebene Kategorie fest.

SetThreshold(Single)

Quelle:

ImageAttributes.cs

Legt den Schwellenwert (Transparenzbereich) für die Standardkategorie fest.

public:
 void SetThreshold(float threshold);

public void SetThreshold (float threshold);

member this.SetThreshold : single -> unit

Public Sub SetThreshold (threshold As Single)

Parameter

threshold

Single

Eine reelle Zahl, die den Schwellenwert angibt.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

1. Öffnet eine Image und zeichnet sie auf dem Bildschirm.

2. Erstellt ein ImageAttributes -Objekt und legt seinen Schwellenwert mithilfe der SetThreshold-Methode fest.

3. Zeichnet das Bild mithilfe des Schwellenwerts des ImageAttributes-Objekts auf den Bildschirm.

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

Hinweise

Der Schwellenwert ist ein Wert zwischen 0 und 1, der einen Trennpunkt für jede Farbkomponente angibt. Angenommen, der Schwellenwert ist auf 0,7 festgelegt, und angenommen, Sie rendern eine Farbe, deren Rot-, Grün- und Blaukomponenten 230, 50 und 220 sind. Die rote Komponente (230) ist größer als 0,7x255, sodass die rote Komponente in 255 (volle Intensität) geändert wird. Die grüne Komponente (50) ist kleiner als 0,7x255, sodass die grüne Komponente auf 0 geändert wird. Die blaue Komponente (220) ist größer als 0,7x255, sodass die blaue Komponente in 255 geändert wird.

Ein ImageAttributes-Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Sie können z. B. einen Schwellenwert für die Standardkategorie, einen Schwellenwert für die Bitmapkategorie und dennoch einen anderen Schwellenwert für die Stiftkategorie angeben.

Die Standardeinstellungen für Farbanpassung und Graustufenanpassung gelten für alle Kategorien, die keine eigenen Anpassungseinstellungen aufweisen. Wenn Sie beispielsweise niemals Anpassungseinstellungen für die Stiftkategorie angeben, gelten die Standardeinstellungen für die Stiftkategorie.

SetThreshold(Single, ColorAdjustType)

Quelle:

ImageAttributes.cs

Legt den Schwellenwert (Transparenzbereich) für eine angegebene Kategorie fest.

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)

Parameter

threshold

Single

Ein Schwellenwert von 0,0 bis 1,0, der als Haltepunkt zum Sortieren von Farben verwendet wird, die entweder einem Maximalwert oder einem Minimalwert zugeordnet werden.

type

ColorAdjustType

Ein Element von ColorAdjustType, das die Kategorie angibt, für die der Farbschwellenwert festgelegt wird.

Beispiele

Ein Codebeispiel finden Sie in der SetThreshold(Single)-Methode.

Hinweise

Der Schwellenwert ist ein Wert zwischen 0 und 1, der einen Trennpunkt für jede Farbkomponente angibt. Angenommen, der Schwellenwert ist auf 0,7 festgelegt, und angenommen, Sie rendern eine Farbe, deren Rot-, Grün- und Blaukomponenten 230, 50 und 220 sind. Die rote Komponente (230) ist größer als 0,7x255, sodass die rote Komponente in 255 (volle Intensität) geändert wird. Die grüne Komponente (50) ist kleiner als 0,7x255, sodass die grüne Komponente auf 0 geändert wird. Die blaue Komponente (220) ist größer als 0,7x255, sodass die blaue Komponente in 255 geändert wird.

Ein ImageAttributes-Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Sie können z. B. einen Schwellenwert für die Standardkategorie, einen Schwellenwert für die Bitmapkategorie und dennoch einen anderen Schwellenwert für die Stiftkategorie angeben.

Die Standardeinstellungen für Farbanpassung und Graustufenanpassung gelten für alle Kategorien, die keine eigenen Anpassungseinstellungen aufweisen. Wenn Sie beispielsweise niemals Anpassungseinstellungen für die Stiftkategorie angeben, gelten die Standardeinstellungen für die Stiftkategorie.

Sobald Sie eine Farbanpassungs- oder Graustufenanpassungseinstellung für eine bestimmte Kategorie angeben, gelten die Standardeinstellungseinstellungen nicht mehr für diese Kategorie. Angenommen, Sie geben eine Sammlung von Anpassungseinstellungen für die Standardkategorie an. Wenn Sie den Schwellenwert für die Stiftkategorie festlegen, indem Sie Pen an die SetThreshold-Methode übergeben, gelten keine der Standardanpassungseinstellungen für Stifte.