Share via


色彩配置偵測

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" 字串即可。