Batch Uncrop Advanced (BatchUncropAdvanced) - ComfyUI-KJNodes

Узел Batch Uncrop Advanced получает на вход исходное изображение, обрезанное изображение, соответствующую маску обрезки, комбинированную маску и данные границ (Bounding Box).

Узел Batch Uncrop Advanced — это расширенный узел обработки изображений, специально разработанный для точного обратного слияния обрезанных и изменённых фрагментов изображения с исходным фоновым изображением. Его основная функция — пакетная обработка изображений с поддержкой масок и границ (Bounding Box) для управления процессом смешивания, обеспечивая бесшовное композиционирование.

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

Этот узел получает на вход исходное изображение, обрезанное изображение, соответствующую маску обрезки, комбинированную маску и данные границ (Bounding Box). Его техническая реализация основана на этих масках и информации о границах для позиционирования и смешивания изображений. Он поддерживает сглаживание краёв смешивания (через параметр border_blending) и позволяет масштабировать обрезанную область (через параметр crop_rescale) для точной настройки результата композиционирования.

Описание параметров узла - Batch Uncrop Advanced

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

Имя параметра	Тип данных	Обязательный	Значение по умолчанию	Диапазон/Опции	Описание
`original_images`	IMAGE	Да	-	-	original_images (входной параметр): Исходные полные изображения, используемые в качестве фона, на который будут наложены обрезанные изображения. Количество входных изображений должно совпадать с количеством `cropped_images`.
`cropped_images`	IMAGE	Да	-	-	cropped_images (входной параметр): Обрезанные фрагменты изображений, которые необходимо вставить обратно в исходный фон. Количество должно совпадать с количеством `original_images`.
`cropped_masks`	MASK	Да	-	-	cropped_masks (входной параметр): Маски, соответствующие каждому `cropped_images`, определяющие область каждого обрезанного фрагмента, которая будет использоваться при слиянии.
`combined_crop_mask`	MASK	Да	-	-	combined_crop_mask (входной параметр): Комбинированная маска, обычно созданная путём объединения масок всех областей обрезки, определяющая общую область для вставки.
`bboxes`	BBOX	Да	-	-	bboxes (входной параметр): Список границ (Bounding Box), определяющих конкретное местоположение и область в `original_images`, куда должен быть помещён каждый `cropped_images`.
`combined_bounding_box`	BBOX	Нет	-	-	combined_bounding_box (входной параметр): Необязательная граница (Bounding Box), определяющая общую область для комбинированной маски. Если не указана, граница вычисляется из отдельных `bboxes`.

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

Имя параметра	Тип данных	Обязательный	Значение по умолчанию	Диапазон/Опции	Описание
`border_blending`	FLOAT	Да	0.25	0.0 - 1.0 (шаг: 0.01)	border_blending (входной параметр): Управляет интенсивностью сглаживания границ слияния. Диапазон от 0.0 до 1.0, шаг 0.01. Чем выше значение, тем плавнее переход по краю.
`crop_rescale`	FLOAT	Да	1.0	0.0 - 10.0 (шаг: 0.01)	crop_rescale (входной параметр): Коэффициент масштабирования для `cropped_images`. Диапазон от 0.0 до 10.0, шаг 0.01. Значение 1.0 соответствует исходному размеру.
`use_combined_mask`	BOOLEAN	Да	False	-	use_combined_mask (входной параметр): Логическое значение. Если `True`, для глобального управления слиянием используется `combined_crop_mask`; если `False`, используются отдельные `cropped_masks`.
`use_square_mask`	BOOLEAN	Да	True	-	use_square_mask (входной параметр): Логическое значение. Если `True`, форма маски обрабатывается как квадратная; если `False`, сохраняется исходная форма маски.

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

Имя параметра	Тип данных	Описание
IMAGE	IMAGE	IMAGE (выходной параметр): Выводит итоговое полное изображение после композиционирования, где все обрезанные фрагменты слиты с исходным фоном.

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

Типичное применение — в рабочих процессах «inpainting» или «восстановления изображений». Например, пользователь может сначала с помощью других узлов (таких как узел Bounding Box) выделить несколько областей исходного изображения, требующих изменения. После отдельной перерисовки или редактирования этих областей данный узел используется для одновременного и естественного встраивания всех изменённых областей обратно в исходное изображение, что позволяет эффективно выполнять редактирование нескольких объектов.

Важные замечания

При использовании узла обратите внимание, что количество изображений во входных группах original_images и cropped_images должно быть строго одинаковым. Если предоставлено больше границ (bboxes), чем изображений, лишние границы будут автоматически проигнорированы.

Ссылка на исходный код узла Batch Uncrop Advanced

Узел Batch Uncrop Advanced из пакета узлов ComfyUI-KJNodes.

Batch Uncrop Advanced(BatchUncropAdvanced)