你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Foundry 工具中的 Azure 视觉可以分析图像中的颜色，并返回描述这些颜色的各种属性。
主色
该服务会返回三种不同属性：主导前景色、主导背景色和图像中的主导色的较大集。
可能返回的一系列颜色值包括：黑色、蓝色、棕色、灰色、绿色、橙色、粉红色、紫色、红色、青色、白色和黄色。
主题色
Azure 视觉还根据主要颜色集和饱和度的组合提取主题色，该颜色代表图像中最具活力的颜色。 主题色作为十六进制 HTML 颜色代码（例如 00CC00）返回。
黑白检测
Azure Vision 还返回一个布尔值，该值指示图像是否为黑白图像。
配色方案检测示例
以下示例演示了 Azure Vision 检测到图像配色方案时返回的 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 视觉黑白评估。
| 图像 | 黑色还是白色？ |
|---|---|
|
true |
|
false |
使用 API
配色方案检测功能属于分析图像 3.2 API。 可以通过本机 SDK 或 REST 调用来调用此 API。 将 Color 包括在 visualFeatures 查询参数中。 然后，在获取完整 JSON 响应时，就只需分析 "color" 部分内容的字符串。