跳到主要内容

几何

用于缩放、裁剪、旋转、仿射/透视变换和几何量计算。

环形扇区面积形心​

AnnularSectorAreaCentroid · 可执行

计算环形扇区(含内径和外径的扇形)的面积与形心。

签名​

var result = AnnularSectorAreaCentroid(centerX: 100, centerY: 100, innerRadiusPixels: 20, outerRadiusPixels: 50, startAngleDegrees: 0, endAngleDegrees: 90);

输入​

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

参数​

centerXdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
环形扇区圆心 X 坐标。
centerYdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
环形扇区圆心 Y 坐标。
innerRadiusPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0–32768。必须小于 outerRadiusPixels。
内半径,单位为像素。
outerRadiusPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0.5–32768。必须大于 innerRadiusPixels。
外半径,单位为像素。
startAngleDegreesdouble
  • 输入
  • 必填
  • 约束 必须为有限值。
有向扇区起始角,单位为度。
endAngleDegreesdouble
  • 输入
  • 必填
  • 约束 必须为有限值。
有向扇区终止角,单位为度。

输出​

outputImage
在输入图像副本上绘制环形扇区与形心的可视化结果。
Measurements量测值集合
  • 约束 Measurements 是执行结果集合,不是图连接端口。
包含 area、centroidX/Y、perimeterPixels、内外弧长、径向边长、归一化角度、扫掠方向与半径等节点前缀量测。

行为​

  • 外半径必须大于内半径。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 AnnularSectorAreaCentroid。

var result = AnnularSectorAreaCentroid(centerX: 100, centerY: 100, innerRadiusPixels: 20, outerRadiusPixels: 50, startAngleDegrees: 0, endAngleDegrees: 90);

圆与矩形相交面积​

CircleRectangleIntersectionArea · 可执行

计算圆与旋转矩形之间的相交面积。

签名​

var area = CircleRectangleIntersectionArea(circleCenterX: 100, circleCenterY: 100, radiusPixels: 50, rectangleCenterX: 150, rectangleCenterY: 150, rectangleWidthPixels: 100, rectangleHeightPixels: 80, rectangleAngleDegrees: 0);

输入​

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

参数​

circleCenterXdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
圆心 X 坐标。
circleCenterYdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
圆心 Y 坐标。
radiusPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0.5–32768。
圆半径,单位为像素。
rectangleCenterXdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
旋转矩形中心 X 坐标。
rectangleCenterYdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
旋转矩形中心 Y 坐标。
rectangleWidthPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0.5–32768。
旋转矩形宽度,单位为像素。
rectangleHeightPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0.5–32768。
旋转矩形高度,单位为像素。
rectangleAngleDegreesdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -360000–360000。
旋转矩形角度,单位为度。

输出​

outputImage
在输入图像副本上绘制圆、旋转矩形及交叠边界。
Measurements量测值集合
  • 约束 Measurements 是执行结果集合,不是图连接端口。
包含交叠面积、覆盖率、形心、交叠周长、边界交点数与拓扑关系码等节点前缀量测。

行为​

  • 圆和矩形均为参数化输入,不依赖图像输入。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 CircleRectangleIntersectionArea。

var area = CircleRectangleIntersectionArea(circleCenterX: 100, circleCenterY: 100, radiusPixels: 50, rectangleCenterX: 150, rectangleCenterY: 150, rectangleWidthPixels: 100, rectangleHeightPixels: 80, rectangleAngleDegrees: 0);

轮廓面积​

ContourMomentArea · 可执行

按显式顶点槽计算最多 16 条轮廓的非负面积。

签名​

var areas = ContourMomentArea(pointCount: 1, contour0VertexCount: 3, contour0Vertex0X: 20, contour0Vertex0Y: 20, contour0Vertex1X: 100, contour0Vertex1Y: 20, contour0Vertex2X: 60, contour0Vertex2Y: 90);

输入​

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

参数​

pointCountint
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 1–16。
参与计算的轮廓数量。
contourVertexCountsDINT[16]
  • 输入
  • 可选
  • 默认 3(每个有效 contourNVertexCount)
  • 约束 每个有效轮廓至少 3 个顶点,最多 16 个顶点。
轮廓顶点计数槽组;实际节点参数名为 contour0VertexCount 至 contour15VertexCount,仅 pointCount 覆盖的槽参与计算。
contourVertexCoordinatesLREAL[16,16,2]
  • 输入
  • 可选
  • 默认 0(未提供的 contourNVertexMX/Y 槽)
  • 约束 坐标必须为有限值;每个轮廓只读取其 contourNVertexCount 覆盖的槽。
轮廓顶点坐标槽组;实际节点参数名为 contourNVertexMX/Y,N、M 范围均为 0–15。

输出​

outputImage
输入图像的可视化副本。
Measurements量测值集合
  • 约束 仅有效轮廓生成对应 areaN。
包含 contourCount 与 area0–area15 节点前缀量测。

行为​

  • 按 pointCount 读取轮廓顶点,坐标舍入为整数像素后计算面积。

错误与限制​

  • WAVEE_GEOMETRY_CONTOUR_VERTEX_COUNT:任一有效轮廓的顶点数不在 3–16。
  • WAVEE_GEOMETRY_CONTOUR_VERTEX_NONFINITE:任一有效顶点坐标不是有限数。
  • WAVEE_GEOMETRY_CONTOUR_AREA_FAIL:轮廓面积计算失败。

示例​

轮廓矩面积

var areas = ContourMomentArea(pointCount: 1, contour0VertexCount: 3, contour0Vertex0X: 20, contour0Vertex0Y: 20, contour0Vertex1X: 100, contour0Vertex1Y: 20, contour0Vertex2X: 60, contour0Vertex2Y: 90);

凸多边形面积形心​

ConvexPolygonAreaCentroid · 可执行

计算凸多边形的面积与形心。

签名​

var result = ConvexPolygonAreaCentroid(polygonVertexCount: 3, polygonVertex0X: 20, polygonVertex0Y: 20, polygonVertex1X: 120, polygonVertex1Y: 20, polygonVertex2X: 70, polygonVertex2Y: 100);

输入​

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

参数​

polygonVertexCountint
  • 输入
  • 必填
  • 约束 允许 3–16。
凸多边形有效顶点数。
polygonVertexCoordinatesLREAL[16,2]
  • 输入
  • 可选
  • 默认 0(未提供坐标槽;有效顶点槽必须显式给出)
  • 约束 X 范围为 0–input.Width-1;Y 范围为 0–input.Height-1。有效顶点必须组成严格凸多边形。
凸多边形顶点坐标槽组;实际节点参数名为 polygonVertex0X/Y 至 polygonVertex15X/Y,计数范围内的槽必须提供。

输出​

outputImage
在输入图像副本上绘制凸多边形及形心。
Measurements量测值集合
  • 约束 Measurements 是执行结果集合,不是图连接端口。
