ImageAttributes.SetOutputChannelColorProfile Methode

Definition

Legt die Farbprofildatei des Ausgabekanals fest.

Überlädt

Name Beschreibung
SetOutputChannelColorProfile(String, ColorAdjustType)

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

SetOutputChannelColorProfile(String)

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

SetOutputChannelColorProfile(String, ColorAdjustType)

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

Legt die Farbprofildatei für den Ausgabekanal 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 dieser Parameter der vollqualifizierte Pfadname sein.

type
ColorAdjustType

Ein Element davon ColorAdjustType gibt die Kategorie an, für die die Farbprofildatei des Ausgabekanals festgelegt ist.

Hinweise

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

  1. Erstellen Sie einen Image.

  2. Erstellen Sie ein ImageAttributes-Objekt.

  3. Übergeben Sie ColorChannelC 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 Und ImageAttributes Objekte an die DrawImage Methode.

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

Ein ImageAttributes Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Sie können z. B. 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 aufweisen. Wenn Sie beispielsweise niemals 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 Farbprofildatei für den Ausgabekanal für die Bitmapkategorie festlegen, indem Sie an die Bitmap Methode übergebenSetOutputChannelColorProfile, gelten keine der Standardanpassungseinstellungen für Bitmaps.

Gilt für:

SetOutputChannelColorProfile(String)

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

Legt die Farbprofildatei für den Ausgabekanal 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 dieser Parameter der vollqualifizierte Pfadname sein.

Hinweise

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

  1. Erstellen Sie einen Image.

  2. Erstellen Sie ein ImageAttributes-Objekt.

  3. Übergeben Sie ColorChannelC 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 Und ImageAttributes Objekte an die DrawImage Methode.

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

Ein ImageAttributes Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Sie können z. B. 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 aufweisen. Wenn Sie beispielsweise niemals Anpassungseinstellungen für die Bitmapkategorie angeben, gelten die Standardeinstellungen für die Bitmapkategorie.

Gilt für: