配色の検出

Azure AI Vision では、イメージ内の色が分析され、前景のドミナント カラー、背景のドミナント カラー、およびイメージのドミナント カラーの大きなセットの 3 種類の属性が利用できます。 返される可能性がある色のセットは、黒、青、茶、グレー、緑、オレンジ、ピンク、紫、赤、青緑、白、黄です。

Azure AI Vision では、ドミナント カラー セットと彩度の組み合わせに基づき、イメージ内で最も鮮やかなカラーを表すアクセント カラーも抽出されます。 アクセント カラーは、16 進数の HTML カラー コードとして返されます (例: 00CC00)。

Azure AI Vision では、イメージが白黒イメージかどうかを示すブール値も返されます。

配色の検出の例

次の例は、イメージの配色を検出するときに Azure AI Vision によって返される JSON 応答を示しています。

Note

ここでは、イメージの例は白黒ではありませんが、前景と背景のドミナント カラーは黒で、イメージ全体のドミナント カラーは白黒です。

{
    "color": {
        "dominantColorForeground": "Black",
        "dominantColorBackground": "Black",
        "dominantColors": ["Black", "White"],
        "accentColor": "BB6D10",
        "isBwImg": false
    },
    "requestId": "0dc394bf-db50-4871-bdcc-13707d9405ea",
    "metadata": {
        "height": 202,
        "width": 300,
        "format": "Jpeg"
    }
}

ドミナント カラーの例

次の表は、各イメージ例について返された前景のカラー、背景のカラー、およびイメージのカラーを示しています。

Image	ドミナント カラー
	前景:Black 背景:White 色:黒、白、緑
	前景:Black 背景:Black 色:Black

アクセント カラーの例

次の表は、各イメージ例について返されたアクセント カラーを 16 進数の HTML カラー値で示したものです。

Image	アクセント カラー
	#BB6D10
	#C6A205
	#474A84

白黒の検出の例

次の表は、イメージ例における Azure AI Vision の白黒の評価を示しています。

Image	白黒かどうか
	true
	false

API の使用

配色検出機能は Analyze Image 3.2 API に含まれています。 ネイティブ SDK または REST を呼び出すことでこの API を呼び出すことができます。 Color を visualFeatures クエリ パラメーターに追加します。 その後、完全な JSON 応答が得られたら、"color" セクションのコンテンツを対象に文字列を解析します。

• クイック スタート: Vision REST API またはクライアント ライブラリ