包含 area、signedArea、centroidX/Y、vertexCount、perimeterPixels 及边长范围等节点前缀量测。

行为​

  • 要求多边形为严格凸多边形。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 ConvexPolygonAreaCentroid。

var result = ConvexPolygonAreaCentroid(polygonVertexCount: 3, polygonVertex0X: 20, polygonVertex0Y: 20, polygonVertex1X: 120, polygonVertex1Y: 20, polygonVertex2X: 70, polygonVertex2Y: 100);

凸多边形直径​

ConvexPolygonDiameter · 可执行

计算凸多边形的直径(最远顶点对距离)。

签名​

var diameter = ConvexPolygonDiameter(polygon1VertexCount: 3, polygon1Vertex0X: 20, polygon1Vertex0Y: 20, polygon1Vertex1X: 120, polygon1Vertex1Y: 20, polygon1Vertex2X: 70, polygon1Vertex2Y: 100);

输入​

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

参数​

polygon1VertexCountint
  • 输入
  • 必填
  • 约束 允许 3–16。
凸多边形有效顶点数。
polygon1VertexCoordinatesLREAL[16,2]
  • 输入
  • 可选
  • 默认 0(未提供坐标槽;有效顶点槽必须显式给出)
  • 约束 X 范围为 0–input.Width-1;Y 范围为 0–input.Height-1。有效顶点必须组成严格凸多边形。
凸多边形顶点坐标槽组;实际节点参数名为 polygon1Vertex0X/Y 至 polygon1Vertex15X/Y,计数范围内的槽必须提供。

输出​

outputImage
在输入图像副本上绘制直径端点与连线。
Measurements量测值集合
  • 约束 Measurements 是执行结果集合,不是图连接端口。
包含 diameterPixels、两端点坐标、方向角、polygonArea 与 vertexCount 等节点前缀量测。

行为​

  • 要求多边形为严格凸多边形。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 ConvexPolygonDiameter。

var diameter = ConvexPolygonDiameter(polygon1VertexCount: 3, polygon1Vertex0X: 20, polygon1Vertex0Y: 20, polygon1Vertex1X: 120, polygon1Vertex1Y: 20, polygon1Vertex2X: 70, polygon1Vertex2Y: 100);

凸多边形差集面积形心​

ConvexPolygonDifferenceAreaCentroid · 可执行

计算两个凸多边形的差集面积与形心(polygon1 - polygon2)。

签名​

var result = ConvexPolygonDifferenceAreaCentroid(polygon1VertexCount: 3, polygon1Vertex0X: 20, polygon1Vertex0Y: 20, polygon1Vertex1X: 120, polygon1Vertex1Y: 20, polygon1Vertex2X: 70, polygon1Vertex2Y: 100, polygon2VertexCount: 3, polygon2Vertex0X: 60, polygon2Vertex0Y: 40, polygon2Vertex1X: 150, polygon2Vertex1Y: 40, polygon2Vertex2X: 100, polygon2Vertex2Y: 130);

输入​

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

参数​

polygon1VertexCountint
  • 输入
  • 必填
  • 约束 允许 3–16。
被减凸多边形有效顶点数。
polygon2VertexCountint
  • 输入
  • 必填
  • 约束 允许 3–16。
减去的凸多边形有效顶点数。
polygonVertexCoordinatesLREAL[2,16,2]
  • 输入
  • 可选
  • 默认 0(未提供坐标槽;有效顶点槽必须显式给出)
  • 约束 X 范围为 0–input.Width-1;Y 范围为 0–input.Height-1。两个有效顶点序列都必须组成严格凸多边形。
两个凸多边形的顶点坐标槽组;实际节点参数名为 polygon1Vertex0X/Y 至 polygon2Vertex15X/Y,各自计数范围内的槽必须提供。

输出​

outputImage
在输入图像副本上绘制 polygon1 - polygon2 的差集结果。
Measurements量测值集合
  • 约束 empty 与 boundaryContact 以 0/1 表示。
包含两多边形面积、intersectionArea、differenceArea、differenceCentroidX/Y、removedRatio、empty 与 boundaryContact 等量测。

行为​

  • 要求两个多边形均为严格凸多边形。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 ConvexPolygonDifferenceAreaCentroid。

var result = ConvexPolygonDifferenceAreaCentroid(polygon1VertexCount: 3, polygon1Vertex0X: 20, polygon1Vertex0Y: 20, polygon1Vertex1X: 120, polygon1Vertex1Y: 20, polygon1Vertex2X: 70, polygon1Vertex2Y: 100, polygon2VertexCount: 3, polygon2Vertex0X: 60, polygon2Vertex0Y: 40, polygon2Vertex1X: 150, polygon2Vertex1Y: 40, polygon2Vertex2X: 100, polygon2Vertex2Y: 130);

凸多边形相交​

ConvexPolygonIntersection · 可执行

计算两个凸多边形的交集面积与形心。

签名​

var result = ConvexPolygonIntersection(polygon1VertexCount: 3, polygon1Vertex0X: 20, polygon1Vertex0Y: 20, polygon1Vertex1X: 120, polygon1Vertex1Y: 20, polygon1Vertex2X: 70, polygon1Vertex2Y: 100, polygon2VertexCount: 3, polygon2Vertex0X: 60, polygon2Vertex0Y: 40, polygon2Vertex1X: 150, polygon2Vertex1Y: 40, polygon2Vertex2X: 100, polygon2Vertex2Y: 130);

输入​

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

参数​

polygon1VertexCountint
  • 输入
  • 必填
  • 约束 允许 3–16。
第一个凸多边形有效顶点数。
polygon2VertexCountint
  • 输入
  • 必填
  • 约束 允许 3–16。
第二个凸多边形有效顶点数。
polygonVertexCoordinatesLREAL[2,16,2]
  • 输入
  • 可选
  • 默认 0(未提供坐标槽;有效顶点槽必须显式给出)
  • 约束 X 范围为 0–input.Width-1;Y 范围为 0–input.Height-1。两个有效顶点序列都必须组成严格凸多边形。
两个凸多边形的顶点坐标槽组;实际节点参数名为 polygon1Vertex0X/Y 至 polygon2Vertex15X/Y,各自计数范围内的槽必须提供。

输出​

outputImage
在输入图像副本上绘制两个多边形及交集。
Measurements量测值集合
  • 约束 交集顶点最多 32 个。
包含两多边形顶点数、intersectionArea、intersectionVertexCount、交集存在性、形心及交集顶点坐标等节点前缀量测。

行为​

  • 要求两个多边形均为严格凸多边形。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 ConvexPolygonIntersection。

