图像变换
用于金字塔、直角旋转、翻转、转置和坐标重映射。
多轴翻转
FLIPMULTI · 可执行
按 X、Y 或 XY 模式沿一个或两个轴翻转图像。
签名
var flipped = FLIPMULTI(mode: "X");
输入
inputImage- 由视觉图上游图像边连接提供;不是节点调用参数。
参数
modestring- 多轴翻转模式。
输出
outputImage- 与输入同尺寸、同类型的翻转图像。
行为
- 图像变换族分派器调用执行体:X 对应绕 X 轴翻转(上下),Y 对应绕 Y 轴翻转(左右),XY 同时翻转;也接受 VERTICAL/HORIZONTAL/BOTH 别名。
- 默认 mode=X。输出与输入同尺寸、同类型。
- 与几何族 Flip 功能相近,但是独立实现,保持族内聚。
错误与限制
VISION_PIPELINE_PARAMETER_ENUM:mode 不是 X、Y、XY(或 VERTICAL、HORIZONTAL、BOTH)。
示例
沿两个轴翻转
var flipped = FLIPMULTI(mode: "XY");
构建图像金字塔
PYRAMIDBUILD · 可执行
连续执行 levels 次 PyrDown,并返回最后一层图像及各层尺寸量测。
签名
var pyramid = PYRAMIDBUILD(levels: 3);
输入
inputImage- 由视觉图上游图像边连接提供;不是节点调用参数。
参数
levelsint- 连续金字塔降采样层数。
输出
outputImage- 连续 levels 次 PyrDown 后的最后一层图像。
Measurements量测值集合- 包含 levelNWidth/Height、levels 与 sourceWidth/Height 节点前缀量测。
行为
- 连续 levels 次金字塔降采样,只返回最后一层图像,不把中间层当作图像对象输出。
- 写入
{nodeId}.levelNWidth/Height、levels、sourceWidth/Height。 - 某一层宽或高变为空时 fail-closed,禁止输出黑图冒充成功。
错误与限制
VISION_PIPELINE_PARAMETER_RANGE:levels 不在 1–6。- 降采样后某一层为空时抛出上下文无效,不返回黑图。
示例
构建 3 层金字塔并取最底层
var pyramid = PYRAMIDBUILD(levels: 3);
像素重映射
REMAP · 可执行
按 identity、swirl 或 wave 坐标场重映射图像。
签名
var remapped = REMAP(mapType: "identity");
输入
inputImage- 由视觉图上游图像边连接提供;不是节点调用参数。
参数
mapTypestring- 内置映射类型。
swirlStrengthdouble- swirl 模式的旋涡强度。
waveAmplitudeXdouble- wave 模式的 X 偏移振幅。
waveAmplitudeYdouble- wave 模式的 Y 偏移振幅。
waveFrequencydouble- wave 模式的空间频率。
interpolationstring- 重映射插值方式。
输出
outputImage- 与输入同尺寸、同类型的重映射图像。
Measurements量测值集合- 包含 mapType;swirl 另含 swirlStrength,wave 另含 waveAmplitudeX/Y。
行为
- identity 使用恒等坐标场,swirl 绕图像中心生成旋涡场,wave 生成双向正弦偏移场。
- 映射到输入边界外的像素填 0。量测把 mapType 记为 identity=0、swirl=1、wave=2。
错误与限制
VISION_PIPELINE_PARAMETER_ENUM:mapType 或 interpolation 不在合同枚举中。VISION_PIPELINE_PARAMETER_RANGE:swirlStrength、振幅或频率越出合同范围。
示例
按正弦波坐标场重映射
var remapped = REMAP(mapType: "wave", waveAmplitudeX: 10, waveAmplitudeY: 6, waveFrequency: 0.05, interpolation: "Linear");
直角旋转
ROTATE90 · 可执行
不插值地将图像顺时针旋转 90°、180° 或 270°。
签名
var rotated = ROTATE90(mode: "Clockwise90");
输入
inputImage- 由视觉图上游图像边连接提供;不是节点调用参数。
参数
modestring- 固定角度旋转模式。
输出
outputImage- 按固定直角旋转后的图像。
行为
- Clockwise90 顺时针 90°,Clockwise180 旋转 180°,Clockwise270 对应逆时针 90°(与执行体 RotateFlags 一致)。
- 90°/270° 交换宽高,180° 保持宽高;固定直角旋转不插值。
错误与限制
VISION_PIPELINE_PARAMETER_ENUM:mode 不是 Clockwise90、Clockwise180 或 Clockwise270。
示例
顺时针旋转 90°
var rotated = ROTATE90(mode: "Clockwise90");
图像转置
TRANSPOSE · 可执行
交换图像的行列坐标,使输出宽高互换。
签名
var transposed = TRANSPOSE();
输入
inputImage- 由视觉图上游图像边连接提供;不是节点调用参数。
参数
无参数。
输出
outputImage- 行列互换后的图像。
行为
- 交换行列坐标,输出宽度等于输入高度,输出高度等于输入宽度。
- 图像变换族已由注册中心接到分派器,无需额外控制参数。
错误与限制
- 输入为空或未通过图像变换族输入校验时执行失败。
示例
转置图像行列
var transposed = TRANSPOSE();