跳到主要内容

图像处理

用于色彩转换、对比度调整、通道处理和基础增强。

伪彩色映射​

ApplyColorMap · 可执行

将 8 位灰度或 BGR 图像通过 视觉运行时 预定义色表转换为 BGR 伪彩色图像。

签名​

var pseudo = ApplyColorMap(colorMap: "Viridis");

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 1 或 3。输入最多 16,777,216 像素。
8 位单通道灰度图像或 BGR 三通道图像。

参数​

colorMapstring
  • 输入
  • 可选
  • 默认 Viridis
  • 约束 可选 Autumn、Bone、Jet、Winter、Rainbow、Ocean、Summer、Spring、Cool、Hsv、Pink、Hot、Parula、Magma、Inferno、Plasma、Viridis、Cividis、Twilight、TwilightShifted、Turbo、DeepGreen。
伪彩色映射类型。

输出​

outImage
与输入同宽高的 BGR8 伪彩色图像。

行为​

  • 真调 视觉运行时 applyColorMap 实现。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:colorMap 不是枚举值之一。

示例​

将深度图可视化。

var depthColored = ApplyColorMap(colorMap: "Jet");

按位取反​

BitwiseNot · 可执行

对图像逐像素执行按位 NOT 运算,反转所有像素值。

签名​

var inverted = BitwiseNot();

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 1、3 或 4。
8 位单通道、BGR 或 BGRA 图像。

参数​

无参数。

输出​

outImage
像素值取反后的图像。

行为​

  • 真调 视觉运行时 bitwise_not 实现。
  • 对每个通道独立执行取反:out = 255 - in。

错误与限制​

  • 未声明额外错误码;输入仍需满足本页参数与图像格式约束。

示例​

反转二值掩码的前景/背景。

var inv = BitwiseNot();

提取通道​

ChannelExtract · 可执行

从 8 位图像中提取指定通道;单通道输入按原图克隆输出。

签名​