var result = ConvexPolygonIntersection(polygon1VertexCount: 3, polygon1Vertex0X: 20, polygon1Vertex0Y: 20, polygon1Vertex1X: 120, polygon1Vertex1Y: 20, polygon1Vertex2X: 70, polygon1Vertex2Y: 100, polygon2VertexCount: 3, polygon2Vertex0X: 60, polygon2Vertex0Y: 40, polygon2Vertex1X: 150, polygon2Vertex1Y: 40, polygon2Vertex2X: 100, polygon2Vertex2Y: 130);

凸多边形最小宽度​

ConvexPolygonMinimumWidth · 可执行

计算凸多边形的最小宽度(卡尺方向)。

签名​

var width = ConvexPolygonMinimumWidth(polygon1VertexCount: 3, polygon1Vertex0X: 20, polygon1Vertex0Y: 20, polygon1Vertex1X: 120, polygon1Vertex1Y: 20, polygon1Vertex2X: 70, polygon1Vertex2Y: 100);

输入​

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

参数​

polygon1VertexCountint
  • 输入
  • 必填
  • 约束 允许 3–16。
凸多边形有效顶点数。
polygon1VertexCoordinatesLREAL[16,2]
  • 输入
  • 可选
  • 默认 0(未提供坐标槽;有效顶点槽必须显式给出)
  • 约束 X 范围为 0–input.Width-1;Y 范围为 0–input.Height-1。有效顶点必须组成严格凸多边形。
凸多边形顶点坐标槽组;实际节点参数名为 polygon1Vertex0X/Y 至 polygon1Vertex15X/Y,计数范围内的槽必须提供。

输出​

outputImage
在输入图像副本上绘制最小宽度支撑线与接触点。
Measurements量测值集合
  • 约束 Measurements 是执行结果集合,不是图连接端口。
包含 minimumWidthPixels、支撑方向、两支撑偏移、接触点、polygonArea 与 vertexCount 等量测。

行为​

  • 要求多边形为严格凸多边形。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 ConvexPolygonMinimumWidth。

var width = ConvexPolygonMinimumWidth(polygon1VertexCount: 3, polygon1Vertex0X: 20, polygon1Vertex0Y: 20, polygon1Vertex1X: 120, polygon1Vertex1Y: 20, polygon1Vertex2X: 70, polygon1Vertex2Y: 100);

凸多边形并集面积形心​

ConvexPolygonUnionAreaCentroid · 可执行

计算两个凸多边形的并集面积与形心。

签名​

var result = ConvexPolygonUnionAreaCentroid(polygon1VertexCount: 3, polygon1Vertex0X: 20, polygon1Vertex0Y: 20, polygon1Vertex1X: 120, polygon1Vertex1Y: 20, polygon1Vertex2X: 70, polygon1Vertex2Y: 100, polygon2VertexCount: 3, polygon2Vertex0X: 60, polygon2Vertex0Y: 40, polygon2Vertex1X: 150, polygon2Vertex1Y: 40, polygon2Vertex2X: 100, polygon2Vertex2Y: 130);

输入​

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

参数​

polygon1VertexCountint
  • 输入
  • 必填
  • 约束 允许 3–16。
第一个凸多边形有效顶点数。
polygon2VertexCountint
  • 输入
  • 必填
  • 约束 允许 3–16。
第二个凸多边形有效顶点数。
polygonVertexCoordinatesLREAL[2,16,2]
  • 输入
  • 可选
  • 默认 0(未提供坐标槽;有效顶点槽必须显式给出)
  • 约束 X 范围为 0–input.Width-1;Y 范围为 0–input.Height-1。两个有效顶点序列都必须组成严格凸多边形。
两个凸多边形的顶点坐标槽组;实际节点参数名为 polygon1Vertex0X/Y 至 polygon2Vertex15X/Y,各自计数范围内的槽必须提供。

输出​

outputImage
在输入图像副本上绘制两个多边形及并集结果。
Measurements量测值集合
  • 约束 disjoint 与 boundaryContact 以 0/1 表示。
包含两多边形面积、intersectionArea、unionArea、unionCentroidX/Y、重叠率、disjoint 与 boundaryContact 等量测。

行为​

  • 要求两个多边形均为严格凸多边形。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 ConvexPolygonUnionAreaCentroid。

var result = ConvexPolygonUnionAreaCentroid(polygon1VertexCount: 3, polygon1Vertex0X: 20, polygon1Vertex0Y: 20, polygon1Vertex1X: 120, polygon1Vertex1Y: 20, polygon1Vertex2X: 70, polygon1Vertex2Y: 100, polygon2VertexCount: 3, polygon2Vertex0X: 60, polygon2Vertex0Y: 40, polygon2Vertex1X: 150, polygon2Vertex1Y: 40, polygon2Vertex2X: 100, polygon2Vertex2Y: 130);

复制边框​

CopyBorder · 可执行

按 top、bottom、left、right 和边界模式扩展输入图像。

签名​

var nodeId = CopyBorder();

输入​

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

参数​

topint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–32768。
上边界扩展像素数。
bottomint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–32768。
下边界扩展像素数。
leftint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–32768。
左边界扩展像素数。
rightint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–32768。
右边界扩展像素数。
borderstring
  • 输入
  • 可选
  • 默认 Constant
  • 约束 可选 Constant、Replicate、Reflect、Reflect101。
边界生成模式。
valueint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–255。
Constant 模式的填充值。

输出​

outputImage
  • 约束 输出宽高不得超过 32768,且必须通过资源预算。
按四边扩展后的图像,像素类型和通道数与输入一致。
Measurements量测值集合
  • 约束 Measurements 是执行结果集合,不是图连接端口。
包含 top、bottom、left、right、outputWidth 与 outputHeight 节点前缀量测。

行为​

  • 按 top、bottom、left、right 和边界模式扩展输入图像。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

复制边框

var bordered = CopyBorder(top: 8, bottom: 8, left: 12, right: 12, border: "Reflect101", value: 0);

裁剪​

Crop · 可执行

从输入图像克隆由 x、y、width、height 定义且完整位于画布内的矩形 ROI。

签名​

var nodeId = Crop();

输入​

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

参数​

xint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–input.Width-1。
裁剪区域左上角 X 坐标。
yint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–input.Height-1。
裁剪区域左上角 Y 坐标。
widthint
  • 输入
  • 可选
  • 默认 input.Width-x
  • 约束 范围为 1–input.Width,且裁剪区域不得超出画布。
裁剪宽度。
heightint
  • 输入
  • 可选
  • 默认 input.Height-y
  • 约束 范围为 1–input.Height,且裁剪区域不得超出画布。
裁剪高度。

输出​

outputImage
  • 约束 x+width 不得超过 input.Width;y+height 不得超过 input.Height。
尺寸为 width × height 的 ROI 克隆图像,像素类型与通道数保持不变。

行为​

  • 从输入图像克隆由 x、y、width、height 定义且完整位于画布内的矩形 ROI。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

裁剪

var cropped = Crop(width: 320, height: 240);

有向圆弧属性​

