共用方式為


色彩配置偵測

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" 區段內容的字串即可。