Grow Mask With Blur (GrowMaskWithBlur) - ComfyUI-KJNodes

Узел Grow Mask With Blur реализует расширение маски на основе морфологических операций библиотеки Kornia, поддерживает обработку одиночной маски или пакета масок.

GrowMaskWithBlur — это узел для обработки и улучшения масок. Его основная функция — расширение или сжатие области входной маски с возможностью применения эффекта размытия для создания гладкой маски или маски с определенными изменениями формы.

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

Этот узел реализует расширение маски на основе морфологических операций библиотеки Kornia, поддерживает обработку одиночной маски или пакета масок. Его основной механизм заключается в изменении размера маски путем корректировки границ пикселей, с возможностью выборочного применения гауссова размытия для смягчения краев, а также предоставляет интерполяцию и коэффициент затухания для обработки переходов между кадрами последовательности.

Описание параметров узла - Grow Mask With Blur

Входные подключения (Inputs)

Название параметра	Тип данных	Обязательный	Значение по умолчанию	Диапазон значений/Опции	Описание
`mask`	MASK	Да	-	-	Входная маска или пакет масок.

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

Название параметра	Тип данных	Обязательный	Значение по умолчанию	Диапазон значений/Опции	Описание
`expand`	INT	Да	0	-MAX_RESOLUTION - MAX_RESOLUTION (шаг: 1)	expand (входной параметр): Управляет количеством пикселей для расширения или сжатия маски. Диапазон от -MAX_RESOLUTION до MAX_RESOLUTION, шаг 1. Положительные значения расширяют, отрицательные — сжимают.
`incremental_expandrate`	FLOAT	Да	0.0	0.0 - 100.0 (шаг: 0.1)	incremental_expandrate (входной параметр): Увеличивает величину расширения для каждого кадра в последовательности с заданной скоростью. Диапазон от 0.0 до 100.0, шаг 0.1.
`tapered_corners`	BOOLEAN	Да	True	-	tapered_corners (входной параметр): При включении использует сужающиеся (tapered) углы для морфологических операций, в противном случае — стандартные прямоугольные. Включено по умолчанию.
`flip_input`	BOOLEAN	Да	False	-	flip_input (входной параметр): При включении инвертирует входную маску (меняет черное и белое) перед обработкой.
`blur_radius`	FLOAT	Да	0.0	0.0 - 100 (шаг: 0.1)	blur_radius (входной параметр): Радиус гауссова размытия, применяемого к обработанной маске. Вступает в силу при значении больше 0. Диапазон от 0.0 до 100, шаг 0.1.
`lerp_alpha`	FLOAT	Да	1.0	0.0 - 1.0 (шаг: 0.01)	lerp_alpha (входной параметр): Значение Alpha, используемое для линейной интерполяции между кадрами. Диапазон от 0.0 до 1.0, шаг 0.01.
`decay_factor`	FLOAT	Да	1.0	0.0 - 1.0 (шаг: 0.01)	decay_factor (входной параметр): Коэффициент затухания, используемый для интерполяции между кадрами. Диапазон от 0.0 до 1.0, шаг 0.01.
`fill_holes`	BOOLEAN	Нет	False	-	Заполняет отверстия в маске (медленная операция).

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

Название параметра	Тип данных	Описание
mask	MASK	mask (выходной параметр): Выводит окончательную обработанную маску.
mask_inverted	MASK	mask_inverted (выходной параметр): Выводит инвертированную версию обработанной маски.

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

Этот узел очень полезен в рабочих процессах генерации изображений или обработки видео. Например, при создании анимационного эффекта постепенного появления, вы можете подключить исходную маску объекта к этому узлу и, увеличивая значение expand для каждого кадра вместе с blur_radius, создать последовательность анимационных масок с мягким рассеиванием краев объекта.

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

Обратите внимание, что функция fill_holes (заполнение отверстий) помечена как медленная операция. При обработке масок высокого разрешения или больших объемов данных следует использовать ее с осторожностью, чтобы не повлиять на эффективность выполнения рабочего процесса.

Ссылка на исходный код узла Grow Mask With Blur

Узел Grow Mask With Blur из пакета узлов ComfyUI-KJNodes.

Grow Mask With Blur(GrowMaskWithBlur)