ImageAttributes.SetOutputChannelColorProfile メソッド

.NET Framework クラス ライブラリ リファレンス

ImageAttributes.SetOutputChannelColorProfile メソッド (String)

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

名前空間: System.Drawing.Imaging
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Sub SetOutputChannelColorProfile ( _
    colorProfileFilename As String _
)

Visual Basic (使用法)

Dim instance As ImageAttributes
Dim colorProfileFilename As String

instance.SetOutputChannelColorProfile(colorProfileFilename)

C#

public void SetOutputChannelColorProfile (
    string colorProfileFilename
)

C++

public:
void SetOutputChannelColorProfile (
    String^ colorProfileFilename
)

J#

public void SetOutputChannelColorProfile (
    String colorProfileFilename
)

JScript

public function SetOutputChannelColorProfile
 (
    colorProfileFilename : String
)

パラメータ

colorProfileFilename

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

戻り値
このメソッドは値を返しません。

解説

SetOutputChannel メソッドと SetOutputChannelColorProfile メソッドを使用して、イメージを CMYK (水色、マゼンダ、黄、黒) の色空間に変換し、CMYK カラー チャネルの 1 つの輝度を調べることができます。たとえば、次の処理を行うコードを記述したとします。

1. Image を作成します。

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

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

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

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

GDI+ は、カラー プロファイル ファイルを使用してイメージ中の各ピクセルの水色の要素を計算し、イメージの各ピクセルは水色チャネルの輝度を示す灰色の網かけで表現されます。

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

既定のカラー調整設定値およびグレースケール調整設定値は、調整設定値が設定されていないすべてのカテゴリに対して適用されます。たとえば、ビットマップ カテゴリの調整設定を一切指定していない場合、ビットマップ カテゴリには既定の設定が適用されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ImageAttributes クラス
ImageAttributes メンバ
System.Drawing.Imaging 名前空間

ImageAttributes.SetOutputChannelColorProfile メソッド (String, ColorAdjustType)

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

名前空間: System.Drawing.Imaging
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Sub SetOutputChannelColorProfile ( _
    colorProfileFilename As String, _
    type As ColorAdjustType _
)

Visual Basic (使用法)

Dim instance As ImageAttributes
Dim colorProfileFilename As String
Dim type As ColorAdjustType

instance.SetOutputChannelColorProfile(colorProfileFilename, type)

C#

public void SetOutputChannelColorProfile (
    string colorProfileFilename,
    ColorAdjustType type
)

C++

public:
void SetOutputChannelColorProfile (
    String^ colorProfileFilename, 
    ColorAdjustType type
)

J#

public void SetOutputChannelColorProfile (
    String colorProfileFilename, 
    ColorAdjustType type
)

JScript

public function SetOutputChannelColorProfile
 (
    colorProfileFilename : String, 
    type : ColorAdjustType
)

パラメータ

colorProfileFilename

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

type

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

戻り値
このメソッドは値を返しません。

解説

SetOutputChannel メソッドと SetOutputChannelColorProfile メソッドを使用して、イメージを CMYK (水色、マゼンダ、黄、黒) の色空間に変換し、CMYK カラー チャネルの 1 つの輝度を調べることができます。たとえば、次の処理を行うコードを記述したとします。

1. Image を作成します。

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

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

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

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

GDI+ は、カラー プロファイル ファイルを使用してイメージ中の各ピクセルの水色の要素を計算し、イメージの各ピクセルは水色チャネルの輝度を示す灰色の網かけで表現されます。

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

既定のカラー調整設定値およびグレースケール調整設定値は、調整設定値が設定されていないすべてのカテゴリに対して適用されます。たとえば、ビットマップ カテゴリの調整設定を一切指定していない場合、ビットマップ カテゴリには既定の設定が適用されます。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ImageAttributes クラス
ImageAttributes メンバ
System.Drawing.Imaging 名前空間

ImageAttributes.SetOutputChannelColorProfile メソッド

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

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

参照

関連項目

ImageAttributes クラス
ImageAttributes メンバ
System.Drawing.Imaging 名前空間