Line Geometry

Esta función proporciona una herramienta única y flexible para una amplia gama de operaciones geométricas sobre líneas: ángulos, distancias, intersecciones, proyecciones, puntos medios, extracción de segmentos y más. Puede producir resultados numéricos, puntos, datos adicionales específicos de la operación y (opcionalmente) una imagen anotada para visualización.

📥 Entradas

• Input Image Imagen opcional usada para superposiciones de visualización (si desea líneas, puntos o contornos dibujados).

• Line 1 Requerida para la mayoría de las operaciones. Acepta una línea descrita como [(x1, y1), (x2, y2)] o una entrada de forma compatible.

• Line 2 Requerida para operaciones de ángulo / intersección / algunas distancias. Acepta una segunda línea en el mismo formato.

• Anchor Point Punto opcional (x, y) usado por operaciones de proyección y punto-a-línea o cuando se suministra un contorno para intersección de formas.

📤 Salidas

• Output Image Imagen anotada (si se proporciona Input Image y está habilitado Show Visualization).

• Result Resultado numérico de la operación seleccionada (por ejemplo ángulo en grados o distancia en píxeles).

• Point Output Resultado en forma de punto cuando la operación produce una coordenada (p. ej., intersección, proyección, punto medio).

• Extra Output Datos específicos de la operación (por ejemplo, extremos de un segmento, lista de puntos de intersección u otra información de depuración).

🕹️ Controles

• Operation Type Elija la operación geométrica a realizar (p. ej., Angle Between Lines, Intersection Point, Segment Extraction, Projection).

• Offset (px) Deslizador usado por operaciones de segmento / proyección para aplicar un desplazamiento en píxeles.

• Interpolation Factor Deslizador (0–100%) usado para operaciones basadas en interpolación (extracción de segmento, proyección a lo largo de la línea).

• Show Visualization Casilla para activar/desactivar el dibujo anotado en Output Image cuando se proporciona un Input Image.

🎯 Funcionalidades clave

• Bloque multiuso que cubre muchas tareas geométricas comunes.

• Comportamiento sensible al contexto: solo las salidas relevantes a la operación seleccionada contendrán datos significativos.

• Superposiciones visuales opcionales: dibuja líneas, puntos medios, intersecciones, proyecciones y segmentos directamente sobre la imagen proporcionada.

• Ayudas interactivas y sugerencias de control que facilitan seleccionar las entradas y parámetros adecuados para cada operación.

⚙️ Cómo se ejecuta

Al ejecutarse, el bloque lee los sockets conectados y el Operation Type seleccionado. Realiza el cálculo geométrico solicitado usando Line 1, la Line 2 opcional y/o el Anchor Point opcional. Si se conecta un Input Image y está habilitado Show Visualization, el bloque devuelve una imagen anotada en Output Image. Los resultados numéricos y los puntos aparecen en las salidas correspondientes según la operación.

📝 Instrucciones de uso

1. Seleccione la operación deseada en Operation Type.

2. Conecte los sockets requeridos: como mínimo conecte Line 1. Conecte Line 2 o Anchor Point cuando la operación lo requiera.

3. Opcionalmente aporte un Input Image y habilite Show Visualization para obtener una imagen anotada.

4. Ajuste Offset (px) o Interpolation Factor para operaciones de extracción de segmento o proyección.

5. Ejecute el escenario; inspeccione Result, Point Output y/o Extra Output y vea la superposición visual en Output Image o mediante un bloque de visualización.

💡 Consejos y trucos (combinación con otros bloques)

• Para obtener líneas automáticamente a partir de contornos o bordes, combínelo con Find Contour o Line Detector para extraer datos de forma/línea y páselos a Line Geometry.

• Recorte una región y realice geometría enfocada con Image ROI, Image ROI Select o Image ROI Polygon antes de enviar la imagen a este bloque — esto reduce ruido y mejora resultados.

• Visualice las salidas en la interfaz usando Show Image para inspeccionar imágenes anotadas y verificar interactivamente puntos e intersecciones.

• Si necesita sobreponer resultados textuales en la imagen anotada para informes o tableros, agregue Draw Result On Image después de la salida visualizada.

• Para medir distancias entre características detectadas, use Find Contour o Feature Detector para localizar puntos, luego use Line Geometry para calcular puntos medios, distancias o proyecciones. Envíe salidas numéricas/punto a Measure Position Distance para desglose adicional.

• Para aislar solo las detecciones relevantes antes de cálculos geométricos, utilice Image ROI Select o Check Area (Polygon) para filtrar posiciones y formas.

• Al combinar flujos de detección y seguimiento, use Object Detection o Object Detection - Custom aguas arriba para proporcionar coordenadas y emplee Line Geometry para análisis como comprobación de intersecciones o cálculo de ángulos de aproximación.

(sugerencia: use las salidas del bloque como Point Output o Extra Output como entradas para otros bloques de procesamiento como Measure Position Distance, Draw Point o bloques de registro/exportación.)

🛠️ Solución de problemas

• Si Output Image está vacío: asegúrese de que se haya conectado un Input Image y que Show Visualization esté habilitado.

• Si una operación no devuelve valor en Result o Point Output: verifique que los sockets requeridos para esa operación estén conectados (por ejemplo, Line 2 es necesaria para ángulo/intersección).

• Si las coordenadas parecen incorrectas: verifique el formato de coordenadas y que las líneas estén provistas como [(x1, y1), (x2, y2)]. Use bloques de vista previa como Show Image o Draw Point para inspeccionar puntos intermedios.

• Para resultados de proyección e interpolación que no coinciden: ajuste finamente Offset (px) y Interpolation Factor para adaptar la escala y las unidades esperadas.

Si necesita verificaciones visuales paso a paso, combine el bloque con Show Image y Draw Point para validar la geometría intermedia antes de usar los resultados en procesos posteriores.