颜色模型说明 - ColorModel

概述

colorJson / 颜色模型字符串用于在图像处理、图像识别、文字识别等接口中限定颜色范围。 本说明文档统一介绍所有支持的颜色表示方式，接口文档只需简单引用本页即可。

1. JSON 格式（原有写法，完全兼容）

[
  {
    "StartColor": "3278FA",
    "EndColor": "6496FF",
    "Type": 0
  },
  {
    "StartColor": "#AABBCC",
    "EndColor": "#DDEEFF",
    "Type": 1
  }
]
  • StartColor / EndColor 支持以下形式：
    • #AARRGGBB
    • AARRGGBB
    • #RRGGBB
    • RRGGBB
  • Type 说明：
    • 0：正常匹配（保留在颜色范围内的像素）
    • 1：反色匹配（保留在颜色范围外的像素）
    • 2：正常交集匹配
    • 3：反色交集匹配

2. 偏色区间格式："RRGGBB-DRDGDB"

  • 基本格式："基准色-偏移量"，例如：
    • "AABBCC-000000"
    • "DDEEFF-202020"
  • 多个区间用 | 分隔，例如：
    • "AABBCC-000000|DDEEFF-202020"
  • 含义：
    • 左侧为基准色 RRGGBB
    • 右侧 DRDGDB 表示每个通道允许的偏移范围

反色模式

  • 在字符串前面加 @ 即表示反色模式：
    • "@AABBCC-000000|DDEEFF-202020"

3. 颜色区间范围格式："RRGGBB~RRGGBB"

  • 基本格式："起始色~结束色"，例如：
    • "000000~FFFFFF" 表示从 #000000 到 #FFFFFF 的连续颜色范围
  • 支持多个区间，用 | 分隔，例如：
    • "AABBCC~BBCCDD|AAAAAA~FFFFFF"

反色模式

  • 在字符串前面加 @ 即表示反色模式：
    • "@AABBCC~BBCCDD|AAAAAA~FFFFFF"

4. 单独颜色格式

  • 支持直接填写单个颜色值：
    • #AARRGGBB
    • AARRGGBB
    • #RRGGBB
    • RRGGBB
  • 支持多个颜色，用 | 组合，例如：
    • "#FF0000|00FF00|0000FF"

反色模式

  • 在字符串前面加 @ 表示对这些颜色进行反选：
    • "@FF0000|00FF00"

5. 使用建议

  • 简单场景可直接使用单独颜色或颜色区间格式，便于书写。
  • 需要精细控制时，推荐使用 JSON 格式并明确设置 Type。
  • 不同接口中 colorJson 的业务含义略有差异（如过滤背景色 / 限制前景色），具体请参考对应接口文档的简要说明。
Last Updated: