Translate Shape

Esta función mueve formas geométricas por los desplazamientos horizontales y verticales especificados. Úsala cuando necesites desplazar puntos, rectángulos, círculos o contornos dentro del espacio de coordenadas de tu imagen.

📥 Entradas

Shape Una forma a traducir. Tipos aceptados:

• Punto único (x, y)

• Rectángulo definido por dos puntos de esquina

• Círculo definido por center_x, center_y, radius

• Contorno (una lista/array ordenada de puntos (x,y))

X Valor de traslación horizontal (opcional). Pixeles enteros para mover la forma a lo largo de X. Por defecto es 0 si no se proporciona.

Y Valor de traslación vertical (opcional). Pixeles enteros para mover la forma a lo largo de Y. Por defecto es 0 si no se proporciona.

(Todos los anteriores son sockets de entrada.)

📤 Salidas

Shape La forma traducida devuelta en el mismo formato que la entrada (punto, rectángulo, círculo o contorno).

(Este es un socket de salida.)

🕹️ Controles

Este bloque de función no tiene controles o widgets adicionales. Proporciona las translaciones a través de los sockets de entrada (X y Y).

⚙️ Mecanismo de ejecución

• Al ejecutarse, el bloque lee la Shape proporcionada y los valores opcionales de traslación X y Y.

• Las translaciones se aplican como desplazamientos de píxeles enteros. Valores positivos mueven la forma a la derecha/abajo; valores negativos la mueven a la izquierda/arriba.

• El bloque devuelve el mismo tipo de forma desplazada por los offsets dados. Para contornos, cada vértice se desplaza por el mismo offset (X, Y).

• Si se suministra un tipo de forma no soportado o datos inválidos, el bloque indicará un error de configuración — asegúrate de que la entrada Shape coincide con uno de los formatos aceptados.

✨ Características

• Soporta tipos de forma comunes: point, rectangle, circle y contour.

• Conserva el formato de salida idéntico al de la entrada para encadenamientos sin fricción.

• Traslación simple basada en enteros para posicionamiento determinista.

• Funciona con formas individuales o arrays de contornos para transformaciones geométricas por lotes.

📝 Instrucciones de uso

1. Proporciona una forma al socket Shape (por ejemplo, el contorno devuelto por un detector).

2. Proporciona el desplazamiento horizontal al socket X (opcional).

3. Proporciona el desplazamiento vertical al socket Y (opcional).

4. Lee la forma traducida desde el socket de salida Shape y úsala para dibujar, medir o procesar posteriormente.

💡 Tips and Tricks

• Combínalo con bloques de detección y ROI:

  • Usa Find Contour, Find Object o Approximate Contour para obtener shapes, luego aliméntalos a este bloque para alinear o desplazar resultados.

  • Usa Image ROI, Image ROI Select o Get ROI para recortar o enfocar una región antes de traducir shapes, de modo que las coordenadas permanezcan consistentes dentro de la región de trabajo.

• Trabajar con múltiples shapes o listas:

  • Usa Batch Processing, Debatch o Batch Concatenation para traducir una lista de shapes de forma iterativa.

  • Para dibujar los resultados traducidos y verificarlos visualmente, envía la salida a Draw Point, Draw Rectangle o Draw Result On Image.

• Para flujos de trabajo de medición:

  • Después de traducir shapes, usa Measure Position Distance para calcular distancias entre posiciones movidas y de referencia.

  • Usa Minimum Rectangle, Hull Convex o Contour to Image para convertir y comparar resúmenes geométricos tras la traducción.

• Visualización y depuración:

  • Para visualizar contornos o rectángulos traducidos en imágenes, enruta la shape traducida a Draw Rectangle o Draw Result On Image y prévisualiza con Show Image.

🛠️ Solución de problemas

• No se ve ningún cambio tras la traducción:

  • Verifica que se hayan proporcionado valores distintos de cero en X o Y.

  • Asegúrate de que el bloque de dibujo/visualización (por ejemplo Show Image o Draw Rectangle) esté recibiendo la shape traducida y que se esté usando el mismo sistema de coordenadas.

• Errores de formato inesperados:

  • Confirma que la Shape de entrada se ajuste a uno de los formatos soportados (point, rectangle, circle o contour).

  • Si trabajas con listas, asegúrate de que se proporcionen mediante un flujo compatible con batch/list (usa Batch Processing / Debatch según sea necesario).

• Shapes fuera de los límites:

  • Las translaciones pueden mover formas fuera del área de la imagen. Si esto es un problema, restringe las coordenadas con comprobaciones posteriores o recorta el ROI antes de la traducción.