ImageAttributes.SetOutputChannelColorProfile メソッド

定義

名前空間:

System.Drawing.Imaging

アセンブリ:

System.Drawing.Common.dll

パッケージ:

System.Drawing.Common v8.0.0

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

オーバーロード

SetOutputChannelColorProfile(String, ColorAdjustType)	指定したカテゴリの出力チャネルのカラー プロファイル ファイルを設定します。
SetOutputChannelColorProfile(String)	既定のカテゴリの出力チャネルのカラー プロファイル ファイルを設定します。

SetOutputChannelColorProfile(String, ColorAdjustType)

ソース:

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

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

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 つの調整カテゴリの色とグレースケールの設定を保持します。 たとえば、既定のカテゴリに出力チャネルカラープロファイルファイルを指定し、ビットマップカテゴリに別の出力チャネルカラープロファイルファイルを指定できます。

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