跳到主要内容

图像变换

用于金字塔、直角旋转、翻转、转置和坐标重映射。

多轴翻转​

FLIPMULTI · 可执行

按 X、Y 或 XY 模式沿一个或两个轴翻转图像。

签名​

var flipped = FLIPMULTI(mode: "X");

输入​

inputImage
  • 输入
  • 必填
  • 约束 必须为非空图像。实际像素深度、通道数、尺寸和资源预算由对应执行体在分配输出前校验。
由视觉图上游图像边连接提供;不是节点调用参数。

参数​

modestring
  • 输入
  • 可选
  • 默认 X
  • 约束 可选 X、Y、XY。
多轴翻转模式。

输出​

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
  • 输入
  • 可选
  • 默认 3
  • 约束 范围为 1–6。
连续金字塔降采样层数。

输出​

outputImage
  • 约束 该输出不包含全部金字塔层的图像对象。
连续 levels 次 PyrDown 后的最后一层图像。
Measurements量测值集合
  • 约束 N 从 1 到 levels。
包含 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
  • 输入
  • 可选
  • 默认 identity
  • 约束 可选 identity、swirl、wave。
内置映射类型。
swirlStrengthdouble
  • 输入
  • 可选
  • 默认 0.5
  • 约束 范围为 0–10。
swirl 模式的旋涡强度。
waveAmplitudeXdouble
  • 输入
  • 可选
  • 默认 10
  • 约束 范围为 0–1000。
wave 模式的 X 偏移振幅。
waveAmplitudeYdouble
  • 输入
  • 可选
  • 默认 10
  • 约束 范围为 0–1000。
wave 模式的 Y 偏移振幅。
waveFrequencydouble
  • 输入
  • 可选
  • 默认 0.05
  • 约束 范围为 0.0001–1。
wave 模式的空间频率。
interpolationstring
  • 输入
  • 可选
  • 默认 Linear
  • 约束 可选 Nearest、Linear、Cubic、Lanczos4。
重映射插值方式。

输出​

outputImage
  • 约束 映射到输入边界外的像素填 0。
与输入同尺寸、同类型的重映射图像。
Measurements量测值集合
  • 约束 mapType 以 identity=0、swirl=1、wave=2 表示。
包含 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
  • 输入
  • 可选
  • 默认 Clockwise90
  • 约束 可选 Clockwise90、Clockwise180、Clockwise270。
固定角度旋转模式。

输出​

outputImage
  • 约束 90°/270° 交换宽高;180° 保持宽高。
按固定直角旋转后的图像。

行为​

  • 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();