配色の検出
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" セクションのコンテンツを対象に文字列を解析します。