# tiling

Python API: `depthai_nodes.node.tiling`

## 类

### Tiling

在启动时和更新时发出 ImageManip 裁剪配置组。

`build()` 存储初始配置。当管道调用 `run()` 时，节点发送第一个 `dai.MessageGroup`。每次调用 `updateTilingConfig()` 都会重新计算并发送另一个组。键是基于零的字符串索引。没有触发输入。

与 `FrameCropper.fromManipConfigs(waitForConfig=False)` 一起使用，以重用最新组用于后续帧。

#### 方法

##### init

```python
def __init__(self):
```

初始化日志记录和特定于平台的输出图像格式。

引发

 * `ValueError`: 如果管道设备平台没有配置图像帧格式。

##### build

```python
def 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
def run(self):
```

计算并发送初始裁剪配置组一次。

##### updateTilingConfig

```python
def 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):
```

更新选定的设置并立即发出新的配置组。

> **注意**
> 更新会在裁剪验证之前改变存储的配置。`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

输出裁剪大小，格式为 `(宽度, 高度)` 像素。
