imageUncropFromBBOX

Descripción

imageUncropFromBBOX coloca una imagen previamente recortada de vuelta sobre su imagen original usando una caja delimitadora. Está diseñado para usarse con flujos de trabajo de recorte o que producen BBOX: recorta una región, procésala y luego pégala de vuelta sobre el lienzo original en la ubicación correcta.

El nodo también te da control sobre cómo el recorte pegado se mezcla con la imagen original circundante, y si la región de pegado se trata como un rectángulo completo o como una forma arbitraria definida por una máscara opcional.

Entradas

Nombre	Tipo	Predeterminado	Descripción
`original_image`	IMAGE	—	La imagen a tamaño completo sobre la que se pegará el recorte.
`crop_image`	IMAGE	—	La región de imagen que se va a pegar de vuelta. Debe corresponder al área definida por `bbox`.
`bbox`	BBOX	—	La caja delimitadora que ubica el recorte dentro de `original_image`. Usa una salida BBOX de un nodo que produzca BBOX.
`border_blending`	FLOTANTE	0.25	Controla la intensidad con la que los bordes del recorte pegado se mezclan en la imagen original. El rango es de 0.0 a 1.0. Un valor de 0 crea un borde definido; los valores más altos producen una transición más suave.
`use_square_mask`	BOOLEANO	verdadero	Cuando está habilitado, la región pegada se trata como un rectángulo relleno que cubre toda la caja delimitadora. Deshabilítalo cuando necesites conservar una forma no rectangular proporcionada por `optional_mask`.
`optional_mask`	MASK	Ninguno	Máscara opcional utilizada cuando `use_square_mask` está deshabilitado. Define qué partes del recorte de imagen deben pegarse y cómo deben manejarse los bordes.

Salidas

Nombre	Tipo	Descripción
IMAGE	IMAGE	El resultado compuesto: la imagen original con `crop_image` pegada de vuelta en la caja delimitadora especificada, usando el comportamiento de mezcla seleccionado.

Notas de Uso

bbox espera un objeto BBOX, no coordenadas sin procesar. Usa una salida BBOX de otro nodo que produzca este tipo.
Las coordenadas de la caja delimitadora se refieren al espacio de píxeles de original_image. crop_image debe ser la región exacta extraída de esa caja delimitadora.
Mantén use_square_mask habilitado para composiciones rectangulares sencillas, como pegar de vuelta un recorte de tamaño fijo o un resultado de Relleno inteligente.
Si tu recorte proviene de un área enmascarada o tiene una forma irregular, establece use_square_mask en False y proporciona optional_mask para controlar la forma de pegado.
border_blending es un valor normalizado entre 0 y 1, por lo que incluso cambios pequeños pueden afectar notablemente la visibilidad de la unión entre el recorte y la imagen original.