ImageAttributes::SetOutputChannelColorProfile メソッド (gdiplusimageattributes.h)

ImageAttributes::SetOutputChannelColorProfile メソッドは、指定されたカテゴリの出力チャネル カラー プロファイル ファイルを設定します。

構文

Status SetOutputChannelColorProfile(
  [in]           const WCHAR     *colorProfileFilename,
  [in, optional] ColorAdjustType type
);

パラメーター

[in] colorProfileFilename

型: const WCHAR*

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

[in, optional] type

型: ColorAdjustType

出力チャネルのカラー プロファイル ファイルを設定するカテゴリを指定する ColorAdjustType 列挙体の要素。 既定値は ColorAdjustTypeDefault です

戻り値

型: 状態

メソッドが成功した場合は、状態列挙体の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

注釈

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

  1. Image オブジェクトを作成します。
  2. ImageAttributes オブジェクトを作成します。
  3. ColorChannelFlagsCImageAttributes オブジェクトの ImageAttributes::SetOutputChannel メソッドに渡します。
  4. カラー プロファイル ファイルのパス名を ImageAttributes オブジェクトの ImageAttributes::SetOutputChannelColorProfileメソッドに渡 します。
  5. Image オブジェクトと ImageAttributes オブジェクトのアドレスを DrawImage メソッドに渡します。
Windows GDI+ では、カラー プロファイル ファイルを使用してイメージ内の各ピクセルのシアン 成分が計算され、レンダリングされたイメージ内の各ピクセルは、シアン チャネルの強度を示す灰色の網掛けになります。

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

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

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

次の例では、 Image オブジェクトを作成し、 DrawImage メソッドを呼び出してイメージを描画します。 次に、 ImageAttributes オブジェクトを作成し、 ImageAttributes::SetOutputChannelColorProfile メソッドを呼び出して、ビットマップ カテゴリのプロファイル ファイルを指定します。 ImageAttributes::SetOutputChannel の呼び出しは、出力チャネル (ビットマップ カテゴリの場合) をシアンに設定します。 このコードは DrawImage を 2 回目に呼び出し、 Image オブジェクトのアドレスと ImageAttributes オブジェクトのアドレスを渡します。 各ピクセルのシアンチャネルが計算され、レンダリングされた画像は、灰色の色合いとしてシアンチャネルの強度を示しています。 このコードでは 、さらに 3 回 DrawImage を呼び出して、マゼンタ、黄色、および黒のチャネルの強度を示します。


VOID Example_SetOutputProfile(HDC hdc)
{
   Graphics graphics(hdc);

   Image image(L"Mosaic2.bmp");
   ImageAttributes imAtt;
   UINT width = image.GetWidth();
   UINT height = image.GetHeight();

   // Draw the image unaltered.
   graphics.DrawImage(&image, 10, 10, width, height);

   imAtt.SetOutputChannelColorProfile(
      L"TEKPH600.ICM", ColorAdjustTypeBitmap);

   // Draw the image, showing the intensity of the cyan channel.
   imAtt.SetOutputChannel(ColorChannelFlagsC, ColorAdjustTypeBitmap);
   graphics.DrawImage(
      &image,
      Rect(110, 10, width, height),  // dest rect
      0, 0, width, height,           // source rect
      UnitPixel,
      &imAtt);

   // Draw the image, showing the intensity of the magenta channel.
   imAtt.SetOutputChannel(ColorChannelFlagsM, ColorAdjustTypeBitmap);
   graphics.DrawImage(
      &image,
      Rect(210, 10, width, height),  // dest rect
      0, 0, width, height,           // source rect
      UnitPixel,
      &imAtt);

   // Draw the image, showing the intensity of the yellow channel.
   imAtt.SetOutputChannel(ColorChannelFlagsY, ColorAdjustTypeBitmap);
   graphics.DrawImage(
      &image,
      Rect(10, 110, width, height),  // dest rect
      0, 0, width, height,           // source rect
      UnitPixel,
      &imAtt);

   // Draw the image, showing the intensity of the black channel.
   imAtt.SetOutputChannel(ColorChannelFlagsK, ColorAdjustTypeBitmap);
   graphics.DrawImage(
      &image,
      Rect(110, 110, width, height),  // dest rect
      0, 0, width, height,            // source rect
      UnitPixel,
      &imAtt); 
}
				

上記のコードは、Mosaic2.bmpファイルと Tekph600.icm ファイルと共に、次の出力を生成しました。

1 つの画像の 4 つのバージョンを示す図:最初に色を付け、次に 3 つの異なるグレースケール パターンで表示する

要件

   
サポートされている最小のクライアント Windows XP、Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー gdiplusimageattributes.h (Gdiplus.h を含む)
Library Gdiplus.lib
[DLL] Gdiplus.dll

こちらもご覧ください

ColorAdjustType

ColorChannelFlags

ImageAttributes

ImageAttributes::ClearOutputChannel

ImageAttributes::ClearOutputChannelColorProfile

ImageAttributes::SetOutputChannel