ImageAttributes.SetOutputChannelColorProfile メソッド

定義

出力チャネルのカラー プロファイル ファイルを設定します。

オーバーロード

SetOutputChannelColorProfile(String, ColorAdjustType)

指定したカテゴリの出力チャネルのカラー プロファイル ファイルを設定します。

SetOutputChannelColorProfile(String)

既定のカテゴリの出力チャネルのカラー プロファイル ファイルを設定します。

SetOutputChannelColorProfile(String, ColorAdjustType)

ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs

指定したカテゴリの出力チャネルのカラー プロファイル ファイルを設定します。

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)

パラメーター

colorProfileFilename
String

カラー プロファイル ファイルのパス名。 カラー プロファイル ファイルが %SystemRoot%\System32\Spool\Drivers\Color ディレクトリにある場合、このパラメーターはファイル名にすることができます。 それ以外の場合、このパラメーターは、完全修飾パス名を指定する必要があります。

type
ColorAdjustType

出力チャネル カラー プロファイル ファイルを設定する対象のカテゴリを指定する ColorAdjustType の要素。

注釈

メソッドと SetOutputChannelColorProfile メソッドを使用SetOutputChannelして、イメージを CMYK (シアン-マゼンタ-イエローブラック) 色空間に変換し、CMYK カラー チャネルの 1 つの強度を調べることができます。 たとえば、次の手順を実行するコードを記述するとします。

  1. をCreateしますImage

  2. ImageAttributes オブジェクトを作成します。

  3. オブジェクトの SetOutputChannel メソッドにImageAttributesを渡ColorChannelCします。

  4. カラー プロファイル ファイルのパス名を オブジェクトの SetOutputChannelColorProfileImageAttributes メソッドに渡します。

  5. オブジェクトと ImageAttributes オブジェクトのパスを Image メソッドにDrawImage渡します。

GDI+ はカラー プロファイル ファイルを使用して画像内の各ピクセルのシアン成分を計算し、レンダリングされたイメージ内の各ピクセルはシアン チャネルの強度を示す灰色の網掛けになります。

オブジェクトは ImageAttributes 、既定、ビットマップ、ブラシ、ペン、テキストの 5 つの調整カテゴリの色とグレースケールの設定を保持します。 たとえば、既定のカテゴリに出力チャネルカラープロファイルファイルを指定し、ビットマップカテゴリに別の出力チャネルカラープロファイルファイルを指定できます。

既定の色調整とグレースケール調整の設定は、独自の調整設定を持たないすべてのカテゴリに適用されます。 たとえば、ビットマップ カテゴリの調整設定を指定しない場合、既定の設定はビットマップ カテゴリに適用されます。

特定のカテゴリに対して色調整またはグレースケール調整設定を指定するとすぐに、既定の調整設定がそのカテゴリに適用されなくなります。 たとえば、既定のカテゴリの調整設定のコレクションを指定するとします。 メソッドに渡 Bitmap してビットマップ カテゴリの出力チャネル カラー プロファイル ファイルを SetOutputChannelColorProfile 設定した場合、既定の調整設定はビットマップに適用されません。

適用対象

SetOutputChannelColorProfile(String)

ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs
ソース:
ImageAttributes.cs

既定のカテゴリの出力チャネルのカラー プロファイル ファイルを設定します。

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

パラメーター

colorProfileFilename
String

カラー プロファイル ファイルのパス名。 カラー プロファイル ファイルが %SystemRoot%\System32\Spool\Drivers\Color ディレクトリにある場合、このパラメーターはファイル名にすることができます。 それ以外の場合、このパラメーターは、完全修飾パス名を指定する必要があります。

注釈

メソッドと SetOutputChannelColorProfile メソッドを使用SetOutputChannelして、イメージを CMYK (シアン-マゼンタ-イエローブラック) 色空間に変換し、CMYK カラー チャネルの 1 つの強度を調べることができます。 たとえば、次の手順を実行するコードを記述するとします。

  1. をCreateしますImage

  2. ImageAttributes オブジェクトを作成します。

  3. オブジェクトの SetOutputChannel メソッドにImageAttributesを渡ColorChannelCします。

  4. カラー プロファイル ファイルのパス名を オブジェクトの SetOutputChannelColorProfileImageAttributes メソッドに渡します。

  5. オブジェクトと ImageAttributes オブジェクトのパスを Image メソッドにDrawImage渡します。

GDI+ はカラー プロファイル ファイルを使用して画像内の各ピクセルのシアン成分を計算し、レンダリングされたイメージ内の各ピクセルはシアン チャネルの強度を示す灰色の網掛けになります。

オブジェクトは ImageAttributes 、既定、ビットマップ、ブラシ、ペン、テキストの 5 つの調整カテゴリの色とグレースケールの設定を保持します。 たとえば、既定のカテゴリに出力チャネルカラープロファイルファイルを指定し、ビットマップカテゴリに別の出力チャネルカラープロファイルファイルを指定できます。

既定の色調整とグレースケール調整の設定は、独自の調整設定を持たないすべてのカテゴリに適用されます。 たとえば、ビットマップ カテゴリの調整設定を指定しない場合、既定の設定はビットマップ カテゴリに適用されます。

適用対象