ImageAttributes.SetOutputChannelColorProfile Methode

Definition

Legt die Ausgabekanal-Farbprofildatei fest.

Überlädt

SetOutputChannelColorProfile(String, ColorAdjustType)

Legt die Ausgabekanal-Farbprofildatei für eine angegebene Kategorie fest.

SetOutputChannelColorProfile(String)

Legt die Ausgabekanal-Farbprofildatei für die Standardkategorie fest.

SetOutputChannelColorProfile(String, ColorAdjustType)

Quelle:
ImageAttributes.cs
Quelle:
ImageAttributes.cs
Quelle:
ImageAttributes.cs

Legt die Ausgabekanal-Farbprofildatei für eine angegebene Kategorie fest.

public:
 void SetOutputChannelColorProfile(System::String ^ colorProfileFilename, System::Drawing::Imaging::ColorAdjustType type);
public void SetOutputChannelColorProfile (string colorProfileFilename, System.Drawing.Imaging.ColorAdjustType type);
member this.SetOutputChannelColorProfile : string * System.Drawing.Imaging.ColorAdjustType -> unit
Public Sub SetOutputChannelColorProfile (colorProfileFilename As String, type As ColorAdjustType)

Parameter

colorProfileFilename
String

Der Pfadname einer Farbprofildatei. Wenn sich die Farbprofildatei im Verzeichnis %SystemRoot%\System32\Spool\Drivers\Color befindet, kann dieser Parameter der Dateiname sein. Andernfalls muss es sich bei diesem Parameter um den voll gekennzeichneten Pfadnamen handeln.

type
ColorAdjustType

Ein Element von ColorAdjustType, das die Kategorie angibt, für die die Ausgabekanal-Farbprofildatei festgelegt ist.

Hinweise

Sie können die SetOutputChannel Methoden und SetOutputChannelColorProfile verwenden, um ein Bild in einen CMYK-Farbraum (Cyan-Magenta-Gelb-Schwarz) zu konvertieren und die Intensitäten eines der CMYK-Farbkanäle zu untersuchen. Angenommen, Sie schreiben Code, der die folgenden Schritte ausführt:

  1. Create ein Image.

  2. Erstellen Sie ein ImageAttributes-Objekt.

  3. Übergeben Sie ColorChannelC an die SetOutputChannel -Methode des ImageAttributes -Objekts.

  4. Übergeben Sie den Pfadnamen einer Farbprofildatei an die SetOutputChannelColorProfile -Methode des ImageAttributes -Objekts.

  5. Übergeben Sie die Pfade der Image -Objekte und ImageAttributes an die DrawImage -Methode.

GDI+ verwendet die Farbprofildatei, um die Cyan-Komponente jedes Pixels im Bild zu berechnen, und jedes Pixel im gerenderten Bild ist ein Grauton, der die Intensität des Cyankanals angibt.

Ein ImageAttributes Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Beispielsweise können Sie eine Ausgabekanalfarbprofildatei für die Standardkategorie und eine andere Ausgabekanalfarbprofildatei für die Bitmapkategorie angeben.

Die Standardeinstellungen für Farbanpassung und Graustufenanpassung gelten für alle Kategorien, die keine eigenen Anpassungseinstellungen haben. Wenn Sie beispielsweise nie Anpassungseinstellungen für die Bitmapkategorie angeben, gelten die Standardeinstellungen für die Bitmapkategorie.

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 die Ausgabekanalfarbprofildatei für die Bitmapkategorie festlegen, indem Sie an die SetOutputChannelColorProfile -Methode übergebenBitmap, gilt keine der Standardanpassungseinstellungen für Bitmaps.

Gilt für:

SetOutputChannelColorProfile(String)

Quelle:
ImageAttributes.cs
Quelle:
ImageAttributes.cs
Quelle:
ImageAttributes.cs

Legt die Ausgabekanal-Farbprofildatei für die Standardkategorie fest.

public:
 void SetOutputChannelColorProfile(System::String ^ colorProfileFilename);
public void SetOutputChannelColorProfile (string colorProfileFilename);
member this.SetOutputChannelColorProfile : string -> unit
Public Sub SetOutputChannelColorProfile (colorProfileFilename As String)

Parameter

colorProfileFilename
String

Der Pfadname einer Farbprofildatei. Wenn sich die Farbprofildatei im Verzeichnis %SystemRoot%\System32\Spool\Drivers\Color befindet, kann dieser Parameter der Dateiname sein. Andernfalls muss es sich bei diesem Parameter um den voll gekennzeichneten Pfadnamen handeln.

Hinweise

Sie können die SetOutputChannel Methoden und SetOutputChannelColorProfile verwenden, um ein Bild in einen CMYK-Farbraum (Cyan-Magenta-Gelb-Schwarz) zu konvertieren und die Intensitäten eines der CMYK-Farbkanäle zu untersuchen. Angenommen, Sie schreiben Code, der die folgenden Schritte ausführt:

  1. Create ein Image.

  2. Erstellen Sie ein ImageAttributes-Objekt.

  3. Übergeben Sie ColorChannelC an die SetOutputChannel -Methode des ImageAttributes -Objekts.

  4. Übergeben Sie den Pfadnamen einer Farbprofildatei an die SetOutputChannelColorProfile -Methode des ImageAttributes -Objekts.

  5. Übergeben Sie die Pfade der Image -Objekte und ImageAttributes an die DrawImage -Methode.

GDI+ verwendet die Farbprofildatei, um die Cyan-Komponente jedes Pixels im Bild zu berechnen, und jedes Pixel im gerenderten Bild ist ein Grauton, der die Intensität des Cyankanals angibt.

Ein ImageAttributes Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Beispielsweise können Sie eine Ausgabekanalfarbprofildatei für die Standardkategorie und eine andere Ausgabekanalfarbprofildatei für die Bitmapkategorie angeben.

Die Standardeinstellungen für Farbanpassung und Graustufenanpassung gelten für alle Kategorien, die keine eigenen Anpassungseinstellungen haben. Wenn Sie beispielsweise nie Anpassungseinstellungen für die Bitmapkategorie angeben, gelten die Standardeinstellungen für die Bitmapkategorie.

Gilt für: