图像处理
用于色彩转换、对比度调整、通道处理和基础增强。
伪彩色映射
ApplyColorMap · 可执行
将 8 位灰度或 BGR 图像通过 视觉运行时 预定义色表转换为 BGR 伪彩色图像。
签名
var pseudo = ApplyColorMap(colorMap: "Viridis");
输入
inputImage- 8 位单通道灰度图像或 BGR 三通道图像。
参数
colorMapstring- 伪彩色映射类型。
输出
outImage- 与输入同宽高的 BGR8 伪彩色图像。
行为
- 真调 视觉运行时 applyColorMap 实现。
错误与限制
VISION_PIPELINE_PARAMETER_ENUM:colorMap 不是枚举值之一。
示例
将深度图可视化。
var depthColored = ApplyColorMap(colorMap: "Jet");
按位取反
BitwiseNot · 可执行
对图像逐像素执行按位 NOT 运算,反转所有像素值。
签名
var inverted = BitwiseNot();
输入
inputImage- 8 位单通道、BGR 或 BGRA 图像。
参数
无参数。
输出
outImage- 像素值取反后的图像。
行为
- 真调 视觉运行时 bitwise_not 实现。
- 对每个通道独立执行取反:out = 255 - in。
错误与限制
- 未声明额外错误码;输入仍需满足本页参数与图像格式约束。
示例
反转二值掩码的前景/背景。
var inv = BitwiseNot();
提取通道
ChannelExtract · 可执行
从 8 位图像中提取指定通道;单通道输入按原图克隆输出。
签名
var channel0 = ChannelExtract(channel: 0);
输入
inputImage- 8 位单通道、BGR 或 BGRA 图像。
参数
channelint- 目标通道索引(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 通道彩色图像。
参数
bToBdouble- B 通道到 B 通道的混合系数。
bToGdouble- B 通道到 G 通道的混合系数。
bToRdouble- B 通道到 R 通道的混合系数。
gToBdouble- G 通道到 B 通道的混合系数。
gToGdouble- G 通道到 G 通道的混合系数。
gToRdouble- G 通道到 R 通道的混合系数。
rToBdouble- R 通道到 B 通道的混合系数。
rToGdouble- R 通道到 G 通道的混合系数。
rToRdouble- R 通道到 R 通道的混合系数。
biasBdouble- B 通道偏置。
biasGdouble- G 通道偏置。
biasRdouble- 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 位单通道、BGR 或 BGRA 图像。
参数
clipLimitdouble- 对比度限制阈值。
tileGridWidthint- 分块网格宽度。
tileGridHeightint- 分块网格高度。
输出
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 位彩色或灰度图像。
参数
modestring- 色彩空间转换模式。
输出
outImage- 转换后的图像。
行为
- 真调 视觉运行时 cvtColor 实现。
错误与限制
VISION_PIPELINE_PARAMETER_ENUM:mode 不是枚举值之一。
示例
BGR 转 HSV 便于基于色域的阈值分割。
var hsv = ColorConvert(mode: "BgrToHsv");
色彩增强
ColorEnhance · 可执行
增强或减弱图像的色彩饱和度。
签名
var vibrant = ColorEnhance(factor: 1.5);
输入
inputImage- 8 位 3 通道彩色图像。
参数
factordouble- 增强因子。
输出
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 通道 BGR 图像。
参数
colorSpacestring- 统计归一化使用的色彩空间。
strengthdouble- 向目标均值/标准差靠拢的插值强度。
输出
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 通道彩色图像。
参数
m00double- 变换矩阵 (0,0) 元素。
m01double- 变换矩阵 (0,1) 元素。
m02double- 变换矩阵 (0,2) 元素。
m10double- 变换矩阵 (1,0) 元素。
m11double- 变换矩阵 (1,1) 元素。
m12double- 变换矩阵 (1,2) 元素。
m20double- 变换矩阵 (2,0) 元素。
m21double- 变换矩阵 (2,1) 元素。
m22double- 变换矩阵 (2,2) 元素。
bias0double- 通道 0 偏移。
bias1double- 通道 1 偏移。
bias2double- 通道 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 通道彩色图像。
参数
colorSpacestring- 颜色空间。
lower0int- 通道 0 下限。
lower1int- 通道 1 下限。
lower2int- 通道 2 下限。
upper0int- 通道 0 上限。
upper1int- 通道 1 上限。
upper2int- 通道 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 通道彩色图像。
参数
shiftdouble- 色温偏移量。正数增加暖色(偏红),负数增加冷色(偏蓝)。
输出
outImage- 色温调整后的图像。
行为
- 正 shift 增强红色通道、减弱蓝色通道,模拟暖色温。
- 负 shift 增强蓝色通道、减弱红色通道,模拟冷色温。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:shift 超出 参数合同 范围。
示例
使图像偏冷(偏蓝)。
var cool = ColorTemperature(shift: -20);
对比度增强
ContrastEnhance · 可执行
通过多种方法增强图像局部或全局对比度。
签名
var enhanced = ContrastEnhance(method: "CLAHE", strength: 2);
输入
inputImage- 8 位 3 通道 BGR 图像。
参数
methodstring- 对比度增强方法。
strengthdouble- 增强强度。
输出
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 位单通道、BGR 或 BGRA 图像。
参数
alphadouble- 缩放因子。
betadouble- 叠加偏移。
输出
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 位单通道、BGR 或 BGRA 图像。
参数
无参数。
输出
outImage- 与输入同宽高的 GRAY8 均衡图。
行为
- 彩色输入先灰度化,再调用 视觉运行时 EqualizeHist;不会分别均衡 B/G/R 三通道。
错误与限制
- 未声明额外错误码;输入仍需满足本页参数与图像格式约束。
示例
适合照明分布相对均匀的灰度检测。
var equalized = EqualizeHist();
自动 Gamma
GammaAuto · 可执行
根据全通道平均像素值计算 Gamma,并通过 256 项 LUT 应用幂律映射。
签名
var autoGamma = GammaAuto(mode: "Mean");
输入
inputImage- 8 位单通道、BGR 或 BGRA 图像。
参数
modestring- 自动 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 位单通道、BGR 或 BGRA 图像。
参数
gammadouble- 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 通道彩色图像。
参数
saturationThresholddouble- 饱和度阈值;只使用饱和度不高于该阈值的像素估算通道增益。
输出
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- 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 通道彩色图像。
参数
methodstring- 高光去除方法。
thresholddouble- 高光检测阈值;像素亮度超过此比例阈值被标记为高光。
输出
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 通道彩色图像。
参数
clipLimitdouble- 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 位彩色图像。
参数
clustersint- 聚类数量。
maximumIterationsint- 最大迭代次数。
epsilondouble- 收敛精度。
输出
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 通道图像。
参数
directionstring- 转换方向。
输出
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- 输入图像。
参数
alphadouble- MinMax 模式的目标最小值,或 L1/L2/Inf 范数归一化的缩放值。
betadouble- MinMax 模式的目标最大值。
typestring- 归一化类型。
输出
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 通道彩色图像。
参数
variantstring- Retinex 变体。
scalesint- 多尺度 Retinex 使用的尺度数。
sigma1double- 第一个高斯尺度 sigma。
sigma2double- 第二个高斯尺度 sigma。
gaindouble- 结果增益。
offsetdouble- 结果偏移。
输出
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 通道彩色图像。
参数
scaledouble- 饱和度缩放因子。
offsetdouble- 饱和度偏移量。
输出
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 通道彩色图像。
参数
methodstring- 阴影去除方法。
kernelSizeint- 照明估计使用的椭圆形态学核大小。
输出
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 通道彩色图像。
参数
inputMindouble- 输入范围下限。
inputMaxdouble- 输入范围上限。
outputMindouble- 输出范围下限。
outputMaxdouble- 输出范围上限。
pdouble- 两端裁剪百分位数。
输出
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 通道彩色图像。
参数
saturationPercentdouble- 两端裁剪的饱和度百分位数。
输出
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 通道彩色图像。
参数
algorithmstring- 超像素算法。
regionSizeint- 初始超像素区域尺寸。
numIterationsint- 迭代优化次数。
输出
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 位单通道或 BGR 图像。
参数
modestring- 色调映射模式。
输出
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 通道图像。
参数
directionstring- 转换方向。
输出
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 通道图像。
参数
directionstring- 转换方向。
输出
outImage- 转换后的 3 通道图像。
行为
- 真调 视觉运行时 cvtColor 实现 (BGR2YUV / YUV2BGR)。
错误与限制
VISION_PIPELINE_PARAMETER_ENUM:direction 不是枚举值之一。
示例
转为 YUV 空间便于视频编码或亮度分析。
var yuv = YuvConvert(direction: "BgrToYuv");