DirectedArcProperties · 可执行

计算有向圆弧的弧长、弦长、圆心角等几何属性。

签名​

var props = DirectedArcProperties(centerX: 100, centerY: 100, radiusPixels: 50, startAngleDegrees: 0, endAngleDegrees: 180);

输入​

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

参数​

centerXdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
圆心 X 坐标。
centerYdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
圆心 Y 坐标。
radiusPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0.5–32768。
圆弧半径,单位为像素。
startAngleDegreesdouble
  • 输入
  • 必填
  • 约束 必须为有限值。
有向圆弧起始角,单位为度。
endAngleDegreesdouble
  • 输入
  • 必填
  • 约束 必须为有限值。
有向圆弧终止角,单位为度。

输出​

outputImage
在输入图像副本上绘制有向圆弧及关键点。
Measurements量测值集合
  • 约束 布尔状态以 0/1 表示。
包含弧长、弦长、弓高、端点、中点、形心、包围盒、归一化角度、扫掠方向与整圆标志等量测。

行为​

  • 所有参数均为必填。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 DirectedArcProperties。

var props = DirectedArcProperties(centerX: 100, centerY: 100, radiusPixels: 50, startAngleDegrees: 0, endAngleDegrees: 180);

椭圆弧长​

EllipseArcLength · 可执行

计算椭圆弧的弧长(基于椭圆积分近似)。

签名​

var length = EllipseArcLength(ellipseCenterX: 100, ellipseCenterY: 100, semiMajorAxisPixels: 80, semiMinorAxisPixels: 50, ellipseAngleDegrees: 0, startAngleDegrees: 0, endAngleDegrees: 180);

输入​

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

参数​

ellipseCenterXdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
椭圆中心 X 坐标。
ellipseCenterYdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
椭圆中心 Y 坐标。
semiMajorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0.5–32768。不得小于 semiMinorAxisPixels。
半长轴,单位为像素。
semiMinorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0.5–32768。
半短轴,单位为像素。
ellipseAngleDegreesdouble
  • 输入
  • 必填
  • 约束 范围为 -360000–360000。
椭圆主轴旋转角,单位为度。
startAngleDegreesdouble
  • 输入
  • 必填
  • 约束 必须为有限值。
参数圆上的起始角,单位为度。
endAngleDegreesdouble
  • 输入
  • 必填
  • 约束 必须为有限值。
参数圆上的终止角,单位为度。

输出​

outputImage
在输入图像副本上绘制椭圆弧及端点。
Measurements量测值集合
  • 约束 zeroArc、fullEllipse 与 clockwise 以 0/1 表示。
包含 arcLengthPixels、端点、归一化角度、扫掠角、积分误差与求积次数等节点前缀量测。

行为​

  • 半长轴不得小于半短轴;两者相等时按圆处理。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 EllipseArcLength。

var length = EllipseArcLength(ellipseCenterX: 100, ellipseCenterY: 100, semiMajorAxisPixels: 80, semiMinorAxisPixels: 50, ellipseAngleDegrees: 0, startAngleDegrees: 0, endAngleDegrees: 180);

椭圆扇区面积形心​

EllipseSectorAreaCentroid · 可执行

计算椭圆扇区(椭圆的一部分扇形)的面积与形心。

签名​

var result = EllipseSectorAreaCentroid(centerX: 100, centerY: 100, semiMajorAxisPixels: 80, semiMinorAxisPixels: 50, ellipseAngleDegrees: 0, startAngleDegrees: 0, endAngleDegrees: 90);

输入​

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

参数​

centerXdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
椭圆中心 X 坐标。
centerYdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
椭圆中心 Y 坐标。
semiMajorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0.5–32768。不得小于 semiMinorAxisPixels。
半长轴,单位为像素。
semiMinorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0.5–32768。
半短轴,单位为像素。
ellipseAngleDegreesdouble
  • 输入
  • 必填
  • 约束 范围为 -360000–360000。
椭圆主轴旋转角,单位为度。
startAngleDegreesdouble
  • 输入
  • 必填
  • 约束 必须为有限值。
参数圆上的起始角,单位为度。
endAngleDegreesdouble
  • 输入
  • 必填
  • 约束 必须为有限值。
参数圆上的终止角,单位为度。

输出​

outputImage
在输入图像副本上绘制椭圆扇区与形心。
Measurements量测值集合
  • 约束 zeroSector、fullEllipse 与 clockwise 以 0/1 表示。
包含 areaPixelsSquared、centroidX/Y、归一化角度、signedSweepAngleDegrees 与方向状态等量测。

行为​

  • 半长轴不得小于半短轴;两者相等时按圆处理。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 EllipseSectorAreaCentroid。

var result = EllipseSectorAreaCentroid(centerX: 100, centerY: 100, semiMajorAxisPixels: 80, semiMinorAxisPixels: 50, ellipseAngleDegrees: 0, startAngleDegrees: 0, endAngleDegrees: 90);

椭圆切段面积形心​

EllipseSegmentAreaCentroid · 可执行

计算椭圆切段(椭圆被直线截取的部分)的面积与形心。

签名​

var result = EllipseSegmentAreaCentroid(centerX: 100, centerY: 100, semiMajorAxisPixels: 80, semiMinorAxisPixels: 50, ellipseAngleDegrees: 0, startAngleDegrees: 0, endAngleDegrees: 90);

输入​

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

参数​

centerXdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
椭圆中心 X 坐标。
centerYdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
椭圆中心 Y 坐标。
semiMajorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0.5–32768。不得小于 semiMinorAxisPixels。
半长轴,单位为像素。
semiMinorAxisPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0.5–32768。
半短轴,单位为像素。
ellipseAngleDegreesdouble
  • 输入
  • 必填
  • 约束 范围为 -360000–360000。
椭圆主轴旋转角,单位为度。
startAngleDegreesdouble
  • 输入
  • 必填
  • 约束 必须为有限值。
弦端点的参数起始角,单位为度。
endAngleDegreesdouble
  • 输入
  • 必填
  • 约束 必须为有限值。
弦端点的参数终止角,单位为度。

输出​

outputImage
在输入图像副本上绘制椭圆弓形、弦与形心。
Measurements量测值集合
  • 约束 zeroSegment、fullEllipse 与 clockwise 以 0/1 表示。
包含 areaPixelsSquared、centroidX/Y、chordLengthPixels、sagittaPixels、归一化角度与方向状态等量测。

行为​

  • 半长轴不得小于半短轴;两者相等时按圆处理。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 EllipseSegmentAreaCentroid。

var result = EllipseSegmentAreaCentroid(centerX: 100, centerY: 100, semiMajorAxisPixels: 80, semiMinorAxisPixels: 50, ellipseAngleDegrees: 0, startAngleDegrees: 0, endAngleDegrees: 90);

提取旋转矩形​

ExtractRotatedRectangle · 可执行

