Cut And Drag On Path (CutAndDragOnPath) - ComfyUI-KJNodes

El nodo Cut And Drag On Path primero analiza la cadena de coordenadas de ruta de entrada, luego identifica con precisión el límite del área de imagen cubierta por la máscara y la recorta.

El nodo Cut And Drag On Path es una herramienta de procesamiento de imágenes que recorta el área seleccionada por una máscara de una imagen y la mueve a lo largo de una ruta definida por el usuario. Este nodo se utiliza principalmente para crear efectos dinámicos, como hacer que un objeto se deslice o flote a lo largo de una trayectoria específica dentro del encuadre. Si la función de restauración (inpainting) está habilitada, también puede rellenar inteligentemente los espacios vacíos dejados por el área recortada.

Funcionalidad del Nodo

El nodo primero analiza la cadena de coordenadas de ruta de entrada, luego identifica con precisión el límite del área de imagen cubierta por la máscara y la recorta. El fragmento de imagen recortado se desplaza y compone en un lienzo del tamaño especificado según la secuencia de coordenadas. El núcleo técnico radica en el análisis de coordenadas, el recorte de áreas y la reasignación de posiciones. Admite los formatos de tensor estándar IMAGE y MASK, y opcionalmente puede utilizar una imagen de fondo o un algoritmo de restauración integrado para procesar el fondo.

Explicación de Parámetros del Nodo - Cut And Drag On Path

Entradas (Inputs)

Nombre del Parámetro	Tipo de Dato	Requerido	Valor por Defecto	Rango/Opciones	Descripción
`image`	IMAGE	Sí	-	-	La imagen de entrada de la cual se recortará el área de la máscara y se moverá a lo largo de la ruta.
`mask`	MASK	Sí	-	-	La máscara que define la región a recortar de la imagen. Solo se consideran los píxeles no nulos.
`bg_image`	IMAGE	No	-	-	Imagen de fondo opcional. Si se proporciona, esta imagen se usará para rellenar las áreas en blanco en lugar del algoritmo de restauración.

Parámetros de Control (Parameters)

Nombre del Parámetro	Tipo de Dato	Requerido	Valor por Defecto	Rango/Opciones	Descripción
`coordinates`	CADENA	Sí	-	-	Una cadena que define la secuencia de coordenadas para la ruta de movimiento. Debe ser un array JSON en un formato específico.
`frame_width`	ENTERO	Sí	512	16 - 4096 (paso: 1)	Establece el ancho de la imagen de salida. Rango válido de 16 a 4096, con paso de 1.
`frame_height`	ENTERO	Sí	512	16 - 4096 (paso: 1)	Establece el alto de la imagen de salida. Rango válido de 16 a 4096, con paso de 1.
`inpaint`	BOOLEANO	Sí	Verdadero	-	Interruptor booleano que controla si se realiza una restauración inteligente para rellenar las áreas en blanco dejadas después del recorte. Cuando está habilitado y no se proporciona una imagen de fondo, el área recortada se rellena usando el algoritmo cv2 TELEA.

Salidas (Output)

Nombre del Parámetro	Tipo de Dato	Descripción
image	IMAGE	La secuencia de imágenes de salida procesadas.
mask	MASK	La secuencia de máscaras transformadas a lo largo de la misma ruta.

Casos de Uso

Puedes usar este nodo al crear animaciones simples o efectos especiales. Por ejemplo, en un flujo de trabajo de procesamiento de fotogramas de video, primero obtén una máscara de un objeto usando SAM o dibujándola manualmente, luego genera coordenadas de una ruta de movimiento a través de otros nodos y finalmente conéctalas a este nodo. Esto generará una serie de secuencias de imágenes donde el objeto se mueve a lo largo de la ruta, listas para la composición posterior de fotogramas.

Consideraciones

Tenga en cuenta que la cadena de coordenadas de entrada debe cumplir con los requisitos de formato JSON específicos; de lo contrario, es posible que no se analice correctamente. Además, si el área de la máscara es completamente negra (es decir, no se selecciona ninguna área), el nodo devolverá la entrada original sin procesar.

Enlace al Código Fuente del Nodo Cut And Drag On Path

El nodo Cut And Drag On Path proviene del paquete de nodos ComfyUI-KJNodes.

Cut And Drag On Path(CutAndDragOnPath)