frame_cropper
最后更新
depthai_nodes.node.frame_cropper类
FrameCropper
dai.ImgFrame。FrameCropper 是一个方便的包装器,它封装了一个内部的 dai.node.ImageManip,该 ImageManip 配置用于裁剪 + 调整大小。它支持两种输入模式:- fromImgDetections:提供
dai.ImgDetections,节点将通过dai.node.Script节点为每个检测生成dai.ImageManipConfig消息。每个配置都与相应的输入帧配对,为每个检测生成一个裁剪后的输出帧。 - fromManipConfigs:提供一个由
dai.MessageGroup消息中打包的裁剪配置组成的上游流。一个设备上的dai.node.Script节点将每个配置与当前帧配对,并将它们转发到内部的dai.node.ImageManip。
fromImgDetections 或 fromManipConfigs 提供。只有在调用 build 后,才会构建管道节点。Note
- 必须且只能选择一个配置路径:
fromImgDetections和fromManipConfigs只能使用其中一个。 - 输出帧始终使用提供的
resizeMode(默认值:CENTER_CROP)调整为outputSize。 - 在
fromImgDetections模式下,dai.node.Script节点通过为每个检测发出一个dai.ImageManipConfig来驱动裁剪。 - 在
fromManipConfigs模式下,inputManipConfigs流必须输出dai.MessageGroup消息,其中每个值都是dai.ImageManipConfig。键名是任意的。
fromImgDetections(padding=0.0) 为每个检测区域添加可选的填充。build(outputSize, resizeMode) 设置裁剪大小和调整大小模式。输出:out : dai.Node.Output:裁剪后的dai.ImgFrame消息流。每个裁剪配置(在fromImgDetections模式下为每个检测;在fromManipConfigs模式下为收到的MessageGroup中的每个配置)都会生成一个输出帧。
dai.node.ImageManip:用于执行裁剪和调整大小的节点。dai.ImageManipConfig:转发到 ImageManip 的裁剪配置消息。dai.ImgDetections:fromImgDetections模式中使用的检测消息类型。dai.MessageGroup:fromManipConfigs期望的消息类型。
方法
init
Python
1def __init__(self):ValueError:如果管道设备平台没有配置图像帧格式。
build
Python
1def build(inputImage: dai.Node.Output) -> FrameCropper:inputImage(dai.Node.Output):要裁剪的图像流。首先调用fromImgDetections()或fromManipConfigs()。
FrameCropper:此节点,裁剪后的帧可在out上获得。
RuntimeError:如果未选择裁剪配置模式。
fromImgDetections
Python
1def fromImgDetections(inputImgDetections: dai.Node.Output, outputSize: tuple[int, int], resizeMode: dai.ImageManipConfig.ResizeMode = dai.ImageManipConfig.ResizeMode.CENTER_CROP, padding: float = 0.0, syncThreshold: timedelta = timedelta(milliseconds=10)) -> FrameCropper:build() 之前选择检测驱动的裁剪。Note
为每个检测生成一个裁剪。图像流稍后由
build() 连接。inputImgDetections(dai.Node.Output):要与图像帧同步的dai.ImgDetections输出流。outputSize(tuple[int, int]):裁剪输出大小,格式为(宽度, 高度)像素。resizeMode(dai.ImageManipConfig.ResizeMode):应用于每个裁剪的 ImageManip 调整大小策略。padding(float):添加到检测区域每侧的归一化填充。syncThreshold(timedelta):用于同步检测和帧的最大时间戳差异。
FrameCropper:用于流畅配置的此节点。
RuntimeError:如果已选择任一裁剪配置模式。
fromManipConfigs
Python
1def fromManipConfigs(inputManipConfigs: dai.Node.Output, maxOutputFrameSize: int, waitForConfig: bool, syncThreshold: timedelta | None = None) -> FrameCropper:inputManipConfigs(dai.Node.Output):dai.MessageGroup对象流,其值是dai.ImageManipConfig消息。组键是任意的。maxOutputFrameSize(int):最大输出图像缓冲区大小(以字节为单位)。waitForConfig(bool):如果为 true,则将每个帧与配置组同步。否则,将最新组用于后续帧。syncThreshold(timedelta | None):可选时间戳容差。仅当waitForConfig为 true 时才能设置。
FrameCropper:用于流畅配置的此节点。
RuntimeError:如果已选择配置模式,或者在不等待配置的情况下提供了同步阈值。
run
Python
1def run(self):