几何
用于缩放、裁剪、旋转、仿射/透视变换和几何量计算。
环形扇区面积形心
AnnularSectorAreaCentroid · 可执行
计算环形扇区(含内径和外径的扇形)的面积与形心。
签名
var result = AnnularSectorAreaCentroid(centerX: 100, centerY: 100, innerRadiusPixels: 20, outerRadiusPixels: 50, startAngleDegrees: 0, endAngleDegrees: 90);
输入
inputImage- 由视觉图上游图像边连接提供;不是节点调用参数。
参数
centerXdouble- 环形扇区圆心 X 坐标。
centerYdouble- 环形扇区圆心 Y 坐标。
innerRadiusPixelsdouble- 内半径,单位为像素。
outerRadiusPixelsdouble- 外半径,单位为像素。
startAngleDegreesdouble- 有向扇区起始角,单位为度。
endAngleDegreesdouble- 有向扇区终止角,单位为度。
输出
outputImage- 在输入图像副本上绘制环形扇区与形心的可视化结果。
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- 圆心 X 坐标。
circleCenterYdouble- 圆心 Y 坐标。
radiusPixelsdouble- 圆半径,单位为像素。
rectangleCenterXdouble- 旋转矩形中心 X 坐标。
rectangleCenterYdouble- 旋转矩形中心 Y 坐标。
rectangleWidthPixelsdouble- 旋转矩形宽度,单位为像素。
rectangleHeightPixelsdouble- 旋转矩形高度,单位为像素。
rectangleAngleDegreesdouble- 旋转矩形角度,单位为度。
输出
outputImage- 在输入图像副本上绘制圆、旋转矩形及交叠边界。
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- 参与计算的轮廓数量。
contourVertexCountsDINT[16]- 轮廓顶点计数槽组;实际节点参数名为 contour0VertexCount 至 contour15VertexCount,仅 pointCount 覆盖的槽参与计算。
contourVertexCoordinatesLREAL[16,16,2]- 轮廓顶点坐标槽组;实际节点参数名为 contourNVertexMX/Y,N、M 范围均为 0–15。
输出
outputImage- 输入图像的可视化副本。
Measurements量测值集合- 包含 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- 凸多边形有效顶点数。
polygonVertexCoordinatesLREAL[16,2]- 凸多边形顶点坐标槽组;实际节点参数名为 polygonVertex0X/Y 至 polygonVertex15X/Y,计数范围内的槽必须提供。
输出
outputImage- 在输入图像副本上绘制凸多边形及形心。
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- 凸多边形有效顶点数。
polygon1VertexCoordinatesLREAL[16,2]- 凸多边形顶点坐标槽组;实际节点参数名为 polygon1Vertex0X/Y 至 polygon1Vertex15X/Y,计数范围内的槽必须提供。
输出
outputImage- 在输入图像副本上绘制直径端点与连线。
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- 被减凸多边形有效顶点数。
polygon2VertexCountint- 减去的凸多边形有效顶点数。
polygonVertexCoordinatesLREAL[2,16,2]- 两个凸多边形的顶点坐标槽组;实际节点参数名为 polygon1Vertex0X/Y 至 polygon2Vertex15X/Y,各自计数范围内的槽必须提供。
输出
outputImage- 在输入图像副本上绘制 polygon1 - polygon2 的差集结果。
Measurements量测值集合- 包含两多边形面积、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- 第一个凸多边形有效顶点数。
polygon2VertexCountint- 第二个凸多边形有效顶点数。
polygonVertexCoordinatesLREAL[2,16,2]- 两个凸多边形的顶点坐标槽组;实际节点参数名为 polygon1Vertex0X/Y 至 polygon2Vertex15X/Y,各自计数范围内的槽必须提供。
输出
outputImage- 在输入图像副本上绘制两个多边形及交集。
Measurements量测值集合- 包含两多边形顶点数、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- 凸多边形有效顶点数。
polygon1VertexCoordinatesLREAL[16,2]- 凸多边形顶点坐标槽组;实际节点参数名为 polygon1Vertex0X/Y 至 polygon1Vertex15X/Y,计数范围内的槽必须提供。
输出
outputImage- 在输入图像副本上绘制最小宽度支撑线与接触点。
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- 第一个凸多边形有效顶点数。
polygon2VertexCountint- 第二个凸多边形有效顶点数。
polygonVertexCoordinatesLREAL[2,16,2]- 两个凸多边形的顶点坐标槽组;实际节点参数名为 polygon1Vertex0X/Y 至 polygon2Vertex15X/Y,各自计数范围内的槽必须提供。
输出
outputImage- 在输入图像副本上绘制两个多边形及并集结果。
Measurements量测值集合- 包含两多边形面积、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- 上边界扩展像素数。
bottomint- 下边界扩展像素数。
leftint- 左边界扩展像素数。
rightint- 右边界扩展像素数。
borderstring- 边界生成模式。
valueint- Constant 模式的填充值。
输出
outputImage- 按四边扩展后的图像,像素类型和通道数与输入一致。
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- 裁剪区域左上角 X 坐标。
yint- 裁剪区域左上角 Y 坐标。
widthint- 裁剪宽度。
heightint- 裁剪高度。
输出
outputImage- 尺寸为 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- 圆心 X 坐标。
centerYdouble- 圆心 Y 坐标。
radiusPixelsdouble- 圆弧半径,单位为像素。
startAngleDegreesdouble- 有向圆弧起始角,单位为度。
endAngleDegreesdouble- 有向圆弧终止角,单位为度。
输出
outputImage- 在输入图像副本上绘制有向圆弧及关键点。
Measurements量测值集合- 包含弧长、弦长、弓高、端点、中点、形心、包围盒、归一化角度、扫掠方向与整圆标志等量测。
行为
- 所有参数均为必填。
错误与限制
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- 椭圆中心 X 坐标。
ellipseCenterYdouble- 椭圆中心 Y 坐标。
semiMajorAxisPixelsdouble- 半长轴,单位为像素。
semiMinorAxisPixelsdouble- 半短轴,单位为像素。
ellipseAngleDegreesdouble- 椭圆主轴旋转角,单位为度。
startAngleDegreesdouble- 参数圆上的起始角,单位为度。
endAngleDegreesdouble- 参数圆上的终止角,单位为度。
输出
outputImage- 在输入图像副本上绘制椭圆弧及端点。
Measurements量测值集合- 包含 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- 椭圆中心 X 坐标。
centerYdouble- 椭圆中心 Y 坐标。
semiMajorAxisPixelsdouble- 半长轴,单位为像素。
semiMinorAxisPixelsdouble- 半短轴,单位为像素。
ellipseAngleDegreesdouble- 椭圆主轴旋转角,单位为度。
startAngleDegreesdouble- 参数圆上的起始角,单位为度。
endAngleDegreesdouble- 参数圆上的终止角,单位为度。
输出
outputImage- 在输入图像副本上绘制椭圆扇区与形心。
Measurements量测值集合- 包含 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- 椭圆中心 X 坐标。
centerYdouble- 椭圆中心 Y 坐标。
semiMajorAxisPixelsdouble- 半长轴,单位为像素。
semiMinorAxisPixelsdouble- 半短轴,单位为像素。
ellipseAngleDegreesdouble- 椭圆主轴旋转角,单位为度。
startAngleDegreesdouble- 弦端点的参数起始角,单位为度。
endAngleDegreesdouble- 弦端点的参数终止角,单位为度。
输出
outputImage- 在输入图像副本上绘制椭圆弓形、弦与形心。
Measurements量测值集合- 包含 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- 旋转矩形中心 X 坐标。
centerYdouble- 旋转矩形中心 Y 坐标。
widthint- 输出图像宽度。
heightint- 输出图像高度。
angleDegreesdouble- 旋转角度,单位为度。
interpolationstring- 重采样插值方式。
borderValueint- 采样区域超出输入边界时的填充值。
输出
outputImage- 尺寸为 width × height 的旋转矩形 ROI 重采样图像。
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- 翻转轴。
输出
outputImage- 与输入同尺寸、同类型的翻转图像。
行为
- 按 Horizontal、Vertical 或 Both 沿对应轴翻转像素,不改变图像尺寸和类型。
错误与限制
VISION_PIPELINE_PARAMETER_UNKNOWN:出现几何族合同未声明的控制参数。VISION_PIPELINE_CONTEXT_INVALID:几何计算或图像上下文无效。
示例
翻转
var flipped = Flip(mode: "Horizontal");
等比缩放填充
Letterbox · 可执行
保持原宽高比缩放到目标画布,并用 paddingValue 对称补齐空白区域。
签名
var nodeId = Letterbox();
输入
inputImage- 由视觉图上游图像边连接提供;不是节点调用参数。
参数
widthint- 目标画布宽度。
heightint- 目标画布高度。
paddingValueint- 补齐区域像素值。
interpolationstring- 缩放插值方式。
输出
outputImage- 尺寸为 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- 线段起点 X。
segmentStartYint- 线段起点 Y。
segmentEndXint- 线段终点 X。
segmentEndYint- 线段终点 Y。
rectangleXint- 裁剪矩形左上角 X。
rectangleYint- 裁剪矩形左上角 Y。
rectangleWidthPixelsint- 裁剪矩形宽度。
rectangleHeightPixelsint- 裁剪矩形高度。
输出
outputImage- 在输入彩色副本上绘制裁剪矩形、原线段和保留线段。
Measurements量测值集合- 包含 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- ROI 左上角 X 坐标。
yint- ROI 左上角 Y 坐标。
widthint- ROI 宽度。
heightint- ROI 高度。
shapestring- ROI 形状。
invertbool- 是否反选 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- 凸多边形有效顶点数。
polygonVertexCoordinatesLREAL[16,2]- 凸多边形顶点坐标槽组;实际节点参数名为 polygonVertex0X/Y 至 polygonVertex15X/Y,计数范围内的槽必须提供。
pointXdouble- 待判断点的 X 坐标。
pointYdouble- 待判断点的 Y 坐标。
输出
outputImage- 在输入图像副本上绘制凸多边形、测试点及包含关系。
Measurements量测值集合- 包含 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- 输出宽度。
heightint- 输出高度。
centerXdouble- 极坐标中心 X。
centerYdouble- 极坐标中心 Y。
maximumRadiusPixelsdouble- 展开使用的最大半径。
modestring- 半径轴映射模式。
directionstring- 变换方向。
interpolationstring- 重采样插值方式。
输出
outputImage- 尺寸为 width × height 的极坐标或笛卡尔坐标图像。
Measurements量测值集合- 包含 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- 连续降采样层数。
输出
outputImage- 连续执行 levels 次高斯金字塔降采样后的图像。
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- 连续升采样层数。
输出
outputImage- 连续执行 levels 次高斯金字塔升采样后的图像。
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- 输出宽度。
heightint- 输出高度。
interpolationstring- 缩放插值方式。
输出
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- 旋转角度,单位为度。
scaledouble- 旋转同时应用的缩放比例。
interpolationstring- 重采样插值方式。
输出
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- 旋转角度,单位为度。
scaledouble- 缩放比例。
borderValueint- 扩展画布的填充值。
interpolationstring- 重采样插值方式。
输出
outputImage- 扩展到旋转后包围盒尺寸的图像。
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- 旋转矩形中心 X 坐标。
centerYdouble- 旋转矩形中心 Y 坐标。
widthPixelsdouble- 矩形宽度,单位为像素。
heightPixelsdouble- 矩形高度,单位为像素。
angleDegreesdouble- 矩形旋转角,单位为度。
输出
outputImage- 在输入图像副本上绘制旋转矩形、顶点与包围盒。
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- 水平方向重复次数。
repeatYint- 垂直方向重复次数。
输出
outputImage- 尺寸为 input.Width×repeatX 和 input.Height×repeatY 的平铺图像。
Measurements量测值集合- 包含 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 的 X 坐标。
vertex0Ydouble- 顶点 0 的 Y 坐标。
vertex1Xdouble- 顶点 1 的 X 坐标。
vertex1Ydouble- 顶点 1 的 Y 坐标。
vertex2Xdouble- 顶点 2 的 X 坐标。
vertex2Ydouble- 顶点 2 的 Y 坐标。
输出
outputImage- 在输入图像副本上绘制三角形、中心与辅助圆。
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- 输出宽度。
heightint- 输出高度。
interpolationstring- 重采样插值方式。
m00double- 2×3 仿射矩阵第 0 行第 0 列。
m01double- 2×3 仿射矩阵第 0 行第 1 列。
m02double- 2×3 仿射矩阵第 0 行平移分量。
m10double- 2×3 仿射矩阵第 1 行第 0 列。
m11double- 2×3 仿射矩阵第 1 行第 1 列。
m12double- 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- 输出宽度。
heightint- 输出高度。
interpolationstring- 重采样插值方式。
borderValueint- 输出画布无源像素处的填充值。
sourceControlPointsLREAL[3,2]- 源图像中的三个控制点坐标,对应 source0X/Y 至 source2X/Y。
destinationControlPointsLREAL[3,2]- 输出画布中的三个对应控制点坐标,对应 destination0X/Y 至 destination2X/Y。
输出
outputImage- 按求得仿射矩阵重采样到 width × height 的图像。
Measurements量测值集合- 包含 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- 输出宽度。
heightint- 输出高度。
interpolationstring- 重采样插值方式。
m00double- 3×3 单应矩阵第 0 行第 0 列。
m01double- 3×3 单应矩阵第 0 行第 1 列。
m02double- 3×3 单应矩阵第 0 行第 2 列。
m10double- 3×3 单应矩阵第 1 行第 0 列。
m11double- 3×3 单应矩阵第 1 行第 1 列。
m12double- 3×3 单应矩阵第 1 行第 2 列。
m20double- 3×3 单应矩阵第 2 行第 0 列。
m21double- 3×3 单应矩阵第 2 行第 1 列。
m22double- 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- 输出宽度。
heightint- 输出高度。
interpolationstring- 重采样插值方式。
borderValueint- 输出画布无源像素处的填充值。
sourceControlPointsLREAL[4,2]- 源图像中的四个控制点坐标,对应 source0X/Y 至 source3X/Y。
destinationControlPointsLREAL[4,2]- 输出画布中的四个对应控制点坐标,对应 destination0X/Y 至 destination3X/Y。
输出
outputImage- 按求得单应矩阵重采样到 width × height 的图像。
Measurements量测值集合- 包含 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);