# FindMultiLine

Localiza bordes rectos multilineales en una región de la imagen. La función FindMultiLine forma una proyección unidimensional de la región de la imagen al sumar los valores de los píxeles ubicados en segmentos de línea radiales que va explorando en la dirección y positiva respecto al sistema de coordenadas local de la región. Las transiciones en los bordes se extraen de los datos de la imagen proyectada.

## FindMultiLine Entradas

Parámetro | Descripción
Imagen | This parameter must reference a spreadsheet cell that contains an Imagen data structure; by default, this parameter references A0, the cell containing the data structure. This parameter can also reference other Image data structures, such as those returned by the Image Vision Data Access functions or Funciones de transformación de coordenadas.
Elemento posicionador | Define la región de interés (RDI) con relación a un Fixture entrado o al sistema de coordenadas de imagen proporcionado por una función de Vision Tools. Establecer la RDI con relación al un elemento posicionador permite asegurar que si se gira o desplaza el elemento posicionador, se girará o desplazará en consonancia la RDI, manteniéndose fija la relación entre ambos. El valor de configuración predeterminado es (0,0,0), la esquina superior izquierda de la imagen.
X | El desplazamiento en X, en coordenadas de la imagen.
Y | El desplazamiento en Y, en coordenadas de la imagen.
Theta | La rotación desde el eje X de la imagen, en el sistema de coordenadas de imagen. (+/-360 grados en el sentido de las agujas del reloj)
Región | También conocida como región de interés (RDI), especifica la región de la imagen que se somete a análisis. Haga doble clic sobre el parámetro Región para crear un Modo gráfico interactivo que permite transformar y girar. Seleccione este parámetro y pulse el botón «Maximizar región» en la barra de herramientas de edición de tareas de la hoja de propiedades a fin de expandir automáticamente la región hasta cubrir toda la imagen.
X | El desplazamiento en X del origen, en coordenadas del elemento posicionador.
Y | El desplazamiento en Y del origen, en coordenadas del elemento posicionador.
Ancho | El tamaño de la región en la dirección del eje X.
Altura | El tamaño de la región en la dirección del eje Y.
Ángulo | La orientación en coordenadas del elemento posicionador.
Curva | La desviación angular entre el eje X de la región y la línea limítrofe del lado opuesto.
Nota: Los parámetros Elemento posicionador y Región deben estar definidos dentro de los límites de la imagen; de lo contrario, la función dará #ERR.
Número a buscar | Especifica el número máximo de bordes que ha de devolver la función (de 1 a anchura de la imagen del sensor menos 1; por defecto = 3). El número máximo de bordes que se pueden detectar es en una unidad menor que la anchura de la imagen que proporciona la cámara In-Sight que captura la imagen (es decir, el máximo de una cámara ISC 8402 sería 1599 o la resolución de imagen de 1600 x 1200 del sistema de visión menos 1).
Umbral negro a blanco | Especifica la puntuación mínima aceptable para el contraste de negro a blanco en un borde (de 0 a 100; por defecto = 25). La función FindMultiLine no considerará los bordes que presenten una transición negro a blanco con puntuación de contraste inferior al valor de Umbral negro a blanco. El contraste en los bordes se normaliza mediante el histograma en escala de grises de la región explorada.
Umbral blanco a negro | Especifica la puntuación mínima aceptable para el contraste de blanco a negro en un borde (de 0 a 100, por defecto = 25). La función FindMultiLine no considerará los bordes que presenten una transición blanco a negro con puntuación de contraste inferior al valor de Umbral blanco a negro. El contraste en los bordes se normaliza mediante el histograma en escala de grises de la región explorada.
Normalizar puntuación | Especifica si las puntuaciones de los bordes serán normalizadas al histograma de escala de grises de la región. Cuando la opción Normalizar puntuación está habilitada, las puntuaciones brutas de los bordes se normalizan al contraste máximo encontrado en la región de imagen utilizando la fórmula siguiente: Puntuación = (Puntuación bruta del borde) x (100/contraste máximo) Donde la puntuación bruta del borde es la diferencia en niveles de gris a lo ancho del borde y el contraste máximo es la diferencia entre el nivel de gris máximo y el mínimo (0 a 255) en la región de la imagen. Si se deshabilita la opción Normalizar puntuación, los bordes de bajo contraste tendrán una puntuación inferior a la de los bordes de alto contraste. Se utiliza la siguiente fórmula: Puntuación = (Puntuación bruta del borde) x (100/255)
0 = DESACTIVADO | No normaliza la puntuación.
1 = ACTIVADO (por defecto) | Normaliza la puntuación.
Nota: Sugerencia: Este parámetro sirve para encontrar bordes en una región de bajo contraste. Si prevé que los bordes a detectar son todos de alto contraste, desactive este parámetro.
Buscar por | Define el método de selección de bordes que utilizará la función para seleccionar un borde de entre múltiples candidatos a borde.
0 = mejor puntuación (por defecto) | Especifica que el borde con la mayor puntuación recibe la mayor de las consideraciones.
1 = primer borde | Especifica que el primer borde detectado recibe la mayor de las consideraciones.
2 = último borde | Especifica que el último borde detectado recibe la mayor de las consideraciones.
Margen angular | Especifica la tolerancia de la función a la rotación de los bordes (de 0 a 10; por defecto = 0). La función seguirá buscando bordes fuera del margen de tolerancia especificado, pero la precisión no será tan alta. Nota: Si se ajusta este parámetro a un valor mayor que 0, se reducirá la velocidad de la función.
Ancho de margen | Especifica la distancia en píxeles (de 1 a 50; por defecto = 3) en la que se produce una transición de borde. El parámetro Ancho de borde se utiliza para filtrar la imagen antes de extraer los bordes.
Mostrar | Especifica el modo de visualización de las superposiciones gráficas de FindMultiLine sobre la imagen.
0 = ocultar todo (por defecto) | Se ocultarán todos los gráficos, excepto cuando la celda que contiene la función FindMultiLine es la celda activa en la hoja de cálculo.
1 = solo gráficos de resultados | Se visualizarán en todo momento los bordes lineales encontrados.
2 = gráficos de entrada y resultado | Se visualizarán en todo momento la región de la imagen entrada y los bordes lineales encontrados.
3 = mostrar todo: entrada, resultado y gráfico | Se visualizarán en todo momento la región de la imagen entrada, los bordes lineales encontrados y el gráfico de respuesta de los bordes. Nota: El gráfico de respuesta a bordes es una ventana acoplable. Para más información, consulte el tema Editor de hojas de cálculo - Gráficos.

## FindMultiLine Salidas

Devuelve | Una estructura de datos Edge que contiene los segmentos de borde multilínea rectos, o #ERR si alguno de los parámetros de entrada no es válido.
Resultados | Cuando se inserta inicialmente la función FindMultiLine en una celda, se crea una tabla de resultados en la hoja de cálculo. Se inserta automáticamente una herramienta Edges Vision Data Access functions en la hoja de cálculo a fin de crear la tabla de resultados:
Etiqueta | Función | Descripción
--- | --- | ---
NFound | GetNFound(Edges) | NFound es el número de bordes encontrados.
Se puede acceder a otros elementos adicionales de datos mediante Edges Vision Data Access functions.