var channel0 = ChannelExtract(channel: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 1、3 或 4。
8 位单通道、BGR 或 BGRA 图像。

参数​

channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 必须小于输入通道数。
目标通道索引(0 起始)。

输出​

outImage
单通道 GRAY8 图像。

行为​

  • 使用 视觉运行时 extractChannel 实现。
  • 通道索引从 0 开始:B=0、G=1、R=2。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:channel 索引超出输入通道数范围。

示例​

从 BGR 图像中提取蓝色通道。

var blueChannel = ChannelExtract(channel: 0);

通道混合​

ChannelMix · 可执行

通过 3×3 通道混合矩阵对 BGR 三通道进行线性混合,实现自定义颜色滤镜。

签名​

var mixed = ChannelMix(bToB: 1, bToG: 0, bToR: 0, gToB: 0, gToG: 1, gToR: 0, rToB: 0, rToG: 0, rToR: 1, biasB: 0, biasG: 0, biasR: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

bToBdouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 -4–4。
B 通道到 B 通道的混合系数。
bToGdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -4–4。
B 通道到 G 通道的混合系数。
bToRdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -4–4。
B 通道到 R 通道的混合系数。
gToBdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -4–4。
G 通道到 B 通道的混合系数。
gToGdouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 -4–4。
G 通道到 G 通道的混合系数。
gToRdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -4–4。
G 通道到 R 通道的混合系数。
rToBdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -4–4。
R 通道到 B 通道的混合系数。
rToGdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -4–4。
R 通道到 G 通道的混合系数。
rToRdouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 -4–4。
R 通道到 R 通道的混合系数。
biasBdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -255–255。
B 通道偏置。
biasGdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -255–255。
G 通道偏置。
biasRdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -255–255。
R 通道偏置。

输出​

outImage
通道混合后的 BGR8 图像。

行为​

  • 真调 视觉运行时 实现,不留 stub/facade。
  • 输出 B' = bToB × B + gToB × G + rToB × R + biasB,其余通道同理。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:任一混合系数或偏置参数超出 参数合同 范围。

示例​

经典棕褐色怀旧滤镜。

var sepia = ChannelMix(bToB: 0.272, bToG: 0.349, bToR: 0.393, gToB: 0.543, gToG: 0.686, gToR: 0.769, rToB: 0.131, rToG: 0.168, rToR: 0.189, biasB: 0, biasG: 0, biasR: 0);

局部对比度​

CLAHE · 可执行

应用限制对比度自适应直方图均衡(CLAHE),在局部区域增强对比度并抑制噪声放大。

签名​

var clahe = CLAHE(clipLimit: 2, tileGridWidth: 8, tileGridHeight: 8);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 1、3 或 4;彩色输入先转为灰度。
8 位单通道、BGR 或 BGRA 图像。

参数​

clipLimitdouble
  • 输入
  • 可选
  • 默认 2
  • 约束 范围为 0.000001–1000。
对比度限制阈值。
tileGridWidthint
  • 输入
  • 可选
  • 默认 8
  • 约束 范围为 1–64。
分块网格宽度。
tileGridHeightint
  • 输入
  • 可选
  • 默认 8
  • 约束 范围为 1–64。
分块网格高度。

输出​

outImage
与输入同宽高的 CLAHE 增强图。

行为​

  • 真调 视觉运行时 CLAHE (createCLAHE) 实现。
  • 彩色输入自动灰度化后再处理。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:clipLimit、tileGridWidth 或 tileGridHeight 超出 参数合同 范围。

示例​

在低对比度显微图像中增强局部细节。

var clahe = CLAHE(clipLimit: 2, tileGridWidth: 8, tileGridHeight: 8);

颜色转换​

ColorConvert · 可执行

在 BGR、BGRA、GRAY、HSV 和 RGB 色彩空间之间按 mode 转换图像。

签名​

var converted = ColorConvert(mode: "BgrToGray");

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须匹配源色彩空间要求。
8 位彩色或灰度图像。

参数​

modestring
  • 输入
  • 可选
  • 默认 BgrToGray
  • 约束 可选 BgrToGray、BgraToGray、GrayToBgr、BgrToHsv、HsvToBgr、BgrToRgb、BgraToBgr。
色彩空间转换模式。

输出​

outImage
转换后的图像。

行为​

  • 真调 视觉运行时 cvtColor 实现。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:mode 不是枚举值之一。

示例​

BGR 转 HSV 便于基于色域的阈值分割。

var hsv = ColorConvert(mode: "BgrToHsv");

色彩增强​

ColorEnhance · 可执行

增强或减弱图像的色彩饱和度。

签名​

var vibrant = ColorEnhance(factor: 1.5);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

factordouble
  • 输入
  • 可选
  • 默认 1.3
  • 约束 范围为 0–3。0 为去色(灰度),1 保持不变。
增强因子。

输出​

outImage
色彩增强后的图像。

行为​

  • 在 HSV 空间中对 S 通道乘因子,再转回 BGR。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:factor 超出 参数合同 范围。

示例​

提升色彩饱和度 50%。

var enhanced = ColorEnhance(factor: 1.5);

颜色统计归一化​

ColorMatch · 可执行

对单张 BGR 图像执行 Lab 或 RGB 通道统计归一化;当前合同不接收目标参考图。

签名​

var matched = ColorMatch(colorSpace: "Lab", strength: 0.5);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。当前节点只有一个图像输入,不接收参考图像。
8 位 3 通道 BGR 图像。

参数​

colorSpacestring
  • 输入
  • 可选
  • 默认 Lab
  • 约束 可选 Lab、RGB。
统计归一化使用的色彩空间。
strengthdouble
  • 输入
  • 可选
  • 默认 0.5
  • 约束 范围为 0–1。
向目标均值/标准差靠拢的插值强度。

输出​

outImage
单图颜色统计归一化后的 BGR8 图像。

行为​

  • Lab 模式只调整 L 通道,a/b 保持不变;RGB 模式分别拉伸三个 BGR 通道。
  • 当前实现使用固定目标统计量,不执行双图 Reinhard 色彩迁移。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:colorSpace 不是 Lab 或 RGB。
  • VISION_PIPELINE_PARAMETER_RANGE:strength 超出 参数合同 范围。

示例​

以 0.8 强度执行单图 Lab 亮度统计归一化。

var matched = ColorMatch(colorSpace: "Lab", strength: 0.8);

颜色矩阵​

ColorMatrixTransform · 可执行

对 3 通道图像应用 3×3 颜色变换矩阵加偏移,实现自定义颜色映射。

签名​

var transformed = ColorMatrixTransform(m00: 1, m01: 0, m02: 0, m10: 0, m11: 1, m12: 0, m20: 0, m21: 0, m22: 1, bias0: 0, bias1: 0, bias2: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

m00double
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 -16–16。
变换矩阵 (0,0) 元素。
m01double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -16–16。
变换矩阵 (0,1) 元素。
m02double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -16–16。
变换矩阵 (0,2) 元素。
m10double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -16–16。
变换矩阵 (1,0) 元素。
m11double
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 -16–16。
变换矩阵 (1,1) 元素。
m12double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -16–16。
变换矩阵 (1,2) 元素。
m20double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -16–16。
变换矩阵 (2,0) 元素。
m21double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -16–16。
变换矩阵 (2,1) 元素。
m22double
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 -16–16。
变换矩阵 (2,2) 元素。
bias0double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -255–255。
通道 0 偏移。
bias1double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -255–255。
通道 1 偏移。
bias2double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -255–255。
通道 2 偏移。

输出​

outImage
变换后的 BGR8 图像。

行为​

  • 真调 视觉运行时 transform 实现。
  • 输出像素 = M × input + bias,M 为 3×3 矩阵。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:任一矩阵或偏移参数超出 参数合同 范围。

示例​

通过灰度转换矩阵将彩色图转为灰度。

var grayed = ColorMatrixTransform(m00: 0.299, m01: 0.587, m02: 0.114, m10: 0.299, m11: 0.587, m12: 0.114, m20: 0.299, m21: 0.587, m22: 0.114);

颜色范围阈值​

ColorRange · 可执行

在指定色彩空间中通过上下限阈值提取特定颜色区域的二值掩码。

签名​

var mask = ColorRange(colorSpace: "Hsv", lower0: 0, lower1: 50, lower2: 50, upper0: 179, upper1: 255, upper2: 255);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

colorSpacestring
  • 输入
  • 可选
  • 默认 Hsv
  • 约束 可选 Bgr、Hsv、Lab。
颜色空间。
lower0int
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–255;HSV 模式下通道 0 上限为 179。
通道 0 下限。
lower1int
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–255。
通道 1 下限。
lower2int
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–255。
通道 2 下限。
upper0int
  • 输入
  • 可选
  • 默认 179
  • 约束 范围为 0–255;HSV 模式下通道 0 上限为 179。
通道 0 上限。
upper1int
  • 输入
  • 可选
  • 默认 255
  • 约束 范围为 0–255。
通道 1 上限。
upper2int
  • 输入
  • 可选
  • 默认 255
  • 约束 范围为 0–255。
通道 2 上限。

输出​

outImage
与输入同宽高的 GRAY8 二值掩码(255=在范围内,0=不在范围内)。

行为​

  • 真调 视觉运行时 inRange 实现。
  • HSV 模式下 H 通道范围为 [0, 179] 而非 [0, 255]。
  • 每个 lower 通道必须小于或等于对应 upper 通道。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:colorSpace 不是 Bgr、Hsv 或 Lab。
  • VISION_PIPELINE_PARAMETER_RANGE:lower0/upper0 在 HSV 模式下超出 [0, 179] 范围。
  • VISION_PIPELINE_PARAMETER_RELATION:某个 lower 通道大于对应的 upper 通道。

示例​

提取蓝色区域掩码。

var mask = ColorRange(colorSpace: "Hsv", lower0: 100, lower1: 50, lower2: 50, upper0: 130, upper1: 255, upper2: 255);

色温调整​

ColorTemperature · 可执行

通过调整 R/B 通道平衡模拟不同色温效果。

签名​

var warm = ColorTemperature(shift: 30);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

shiftdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -100–100。
色温偏移量。正数增加暖色(偏红),负数增加冷色(偏蓝)。

输出​

outImage
色温调整后的图像。

行为​

  • 正 shift 增强红色通道、减弱蓝色通道,模拟暖色温。
  • 负 shift 增强蓝色通道、减弱红色通道,模拟冷色温。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:shift 超出 参数合同 范围。

示例​

使图像偏冷(偏蓝)。

var cool = ColorTemperature(shift: -20);

对比度增强​

ContrastEnhance · 可执行

通过多种方法增强图像局部或全局对比度。

签名​

var enhanced = ContrastEnhance(method: "CLAHE", strength: 2);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道 BGR 图像。

参数​

methodstring
  • 输入
  • 可选
  • 默认 CLAHE
  • 约束 可选 CLAHE、LogTransform、GammaLocal。
对比度增强方法。
strengthdouble
  • 输入
  • 可选
  • 默认 2
  • 约束 参数合同 范围为 0–5。CLAHE 方法必须使用大于 0 的 strength;0 会使当前执行体的分块尺寸计算失效。
增强强度。

输出​

outImage
对比度增强后的图像。

行为​

  • 真调 视觉运行时 实现,不留 stub/facade。
  • CLAHE 在 Lab 的 L 通道执行自适应均衡;LogTransform 使用对数 LUT;GammaLocal 根据整幅 L 通道均值计算 Gamma。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:method 不是枚举值之一。
  • VISION_PIPELINE_PARAMETER_RANGE:strength 超出 参数合同 范围。

示例​

CLAHE 局部对比度增强。

var contrast = ContrastEnhance(method: "CLAHE", strength: 2);

缩放绝对值转换​

ConvertScaleAbs · 可执行

对图像执行线性缩放后取绝对值,将结果转换为 8 位无符号。

签名​

var scaled = ConvertScaleAbs(alpha: 1, beta: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 1、3 或 4。
8 位单通道、BGR 或 BGRA 图像。

参数​

alphadouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 -65535–65535。
缩放因子。
betadouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -65535–65535。
叠加偏移。

输出​

outImage
与输入同尺寸、同通道数的 8 位无符号图像。

行为​

  • 真调 视觉运行时 convertScaleAbs 实现。
  • out = saturate_cast<uchar>(|alpha × input + beta|)。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:alpha 或 beta 超出 参数合同 范围。

示例​

提升图像对比度。

var contrast = ConvertScaleAbs(alpha: 1.5, beta: 0);

直方图均衡​

EqualizeHist · 可执行

将输入转为灰度后执行全局直方图均衡,增强整体对比度。

签名​

var equalized = EqualizeHist();

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 1、3 或 4;彩色输入先转为灰度。
8 位单通道、BGR 或 BGRA 图像。

参数​

无参数。

输出​

outImage
与输入同宽高的 GRAY8 均衡图。

行为​

  • 彩色输入先灰度化,再调用 视觉运行时 EqualizeHist;不会分别均衡 B/G/R 三通道。

错误与限制​

  • 未声明额外错误码;输入仍需满足本页参数与图像格式约束。

示例​

适合照明分布相对均匀的灰度检测。

var equalized = EqualizeHist();

自动 Gamma​

GammaAuto · 可执行

根据全通道平均像素值计算 Gamma,并通过 256 项 LUT 应用幂律映射。

签名​

var autoGamma = GammaAuto(mode: "Mean");

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 1、3 或 4。图像全通道均值必须大于 0。
8 位单通道、BGR 或 BGRA 图像。

参数​

modestring
  • 输入
  • 可选
  • 默认 Mean
  • 约束 可选 Mean、Log。
自动 Gamma 计算模式。

输出​

outImage
自动 Gamma 校正后的图像。

行为​

  • Mean 模式计算 gamma = clamp(255 / inputMean, 0.01, 10)。
  • Log 模式计算 gamma = clamp(log(0.5) / log(clamp(inputMean/255)), 0.01, 10)。
  • 两种模式都应用 O = (I / 255)^gamma × 255;文档不把该固定公式描述为曝光最优解。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:mode 不是枚举值之一。

示例​

按 Mean 固定公式计算并应用 Gamma。

var auto = GammaAuto(mode: "Mean");

Gamma 校正​

GammaCorrect · 可执行

对图像应用 Gamma 幂律校正,调整整体亮度感知。

签名​

var corrected = GammaCorrect(gamma: 1);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 1、3 或 4。
8 位单通道、BGR 或 BGRA 图像。

参数​

gammadouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 0.01–10。gamma=1 不改变图像。gamma<1 提亮暗部。gamma>1 压暗暗部。
Gamma 值。

输出​

outImage
Gamma 校正后的图像。

行为​

  • 对每个像素应用 O = (I / 255)^gamma * 255 变换。
  • 多通道图像逐通道独立应用。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:gamma 超出 参数合同 范围。

示例​

提升暗部细节。

var brightened = GammaCorrect(gamma: 0.5);

灰度世界白平衡​

GrayWorldWhiteBalance · 可执行

基于灰度世界假设自动调整图像白平衡。

签名​

var balanced = GrayWorldWhiteBalance(saturationThreshold: 0.9);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

saturationThresholddouble
  • 输入
  • 可选
  • 默认 0.9
  • 约束 范围为 0–1。
饱和度阈值;只使用饱和度不高于该阈值的像素估算通道增益。

输出​

outImage
白平衡校正后的图像。

行为​

  • 假设场景平均色为灰色,计算各通道增益并归一化。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:saturationThreshold 超出 参数合同 范围。
  • VISION_WAVEB_DEGENERATE_GEOMETRY:没有符合阈值的像素,或任一通道统计和为 0,无法计算有限增益。

示例​

校正室内暖色灯光下的偏色。

var wb = GrayWorldWhiteBalance(saturationThreshold: 0.1);

灰度​

Grayscale · 可执行

把 8 位 BGR/BGRA 图像转换为单通道灰度图;单通道输入保持像素语义。

签名​

var gray = Grayscale();

输入​

inputImage
  • 输入
  • 必填
  • 约束 通道数必须为 1、3 或 4。位深必须为 8 位无符号。
8 位 BGR/BGRA 或单通道 GRAY8 图像。

参数​

无参数。

输出​

outImage
与输入同宽高的 GRAY8 图像。

行为​

  • BGR 使用 视觉运行时 BGR2GRAY,BGRA 使用 BGRA2GRAY;GRAY8 输入不改变像素语义。

错误与限制​

  • 未声明额外错误码;输入仍需满足本页参数与图像格式约束。

示例​

为阈值、边缘和统计算子生成灰度输入。

var gray = Grayscale();

高光去除​

HighlightRemove · 可执行

检测并移除图像中的高光/镜面反射区域。

签名​

var noGlare = HighlightRemove(method: "InpaintTelea", threshold: 0.95);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

methodstring
  • 输入
  • 可选
  • 默认 InpaintTelea
  • 约束 可选 InpaintNaive、InpaintTelea。
高光去除方法。
thresholddouble
  • 输入
  • 可选
  • 默认 0.95
  • 约束 范围为 0.5–0.999。
高光检测阈值;像素亮度超过此比例阈值被标记为高光。

输出​

outImage
高光去除后的图像。

行为​

  • 真调 视觉运行时 实现,不留 stub/facade。
  • InpaintNaive 映射到 视觉运行时 Navier-Stokes 修复算法。
  • InpaintTelea 使用 Telea 算法填充高光区域。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:threshold 超出 参数合同 范围。
  • VISION_PIPELINE_PARAMETER_ENUM:method 不是枚举值之一。

示例​

去除金属表面的镜面反射。

var matte = HighlightRemove(method: "InpaintTelea", threshold: 0.85);

Lab 直方图均衡​

HistogramEqualizeLab · 可执行

在 CIELAB 色彩空间中仅对 L 通道执行直方图均衡,避免色彩失真。

签名​

var labEq = HistogramEqualizeLab(clipLimit: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

clipLimitdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–10。
CLAHE 对比度限制阈值;0 表示使用全局均衡而非 CLAHE。

输出​

outImage
对比度增强后的彩色图像。

行为​

  • 真调 视觉运行时 实现,不留 stub/facade。
  • BGR→Lab,仅均衡 L 通道,Lab→BGR。
  • clipLimit=0 使用全局直方图均衡;clipLimit>0 使用 CLAHE。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:clipLimit 超出 参数合同 范围。

示例​

增强对比度而不引入色偏。

var enhanced = HistogramEqualizeLab(clipLimit: 3);

K-Means 颜色分割​

KMeansColorSegmentation · 可执行

使用 K-Means 按 BGR 颜色分簇,并以各簇中心颜色生成量化图像。

签名​

var segmented = KMeansColorSegmentation(clusters: 4, maximumIterations: 20, epsilon: 0.1);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位彩色图像。

参数​

clustersint
  • 输入
  • 可选
  • 默认 4
  • 约束 范围为 2–16。不得超过输入像素总数。
聚类数量。
maximumIterationsint
  • 输入
  • 可选
  • 默认 20
  • 约束 范围为 1–100。
最大迭代次数。
epsilondouble
  • 输入
  • 可选
  • 默认 0.1
  • 约束 范围为 0.000001–1000。
收敛精度。

输出​

outImage
每个像素由所属聚类中心的 BGR 均值着色,输出为 BGR8 量化图像。

行为​

  • 调用 视觉运行时 kmeans,使用确定性初始标签并按 B/G/R 中心值排序规范化簇序。
  • 输出为 BGR8 聚类中心着色图,并输出量测:clusterCount、compactness、uniqueOutputColors。
  • 聚类数不得超过输入像素数,否则生产校验拒斥。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:clusters、maximumIterations 或 epsilon 超出 参数合同 范围。
  • VISION_PIPELINE_PARAMETER_RELATION:clusters 超过输入像素数。

示例​

将图像分割为 3 个主色区域。

var labels = KMeansColorSegmentation(clusters: 3, maximumIterations: 30, epsilon: 0.01);

Lab 色彩空间转换​

LabConvert · 可执行

在 BGR 和 CIELAB 色彩空间之间转换图像。

签名​

var lab = LabConvert(direction: "BgrToLab");

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道图像。

参数​

directionstring
  • 输入
  • 可选
  • 默认 BgrToLab
  • 约束 可选 BgrToLab、LabToBgr。
转换方向。

输出​

outImage
转换后的 3 通道图像。

行为​

  • 真调 视觉运行时 cvtColor 实现 (BGR2Lab / Lab2BGR)。
  • CIELAB 空间 L 通道对亮度变化更鲁棒。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:direction 不是枚举值之一。

示例​

转为 Lab 空间以便基于亮度的处理。

var lab = LabConvert(direction: "BgrToLab");

归一化​

Normalize · 可执行

对图像像素值进行线性归一化到指定范围或指定范数。

签名​

var norm = Normalize(alpha: 0, beta: 255, type: "MinMax");

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。
输入图像。

参数​

alphadouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -65535–65535。
MinMax 模式的目标最小值,或 L1/L2/Inf 范数归一化的缩放值。
betadouble
  • 输入
  • 可选
  • 默认 255
  • 约束 范围为 -65535–65535。
MinMax 模式的目标最大值。
typestring
  • 输入
  • 可选
  • 默认 MinMax
  • 约束 可选 MinMax、L1、L2、Inf。
归一化类型。

输出​

outImage
与输入同宽高的归一化图像。

行为​

  • 真调 视觉运行时 normalize 实现。
  • MinMax 将像素值线性映射到 [alpha, beta]。
  • L1/L2/Inf 将像素向量归一化到指定范数。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:type 不是 MinMax、L1、L2 或 Inf。
  • VISION_PIPELINE_PARAMETER_RANGE:alpha 或 beta 超出 参数合同 范围。

示例​

将图像像素值拉伸到全 8 位范围。

var norm = Normalize(alpha: 0, beta: 255, type: "MinMax");

Retinex 增强​

Retinex · 可执行

基于 Retinex 理论增强图像,分离照明和反射分量,改善不均匀光照。

签名​

var retinex = Retinex(variant: "SingleScale", scales: 3, sigma1: 50, sigma2: 200, gain: 1, offset: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

variantstring
  • 输入
  • 可选
  • 默认 SingleScale
  • 约束 可选 SingleScale、MultiScale。
Retinex 变体。
scalesint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围为 1–8。仅在 MultiScale 模式下有效。
多尺度 Retinex 使用的尺度数。
sigma1double
  • 输入
  • 可选
  • 默认 50
  • 约束 范围为 0.1–500。
第一个高斯尺度 sigma。
sigma2double
  • 输入
  • 可选
  • 默认 200
  • 约束 范围为 0.1–500。
第二个高斯尺度 sigma。
gaindouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 0–500。
结果增益。
offsetdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -255–255。
结果偏移。

输出​

outImage
Retinex 增强后的图像。

行为​

  • 将输入转为 CV_32FC3,计算 log(input+1) 与高斯照明估计之差,再经 gain、offset、exp 恢复并转回 BGR8。
  • SingleScale 只使用 sigma1;MultiScale 在 sigma1 到 sigma2 之间生成对数间隔尺度并等权平均。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:variant 不是 SingleScale 或 MultiScale。
  • VISION_PIPELINE_PARAMETER_RANGE:任一参数超出 参数合同 范围。

示例​

校正不均匀光照场景。

var uniform = Retinex(variant: "MultiScale", scales: 3, sigma1: 15, sigma2: 80, gain: 1, offset: 0);

饱和度调整​

SaturationAdjust · 可执行

通过缩放和偏移精确调整图像饱和度。

签名​

var adjusted = SaturationAdjust(scale: 1.2, offset: 10);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

scaledouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 0–3。
饱和度缩放因子。
offsetdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -100–100。
饱和度偏移量。

输出​

outImage
饱和度调整后的图像。

行为​

  • 在 HSV 空间中:S = clamp(S × scale + offset, 0, 255)。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:scale 或 offset 超出 参数合同 范围。

示例​

提升饱和度 50%。

var boosted = SaturationAdjust(scale: 1.5, offset: 0);

阴影去除​

ShadowRemove · 可执行

通过形态学照明估计补偿 BGR 图像阴影;当前受 Runtime 参数合同 奇数合同缺失阻塞。

签名​

var noShadow = ShadowRemove(method: "DivideLight", kernelSize: 31);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

methodstring
  • 输入
  • 可选
  • 默认 DivideLight
  • 约束 可选 DivideLight、MorphClose。
阴影去除方法。
kernelSizeint
  • 输入
  • 可选
  • 默认 31
  • 约束 范围为 1–127。执行器要求奇数;当前 Runtime 参数合同 未声明奇数合同,因此该算子尚不能从主执行链安全调用。
照明估计使用的椭圆形态学核大小。

输出​

outImage
阴影去除后的图像。

行为​

  • 先以椭圆核闭运算估计灰度照明分量。
  • DivideLight 将灰度/照明比扩展到三通道并与原图相乘。
  • MorphClose 计算照明分量与原灰度之差,并把该补光量加回原图。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:kernelSize 超出 参数合同 范围。
  • VISION_PIPELINE_PARAMETER_ENUM:method 不是枚举值之一。

示例​

移除室外拍摄时的地面阴影。

var clean = ShadowRemove(method: "DivideLight", kernelSize: 21);

简单白平衡​

SimpleWhiteBalance · 可执行

通过裁剪输入/输出范围的简单映射实现白平衡校正。

签名​

var wb = SimpleWhiteBalance(inputMin: 0, inputMax: 255, outputMin: 0, outputMax: 255, p: 2);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

inputMindouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–254。必须严格小于 inputMax。
输入范围下限。
inputMaxdouble
  • 输入
  • 可选
  • 默认 255
  • 约束 范围为 1–255。必须严格大于 inputMin。
输入范围上限。
outputMindouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–254。必须严格小于 outputMax。
输出范围下限。
outputMaxdouble
  • 输入
  • 可选
  • 默认 255
  • 约束 范围为 1–255。必须严格大于 outputMin。
输出范围上限。
pdouble
  • 输入
  • 可选
  • 默认 2
  • 约束 范围为 0–49.9。
两端裁剪百分位数。

输出​

outImage
白平衡校正后的图像。

行为​

  • 统计各通道直方图,裁剪 p% 两端极值,再线性映射到 [outputMin, outputMax]。
  • inputMin 必须小于 inputMax,outputMin 必须小于 outputMax,否则生产校验拒斥。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:任一参数超出 参数合同 范围。
  • VISION_PIPELINE_PARAMETER_RELATION:inputMin ≥ inputMax 或 outputMin ≥ outputMax。

示例​

轻度白平衡校正,仅裁剪两端 2% 的极端像素。

var wb = SimpleWhiteBalance(inputMin: 5, inputMax: 250, outputMin: 0, outputMax: 255, p: 2);

最简白平衡​

SimplestWhiteBalance · 可执行

通过裁剪饱和度直方图两端的百分位实现快速白平衡校正。

签名​

var wb = SimplestWhiteBalance(saturationPercent: 2);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

saturationPercentdouble
  • 输入
  • 可选
  • 默认 2
  • 约束 范围为 0.0001–49.9999。
两端裁剪的饱和度百分位数。

输出​

outImage
白平衡校正后的图像。

行为​

  • 逐通道统计直方图,裁剪两端 saturationPercent 百分位后线性拉伸。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:saturationPercent 超出 参数合同 范围。

示例​

轻度白平衡校正。

var wb = SimplestWhiteBalance(saturationPercent: 1);

超像素着色​

SuperpixelColor · 可执行

使用 SEEDS 或 SLIC 算法将图像分割为超像素区域,输出每个超像素的均值颜色。

签名​

var sp = SuperpixelColor(algorithm: "SLIC", regionSize: 40, numIterations: 10);

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道彩色图像。

参数​

algorithmstring
  • 输入
  • 可选
  • 默认 SLIC
  • 约束 可选 SEEDS、SLIC。
超像素算法。
regionSizeint
  • 输入
  • 可选
  • 默认 40
  • 约束 范围为 4–256。
初始超像素区域尺寸。
numIterationsint
  • 输入
  • 可选
  • 默认 10
  • 约束 范围为 1–20。
迭代优化次数。

输出​

outImage
每个超像素区域以均值颜色填充的平滑图像。

行为​

  • 真调 视觉运行时 xImgProc 实现,不留 stub/facade。
  • SEEDS 和 SLIC 均为超像素生成算法。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:regionSize 或 numIterations 超出 参数合同 范围。
  • VISION_PIPELINE_PARAMETER_ENUM:algorithm 不是枚举值之一。

示例​

用超像素平滑图像,保留边缘。

var smoothed = SuperpixelColor(algorithm: "SLIC", regionSize: 20, numIterations: 5);

简单色调映射​

ToneMapSimple · 可执行

对 8 位图像执行全局线性拉伸或简化 Reinhard LUT 映射。

签名​

var mapped = ToneMapSimple(mode: "Reinhard");

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 1 或 3。
8 位单通道或 BGR 图像。

参数​

modestring
  • 输入
  • 可选
  • 默认 Reinhard
  • 约束 可选 Linear、Reinhard。
色调映射模式。

输出​

outImage
色调映射后的 8 位图像。

行为​

  • Linear 将当前图像的全局最小值/最大值映射到 0–255;常量图像保持恒等。
  • Reinhard 使用 8 位 LUT 计算 x/(1+x),不是浮点 HDR 曝光合成。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:mode 不是枚举值之一。

示例​

压缩 8 位图像高亮范围。

var hdr = ToneMapSimple(mode: "Reinhard");

YCrCb 色彩空间转换​

YCrCbConvert · 可执行

在 BGR 和 YCrCb 色彩空间之间转换图像。

签名​

var ycrcb = YCrCbConvert(direction: "BgrToYCrCb");

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道图像。

参数​

directionstring
  • 输入
  • 可选
  • 默认 BgrToYCrCb
  • 约束 可选 BgrToYCrCb、YCrCbToBgr。
转换方向。

输出​

outImage
转换后的 3 通道图像。

行为​

  • 真调 视觉运行时 cvtColor 实现 (BGR2YCrCb / YCrCb2BGR)。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:direction 不是枚举值之一。

示例​

转为 YCrCb 空间便于皮肤检测等应用。

var ycrcb = YCrCbConvert(direction: "BgrToYCrCb");

YUV 色彩空间转换​

YuvConvert · 可执行

在 BGR 和 YUV 色彩空间之间转换图像。

签名​

var yuv = YuvConvert(direction: "BgrToYuv");

输入​

inputImage
  • 输入
  • 必填
  • 约束 位深必须为 8 位无符号。通道数必须为 3。
8 位 3 通道图像。

参数​

directionstring
  • 输入
  • 可选
  • 默认 BgrToYuv
  • 约束 可选 BgrToYuv、YuvToBgr。
转换方向。

输出​

outImage
转换后的 3 通道图像。

行为​

  • 真调 视觉运行时 cvtColor 实现 (BGR2YUV / YUV2BGR)。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:direction 不是枚举值之一。

示例​

转为 YUV 空间便于视频编码或亮度分析。

var yuv = YuvConvert(direction: "BgrToYuv");