此页面由 AI 自动翻译。查看英文原版
最后更新

本页目录

  • 类
  • Tiling
  • TilingCfg
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包
最后更新
Python API: depthai_nodes.node.tiling

类

Tiling

在启动时和更新时发出 ImageManip 裁剪配置组。build() 存储初始配置。当管道调用 run() 时,节点发送第一个 dai.MessageGroup。每次调用 updateTilingConfig() 都会重新计算并发送另一个组。键是基于零的字符串索引。没有触发输入。与 FrameCropper.fromManipConfigs(waitForConfig=False) 一起使用,以重用最新组用于后续帧。

方法

init
Python
1def __init__(self):
初始化日志记录和特定于平台的输出图像格式。引发
  • ValueError: 如果管道设备平台没有配置图像帧格式。
build
Python
1def build(overlap: float, gridSize: tuple[int, int], canvasShape: tuple[int, int], resizeShape: tuple[int, int], resizeMode: dai.ImageManipConfig.ResizeMode, globalDetection: bool = False, gridMatrix: np.ndarray | list | None = None) -> Tiling:
存储初始配置,以便在管道启动时发出。参数
  • overlap (float): 相邻单元格之间的分数重叠,范围为 [0, 1)。
  • gridSize (tuple[int, int]): 网格尺寸,格式为 (列, 行)。
  • canvasShape (tuple[int, int]): 源画布大小,格式为 (宽度, 高度) 像素。
  • resizeShape (tuple[int, int]): 输出裁剪大小,格式为 (宽度, 高度) 像素。
  • resizeMode (dai.ImageManipConfig.ResizeMode): 每个裁剪的 ImageManip 调整大小策略。
  • globalDetection (bool): 如果为 true,则在前面添加一个覆盖整个画布的裁剪。
  • gridMatrix (np.ndarray | list | None): 可选的行主序网格标签。具有相同标签的四连通单元格将合并到其包含的矩形中。
返回
  • Tiling: 此节点。裁剪生成和验证在其运行时发生。
run
Python
1def run(self):
计算并发送初始裁剪配置组一次。
updateTilingConfig
Python
1def updateTilingConfig(overlap: float | None = None, gridSize: tuple[int, int] | None = None, canvasShape: tuple[int, int] | None = None, resizeShape: tuple[int, int] | None = None, resizeMode: dai.ImageManipConfig.ResizeMode | None = None, globalDetection: bool | None = None, gridMatrix: np.ndarray | list | None | None = None):
更新选定的设置并立即发出新的配置组。参数
  • overlap (float | None): 相邻单元格之间的分数重叠,范围为 [0, 1)。None 保留当前值。
  • gridSize (tuple[int, int] | None): 网格尺寸,格式为 (列, 行)。None 保留当前值。
  • canvasShape (tuple[int, int] | None): 源画布大小,格式为 (宽度, 高度) 像素。None 保留当前值。
  • resizeShape (tuple[int, int] | None): 输出裁剪大小,格式为 (宽度, 高度) 像素。None 保留当前值。
  • resizeMode (dai.ImageManipConfig.ResizeMode | None): 每个裁剪的 ImageManip 调整大小策略。None 保留当前值。
  • globalDetection (bool | None): 如果为 true,则在前面添加一个覆盖整个画布的裁剪。None 保留当前值。
  • gridMatrix (np.ndarray | list | None | None): 可选的行主序网格标签。具有相同标签的四连通单元格将合并到其包含的矩形中。None 保留当前值。
引发
  • RuntimeError: 如果尚未调用 build()。
  • ValueError: 如果重叠超出 [0, 1) 范围或网格矩阵尺寸与 gridSize 不一致。

属性

out
返回瓦片配置组的输出流。
tileCount
返回当前配置中的瓦片数量。
tilePositions
将裁剪矩形返回为 (xmin, ymin, xmax, ymax) 像素边界。首先需要 build()。当启用全局检测时,首先包含完整画布,然后是计算出的单元格或组矩形。

TilingCfg

瓦片几何和 ImageManip 生成共享的配置。

属性

canvasShape
源画布大小,格式为 (宽度, 高度) 像素。
globalDetection
如果为 true,则在前面添加一个覆盖整个画布的裁剪。
gridMatrix
可选的行主序网格标签。具有相同标签的四连通单元格将合并到其包含的矩形中。
gridSize
网格尺寸,格式为 (列, 行)。
overlap
相邻单元格之间的分数重叠,范围为 [0, 1)。
resizeMode
每个裁剪的 ImageManip 调整大小策略。
resizeShape
输出裁剪大小,格式为 (宽度, 高度) 像素。