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

[アーティクル]
09/28/2022

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

Image オブジェクトを作成します。
ImageAttributes オブジェクトを作成します。
ColorChannelFlagsC を ImageAttributes オブジェクトの ImageAttributes::SetOutputChannel メソッドに渡します。
カラープロファイルファイルのパス名を ImageAttributes オブジェクトの ImageAttributes::SetOutputChannelColorProfileメソッドに渡します。
Image オブジェクトと ImageAttributes オブジェクトのアドレスを DrawImage メソッドに渡します。

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

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

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

特定のカテゴリに対してカラー調整またはグレースケール調整設定を指定するとすぐに、既定の調整設定がそのカテゴリに適用されなくなります。たとえば、既定のカテゴリの調整設定のコレクションを指定するとします。 ColorAdjustTypeBitmap を ImageAttributes::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