按中心、尺寸和角度从输入图像重采样旋转矩形 ROI。

签名​

var roi = ExtractRotatedRectangle(centerX: 320, centerY: 240, width: 160, height: 80, angleDegrees: 25);

输入​

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

参数​

centerXdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
旋转矩形中心 X 坐标。
centerYdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
旋转矩形中心 Y 坐标。
widthint
  • 输入
  • 必填
  • 约束 范围为 1–32768。
输出图像宽度。
heightint
  • 输入
  • 必填
  • 约束 范围为 1–32768。
输出图像高度。
angleDegreesdouble
  • 输入
  • 必填
  • 约束 范围为 -360000–360000。
旋转角度,单位为度。
interpolationstring
  • 输入
  • 可选
  • 默认 Linear
  • 约束 可选 Nearest、Linear。
重采样插值方式。
borderValueint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–255。
采样区域超出输入边界时的填充值。

输出​

outputImage
  • 约束 输出必须通过轴长、像素数与资源预算限制。
尺寸为 width × height 的旋转矩形 ROI 重采样图像。
Measurements量测值集合
  • 约束 Measurements 是执行结果集合,不是图连接端口。
包含中心、规范化角度、输出尺寸、sourceToOutput 2×3 矩阵、源采样四角、源包围盒和越界角点数等回执。

行为​

  • 先求输出像素到源图的仿射映射,再按 interpolation 重采样;越界位置使用 borderValue。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

提取旋转矩形

var roi = ExtractRotatedRectangle(centerX: 320, centerY: 240, width: 160, height: 80, angleDegrees: 25, interpolation: "Linear", borderValue: 0);

翻转​

Flip · 可执行

按 Horizontal、Vertical 或 Both 沿对应轴翻转像素,不改变图像尺寸和类型。

签名​

var nodeId = Flip();

输入​

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

参数​

modestring
  • 输入
  • 可选
  • 默认 Horizontal
  • 约束 可选 Horizontal、Vertical、Both。
翻转轴。

输出​

outputImage
与输入同尺寸、同类型的翻转图像。

行为​

  • 按 Horizontal、Vertical 或 Both 沿对应轴翻转像素,不改变图像尺寸和类型。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

翻转

var flipped = Flip(mode: "Horizontal");

等比缩放填充​

Letterbox · 可执行

保持原宽高比缩放到目标画布,并用 paddingValue 对称补齐空白区域。

签名​

var nodeId = Letterbox();

输入​

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

参数​

widthint
  • 输入
  • 可选
  • 默认 input.Width
  • 约束 范围为 1–32768。
目标画布宽度。
heightint
  • 输入
  • 可选
  • 默认 input.Height
  • 约束 范围为 1–32768。
目标画布高度。
paddingValueint
  • 输入
  • 可选
  • 默认 114
  • 约束 范围为 0–255。
补齐区域像素值。
interpolationstring
  • 输入
  • 可选
  • 默认 Linear
  • 约束 可选 Nearest、Linear、Cubic、Area、Lanczos4。
缩放插值方式。

输出​

outputImage
  • 约束 填充边界使用 paddingValue。
尺寸为 width × height 的等比缩放填充图像。
Measurements量测值集合
  • 约束 这些量测是将模型坐标映射回源图的几何证据。
包含 letterboxScale、scaleX/Y、四边 padding 与源图宽高节点前缀量测。

行为​

  • 保持原宽高比缩放到目标画布,并用 paddingValue 对称补齐空白区域。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

等比缩放填充

var letterbox = Letterbox(width: 640, height: 640, paddingValue: 114, interpolation: "Linear");

线段裁剪到矩形​

LineClipToRectangle · 可执行

将有限线段裁剪到轴对齐矩形,并给出无交、点交或线段交的几何回执。

签名​

var clipped = LineClipToRectangle(segmentStartX: 10, segmentStartY: 20, segmentEndX: 500, segmentEndY: 300, rectangleX: 40, rectangleY: 30, rectangleWidthPixels: 320, rectangleHeightPixels: 240);

输入​

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

参数​

segmentStartXint
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
线段起点 X。
segmentStartYint
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
线段起点 Y。
segmentEndXint
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
线段终点 X。
segmentEndYint
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。终点不得与起点重合。
线段终点 Y。
rectangleXint
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
裁剪矩形左上角 X。
rectangleYint
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
裁剪矩形左上角 Y。
rectangleWidthPixelsint
  • 输入
  • 必填
  • 约束 范围为 1–32768,且矩形必须完整位于输入画布内。
裁剪矩形宽度。
rectangleHeightPixelsint
  • 输入
  • 必填
  • 约束 范围为 1–32768,且矩形必须完整位于输入画布内。
裁剪矩形高度。

输出​

outputImage
  • 约束 输入为空或不是 CV_8U 1/3/4 通道时失败。
在输入彩色副本上绘制裁剪矩形、原线段和保留线段。
Measurements量测值集合
  • 约束 relationCode:0=无交,1=点交,2=线段交。
包含 relationCode、裁剪后端点、原始/保留长度、保留率、裁剪标志、线段参数和矩形边界等回执。

行为​

  • 矩形必须完整位于输入画布,线段不得退化为点;无交集时回执坐标统一清零。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

线段裁剪到矩形

var clipped = LineClipToRectangle(segmentStartX: 10, segmentStartY: 20, segmentEndX: 500, segmentEndY: 300, rectangleX: 40, rectangleY: 30, rectangleWidthPixels: 320, rectangleHeightPixels: 240);

ROI 掩膜​

MaskRoi · 可执行

按矩形或椭圆 ROI 保留像素并将其余位置清零;invert 可反选区域。

签名​

var nodeId = MaskRoi();

输入​

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

参数​

xint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–input.Width-1。
ROI 左上角 X 坐标。
yint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–input.Height-1。
ROI 左上角 Y 坐标。
widthint
  • 输入
  • 可选
  • 默认 input.Width-x
  • 约束 范围为 1–input.Width,且 ROI 不得超出画布。
ROI 宽度。
heightint
  • 输入
  • 可选
  • 默认 input.Height-y
  • 约束 范围为 1–input.Height,且 ROI 不得超出画布。
ROI 高度。
shapestring
  • 输入
  • 可选
  • 默认 Rect
  • 约束 可选 Rect、Ellipse。
ROI 形状。
invertbool
  • 输入
  • 可选
  • 默认 FALSE
  • 约束 可选 TRUE、FALSE。
是否反选 ROI。

输出​

outputImage
保留 ROI(或反选后的 ROI)像素、其余位置清零的图像。

行为​

  • 仅有一个图输入端口;ROI 由参数定义,不接受第二张掩膜图。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:shape 不是 Rect 或 Ellipse。

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

ROI掩膜

var masked = MaskRoi(width: 320, height: 240, shape: "Ellipse", invert: false);

