色彩配置偵測

  • 發行項

Azure AI 視覺會分析影像中的色彩，提供三個不同的屬性：主要前景色彩、主要背景色彩，以及影像整體的主要色彩集合。 可能的傳回色彩集是：黑色、藍色、棕色、灰色、綠色、橙色、粉紅色、紫色、紅色、青紅、青紅、青紅、白和黃色。

Azure AI 視覺也可根據主要色彩集合和飽和度來擷取輔色 (代表影像中最顯眼的色彩)。 輔色會以十六進位 HTML 色彩代碼傳回（例如 ， 00CC00）。

Azure AI 視覺也會傳回布林值，指出是否為黑白影像。

色彩配置偵測範例

下列範例示範偵測到影像色彩配置時，Azure AI 視覺所傳回的 JSON 回應。

注意

在此情況下，範例影像不是黑白影像，但主要前景和背景色彩為黑色，而整體影像的主要色彩為黑色和白色。

Outdoor Mountain at sunset, with a person's silhouette

{
    "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"
    }
}

主要色彩範例

下表顯示每個範例影像傳回的前景、背景和影像色彩。

映像 主要色彩
A white flower with a green background 前景：黑色
背景：白色
色彩：黑色、白色、綠色
A train running through a station 前景：黑色
背景：黑色
色彩：黑色

輔色範例

下表顯示每個範例影像的傳回輔色，以十六進位 HTML 色彩值表示。

映像 輔色
A person standing on a mountain rock at sunset #BB6D10
A white flower with a green background #C6A205
A train running through a station #474A84

黑白偵測範例

下表顯示 Azure AI 視覺對範例影像的黑白評估。

映像 黑白？
A black and white picture of buildings in Manhattan true
A blue house and the front yard false

使用 API

色彩配置偵測功能是分析影像 3.2 API 的一部分。 您可以透過原生 SDK 或 REST 呼叫來呼叫此 API。 包含在 Color visualFeatures查詢參數中。 然後，當您取得完整的 JSON 回應時，只要剖析區段內容的 "color" 字串即可。