ImageAttributes.SetOutputChannelColorProfile メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
出力チャネルのカラー プロファイル ファイルを設定します。
オーバーロード
| 名前 | 説明 |
|---|---|
| SetOutputChannelColorProfile(String, ColorAdjustType) |
指定したカテゴリの出力チャネル カラー プロファイル ファイルを設定します。 |
| SetOutputChannelColorProfile(String) |
既定のカテゴリの出力チャネル カラー プロファイル ファイルを設定します。 |
SetOutputChannelColorProfile(String, ColorAdjustType)
指定したカテゴリの出力チャネル カラー プロファイル ファイルを設定します。
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 -> unitPublic Sub SetOutputChannelColorProfile (colorProfileFilename As String, type As ColorAdjustType)パラメーター
- colorProfileFilename
- String
カラー プロファイル ファイルのパス名。 カラー プロファイル ファイルが %SystemRoot%\System32\Spool\Drivers\Color ディレクトリにある場合、このパラメーターにはファイル名を指定できます。 それ以外の場合、このパラメーターは完全修飾パス名である必要があります。
- type
- ColorAdjustType
出力チャネルのカラー プロファイル ファイルを設定するカテゴリを指定する ColorAdjustType の要素。
注釈
SetOutputChannelおよびSetOutputChannelColorProfileメソッドを使用して、イメージを CMYK (シアンマゼンタ-イエローブラック) 色空間に変換し、CMYK カラー チャネルの 1 つの強度を調べることができます。 たとえば、次の手順を実行するコードを記述するとします。
Image を作成します。
ImageAttributes オブジェクトを作成します。
ColorChannelC オブジェクトのSetOutputChannel メソッドにImageAttributesを渡します。
カラー プロファイル ファイルのパス名を、SetOutputChannelColorProfile オブジェクトのImageAttributes メソッドに渡します。
ImageおよびImageAttributes オブジェクトのパスを DrawImage メソッドに渡します。
GDI+ では、カラー プロファイル ファイルを使用して画像内の各ピクセルのシアン成分を計算します。レンダリングされたイメージ内の各ピクセルは、シアン チャネルの強度を示す灰色の網掛けになります。
ImageAttributes オブジェクトは、既定、ビットマップ、ブラシ、ペン、テキストの 5 つの調整カテゴリの色とグレースケールの設定を維持します。 たとえば、既定のカテゴリの出力チャネルのカラー プロファイル ファイルと、ビットマップ カテゴリに別の出力チャネルカラー プロファイル ファイルを指定できます。
既定の色調整とグレースケール調整の設定は、独自の調整設定を持たないすべてのカテゴリに適用されます。 たとえば、ビットマップ カテゴリの調整設定を指定しない場合、既定の設定はビットマップ カテゴリに適用されます。
特定のカテゴリに対して色調整またはグレースケール調整設定を指定するとすぐに、既定の調整設定がそのカテゴリに適用されなくなります。 たとえば、既定のカテゴリの調整設定のコレクションを指定するとします。 Bitmapを SetOutputChannelColorProfile メソッドに渡してビットマップ カテゴリの出力チャネル カラー プロファイル ファイルを設定した場合、既定の調整設定はビットマップに適用されなくなります。
適用対象
SetOutputChannelColorProfile(String)
既定のカテゴリの出力チャネル カラー プロファイル ファイルを設定します。
public:
void SetOutputChannelColorProfile(System::String ^ colorProfileFilename);public void SetOutputChannelColorProfile(string colorProfileFilename);member this.SetOutputChannelColorProfile : string -> unitPublic Sub SetOutputChannelColorProfile (colorProfileFilename As String)パラメーター
- colorProfileFilename
- String
カラー プロファイル ファイルのパス名。 カラー プロファイル ファイルが %SystemRoot%\System32\Spool\Drivers\Color ディレクトリにある場合、このパラメーターにはファイル名を指定できます。 それ以外の場合、このパラメーターは完全修飾パス名である必要があります。
注釈
SetOutputChannelおよびSetOutputChannelColorProfileメソッドを使用して、イメージを CMYK (シアンマゼンタ-イエローブラック) 色空間に変換し、CMYK カラー チャネルの 1 つの強度を調べることができます。 たとえば、次の手順を実行するコードを記述するとします。
Image を作成します。
ImageAttributes オブジェクトを作成します。
ColorChannelC オブジェクトのSetOutputChannel メソッドにImageAttributesを渡します。
カラー プロファイル ファイルのパス名を、SetOutputChannelColorProfile オブジェクトのImageAttributes メソッドに渡します。
ImageおよびImageAttributes オブジェクトのパスを DrawImage メソッドに渡します。
GDI+ では、カラー プロファイル ファイルを使用して画像内の各ピクセルのシアン成分を計算します。レンダリングされたイメージ内の各ピクセルは、シアン チャネルの強度を示す灰色の網掛けになります。
ImageAttributes オブジェクトは、既定、ビットマップ、ブラシ、ペン、テキストの 5 つの調整カテゴリの色とグレースケールの設定を維持します。 たとえば、既定のカテゴリの出力チャネルのカラー プロファイル ファイルと、ビットマップ カテゴリに別の出力チャネルカラー プロファイル ファイルを指定できます。
既定の色調整とグレースケール調整の設定は、独自の調整設定を持たないすべてのカテゴリに適用されます。 たとえば、ビットマップ カテゴリの調整設定を指定しない場合、既定の設定はビットマップ カテゴリに適用されます。
