图像统计
用于计算直方图、纹理、清晰度和区域统计量。
图像质心
CentroidImage · 可执行
计算图像像素强度的质心坐标。
签名
Image centroid = CentroidImage(channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
channelint- 目标通道索引。
返回值
returnImage- 返回输入图像克隆;量测值s 输出 centroidX、centroidY、totalIntensity、channel、pixelCount。
行为
- 按 Σ(x×I)/ΣI 和 Σ(y×I)/ΣI 计算灰度加权质心。
- 全黑图像的 totalIntensity=0,此时返回几何中心 ((width−1)/2, (height−1)/2)。
- 图像数据不变;输入像素数上限为 1,048,576。
错误与限制
VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像,或 channel 超出范围。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。VISION_CORE_RESULT_NON_FINITE:质心或总强度包含 NaN 或 Infinity。
示例
计算通道 0 的像素强度质心。
Image centroid = CentroidImage(channel: 0);
彩色直方图
ColorHistogram · 可执行
分别计算三个通道的一维直方图,并叠加绘制彩色可视化。
签名
Image chist = ColorHistogram(bins: 32, channelA: 0, channelB: 1, channelC: 2);
输入
inputImage- 8-bit 的 1、3 或 4 通道源图像;单通道输入会复用通道 0。
参数
binsint- 每通道直方图柱数。
channelAint- 第一通道索引。
channelBint- 第二通道索引。
channelCint- 第三通道索引。
返回值
returnImage- 返回 512×320 BGR8 三曲线可视化;量测值s 输出 peak、bins、channelA、channelB、channelC。
行为
- 对 channelA、channelB、channelC 分别调用一维 CalcHist,并把三条归一化曲线叠加绘制。
- 单通道输入会复用通道 0;本算子不计算 bins³ 的联合直方图。
- 输入像素数上限为 1,048,576。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:bins 或显式通道参数超出 参数合同 范围。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
分别绘制 BGR 三通道的 32-bin 一维直方图。
Image chist = ColorHistogram(bins: 32, channelA: 0, channelB: 1, channelC: 2);
灰度共生矩阵
Cooccurrence · 可执行
计算灰度共生矩阵 (GLCM), 用于纹理分析。
签名
Image glcm = Cooccurrence(levels: 8, distance: 1, direction: "Horizontal", channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
levelsint- 灰度量化级数。
distanceint- 像素对距离。
directionstring- 方向。
channelint- 目标通道索引。
返回值
returnImage- 返回输入图像克隆;量测值s 输出 contrast、homogeneity、energy、levels、distance、channel、pixelCount。
行为
- 把指定通道量化到 levels 个灰度级,并按 direction 和 distance 累计有向像素对。
- 从归一化 GLCM 计算 contrast、homogeneity 和 energy;不返回矩阵图像。
- 输入像素数上限为 1,048,576。
错误与限制
VISION_PIPELINE_PARAMETER_ENUM:direction 不是 Horizontal、Vertical、Diagonal45 或 Diagonal135。VISION_PIPELINE_PARAMETER_RANGE:levels、distance 或 channel 超出声明范围。VISION_CORE_DEGENERATE_GEOMETRY:图像尺寸和方向/距离组合没有可统计的像素对。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
计算水平方向、距离 1 的 8 级灰度共生矩阵。
Image glcm = Cooccurrence(levels: 8, distance: 1, direction: "Horizontal", channel: 0);
边缘密度
EdgeDensity · 可执行
计算图像的边缘密度。
签名
Image density = EdgeDensity(threshold: 50, apertureSize: 3);
输入
inputImage- 8-bit 的 1、3 或 4 通道源图像;彩色输入在执行时转灰度。
参数
thresholdint- Canny 边缘检测阈值。
apertureSizeint- Sobel 孔径大小。
返回值
returnImage- 返回输入图像克隆;量测值s 输出 edgeDensity、edgePixelCount、threshold、apertureSize、pixelCount。
行为
- 8-bit 的 1、3 或 4 通道输入先转灰度。
- Canny 低阈值为 max(1, threshold/2),高阈值为 max(1, threshold)。
- 图像数据不变;输入像素数上限为 1,048,576。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:threshold 不在 0–255,或 apertureSize 不是 3–7 的奇数。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
计算 Canny 边缘密度。
Image density = EdgeDensity(threshold: 50, apertureSize: 3);
信息熵
Entropy · 可执行
计算图像的信息熵,衡量图像纹理复杂度。
签名
Image entropy = Entropy(channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
channelint- 目标通道索引。
返回值
returnImage- 返回输入图像克隆;量测值s 输出 entropyBits、occupiedBins、pixelCount。
行为
- 提取 channel 后按固定 256 个 bin 计算直方图。
- 按 H = -Σ(p×log2(p)) 计算熵;图像数据不变。
错误与限制
VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像,或 channel 超出范围。VISION_CORE_RESULT_NON_FINITE:熵结果包含 NaN 或 Infinity。
示例
计算通道 0 的信息熵。
Image entropy = Entropy(channel: 0);
聚焦度量
FocusMetrics · 可执行
计算 Laplacian 方差、Tenengrad 均值和 Brenner 均值三种聚焦指标。
签名
Image focus = FocusMetrics(maximumPixels: 2073600);
输入
inputImage- 由视觉图连接提供的源图像。
参数
maximumPixelsint- 参与计算的最大像素数。
返回值
returnImage- 返回输入图像克隆;量测值s 输出 laplacianVariance、tenengradMean、brennerMean。
行为
- 输入先转为灰度,再分别计算 Laplacian、Scharr 和 Brenner 指标。
- 输入宽度至少为 3;输入像素数不得超过 maximumPixels。
- 图像数据不变,指标进入 量测值s。
错误与限制
VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 maximumPixels。VISION_CORE_DEGENERATE_GEOMETRY:输入宽度小于 Brenner 计算要求的 3 列。VISION_CORE_RESULT_NON_FINITE:任一聚焦指标包含 NaN 或 Infinity。
示例
计算图像清晰度,最大处理 1920x1080 像素。
Image focus = FocusMetrics(maximumPixels: 2073600);
梯度幅度
GradientMagitude · 可执行
使用 Scharr 计算梯度幅值并输出单通道 8U 可视化;符号名保留历史拼写 GradientMagitude。
签名
Image grad = GradientMagitude(channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
channelint- 目标通道索引。
返回值
returnImage- 返回同尺寸单通道 8U 梯度幅值图;量测值s 输出 rawMin、rawMax、responseMean8U、channel、pixelCount。
行为
- 对指定通道计算 Scharr X/Y 梯度和 sqrt(Gx²+Gy²)。
- 32F 响应按本帧 rawMin/rawMax 线性投影为 8U;常量响应输出全零。
- 输入像素数上限为 1,048,576。
错误与限制
VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。VISION_CORE_RESULT_NON_FINITE:梯度响应包含 NaN 或 Infinity。
示例
计算通道 0 的梯度幅度图。
Image grad = GradientMagitude(channel: 0);
直方图统计
Histogram · 可执行
计算指定通道直方图并绘制 512×320 BGR8 折线图。
签名
Image hist = Histogram(bins: 256, channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
binsint- 直方图柱数。
channelint- 目标通道索引。
返回值
returnImage- 512×320 的 BGR8 直方图折线图;峰值计数和实际 bins 另写入 量测值s。
行为
- 对指定输入通道调用 视觉运行时 CalcHist,并把计数归一化到 300 像素高度后绘制折线。
- 返回的是直方图可视化图像,不返回原始 bin 数组。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:bins 不在 2–1024,或 channel 超出输入通道范围。VISION_PIPELINE_PARAMETER_TYPE:bins 或 channel 不是整数文本。
示例
计算通道 0 的 256 级直方图。
Image hist = Histogram(bins: 256, channel: 0);
二维直方图
Histogram2D · 可执行
计算两个通道的二维联合直方图并生成 512×320 Jet 色图。
签名
Image h2d = Histogram2D(bins: 32, channelA: 0, channelB: 1);
输入
inputImage- BGR8 或 BGRA8 多通道源图像。
参数
binsint- 每个维度的直方图 bin 数。
channelAint- 第一通道索引。
channelBint- 第二通道索引。
返回值
returnImage- 返回 512×320 BGR8 Jet 色图;量测值s 输出 peak、bins、channelA、channelB、totalPairs。
行为
- 在 channelA×channelB 上调用二维 CalcHist,将 bins×bins 响应归一化并应用 Jet 色表。
- 执行器不要求两个通道互异,但输入必须至少有两个通道;实际支持 BGR8 或 BGRA8。
- 输入像素数上限为 1,048,576。
错误与限制
VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入少于两个通道、不是受支持的 8-bit 格式,或通道索引越界。VISION_PIPELINE_PARAMETER_RANGE:bins 不在 2–128,或显式通道参数超出 参数合同 范围。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
计算通道 0 和 1 的 32 级 2D 联合直方图。
Image h2d = Histogram2D(bins: 32, channelA: 0, channelB: 1);
峰度和偏度
KurtosisSkewness · 可执行
计算图像像素值的峰度 (Kurtosis) 和偏度 (Skewness)。
签名
Image ks = KurtosisSkewness(channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
channelint- 目标通道索引。
返回值
returnImage- 返回输入图像克隆;量测值s 输出 mean、variance、stdDev、skewness、kurtosis、channel、pixelCount。
行为
- 两遍扫描指定通道:第一遍求均值,第二遍求二至四阶中心矩。
- 标准差≤1e-10 的常量图像将 skewness 和 kurtosis 置 0。
- 图像数据不变;输入像素数上限为 1,048,576。
错误与限制
VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像,或 channel 超出范围。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。VISION_CORE_RESULT_NON_FINITE:均值、方差、偏度或峰度包含 NaN 或 Infinity。
示例
计算通道 0 的峰度和偏度。
Image ks = KurtosisSkewness(channel: 0);
局部最大值
LocalMaximum · 可执行
计算局部窗口内像素值的最大值。
签名
Image max = LocalMaximum(windowSize: 3, channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
windowSizeint- 局部窗口大小。
channelint- 目标通道索引。
返回值
returnImage- 返回同尺寸单通道 8U 局部最大值图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount。
行为
- 以矩形结构元素和 Reflect101 边界执行一次 Dilate,得到局部最大值。
- 只接受 8-bit 的 1、3 或 4 通道图像,且像素数上限为 1,048,576。
错误与限制
VISION_PIPELINE_PARAMETER_ODD:windowSize 不是奇数。VISION_PIPELINE_PARAMETER_RELATION:windowSize 超过输入宽度或高度。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
使用 3x3 窗口计算局部最大值。
Image max = LocalMaximum(windowSize: 3, channel: 0);
局部均值
LocalMean · 可执行
计算局部均值并输出按本帧量程归一化的单通道 8U 显示图。
签名
Image mean = LocalMean(windowSize: 3, channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
windowSizeint- 局部窗口大小。
channelint- 目标通道索引。
返回值
returnImage- 返回同尺寸单通道 8U 显示图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount。
行为
- 以 Reflect101 边界调用归一化 BoxFilter 计算 64F 局部均值。
- 64F 响应按本帧 rawMin/rawMax 投影为 8U;常量响应输出全零。
- 只接受 8-bit 的 1、3 或 4 通道图像,且像素数上限为 1,048,576。
错误与限制
VISION_PIPELINE_PARAMETER_ODD:windowSize 不是奇数。VISION_PIPELINE_PARAMETER_RELATION:windowSize 超过输入宽度或高度。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
使用 3x3 窗口计算局部均值。
Image mean = LocalMean(windowSize: 3, channel: 0);
局部最小值
LocalMinimum · 可执行
计算局部窗口内像素值的最小值。
签名
Image min = LocalMinimum(windowSize: 3, channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
windowSizeint- 局部窗口大小。
channelint- 目标通道索引。
返回值
returnImage- 返回同尺寸单通道 8U 局部最小值图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount。
行为
- 以矩形结构元素和 Reflect101 边界执行一次 Erode,得到局部最小值。
- 只接受 8-bit 的 1、3 或 4 通道图像,且像素数上限为 1,048,576。
错误与限制
VISION_PIPELINE_PARAMETER_ODD:windowSize 不是奇数。VISION_PIPELINE_PARAMETER_RELATION:windowSize 超过输入宽度或高度。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
使用 3x3 窗口计算局部最小值。
Image min = LocalMinimum(windowSize: 3, channel: 0);
局部平方均值 (8U)
LocalSquaredMean8U · 可执行
计算局部窗口内像素平方值的均值。
签名
Image lsm = LocalSquaredMean8U(windowSize: 3, channel: 0);
输入
inputImage- 8 位无符号整数源图像。
参数
windowSizeint- 局部窗口大小。
channelint- 目标通道索引。
返回值
returnImage- 返回同尺寸单通道 8U 显示图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount。
行为
- 以 Reflect101 边界计算 windowSize×windowSize 邻域内像素平方值的均值。
- 真实响应按本帧 rawMin/rawMax 线性投影为 0–255;常量响应输出全零。
- 只接受 8-bit 的 1、3 或 4 通道图像,且像素数上限为 1,048,576。
错误与限制
VISION_WAVEC_STATISTICS_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。VISION_WAVEC_STATISTICS_INPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。VISION_WAVEC_STATISTICS_WINDOW_INVALID:windowSize 不是 1–255 的奇数,或超过输入宽高。VISION_WAVEC_STATISTICS_RESULT_NON_FINITE:64F 或 8U 统计响应包含非有限值。
示例
使用 3x3 窗口计算局部平方均值。
Image lsm = LocalSquaredMean8U(windowSize: 3, channel: 0);
局部标准差 (8U)
LocalStdDev8U · 可执行
计算局部窗口内像素值的标准差。
签名
Image stddev = LocalStdDev8U(windowSize: 3, channel: 0);
输入
inputImage- 8 位无符号整数源图像。
参数
windowSizeint- 局部窗口大小。
channelint- 目标通道索引。
返回值
returnImage- 返回同尺寸单通道 8U 显示图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount、negativeClampCount。
行为
- 先按 E[x²]−E[x]² 计算局部方差,再对非负方差开平方。
- 绝对值不超过 1e-9 的负方差夹为 0;真实响应按本帧量程投影为 8U。
- 只接受 8-bit 的 1、3 或 4 通道图像,且像素数上限为 1,048,576。
错误与限制
VISION_WAVEC_STATISTICS_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。VISION_WAVEC_STATISTICS_INPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。VISION_WAVEC_STATISTICS_WINDOW_INVALID:windowSize 不是 1–255 的奇数,或超过输入宽高。VISION_WAVEC_STATISTICS_NEGATIVE_VARIANCE_EXCEEDED:负方差小于 -1e-9。VISION_WAVEC_STATISTICS_RESULT_NON_FINITE:统计响应包含 NaN 或 Infinity。
示例
使用 3x3 窗口计算局部标准差。
Image stddev = LocalStdDev8U(windowSize: 3, channel: 0);
局部方差 (8U)
LocalVariance8U · 可执行
计算局部窗口内像素值的方差。
签名
Image variance = LocalVariance8U(windowSize: 3, channel: 0);
输入
inputImage- 8 位无符号整数源图像。
参数
windowSizeint- 局部窗口大小。
channelint- 目标通道索引。
返回值
returnImage- 返回同尺寸单通道 8U 显示图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount、negativeClampCount。
行为
- 以 Reflect101 边界计算 E[x²]−E[x]²。
- 绝对值不超过 1e-9 的负方差夹为 0;更大的负值 fail-closed。
- 真实响应按本帧 rawMin/rawMax 投影为 8U;像素数上限为 1,048,576。
错误与限制
VISION_WAVEC_STATISTICS_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像,或 channel 超出范围。VISION_WAVEC_STATISTICS_INPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。VISION_WAVEC_STATISTICS_WINDOW_INVALID:windowSize 不是 1–255 的奇数,或超过输入宽高。VISION_WAVEC_STATISTICS_NEGATIVE_VARIANCE_EXCEEDED:负方差小于 -1e-9,不能归因于舍入误差。VISION_WAVEC_STATISTICS_RESULT_NON_FINITE:统计响应包含 NaN 或 Infinity。
示例
使用 3x3 窗口计算局部方差。
Image variance = LocalVariance8U(windowSize: 3, channel: 0);
中心块中位绝对偏差 (MAD)
MadBlockMetric · 可执行
计算中心块像素相对该块中位数的平均绝对偏差。
签名
Image mad = MadBlockMetric(blockSize: 8, channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
blockSizeint- 块大小。
channelint- 目标通道索引。
返回值
returnImage- 返回输入图像克隆;量测值s 输出 mad、meanMad、blockSize、channel、pixelCount。
行为
- 提取居中的 blockSize×blockSize 区域,排序求中位数,再计算平均绝对偏差。
- 这是单图中心块统计,不比较两幅图像或相邻块。
- blockSize 不得超过输入宽高;输入像素数上限为 1,048,576。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:blockSize 不在 1–64,或 channel 超出范围。VISION_PIPELINE_PARAMETER_RELATION:blockSize 超过输入宽度或高度。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
使用 8x8 块计算 MAD 度量。
Image mad = MadBlockMetric(blockSize: 8, channel: 0);
众数滤波
MajorityFilter · 可执行
对图像执行众数滤波, 每个像素替换为局部窗口中出现次数最多的灰度值。
签名
Image majority = MajorityFilter(windowSize: 3, channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
windowSizeint- 局部窗口大小。
channelint- 目标通道索引。
返回值
returnImage- 返回同尺寸单通道 8U 众数滤波图;量测值s 输出 responseMean8U、windowSize、channel、pixelCount。
行为
- 逐像素统计裁剪到图像边界内的局部窗口 256 级直方图,并取计数最大的最小灰度值。
- windowSize 上限 15 是 O(N×W²) 复杂度护栏;像素数上限为 1,048,576。
- 出现并列众数时选择灰度值较小者。
错误与限制
VISION_PIPELINE_PARAMETER_ODD:windowSize 不是奇数。VISION_PIPELINE_PARAMETER_RANGE:windowSize 不在 1–15,或 channel 超出范围。VISION_PIPELINE_PARAMETER_RELATION:windowSize 超过输入宽度或高度。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
使用 3x3 窗口执行众数滤波。
Image majority = MajorityFilter(windowSize: 3, channel: 0);
灰度中值模糊
MedianBlurGray · 可执行
对灰度图像执行中值模糊滤波。
签名
Image median = MedianBlurGray(kernelSize: 3, channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
kernelSizeint- 参数合同 声明的中值核大小;当前执行器未读取该字段,实际固定使用隐式 windowSize=3。
channelint- 目标通道索引。
返回值
returnImage- 返回同尺寸单通道 8U 中值滤波图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount。
行为
- 提取 channel 后调用 视觉运行时 MedianBlur。
- 当前执行器的窗口校验读取未公开的 windowSize 并回落到 3,随后以 3 调用 MedianBlur;公开 kernelSize 目前不影响执行结果。
- 输入像素数上限为 1,048,576。
错误与限制
VISION_PIPELINE_PARAMETER_ODD:参数合同 中的 kernelSize 不是奇数。VISION_PIPELINE_PARAMETER_RANGE:kernelSize 不在 1–255,或 channel 超出范围。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
使用 3x3 核执行中值滤波。
Image median = MedianBlurGray(kernelSize: 3, channel: 0);
百分位数
Percentile · 可执行
计算图像指定百分位数的像素值。
签名
Image pct = Percentile(percentile: 50, channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
percentileint- 百分位数 (0–100)。
channelint- 目标通道索引。
返回值
returnImage- 返回输入图像克隆;量测值s 输出 percentileValue、percentile、pixelCount、channel。
行为
- 读取指定通道的全部像素并执行升序排序,索引为 round((percentile/100)×(N−1))。
- percentile=50 为本实现的离散中位数取样;图像数据不变。
- 只接受 8-bit 的 1、3 或 4 通道图像,且像素数上限为 1,048,576。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:percentile 不在 0–100,或 channel 超出输入通道范围。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
计算通道 0 的中位数。
Image median = Percentile(percentile: 50, channel: 0);
像素统计
PixelStatistics · 可执行
计算指定通道的最小值、最大值、均值、标准差、非零像素数和总像素数。
签名
Image stats = PixelStatistics(channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
channelint- 目标通道索引。
返回值
returnImage- 返回输入图像克隆;量测值s 输出 minimum、maximum、mean、stdDev、nonZeroCount、pixelCount。
行为
- 从 8-bit 的 1、3 或 4 通道输入提取 channel,调用 MinMaxLoc 和 MeanStdDev。
- 图像数据不变;统计量进入 量测值s,不返回匿名结构体。
错误与限制
VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像,或 channel 超出范围。VISION_CORE_RESULT_NON_FINITE:统计结果包含 NaN 或 Infinity。
示例
计算通道 0 的像素统计量。
Image stats = PixelStatistics(channel: 0);
峰值信噪比 (PSNR)
Psnr · 可执行
比较指定通道与其高斯模糊副本,计算高频细节的 PSNR 指标。
签名
Image psnr = Psnr(blurRadius: 3, channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
blurRadiusint- 高斯模糊半径。
channelint- 目标通道索引。
返回值
returnImage- 返回输入图像克隆;量测值s 输出 psnr、mse、blurRadius、channel、pixelCount。
行为
- 对指定通道执行 blurRadius×blurRadius 高斯模糊,并计算 MSE。
- PSNR=10×log10(255²/MSE);MSE≤1e-10 时返回 100 dB 上限。
- 这是单输入高频细节指标,不接受第二幅参考图;像素数上限为 1,048,576。
错误与限制
VISION_PIPELINE_PARAMETER_ODD:blurRadius 不是奇数。VISION_PIPELINE_PARAMETER_RELATION:blurRadius 超过输入最大尺寸。VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
计算通道 0 的 PSNR。
Image psnr = Psnr(blurRadius: 3, channel: 0);
中心块绝对偏差和 (SAD)
SadBlockMetric · 可执行
计算中心块像素相对全图均值的绝对偏差和与平均值。
签名
Image sad = SadBlockMetric(blockSize: 8, channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
blockSizeint- 块大小。
channelint- 目标通道索引。
返回值
returnImage- 返回输入图像克隆;量测值s 输出 sad、meanSad、blockSize、channel、pixelCount。
行为
- 先计算指定通道的全图均值,再取居中的 blockSize×blockSize 区域累加绝对偏差。
- 这是单图中心块统计,不比较两幅图像或两个块。
- blockSize 不得超过输入宽高;输入像素数上限为 1,048,576。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:blockSize 不在 1–64,或 channel 超出范围。VISION_PIPELINE_PARAMETER_RELATION:blockSize 超过输入宽度或高度。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
使用 8x8 块计算 SAD 度量。
Image sad = SadBlockMetric(blockSize: 8, channel: 0);
清晰度度量
SharpnessMetric · 可执行
一次计算 Laplacian 方差、Tenengrad 均值和 Brenner 均值三种清晰度指标。
签名
Image sharpness = SharpnessMetric(variant: "All");
输入
inputImage- 由视觉图连接提供的源图像。
参数
variantstring- 清晰度度量方法。
返回值
returnImage- 返回输入图像克隆;量测值s 输出 laplacianVariance、tenengradMean、brennerMean、variant。
行为
- variant=All 时一次计算 LaplacianVariance、Tenengrad 和 Brenner,并写入三个 量测值。
- 当前执行器会对未计算的 量测值 做有限性校验,因此单独选择 LaplacianVariance、Tenengrad 或 Brenner 会以 VISION_CORE_RESULT_NON_FINITE 失败;可执行合同限 All。
- Brenner 要求输入宽度至少 3;输入像素数上限为 1,048,576。
错误与限制
VISION_PIPELINE_PARAMETER_ENUM:variant 不在 LaplacianVariance、Tenengrad、Brenner、All。VISION_CORE_DEGENERATE_GEOMETRY:执行 Brenner 时输入宽度小于 3。VISION_CORE_RESULT_NON_FINITE:结果包含非有限值;当前也包括选择非 All 单变体的执行限制。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
一次计算并输出三项清晰度 量测值。
Image sharp = SharpnessMetric(variant: "All");
结构相似性 (SSIM)
Ssim · 可执行
比较指定通道与其高斯模糊副本,计算局部结构相似性均值。
签名
Image ssim = Ssim(blurRadius: 3, windowSize: 3, channel: 0);
输入
inputImage- 由视觉图连接提供的源图像。
参数
blurRadiusint- 高斯模糊半径。
windowSizeint- SSIM 局部窗口边长;当前执行器隐式默认 8 与奇数约束冲突,调用时必须显式传入合法奇数。
channelint- 目标通道索引。
返回值
returnImage- 返回输入图像克隆;量测值s 输出 ssim、ssimMean、blurRadius、windowSize、channel、pixelCount。
行为
- 源通道先生成高斯模糊副本,再以 BoxFilter 计算局部均值、方差和协方差。
- 采用 L=255、K1=0.01、K2=0.03 的 SSIM 常数,输出 ssimMap 的全图均值。
- 这是单输入指标;像素数上限为 1,048,576。
错误与限制
VISION_PIPELINE_PARAMETER_ODD:blurRadius 或 windowSize 不是奇数;省略 windowSize 时当前隐式默认 8 也会触发此错误。VISION_PIPELINE_PARAMETER_RELATION:blurRadius 超过输入最大尺寸,或 windowSize 超过输入宽高。VISION_CORE_RESULT_NON_FINITE:SSIM 均值为 NaN 或 Infinity。VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
示例
计算通道 0 的 SSIM。
Image ssim = Ssim(blurRadius: 3, windowSize: 3, channel: 0);