Batch Crop From Mask (BatchCropFromMask) - ComfyUI-KJNodes

С технической точки зрения, узел Batch Crop From Mask принимает на вход исходное изображение типа IMAGE и маску типа MASK.

Узел Batch Crop From Mask — это инструмент для пакетной обработки изображений, который может автоматически определять и вырезать целевые области на изображении на основе предоставленной маски (Mask). Основная функция узла — анализировать области ненулевых пикселей каждой маски, вычислять соответствующие ограничивающие рамки (Bounding Box) и использовать эти рамки для вырезания соответствующих суб-изображений из исходного изображения.

Функциональность узла

С технической точки зрения, этот узел принимает на вход исходное изображение типа IMAGE и маску типа MASK. Он проходит по каждой паре изображение-маска и вычисляет минимальный описывающий прямоугольник по координатам ненулевых пикселей маски. Узел поддерживает сглаживание размеров ограничивающей рамки: параметр bbox_smooth_alpha позволяет регулировать степень смешивания размеров рамки текущего кадра с размерами рамки предыдущего кадра, что помогает получить более стабильные результаты обрезки при обработке последовательностей. Вычисленные размеры ограничивающей рамки также умножаются на коэффициент crop_size_mult для масштабирования, что позволяет гибко регулировать итоговый размер области обрезки.

Описание параметров узла - Batch Crop From Mask

Входные соединения (Inputs)

Название параметра	Тип данных	Обязательный	Значение по умолчанию	Диапазон значений/Опции	Описание
`original_images`	IMAGE	Да	-	-	**: Выходная последовательность исходных изображений, идентичная входной. Тип: IMAGE.
`masks`	MASK	Да	-	-	**: Входная последовательность масок, используемая для определения целевой области на исходном изображении, которую необходимо вырезать. Области ненулевых пикселей маски будут вычислены как ограничивающая рамка. Тип: MASK.

Параметры управления (Parameters)

Название параметра	Тип данных	Обязательный	Значение по умолчанию	Диапазон значений/Опции	Описание
`crop_size_mult`	FLOAT	Да	1.0	0.0 - 10.0 (шаг: 0.001)	**: Множитель размера обрезки, используемый для масштабирования вычисленного размера ограничивающей рамки. Диапазон значений от 0.0 до 10.0, шаг 0.001.
`bbox_smooth_alpha`	FLOAT	Да	0.5	0.0 - 1.0 (шаг: 0.01)	**: Коэффициент сглаживания ограничивающей рамки, используемый для смешивания размеров рамки текущего кадра с размерами рамки предыдущего кадра для обеспечения плавного перехода. Диапазон значений от 0.0 до 1.0, шаг 0.01.

Выходные данные (Output)

Название параметра	Тип данных	Описание
original_images	IMAGE	**: Выходная последовательность исходных изображений, идентичная входной. Тип: IMAGE.
cropped_images	IMAGE	**: Выходная последовательность обрезанных изображений. Тип: IMAGE.
bboxes	BBOX	**: Выходная последовательность координат ограничивающих рамок в формате (x1, y1, x2, y2). Тип: BBOX.
width	INT	**: Единая ширина выходных обрезанных изображений. Тип: INT.
height	INT	**: Единая высота выходных обрезанных изображений. Тип: INT.

Сценарии использования

В реальном рабочем процессе этот узел часто используется в сценариях, требующих фокусировки на определенных частях изображения. Например, при создании анимации или обработке видео-последовательностей вы можете сначала использовать узел генерации маски (например, SAM или GroundingDino) для идентификации основного объекта на каждом кадре, а затем подключить сгенерированную последовательность масок и исходную последовательность изображений к этому узлу. Узел выведет последовательность обрезанных изображений и соответствующие координаты ограничивающих рамок. Эти выходные данные могут быть далее использованы для локальной перерисовки, повышения разрешения или в качестве входных данных для других узлов обработки изображений.

Ссылка на исходный код узла Batch Crop From Mask

Узел Batch Crop From Mask взят из пакета узлов ComfyUI-KJNodes.

Batch Crop From Mask(BatchCropFromMask)