点在凸多边形内​

PointInConvexPolygon · 可执行

判断点是否位于凸多边形内部。

签名​

var inside = PointInConvexPolygon(polygonVertexCount: 3, polygonVertex0X: 20, polygonVertex0Y: 20, polygonVertex1X: 120, polygonVertex1Y: 20, polygonVertex2X: 70, polygonVertex2Y: 100, pointX: 70, pointY: 50);

输入​

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

参数​

polygonVertexCountint
  • 输入
  • 必填
  • 约束 允许 3–16。
凸多边形有效顶点数。
polygonVertexCoordinatesLREAL[16,2]
  • 输入
  • 可选
  • 默认 0(未提供坐标槽;有效顶点槽必须显式给出)
  • 约束 X 范围为 0–input.Width-1;Y 范围为 0–input.Height-1。有效顶点必须组成严格凸多边形。
凸多边形顶点坐标槽组;实际节点参数名为 polygonVertex0X/Y 至 polygonVertex15X/Y,计数范围内的槽必须提供。
pointXdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
待判断点的 X 坐标。
pointYdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
待判断点的 Y 坐标。

输出​

outputImage
在输入图像副本上绘制凸多边形、测试点及包含关系。
Measurements量测值集合
  • 约束 inside 与 boundary 以 0/1 表示。
包含 vertexCount、polygonArea、pointX/Y、signedDistancePixels、absoluteDistancePixels、inside 与 boundary 等量测。

行为​

  • 要求多边形为严格凸多边形。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 PointInConvexPolygon。

var inside = PointInConvexPolygon(polygonVertexCount: 3, polygonVertex0X: 20, polygonVertex0Y: 20, polygonVertex1X: 120, polygonVertex1Y: 20, polygonVertex2X: 70, polygonVertex2Y: 100, pointX: 70, pointY: 50);

极坐标变换​

PolarTransform · 可执行

在线性或对数半径刻度下执行笛卡尔坐标与极坐标图像的双向映射。

签名​

var nodeId = PolarTransform();

输入​

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

参数​

widthint
  • 输入
  • 可选
  • 默认 input.Width
  • 约束 范围为 1–32768。
输出宽度。
heightint
  • 输入
  • 可选
  • 默认 input.Height
  • 约束 范围为 1–32768。
输出高度。
centerXdouble
  • 输入
  • 可选
  • 默认 (input.Width-1)/2
  • 约束 显式提供时必须位于输入画布内。
极坐标中心 X。
centerYdouble
  • 输入
  • 可选
  • 默认 (input.Height-1)/2
  • 约束 显式提供时必须位于输入画布内。
极坐标中心 Y。
maximumRadiusPixelsdouble
  • 输入
  • 可选
  • 默认 min(cartesianWidth,cartesianHeight)/2
  • 约束 范围为 0.001–1000000000。
展开使用的最大半径。
modestring
  • 输入
  • 可选
  • 默认 Linear
  • 约束 可选 Linear、Log。
半径轴映射模式。
directionstring
  • 输入
  • 可选
  • 默认 CartesianToPolar
  • 约束 可选 CartesianToPolar、PolarToCartesian。
变换方向。
interpolationstring
  • 输入
  • 可选
  • 默认 Linear
  • 约束 可选 Nearest、Linear、Cubic、Lanczos4。
重采样插值方式。

输出​

outputImage
尺寸为 width × height 的极坐标或笛卡尔坐标图像。
Measurements量测值集合
  • 约束 inverse 以 0/1 表示。
包含 centerX/Y、maxRadiusPixels、outputWidth/Height 与 inverse 节点前缀量测。

行为​

  • direction 决定笛卡尔到极坐标或反向映射;mode 决定线性或对数半径刻度。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

极坐标变换

var polar = PolarTransform(width: 640, height: 480, centerX: 320, centerY: 240, maximumRadiusPixels: 240, mode: "Linear", direction: "CartesianToPolar", interpolation: "Linear");

金字塔降采样​

PyramidDown · 可执行

连续执行 levels 次高斯金字塔降采样并返回最后一层。

签名​

var nodeId = PyramidDown();

输入​

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

参数​

levelsint
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 1–4。
连续降采样层数。

输出​

outputImage
连续执行 levels 次高斯金字塔降采样后的图像。
Measurements量测值集合
  • 约束 Measurements 是执行结果集合,不是图连接端口。
包含 levels、sourceWidth/Height 与 outputWidth/Height 节点前缀量测。

行为​

  • 每层先高斯平滑再将宽高约缩小为上一层的一半。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

金字塔降采样

var down = PyramidDown(levels: 2);

金字塔升采样​

PyramidUp · 可执行

连续执行 levels 次高斯金字塔升采样并返回最后一层。

签名​

var nodeId = PyramidUp();

输入​

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

参数​

levelsint
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 1–4。最终输出单轴不得超过 32768。
连续升采样层数。

输出​

outputImage
连续执行 levels 次高斯金字塔升采样后的图像。
Measurements量测值集合
  • 约束 Measurements 是执行结果集合,不是图连接端口。
包含 levels、sourceWidth/Height 与 outputWidth/Height 节点前缀量测。

行为​

  • 每层将宽高约扩大为上一层的两倍,并在规划期校验输出尺寸上限。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

金字塔升采样

var up = PyramidUp(levels: 2);

缩放​

Resize · 可执行

按 width、height 和 interpolation 将输入图像重采样到指定尺寸。

签名​

var nodeId = Resize();

输入​

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

参数​

widthint
  • 输入
  • 可选
  • 默认 input.Width
  • 约束 范围为 1–32768。
输出宽度。
heightint
  • 输入
  • 可选
  • 默认 input.Height
  • 约束 范围为 1–32768。
输出高度。
interpolationstring
  • 输入
  • 可选
  • 默认 Linear
  • 约束 可选 Nearest、Linear、Cubic、Area、Lanczos4。
缩放插值方式。

输出​

outputImage
  • 约束 必须通过输出资源预算。
尺寸为 width × height 的重采样图像。

行为​

  • 按 width、height 和 interpolation 将输入图像重采样到指定尺寸。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

缩放

var resized = Resize(width: 640, height: 480, interpolation: "Linear");

旋转​

Rotate · 可执行

绕图像中心按 angleDegrees 和 scale 旋转,输出画布保持输入尺寸,越界像素填黑。

签名​

var nodeId = Rotate();

输入​

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

参数​

angleDegreesdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -360000–360000。
旋转角度,单位为度。
scaledouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 0.000001–1000000。
旋转同时应用的缩放比例。
interpolationstring
  • 输入
  • 可选
  • 默认 Linear
  • 约束 可选 Nearest、Linear、Cubic、Area、Lanczos4。
重采样插值方式。

输出​

outputImage
  • 约束 旋转后落在画布外的区域被裁掉,画布内无源像素填黑。
