设置指定颜色为新的颜色 - SetColorsToNewColor
函数简介
将图片中指定的颜色替换为新的颜色。此函数可以批量修改图片中所有匹配指定颜色的像素点,支持颜色范围匹配和精确匹配。常用于图片颜色替换、背景色修改、主题色更改等场景。可以同时替换多个颜色。
接口名称
SetColorsToNewColor
DLL调用
int SetColorsToNewColor(long ola, long image_ptr, string colors_json, string new_colors)
参数定义:
ola
(长整型数): OLAPlug对象的指针,由 CreateCOLAPlugInterFace 接口生成。image_ptr
(长整型数): 要修改的图片句柄。colors_json
(字符串): 颜色列表的JSON字符串,格式为:[{"StartColor": "3278FA", "EndColor": "6496FF", "Type": 0}]。其中Type取值:- 0: 正常匹配,保留在颜色范围内的像素
- 1: 反色匹配,保留在颜色范围外的像素
- 2: 正常交集匹配,保留在颜色范围内的像素取交集
- 3: 反色交集匹配,保留在颜色范围外的像素取交集
new_colors
(字符串): 要设置的颜色值,支持ARGB格式,如"#FFFFFFFF"(带透明度)或"#FFFFFF"(不透明)
示例:
返回值
整型数:
- 0: 替换失败
- 1: 替换成功
注意事项
- 处理大图片时,较大的相似度值可能会显著增加处理时间