色彩配置偵測
Azure AI 視覺會分析影像中的色彩,提供三個不同的屬性:主要前景色彩、主要背景色彩,以及影像整體的主要色彩集合。 可能傳回的色彩集合為:黑色、藍色、褐色、灰色、綠色、橙色、粉紅色、紫色、紅色、藍綠色、白色和黃色。
Azure AI 視覺也可根據主要色彩集合和飽和度來擷取輔色 (代表影像中最顯眼的色彩)。 輔色會以十六進位的 HTML 色彩代碼傳回 (例如 00CC00
)。
Azure AI 視覺也會傳回布林值,指出是否為黑白影像。
色彩配置偵測範例
下列範例示範偵測到影像色彩配置時,Azure AI 視覺所傳回的 JSON 回應。
注意
在此情況下,本範例影像不是黑白影像,但主要前景和背景色彩為黑色,而且整體影像的主要色彩為黑色和白色。
{
"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"
}
}
主要色彩範例
下表顯示傳回之每個範例影像的前景、背景及影像色彩。
映像 | 主要色彩 |
---|---|
前景:黑色 背景:白色 色彩:黑色、白色、綠色 |
|
前景:黑色 背景:黑色 色彩:黑色 |
輔色範例
下表顯示傳回之每個範例影像的輔色 (十六進位 HTML 色彩值)。
映像 | 輔色 |
---|---|
#BB6D10 | |
#C6A205 | |
#474A84 |
黑白偵測範例
下表顯示 Azure AI 視覺對範例影像的黑白評估。
映像 | 黑白? |
---|---|
true | |
false |
使用 API
色彩配置偵測功能是分析影像 3.2 API 的一部分。 您可以透過原生 SDK 或 REST 呼叫來呼叫此 API。 在 visualFeatures 查詢參數中包含 Color
。 然後,當您取得完整的 JSON 回應時,只需要剖析 "color"
區段內容的字串即可。