与输入同尺寸的中心旋转图像。

行为​

  • 绕图像中心按 angleDegrees 和 scale 旋转,输出画布保持输入尺寸,越界像素填黑。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

旋转

var rotated = Rotate(angleDegrees: 30, scale: 1, interpolation: "Linear");

旋转(保持边界)​

RotateBound · 可执行

旋转并扩展输出画布,使旋转后的源图边界完整保留。

签名​

var nodeId = RotateBound();

输入​

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

参数​

angleDegreesdouble
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -360000–360000。
旋转角度,单位为度。
scaledouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 0.000001–1000000。
缩放比例。
borderValueint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–255。
扩展画布的填充值。
interpolationstring
  • 输入
  • 可选
  • 默认 Linear
  • 约束 可选 Nearest、Linear、Cubic、Area、Lanczos4。
重采样插值方式。

输出​

outputImage
  • 约束 输出单轴不超过 32768,输出字节数不超过当前图像上限。
扩展到旋转后包围盒尺寸的图像。
Measurements量测值集合
  • 约束 Measurements 是执行结果集合,不是图连接端口。
包含 angleDegrees、scale、outputWidth 与 outputHeight 节点前缀量测。

行为​

  • 按旋转后包围盒扩展输出尺寸;任一输出轴或输出字节数超过硬上限时在分配前失败。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

旋转(保持边界)

var rotated = RotateBound(angleDegrees: 30, scale: 1, borderValue: 0, interpolation: "Linear");

旋转矩形属性​

RotatedRectangleProperties · 可执行

计算旋转矩形的面积、周长、外接圆半径等几何属性。

签名​

var props = RotatedRectangleProperties(centerX: 100, centerY: 100, widthPixels: 200, heightPixels: 100, angleDegrees: 30);

输入​

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

参数​

centerXdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
旋转矩形中心 X 坐标。
centerYdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
旋转矩形中心 Y 坐标。
widthPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0.5–32768。
矩形宽度,单位为像素。
heightPixelsdouble
  • 输入
  • 必填
  • 约束 范围为 0.5–32768。
矩形高度,单位为像素。
angleDegreesdouble
  • 输入
  • 必填
  • 约束 范围为 -360000–360000。
矩形旋转角,单位为度。

输出​

outputImage
在输入图像副本上绘制旋转矩形、顶点与包围盒。
Measurements量测值集合
  • 约束 Measurements 是执行结果集合,不是图连接端口。
包含中心、尺寸、归一化角度、面积、周长、对角线、宽高比、包围盒与四角坐标等量测。

行为​

  • 所有参数均为必填。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 RotatedRectangleProperties。

var props = RotatedRectangleProperties(centerX: 100, centerY: 100, widthPixels: 200, heightPixels: 100, angleDegrees: 30);

平铺重复​

TileRepeat · 可执行

按水平和垂直重复次数平铺输入图像。

签名​

var nodeId = TileRepeat();

输入​

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

参数​

repeatXint
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 1–32768,且输出宽度不得超过资源上限。
水平方向重复次数。
repeatYint
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 1–32768,且输出高度不得超过资源上限。
垂直方向重复次数。

输出​

outputImage
  • 约束 输出必须通过轴长、像素数、字节数与资源预算限制。
尺寸为 input.Width×repeatX 和 input.Height×repeatY 的平铺图像。
Measurements量测值集合
  • 约束 tileCount 等于 repeatX×repeatY。
包含 repeatX/Y、sourceWidth/Height、outputWidth/Height 与 tileCount 节点前缀量测。

行为​

  • 输出宽高分别为输入宽高乘 repeatX、repeatY,并在分配前校验尺寸、像素数和资源预算。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

平铺重复

var tiled = TileRepeat(repeatX: 3, repeatY: 2);

三角形属性​

TriangleProperties · 可执行

计算三角形的面积、周长、重心、外接圆半径等几何属性。

签名​

var props = TriangleProperties(vertex0X: 0, vertex0Y: 0, vertex1X: 100, vertex1Y: 0, vertex2X: 50, vertex2Y: 100);

输入​

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

参数​

vertex0Xdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
顶点 0 的 X 坐标。
vertex0Ydouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
顶点 0 的 Y 坐标。
vertex1Xdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
顶点 1 的 X 坐标。
vertex1Ydouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。
顶点 1 的 Y 坐标。
vertex2Xdouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Width-1。
顶点 2 的 X 坐标。
vertex2Ydouble
  • 输入
  • 必填
  • 约束 范围为 0–input.Height-1。三个顶点不得共线。
顶点 2 的 Y 坐标。

输出​

outputImage
在输入图像副本上绘制三角形、中心与辅助圆。
Measurements量测值集合
  • 约束 Measurements 是执行结果集合,不是图连接端口。
包含面积、周长、形心、三边、三角、内切圆/外接圆、内心/外心与最小高等量测。

行为​

  • 要求三点不共线(严格凸)。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:数值参数越出几何族合同范围。

示例​

计算 TriangleProperties。

var props = TriangleProperties(vertex0X: 0, vertex0Y: 0, vertex1X: 100, vertex1Y: 0, vertex2X: 50, vertex2Y: 100);

仿射变换​

WarpAffine · 可执行

按 2×3 非奇异仿射矩阵和 interpolation 重采样到 width × height。

签名​

var nodeId = WarpAffine();

输入​

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

参数​

widthint
  • 输入
  • 可选
  • 默认 input.Width
  • 约束 范围为 1–32768。
输出宽度。
heightint
  • 输入
  • 可选
  • 默认 input.Height
  • 约束 范围为 1–32768。
输出高度。
interpolationstring
  • 输入
  • 可选
  • 默认 Linear
  • 约束 可选 Nearest、Linear、Cubic、Area、Lanczos4。
重采样插值方式。
m00double
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 -1e12–1e12。
2×3 仿射矩阵第 0 行第 0 列。
m01double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -1e12–1e12。
2×3 仿射矩阵第 0 行第 1 列。
m02double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -1e12–1e12。
2×3 仿射矩阵第 0 行平移分量。
m10double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -1e12–1e12。
2×3 仿射矩阵第 1 行第 0 列。
m11double
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 -1e12–1e12。m00×m11-m01×m10 不得为 0。
2×3 仿射矩阵第 1 行第 1 列。
m12double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -1e12–1e12。
2×3 仿射矩阵第 1 行平移分量。

输出​

outputImage
  • 约束 线性部分必须非奇异,输出必须通过资源预算。
按 2×3 仿射矩阵重采样到 width × height 的图像。

行为​

  • 按 2×3 非奇异仿射矩阵和 interpolation 重采样到 width × height。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

仿射变换

var warped = WarpAffine(width: 640, height: 480, interpolation: "Linear", m00: 1, m01: 0, m02: 20, m10: 0, m11: 1, m12: 10);

三点仿射变换​

