次の方法で共有

CheckColorsInGamut 関数 (wingdi.h)

  • [アーティクル]

CheckColorsInGamut 関数は、指定した RGB トリプルのセットが、指定したデバイスの出力色域にあるかどうかを判断します。 RGB トリプルは、入力論理色空間で解釈されます。

構文

BOOL CheckColorsInGamut(
  HDC         hdc,
  LPRGBTRIPLE lpRGBTriple,
  LPVOID      dlpBuffer,
  DWORD       nCount
);

パラメーター

hdc

出力の色域を確認するデバイス コンテキストを処理します。

lpRGBTriple

チェックする RGB トリプルの配列へのポインター。

dlpBuffer

結果を配置するバッファーへのポインター。 このバッファーは、 nCount バイト以上である必要があります。

nCount

トリプルの配列内の要素の数。

戻り値

この関数が成功した場合、戻り値は 0 以外の値になります。

この関数が失敗した場合、戻り値は 0 です。

注釈

この関数は、テスト結果を lpBuffer が指すバッファーに配置します。 バッファー内の各バイトは RGB トリプルに対応し、CM_IN_GAMUT (= 0) とCM_OUT_OF_GAMUT (= 255) の間の符号なし値を持ちます。 値 0 は色が色域にあることを示し、0 以外の値は色域外であることを示します。 0 <n< 255 のような任意の整数 n の場合、結果値 n + 1 は、対応する色が少なくとも色域外であることを示します。これは、ICC プロファイル形式仕様で指定された結果値 n で示されるとおりです。 ICC プロファイル形式の仕様の詳細については、「 詳細情報 」に記載されているソースを参照してください。

この関数を成功させるには、 hDC パラメーターを介して渡されるデバイス コンテキスト ハンドルに対して WCS を有効にする必要があることに注意してください。 デバイス コンテキスト ハンドルに対して WCS を有効にするには、 SetICMMode 関数を呼び出します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wingdi.h
Library Gdi32.lib
[DLL] Gdi32.dll

こちらもご覧ください