你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

配色方案检测

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 视觉对示例图像中的黑白计算。

映像 黑色还是白色?
曼哈顿建筑的黑白照片
一座蓝色的房子和前院 false

使用 API

配色方案检测功能属于分析图像 3.2 API。 可以通过本机 SDK 或 REST 调用来调用此 API。 将 Color 包括在 visualFeatures 查询参数中。 然后,在获取完整 JSON 响应时,就只需分析 "color" 部分内容的字符串。