WarpAffineFromThreePoints · 可执行

由三对非共线控制点求解 2×3 仿射矩阵并重采样输入图像。

签名​

var warped = WarpAffineFromThreePoints(source0X: 0, source0Y: 0, source1X: 639, source1Y: 0, source2X: 0, source2Y: 479, destination0X: 20, destination0Y: 10, destination1X: 620, destination1Y: 30, destination2X: 40, destination2Y: 450);

输入​

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

参数​

widthint
  • 输入
  • 可选
  • 默认 input.Width
  • 约束 范围为 1–32768。
输出宽度。
heightint
  • 输入
  • 可选
  • 默认 input.Height
  • 约束 范围为 1–32768。
输出高度。
interpolationstring
  • 输入
  • 可选
  • 默认 Linear
  • 约束 可选 Nearest、Linear。
重采样插值方式。
borderValueint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–255。
输出画布无源像素处的填充值。
sourceControlPointsLREAL[3,2]
  • 输入
  • 必填
  • 约束 X 范围为 0–input.Width-1;Y 范围为 0–input.Height-1。三个源点不得共线。
源图像中的三个控制点坐标,对应 source0X/Y 至 source2X/Y。
destinationControlPointsLREAL[3,2]
  • 输入
  • 必填
  • 约束 坐标范围为 0–32765。三个目标点不得共线。
输出画布中的三个对应控制点坐标,对应 destination0X/Y 至 destination2X/Y。

输出​

outputImage
  • 约束 无源像素使用 borderValue。
按求得仿射矩阵重采样到 width × height 的图像。
Measurements量测值集合
  • 约束 orientationPreserved 与 noFoldCertificate 以 0/1 表示。
包含 2×3 矩阵、determinant、输出尺寸、两三角形面积、面积比、奇异值/条件数、控制点重投影误差和无折叠证书等回执。

行为​

  • 源点和目标点都必须非共线;执行体求解矩阵、校验证据和条件数后再重采样。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

三点仿射变换

var warped = WarpAffineFromThreePoints(width: 640, height: 480, source0X: 0, source0Y: 0, source1X: 639, source1Y: 0, source2X: 0, source2Y: 479, destination0X: 20, destination0Y: 10, destination1X: 620, destination1Y: 30, destination2X: 40, destination2Y: 450);

透视变换​

WarpPerspective · 可执行

按 3×3 非奇异单应矩阵和 interpolation 重采样到 width × height。

签名​

var nodeId = WarpPerspective();

输入​

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

参数​

widthint
  • 输入
  • 可选
  • 默认 input.Width
  • 约束 范围为 1–32768。
输出宽度。
heightint
  • 输入
  • 可选
  • 默认 input.Height
  • 约束 范围为 1–32768。
输出高度。
interpolationstring
  • 输入
  • 可选
  • 默认 Linear
  • 约束 可选 Nearest、Linear、Cubic、Area、Lanczos4。
重采样插值方式。
m00double
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 -1e12–1e12。
3×3 单应矩阵第 0 行第 0 列。
m01double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -1e12–1e12。
3×3 单应矩阵第 0 行第 1 列。
m02double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -1e12–1e12。
3×3 单应矩阵第 0 行第 2 列。
m10double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -1e12–1e12。
3×3 单应矩阵第 1 行第 0 列。
m11double
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 -1e12–1e12。
3×3 单应矩阵第 1 行第 1 列。
m12double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -1e12–1e12。
3×3 单应矩阵第 1 行第 2 列。
m20double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -1e12–1e12。
3×3 单应矩阵第 2 行第 0 列。
m21double
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 -1e12–1e12。
3×3 单应矩阵第 2 行第 1 列。
m22double
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 -1e12–1e12。矩阵行列式绝对值必须大于 1e-12。
3×3 单应矩阵第 2 行第 2 列。

输出​

outputImage
  • 约束 矩阵必须非奇异,输出必须通过资源预算。
按 3×3 单应矩阵重采样到 width × height 的图像。

行为​

  • 按 3×3 非奇异单应矩阵和 interpolation 重采样到 width × height。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

透视变换

var warped = WarpPerspective(width: 640, height: 480, interpolation: "Linear", m00: 1, m01: 0, m02: 0, m10: 0, m11: 1, m12: 0, m20: 0.0002, m21: 0, m22: 1);

四点透视变换​

WarpPerspectiveFromFourPoints · 可执行

由四对控制点求解 3×3 单应矩阵并执行透视重采样。

签名​

var warped = WarpPerspectiveFromFourPoints(source0X: 0, source0Y: 0, source1X: 639, source1Y: 0, source2X: 639, source2Y: 479, source3X: 0, source3Y: 479, destination0X: 30, destination0Y: 20, destination1X: 610, destination1Y: 0, destination2X: 630, destination2Y: 460, destination3X: 10, destination3Y: 479);

输入​

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

参数​

widthint
  • 输入
  • 可选
  • 默认 input.Width
  • 约束 范围为 1–32768。
输出宽度。
heightint
  • 输入
  • 可选
  • 默认 input.Height
  • 约束 范围为 1–32768。
输出高度。
interpolationstring
  • 输入
  • 可选
  • 默认 Linear
  • 约束 可选 Nearest、Linear。
重采样插值方式。
borderValueint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–255。
输出画布无源像素处的填充值。
sourceControlPointsLREAL[4,2]
  • 输入
  • 必填
  • 约束 X 范围为 0–input.Width-1;Y 范围为 0–input.Height-1。四边形必须非退化且顺序一致。
源图像中的四个控制点坐标,对应 source0X/Y 至 source3X/Y。
destinationControlPointsLREAL[4,2]
  • 输入
  • 必填
  • 约束 坐标范围为 0–32765。四边形必须非退化且顺序一致。
输出画布中的四个对应控制点坐标,对应 destination0X/Y 至 destination3X/Y。

输出​

outputImage
  • 约束 无源像素使用 borderValue。
按求得单应矩阵重采样到 width × height 的图像。
Measurements量测值集合
  • 约束 orientationPreserved 与 noFoldCertificate 以 0/1 表示。
包含 3×3 单应矩阵、determinant、输出尺寸、四边形面积、条件数、视界裕量、局部面积尺度、重投影误差和无折叠证书等回执。

行为​

  • 源四边形和目标四边形必须可形成稳定单应矩阵;执行体校验视界、折叠和条件数后再重采样。

错误与限制​

  • VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。
  • VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。

示例​

四点透视变换

var warped = WarpPerspectiveFromFourPoints(width: 640, height: 480, source0X: 0, source0Y: 0, source1X: 639, source1Y: 0, source2X: 639, source2Y: 479, source3X: 0, source3Y: 479, destination0X: 30, destination0Y: 20, destination1X: 610, destination1Y: 0, destination2X: 630, destination2Y: 460, destination3X: 10, destination3Y: 479);