# Funciones de Math Tool

Math Tool ofrece un diccionario completo de operaciones matemáticas:

- Las funciones de «Almacenamiento cronometrado de datos» almacenan el flujo de valores de una celda controlándolo a lo largo del tiempo. Cada función devuelve un único valor seleccionado del flujo de valores cada vez que el evento especificado actualiza la hoja de cálculo.

- Con las funciones de «Geometría y medición» se puede calcular fácilmente la distancia entre construcciones geométricas estándar como, por ejemplo, círculos, puntos y segmentos de línea.
- Gráficos:
  - Las funciones de «Control» insertan elementos interactivos en la hoja de cálculo que permiten al usuario modificar de forma sencilla la configuración de una tarea sin tener que utilizar el cuadro de diálogo Insertar función o una hoja de propiedades.
  - Las funciones de «Imagen» trazan superposiciones gráficas sobre la imagen.
- Funciones matemáticas:
  - Las funciones «Lógicas» permiten realizar operaciones de álgebra booleana y pruebas condicionales. Para todas las funciones lógicas, el valor 0 significa resultado FALSO, mientras que cualquier resultado distinto de cero significa VERDADERO.
  - Utilice las funciones de «Búsqueda» para buscar un máximo, un mínimo o un número de índice dentro de un determinado intervalo de valores; devolver coordenadas X e Y o datos de #ERR; suprimir celdas con #ERR a fin de evitar la propagación de errores a través de múltiples funciones.
  - Las funciones «Aritméticas» incluyen varias funciones matemáticas como valor absoluto, potencia, truncamiento, redondeo y generación de números aleatorios.
  - «Estadísticas»: devuelven datos como máximo, mínimo, media (promedio) y desviación estándar de un grupo de valores.
  - «Trigonometría»: proporciona funciones para determinar (o relacionadas con) el seno, el coseno, la tangente, pi, grados y radianes.
- Las funciones de «Operador» proporcionan operadores relacionales como =, <>, >, <, >=, <=.

- Las funciones de cadena dan formato a los datos alfanuméricos a visualizar y los que se transfieren entre el sistema de visión In-Sight y un dispositivo remoto.

- Las funciones de Vision Data Access (VDA) extraen valores individuales de estructuras de datos, funciones y otras referencias de celda.

- Las funciones de Vision Tools son funciones que extraen y procesan características de imágenes para posteriores análisis de datos y tomas de decisiones.

Nota: Los nombres de las categorías (indicados anteriormente entre comillas) no aparecen en la lista del cuadro de diálogo Insertar función. Las funciones se presentan en la lista por orden alfabético.

## Lista de funciones

Grupo | Tipo | Función | Descripción
--- | --- | --- | ---
Funciones de almacenamiento cronometrado de datos | Accumulate [Acumular] | Sintaxis: Accumulate(Evento,Valor,Restablecer,Preestablecido) Suma un valor en un intervalo infinito. La función devuelve la integral de un flujo de datos muestreados, cada vez que ocurre el evento especificado. #### Entradas
Parámetro | Descripción
--- | ---
Evento | Especifica el evento en el que se debe leer el valor especificado. Este parámetro tiene que ser una referencia para uno de los siguientes elementos: La palabra clave Capturada que se refiere a la captura de imagen más reciente. Una celda que contiene una función Evento. Una celda que contiene una función Botón. Nota: La función Accumulate [Acumular] introduce en una memoria intermedia el estado de un valor referenciado antes de que dicho valor sea actualizado por cualquier otra función que dependa del evento especificado.
Valor | Una referencia a la celda que contiene el origen del flujo de datos a acumular. (;De -16777216 a 16777216 por defecto = 1.000)
Restablecer | Fuerza al acumulador a restablecerse al valor Preestablecido.
0 = Desactivado (por defecto) | El acumulador continuará sumando indefinidamente el valor especificado.
1 = Activado | El acumulador se restablecerá inmediatamente.
Preestablecido | Especifica el valor mínimo al que se pone el acumulador cuando restablecer está activado (De -16777216 a 16777216; por defecto = 0.000).
#### Salidas
Devuelve | Un valor que representa la suma del flujo de datos a lo largo de un intervalo de tiempo desde el último restablecimiento.
ClockedMax [MáxCronometrado] | Sintaxis: ClockedMax(Evento,Valor,Restablecer,Preestablececido) Muestrea un flujo de valores a lo largo de un intervalo infinito y, a continuación, devuelve el valor máximo del flujo muestreado durante dicho intervalo. ## Entradas
Parámetro | Descripción
--- | ---
Evento | Especifica el evento que fuerza una actualización.Este parámetro tiene que ser una referencia para uno de los siguientes elementos: La palabra clave Capturada que se refiere a la captura de imagen más reciente. Una celda que contiene una función Evento. Una celda que contiene una función Botón. Nota: A diferencia de la función Maximum, que muestrea el estado de un valor referenciado antes de que dicho valor sea actualizado por cualquier otra función que dependa del evento especificado, ClockedMax muestrea el estado del valor referenciado tras la actualización de dicho valor por cualquier otra función.
Valor | Una referencia a la celda de origen del flujo de datos en el que se busca un mínimo. (De -16777216 a 16777216; por defecto = 0).
Restablecer | Fuerza a la función a restablecer su registro interno al valor especificado mediante Preestablecido.
0 = Desactivado (por defecto) | La función continuará con el valor que tenga el muestreo del flujo de datos actual.
1 = Activado | La función restablecerá el valor mínimo definido y empezará a muestrear con un nuevo flujo de datos.
Preestablecido | Especifica el valor mínimo al que se restablece la función (De -16777216 a 16777216; por defecto = -16777216).
#### Salidas
Devuelve | Un valor que representa el mínimo de un flujo de datos en el periodo comprendido desde el restablecimiento hasta el momento actual.
ClockedMin [MínCronometrado] | Sintaxis: ClockedMin(Evento,Valor,Restablecer,Preestablecido) Muestrea un flujo de valores a lo largo de un intervalo infinito y, a continuación, devuelve el valor mínimo del flujo muestreado durante dicho intervalo. #### Entradas
Parámetro | Descripción
--- | ---
Evento | Especifica el evento de actualización en el que se debe leer el valor. Este parámetro tiene que ser una referencia para uno de los siguientes elementos: La palabra clave Capturada que se refiere a la captura de imagen más reciente. Una celda que contiene una función Evento. Una celda que contiene una función Botón. Nota: A diferencia de la función Minimum, que muestrea el estado de un valor referenciado antes de que dicho valor sea actualizado por cualquier otra función que dependa del evento especificado, ClockedMin muestrea el estado del valor referenciado tras la actualización de dicho valor por cualquier otra función.
Valor | Una referencia a la celda de origen del flujo de datos en el que se busca un mínimo (De -16777216 a 16777216; por defecto = 0).
Restablecer | Fuerza a la función a restablecer su registro interno al valor especificado mediante Preestablecido.
0 = Desactivado (por defecto) | La función continuará con el valor que tenga el muestreo del flujo de datos actual.
1 = Activado | La función restablecerá el valor mínimo definido y empezará a muestrear con un nuevo flujo de datos.
Preestablecido | Especifica el valor mínimo al que se restablece la función (De -16777216 a 16777216; por defecto = -16777216).
#### Salidas
Devuelve | Un valor que representa el mínimo de un flujo de datos en el periodo comprendido desde el restablecimiento hasta el momento actual.
ClockedSum [SumaCronometrada] | Sintaxis: ClockedSum(Evento,Valor,Reestablecer,Preestablecido)
Count [Contar] | Sintaxis: Count(Evento,Valor máx.,Restablecer,Preestablecido) Cuenta los eventos en un intervalo infinito. La función devuelve el valor Preestablecido más el número de eventos que se han producido desde el último restablecimiento. #### Entradas
Parámetro | Descripción
--- | ---
Evento | Especifica el evento de actualización que hace que se incremente el contador. Este parámetro tiene que ser una referencia para uno de los siguientes elementos: La palabra clave Capturada que se refiere a la captura de imagen más reciente. Una celda que contiene una función Evento. Una celda que contiene una función Botón.
Valor máx. | Especifica el valor más alto permitido antes de que el contador se reinicie automáticamente al valor mínimo Preestablecido.(De -16777216 a 16777216; por defecto = 16777216)
Restablecer | Fuerza al contador a reiniciarse al valor Preestablecido.
0 = Desactivado (por defecto) | El contador podrá alcanzar el Valor máx. antes de que haga un reinicio.
1 = Activado | El contador se reiniciará inmediatamente aunque no haya alcanzado el Valor máx.
Preestablecido | Especifica el valor mínimo al que se reinicia el contador cuando ha alcanzado el Valor máx. o cuando Restablecer está activado.(De -16777216 a 16777216; por defecto = 0)
#### Salidas
Devuelve | Un valor que es el valor Preestablecido más el número de eventos que se han producido desde el último reinicio.
CountPassFail [ContarPasesFallos] | Sintaxis: CountPassFail(Evento,Valor,ContarCuando SinConexión,EventosReinicio.Manual,EventosReinicio.EnLínea,EventosReinicio.CargaDeTarea) Cuenta y devuelve los pases (aprobados), los fallos (rechazos) y el total de eventos para un determinado valor referenciado. #### Entradas
Parámetro | Descripción
--- | ---
Evento | Especifica el evento que hace que se incremente el contador. Este parámetro tiene que ser una referencia para uno de los siguientes elementos: La palabra clave Capturada que se refiere a la captura de imagen más reciente. Una celda que contiene una función Evento. Una celda que contiene una función Botón.
Valor | Especifica la referencia necesaria a la celda que contiene el origen del flujo de datos a contabilizar. Si no se hace referencia a ninguna celda, la función devolverá un #ERR sea cual sea el resultado. El contador que se irá incrementando (Pase, Fallo o #ERR) se basa en el Valor devuelto de la manera siguiente:
Pase | Valor > 0
Fallo | Valor = 0
#ERR | Valor < 0
Contar cuando sin conexión | Especifica si se incrementarán los contadores mientras el sensor está fuera de línea.
0 = Desactivado | No se incrementarán los contadores cuando el sensor está fuera de línea.
1 = Activado (por defecto) | Se incrementarán los contadores cuando el sensor está fuera de línea.
Eventos reinicio | Fuerza a los contadores a reiniciarse en función de determinados eventos.
Manual | Especifica si se reiniciarán los contadores al producirse el evento especificado. Este parámetro hace automáticamente referencia al botón de reinicio que se inserta en la hoja de cálculo cuando se crea inicialmente la función. Nota: Si se ha activado manualmente esta casilla en la hoja de propiedades, se eliminará la referencia al botón de reinicio. Para utilizar el botón de reinicio, este parámetro debe hacer referencia a la celda que contiene el botón de reinicio.
0 = Desactivado (por defecto) | No reinicie los contadores cuando se produzca el evento especificado.
1 = Activado | Reinicie los contadores cuando se produzca el evento especificado.
En línea | Cuando se pone el sensor En línea, especifica si se reiniciarán los contadores tras ocurrir el primer evento.
0 = Desactivado | Cuando se pone el sensor En línea, no reinicie los contadores tras ocurrir el primer evento.
1 = Activado (por defecto) | Cuando el sensor se pone En línea, reinicie los contadores tras ocurrir el primer evento.
Carga de tarea | Especifica si se pondrán los contadores a cero cuando se cargue una tarea.
0 = Desactivado | No reinicie los contadores cuando se carga una tarea.
1 = Activado (por defecto) | Reinicie los contadores cuando se carga una tarea.
#### Salidas
Devuelve | Una estructura de datos de Count que contiene los contadores incrementados o #ERR si alguno de los parámetros de entrada no es válido.
Resultados | Cuando se inserta inicialmente CountPassFail en una celda, se crean una tabla de resultados y un botón de reinicio en la hoja de cálculo. Cuando se pulse el botón de reinicio, todos los contadores se pondrán a cero.
#### Funciones de Vision Data Access Las siguientes funciones de Vision Data Access se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados..
Pases | GetPassCount(Recuento) | El recuento incremental de pases (aprobados). Se incrementa el contador cuando el Valor devuelto es mayor que cero.
Fallos | GetFailCount(Recuento) | El recuento incremental de fallos. Se incrementa el contador cuando el Valor devuelto es igual a cero.
Errores | GetErrorCount(Recuento) | El recuento incremental de errores. Se incrementa el contador cuando el Valor devuelto es menor que cero.
Total | GetTotalCount(Recuento) | El número total de pases, fallos y errores.
Latch [Retener] | Sintaxis: Latch(Evento,Valor) Almacena (retiene) un valor de entrada al producirse el evento especificado. #### Entradas
Parámetro | Descripción
--- | ---
Evento | Especifica el evento de actualización en el que se debe leer el valor. Este parámetro tiene que ser una referencia para uno de los siguientes elementos: La palabra clave Capturada que se refiere a la captura de imagen más reciente. Una celda que contiene una función Evento. Una celda que contiene una función Botón.
Valor | Una referencia a la celda que contiene los datos a guardar (De -16777216 a 16777216; por defecto = 0.000).
#### Salidas
Devuelve | El valor almacenado en el último evento.
LatchString [RetenerCadena] | Sintaxis: LatchString(Evento,"Cadena") Almacena (retiene) una cadena de entrada alfanumérica en el evento especificado. #### Entradas
Parámetro | Descripción
--- | ---
Evento | Especifica el evento de actualización en el que deberá leerse la cadena. Este parámetro tiene que ser una referencia para uno de los siguientes elementos: La palabra clave Capturada que se refiere a la captura de imagen más reciente. Una celda que contiene una función Evento. Una celda que contiene una función Botón.
Cadena | Una referencia a la celda que contiene la cadena a guardar.
#### Salidas
Devuelve | La cadena guardada en el último evento.
Maximum [Máximo] | Sintaxis: Maximum(Evento,Valor,Restablecer,Preestablecido) Muestrea un flujo de valores a lo largo de un intervalo infinito y, a continuación, devuelve el valor máximo del flujo muestreado durante dicho intervalo. #### Entradas
Parámetro | Descripción
--- | ---
Evento | Especifica el evento de actualización en el que se debe leer el valor. Este parámetro tiene que ser una referencia para uno de los siguientes elementos: La palabra clave Capturada que se refiere a la captura de imagen más reciente. Una celda que contiene una función Evento. Una celda que contiene una función Botón. Nota: Maximum muestrea el estado de un valor referenciado antes de que dicho valor sea actualizado por cualquier otra función que dependa del evento especificado.
Valor | Una referencia a la celda de origen del flujo de datos en el que se busca un máximo.
Restablecer | Fuerza a la función a restablecer su registro interno al valor especificado mediante Preestablecido.
0 = Desactivado (por defecto) | La función continuará con el valor que tenga el muestreo del flujo de datos actual.
1 = Activado | La función restablecerá el valor máximo que devuelve y comenzará con un nuevo flujo de datos a muestrear.
Preestablecido | Especifica el valor máximo al que se restablece la función (De -16777216 a 16777216; por defecto = -16777216).
#### Salidas
Devuelve | Un valor que es el valor máximo encontrado en el flujo de datos desde que se produjo el último restablecimiento.
Minimum [Mínimo] | Sintaxis: Minimum(Evento,Valor,Restablecer,Preestablecido) Muestrea un flujo de valores a lo largo de un intervalo infinito y, a continuación, devuelve el valor mínimo del flujo muestreado durante dicho intervalo. #### Entradas
Parámetro | Descripción
--- | ---
Evento | Especifica el evento de actualización en el que se debe leer el valor. Este parámetro tiene que ser una referencia para uno de los siguientes elementos: La palabra clave Capturada que se refiere a la captura de imagen más reciente. Una celda que contiene una función Evento. Una celda que contiene una función Botón. Nota: Minimum muestrea el estado de un valor referenciado antes de que dicho valor sea actualizado por cualquier otra función que dependa del evento especificado.
Valor | Una referencia a la celda de origen del flujo de datos en el que se busca un mínimo.
Restablecer | Fuerza a la función a restablecer su registro interno al valor especificado mediante Preestablecido.
0 = Desactivado (por defecto) | La función continuará con el valor que tenga el muestreo del flujo de datos actual.
1 = Activado | La función restablecerá el valor mínimo definido y empezará a muestrear con un nuevo flujo de datos.
Preestablecido | Especifica el valor mínimo al que se restablece la función (De -16777216 a 16777216; por defecto = 16777216).
#### Salidas
Devuelve | Un valor que representa el mínimo de un flujo de datos en el periodo comprendido desde el restablecimiento hasta el momento actual.
ShiftRegister [RegistroDeTurno] | Sintaxis: ShiftRegister (Evento,Valor,Número de pasos,Restablecer) Implementa una matriz de registro de turno o un "flujo" de datos en la/el que se almacenan los valores de una celda tras cada evento. Nota: Tras un restablecimiento, se llena el registro de turno con el primer valor que se lee. #### Entradas
Evento | Especifica el evento de actualización en el que se debe leer el valor. Este parámetro tiene que ser una referencia para uno de los siguientes elementos: La palabra clave Capturada que se refiere a la captura de imagen más reciente. Una celda que contiene una función Evento. Una celda que contiene una función Botón. Nota: A diferencia de la función DelayLine que almacena el estado de un valor referenciado antes de que dicho valor sea actualizado por cualquier otra función que dependa del evento especificado, ShiftRegister almacena el estado del valor referenciado tras la actualización de dicho valor por cualquier otra función.
Valor | Una referencia a la celda que contiene los datos de origen (De -16777216 a 16777216; por defecto = 0).
Número de pasos | Especifica el número de valores en la matriz interna de registro de turno de la función (de 1 a 5000; por defecto = 10).
Restablecer | Obliga a la función a purgarse de los valores leídos anteriormente. El primer valor leído tras el restablecimiento "llenará" eficazmente el registro de turno.
0 = Desactivado (por defecto) | La función continuará registrando valores en el flujo de datos.
1 = Activado | La función purgará todos los valores del flujo de datos.
#### Salidas
Devuelve | Una estructura de datos de Buffer que contiene estadísticas sobre el valor especificado en el periodo comprendido desde el restablecimiento hasta el momento actual.
Resultados | Cuando se inserta inicialmente la función en una celda, se crea una tabla de resultados en la hoja de cálculo.
#### Funciones de Vision Data Access Las siguientes funciones de Vision Data Access se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados.
Last [Último] | GetValue(Retardo, Índice) | El último valor contenido en la estructura.
Media | GetMean(Retardo) | El promedio de todos los valores en la estructura.
SDev | GetSDev(Retardo) | La desviación estándar de todos los valores en la estructura.
Min | GetMin(Retardo) | El valor más pequeño contenido en la estructura.
Max | GetMax(Retardo) | El valor máximo contenido en la estructura.
Se puede acceder a elementos adicionales de datos mediante las siguientes funciones de Vision Data Access:
Count [Contar/Recuento] | GetCount(Retardo) | El número de valores que contiene la estructura.
Sum [Suma] | GetSum(Retardo) | La suma de todos los valores contenidos en la estructura.
Geometría | Funciones de ajuste/aproximación Nota: Si una función de Geometría utiliza datos de coordenadas mundo como referencia, los gráficos resultantes no se visualizarán correctamente. | CircleFromNPoints [CírculoApartirNPuntos] | Sintaxis: CircleFromNPoints(Punto X 0,Punto Y 0,Punto X 1,Punto Y 1,Punto X 2,Punto Y 2,...,Punto X N,Punto Y N,Mostrar) Aproxima a un círculo utilizando tres o más puntos de entrada. #### Entradas
Parámetro | Descripción
--- | ---
Punto 0 | Especifica las coordenadas del primer punto.
Punto X 0 | La coordenada X del primer punto.
Punto Y 0 | La coordenada Y del primer punto.
Punto1 | Especifica las coordenadas del segundo punto.
Punto X 1 | La coordenada X del segundo punto.
Punto Y 1 | La coordenada Y del segundo punto.
Punto 2 | Especifica las coordenadas del tercer punto.
Punto X 2 | La coordenada X del tercer punto.
Punto Y 2 | La coordenada Y del tercer punto.
Punto 3..N | Opcionalmente, especifica las coordenadas de los puntos adicionales que se quieran incluir.
Punto X N | La coordenada X del punto enésimo.
Punto Y N | La coordenada Y del punto enésimo.
Mostrar | Especifica los elementos gráficos a visualizar de modo permanente.
0 = ocultar todo | Todos los elementos gráficos estarán ocultos excepto cuando la celda que contiene la función CircleFromNPoints es la celda activa en la hoja de cálculo.
1 = solo gráficos de resultados | El gráfico del círculo aproximado se visualizará en todo momento. Los puntos de entrada se mostrarán únicamente cuando la celda que contiene la función CircleFromNPoints es la celda activa de la hoja de cálculo.
2 = gráficos de entrada y resultado | El círculo aproximado y los puntos de entrada se visualizarán en todo momento.
#### Salidas
Devuelve | Una estructura de datos de CircleFit (EncuadreDeCírculo) que contiene las coordenadas X e Y, el radio y el valor sigma del círculo aproximado.
Resultados | Cuando se inserta inicialmente la función en una celda, se crea una tabla de resultados en la hoja de cálculo.
#### Funciones de Vision Data Access Las siguientes funciones de Vision Data Access se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados.
X | GetX(CircleFit) | La coordenada X del centro del círculo.
Y | GetY(CircleFit) | La coordenada Y del centro del círculo.
Radius | GetRadius(CircleFit) | El radio del círculo.
Sigma | GetSigma(CircleFit) | La raíz cuadrada de la suma de los cuadrados de las distancias de los puntos al círculo dividida por el número de puntos.
Se puede acceder a elementos adicionales de datos mediante las siguientes funciones de Vision Data Access:
Distance | GetDistance(CircleFit, Índice) | La distancia entre el punto indexado y el círculo. Si el valor es negativo, el punto está dentro del círculo. Si el punto indexado no es válido, se devuelve un #ERR.
MaxDist | GetMaxDist(CircleFit) | La distancia entre el círculo y el punto más alejado del círculo. Si el valor es negativo, el punto está dentro del círculo.
MaxDistIndex | GetMaxDistIndex(CircleFit) | El índice del punto más alejado del círculo.
NPointsUsed | GetNPointsUsed(CircleFit) | El número de puntos utilizados para aproximar al círculo.
LineFromNPoints [LíneaApartirNPuntos] | Sintaxis: LineFromNPoints(Punto X 0,Punto Y 0,Punto X 1,Punto Y 1,[...Punto X N,Punto Y N,Mostrar]) Aproxima a una línea utilizando dos o más puntos de entrada. #### Entradas
Parámetro | Descripción
--- | ---
Punto 0 | Especifica las coordenadas del primer punto.
Punto X 0 | La coordenada X del primer punto.
Punto Y 0 | La coordenada Y del primer punto.
Punto1 | Especifica las coordenadas del segundo punto.
Punto X 1 | La coordenada X del segundo punto.
Punto Y 1 | La coordenada Y del segundo punto.
Punto 2..N | Especifica las coordenadas de los puntos adicionales que se quieran incluir.
Punto X N | La coordenada X del punto enésimo.
Punto Y N | La coordenada Y del punto enésimo.
Mostrar | Especifica los elementos gráficos a visualizar de modo permanente.
0 = ocultar todo | Todos los elementos gráficos estarán ocultos excepto cuando la celda que contiene la función LineFromNPoints es la celda activa en la hoja de cálculo.
1 = solo gráficos de resultados | El gráfico de la línea aproximada se visualizará en todo momento. Los puntos de entrada se visualizarán únicamente cuando la celda que contiene la función LineFromNPoints es la celda activa de la hoja de cálculo.
2 = gráficos de entrada y resultado | La línea aproximada y los puntos de entrada se visualizarán en todo momento.
#### Salidas
Devuelve | Una estructura de datos de LineFit (EncuadreDeLínea) si los datos incluyen dos o más puntos válidos o #ERR si no hay ningún punto o solo un punto válido.
Resultados | Cuando se inserta inicialmente la función en una celda, se crea una tabla de resultados en la hoja de cálculo.
#### Funciones de Vision Data Access Las siguientes funciones de Vision Data Access se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados.
X0 | GetX(LineFit, 0) | La coordenada X del primer extremo.
Y0 | GetY(LineFit, 0) | La coordenada Y del primer extremo.
X1 | GetX(LineFit, 1) | La coordenada X del segundo extremo.
Y1 | GetY(LineFit, 1) | La coordenada Y del segundo extremo.
Chi2 (Ji cuadrado) | GetChi2(LineFit) | La suma de los cuadrados de las distancias de los puntos a la línea.
Se puede acceder a elementos adicionales de datos mediante las siguientes funciones de acceso a datos de visión.
Distance | GetDistance(LineFit, Índice) | La distancia entre el punto indexado y la línea.
MaxDist | GetMaxDist(LineFit) | El punto más alejado de la línea.
MaxDistIndex | GetMaxDistIndex(LineFit) | El índice del punto más alejado de la línea.
NPointsUsed | GetNPointsUsed(LineFit) | El número de puntos utilizados para calcular la línea.
Medición | PointToCircle [PuntoACirculo] | Sintaxis: PointToCircle(Punto.X,Punto.Y,Círculo.X,Círculo.Y,Círculo.Radio,Mostrar) Calcula la distancia mínima que hay desde un punto hasta el punto más cercano en un círculo. Si el punto está dentro del círculo, la distancia se notifica como número negativo. #### Entradas
Parámetro | Descripción
--- | ---
Punto | Especifica las coordenadas del punto que se utilizará como origen.
X | La coordenada X del punto.
Y | La coordenada Y del punto.
Círculo | Especifica las coordenadas Y el tamaño del círculo.
X | La coordenada X del centro del círculo.
Y | La coordenada Y del centro del círculo.
Radius | El radio del círculo.
Mostrar | Especifica el modo de visualización de las superposiciones gráficas de la función sobre la imagen.
0 = ocultar todo | Se ocultarán todos los gráficos, excepto cuando la celda que contiene la función está resaltada en la hoja de cálculo.
1 = solo gráficos de resultados | Se visualizará en todo momento el segmento de línea correspondiente a la distancia mínima entre el punto y el círculo.
2 = gráficos de entrada y resultado | Se visualizará en todo momento el punto y el círculo y el segmento de línea entre ellos.
#### Salidas
Devuelve | Una estructura de datos de Dist que contiene la distancia orientada entre el punto y el punto más cercano en el círculo.
Resultados | Cuando se inserta inicialmente la función en una celda, se crea una tabla de resultados en la hoja de cálculo.
#### Funciones de Vision Data Access Las siguientes funciones de Vision Data Access se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados.
X0 | GetX(Dist, 0) | La coordenada X del punto.
Y0 | GetY(Dist, 0) | La coordenada Y del punto.
X1 | GetX(Dist, 1) | La coordenada X del punto más cercano del círculo.
Y1 | GetY(Dist, 1) | La coordenada Y del punto más cercano del círculo.
Angle [Ángulo] | GetAngle(Dist) | El ángulo punto a punto.
Distance | GetDistance(Dist) | La distancia punto a punto.
PointToLine [PuntoALinea] | Sintaxis: PointToLine(Punto.X,Punto.Y,Línea.X 0,Línea.Y 0,Línea.X 1,Línea.Y 1,Mostrar) Calcula la distancia mínima desde un punto a una línea. En este ejemplo, la función PointToLine mide la distancia entre un punto y una línea. El punto es el origen y el ángulo se calcula en función de su posición respecto a la línea. #### Entradas
Parámetro | Descripción
--- | ---
Punto | Especifica las coordenadas del punto que se utilizará como origen.
X | La coordenada X del punto.
Y | La coordenada Y del punto.
Línea | Especifica las coordenadas de la línea.
X 0 | La coordenada X del primer extremo de la línea.
Y 0 | La coordenada Y del primer extremo de la línea.
X 1 | La coordenada X del segundo extremo de la línea.
Y 1 | La coordenada Y del segundo extremo de la línea.
Mostrar | Especifica el modo de visualización de las superposiciones gráficas de la función sobre la imagen.
0 = ocultar todo | Se ocultarán todos los gráficos, excepto cuando la celda que contiene la función está resaltada en la hoja de cálculo.
1 = solo gráficos de resultados | Se visualizará en todo momento el segmento de línea correspondiente a la distancia mínima entre el punto y la línea de entrada.
2 = gráficos de entrada y resultado | Se visualizarán en todo momento el punto, la línea de entrada y el segmento de línea entre ellos.
#### Salidas
Devuelve | Una estructura de datos de Dist que contiene la distancia orientada entre el punto y el punto más cercano de la línea.
Resultados | Cuando se inserta inicialmente la función en una celda, se crea una tabla de resultados en la hoja de cálculo.
#### Funciones de Vision Data Access Las siguientes funciones de Vision Data Access se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados.
X0 | GetX(Dist, 0) | La coordenada X del punto.
Y0 | GetY(Dist, 0) | La coordenada Y del punto.
X1 | GetX(Dist, 1) | La coordenada X del punto más cercano de la línea.
Y1 | GetY(Dist, 1) | La coordenada Y del punto más cercano de la línea.
Angle [Ángulo] | GetAngle(Dist) | El ángulo punto a línea.
Distance | GetDistance(Dist) | La distancia punto a línea.
PointToPoint [PuntoAPunto] | Sintaxis: PointToPoint(Punto 0.X,Punto 0.Y,Punto 1.X,Punto 1.Y,Mostrar) Calcula la distancia orientada entre dos puntos. En este ejemplo, la función PointToPoint mide la distancia entre dos puntos. El ángulo se calcula en función de la posición del primer punto con respecto al segundo. #### Entradas
Parámetro | Descripción
--- | ---
Punto 0 | Especifica las coordenadas del primer punto que será el punto que se utilizará como origen.
X | La coordenada X del primer punto.
Y | La coordenada Y del primer punto.
Punto1 | Especifica las coordenadas del segundo punto.
X | La coordenada X del segundo punto.
Y | La coordenada Y del segundo punto.
Mostrar | Especifica el modo de visualización de las superposiciones gráficas de la función sobre la imagen.
0 = ocultar todo | Se ocultarán todos los gráficos, excepto cuando la celda que contiene la función está resaltada en la hoja de cálculo.
1 = solo gráficos de resultados | Se visualizará en todo momento el segmento de línea correspondiente a la distancia mínima entre los dos puntos de entrada.
2 = gráficos de entrada y resultado | Se visualizarán en todo momento los dos puntos de entrada y el segmento de línea entre ellos.
#### Salidas
Devuelve | Una estructura de datos de Dist que contiene la distancia orientada entre los puntos.
Resultados | Cuando se inserta inicialmente la función en una celda, se crea una tabla de resultados en la hoja de cálculo.
#### Funciones de Vision Data Access Las siguientes funciones de Vision Data Access se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados.
X0 | GetX(Dist, 0) | La coordenada X del primer punto.
Y0 | GetY(Dist, 0) | La coordenada Y del primer punto.
X1 | GetX(Dist, 1) | La coordenada X del segundo punto.
Y1 | GetY(Dist, 1) | La coordenada Y del segundo punto.
Angle [Ángulo] | GetAngle(Dist) | El ángulo punto a punto.
Distance | GetDistance(Dist) | La distancia punto a punto.
PointToPointAngle [AnguloPuntoAPunto] | Sintaxis: PointToPointAngle(Punto 0.X,Punto 0.Y,Punto 1.X,Punto 1.Y) Calcula el ángulo entre dos puntos. #### Entradas
Parámetro | Descripción
--- | ---
Punto 0 | Especifica las coordenadas del primer punto que será el punto que se utilizará como origen.
X | La coordenada X del primer punto.
Y | La coordenada Y del primer punto.
Punto1 | Especifica las coordenadas del segundo punto.
X | La coordenada X del segundo punto.
Y | La coordenada Y del segundo punto.
#### Salidas
Devuelve | Un valor que contiene el ángulo entre los dos puntos con respecto al eje X de la imagen.
Nota: A diferencia de la mayoría de las otras funciones de medición incluidas en la categoría Geometría, la función PointToPointAngle no inserta una estructura de datos Dist ni una tabla de resultados en la hoja de cálculo.
PointToPointDistance [DistanciaPuntoAPunto] | Sintaxis: PointToPointDistance(Punto 0.X,Punto 0.Y,Punto 1.X,Punto 1.Y) Calcula la distancia entre dos puntos. #### Entradas
Parámetro | Descripción
--- | ---
Punto 0 | Especifica las coordenadas del primer punto.
X | La coordenada X del primer punto.
Y | La coordenada Y del primer punto.
Punto1 | Especifica las coordenadas del segundo punto.
X | La coordenada X del segundo punto.
Y | La coordenada Y del segundo punto.
#### Salidas
Devuelve | Un valor que contiene la distancia entre los dos puntos.
Nota: A diferencia de la mayoría de las funciones de medición de la categoría Geometría, la función PointToPointDistance no inserta una estructura de datos de Dist ni una tabla de resultados en la hoja de cálculo.
Gráficos | Control Nota: Asegúrese de utilizar la palabra clave "Capturada" para indicar imagen actual. | Button [Botón] | Sintaxis: Button(Nombre,Disparador) Inserta un control de botón etiquetado en la hoja de cálculo. Opcionalmente, se puede configurar la pulsación de un botón para que esta señale la activación de un evento de hoja de cálculo. Sugerencia: Para acceder a la hoja de propiedades de un botón, haga clic con el botón derecho del ratón sobre el botón en cuestión y seleccione Editar función. Nota: El control de un botón se puede controlar mediante programación utilizando los comandos del modo nativo de In-Sight, en particular, el comando SetCellValue de EV. Introduzca un 1 para pulsar el botón y un 0 para soltarlo. Asegúrese de que se ha enviado la orden de soltar el botón tras pulsarlo, ya que de lo contrario el botón permanecería como si estuviera pulsado. Un clic de botón genera dos eventos. El estado del botón cambia de 0 a 1 cuando se presiona el botón y luego de 1 a 0 cuando se suelta el botón. Si un botón está configurado para generar un evento de programación, el evento se activará solo una vez mediante pulsación del botón. #### Entradas
Parámetro | Descripción
--- | ---
Name | Especifica una etiqueta de cadena de texto; este nombre aparecerá en el propio botón.
Trigger | Opcionalmente, especifica una señal de activación que se producirá al pulsar el botón.
-1 = ninguno (por defecto) | No se emitirá ninguna señal de activación.
32 = manual | Se emitirá manualmente una señal de activación.
(80 a 87) = de programación [Soft] (0 a 7) | Se emitirá una señal de activación de un evento de programación.
#### Salidas
Devuelve | El valor 1 cuando se pulsa el botón; en caso contrario, el valor devuelto es 0.
Resultados | Un control de botón etiquetado.
Checkbox [Casilla] | Sintaxis: Checkbox(Nombre) Inserta un control etiquetado de casilla de verificación en la hoja de cálculo. Nota: Para acceder a la hoja de propiedades de una casilla, haga clic con el botón derecho del ratón sobre la casilla y seleccione Editar función. #### Entradas
Parámetro | Descripción
--- | ---
Name | Especifica una etiqueta de cadena de texto a visualizar junto a la casilla.
#### Salidas
Devuelve | El valor 0 cuando está libre (sin marcar) y el valor 1 cuando está seleccionada (marcada).
Resultados | Un control de casilla etiquetada.
#### Ejemplo Se ha configurado una hoja de cálculo de la manera siguiente: A3=CheckBox("On") A4=A3 La celda A4 hace referencia a la celda A3 para determinar el estado de activación/desactivación de la casilla "Activa". Cuando la casilla no está seleccionada, se devuelve el valor 0.000 en la celda A4. Cuando la casilla está seleccionada, se devuelve el valor 1.000.
EditFloat [EditarFlotante] | Sintaxis: EditFloat(Mín,Máx) Inserta un control de edición de punto flotante en la hoja de cálculo. Este control se comporta como otros controles interactivos de entrada numérica. Nota: Para acceder a la hoja de propiedades de un control para EditFloat, haga clic con el botón derecho del ratón sobre el control y seleccione Editar función. #### Entradas
Parámetro | Descripción
--- | ---
Mín. | Especifica el valor mínimo que aceptará el control de cuadro de edición (De -16777216 a 16777216; por defecto = 0).
Máx. | Especifica el valor máximo que aceptará el control de cuadro de edición (De -16777216 a 16777216; por defecto = 100).
#### Salidas
Devuelve | El valor introducido en el control.
Resultados | Un control para EditFloat .
EditInt [EditarEntero] | Sintaxis: EditInt(Mín,Máx) Inserta un control de edición de enteros en la hoja de cálculo. Este control funciona como todos los demás controles interactivos de entrada numérica que tiene el sistema In-Sight. Nota: Para acceder a la hoja de propiedades de un control para EditInt, haga clic con el botón derecho del ratón sobre el control y seleccione Editar función. #### Entradas
Parámetro | Descripción
--- | ---
Mín. | Especifica el valor mínimo que aceptará el control de cuadro de edición (De -16777216 a 16777216; por defecto = 0).
Máx. | Especifica el valor máximo que aceptará el control de cuadro de edición (De -16777216 a 16777216; por defecto = 255).
#### Salidas
Devuelve | El valor introducido en el control.
Resultados | Un control para EditInt .
EditString [EditarCadena] | Sintaxis: EditString(Longitud máx. de la cadena) Inserta un control de edición de enteros en la hoja de cálculo. Este control funciona como todos los demás controles interactivos de entrada numérica que tiene el sistema In-Sight. Nota: Para acceder a la hoja de propiedades de un control para EditInt, haga clic con el botón derecho del ratón sobre el control y seleccione Editar función. #### Entradas
Parámetro | Descripción
--- | ---
Mín. | Especifica el valor mínimo que aceptará el control de cuadro de edición (De -16777216 a 16777216; por defecto = 0).
Máx. | Especifica el valor máximo que aceptará el control de cuadro de edición (De -16777216 a 16777216; por defecto = 255).
#### Salidas
Devuelve | El valor introducido en el control.
Resultados | Un control para EditInt .
ListBox [CuadroDeLista] | Sintaxis: ListBox("Cadena0","Cadena1","Cadena2",...) Inserta un control de lista desplegable en la hoja de cálculo. Nota: Debido a que la función ListBox puede aceptar un número variable de cadenas, no se puede configurar esta función mediante una hoja de propiedades. Esta función puede se configurar directamente en la celda o en la barra de fórmulas que presenta la barra de herramientas de edición de tareas. #### Entradas
Parámetro | Descripción
--- | ---
Cadena0, 1, 2, ... | Una lista de longitud variable de distintas cadenas de texto, cada una de las cuales devuelve un valor diferente cuando el usuario las selecciona en una lista desplegable.
#### Salidas
Devuelve | Un valor que representa el número de índice (de base cero) del elemento seleccionado.
Resultados | Un control para ListBox . Nota: También se puede utilizar la función GetString de Vision Data Access para acceder a la cadena de texto seleccionada actualmente en la lista.
#### Ejemplo Se ha configurado una hoja de cálculo de la manera siguiente: A3=ListBox("Elemento1","Elemento2","Elemento3") A4=A3 La función en la celda A3 crea el control de lista, con "Elemento1" como selección predeterminada. El valor del índice de Elemento1 es 0, por lo que el valor en la celda A4 será 0.000. Si el usuario selecciona "Elemento2", entonces el valor en la celda A4 será 1.000. Si selecciona "Elemento3", el valor en la celda A4 será 2.000. #### Funciones de Vision Data Access Se puede acceder a elementos adicionales de datos mediante las siguientes funciones de Vision Data Access:
GetString | GetString(ListBox) | Devuelve la cadena de texto.
Imagen Nota: Asegúrese de utilizar la palabra clave "Capturada" para indicar imagen actual. | PlotCircle [TrazarCírculo] | Sintaxis: PlotCircle(Círculo.X,Círculo.Y,Círculo.Radio,Nombre,Color,Mostrar) Traza un círculo en la imagen. #### Entradas
Parámetro | Descripción
--- | ---
Circle [Círculo] | Especifica las coordenadas de imagen del círculo a trazar (De -16777216 a 16777216).
X | La coordenada X del centro del círculo.
Y | La coordenada Y del centro del círculo.
Radius | El radio del círculo.
Name | Especifica una etiqueta de texto a visualizar con el gráfico en la imagen.
Color | Especifica el color del trazado del gráfico. (Por defecto: 0x32cd32, verde lima; Máx.: 0xffffff)
Mostrar | Especifica el modo de visualización de la superposición gráfica en la imagen.
0 = Desactivado | El gráfico estará oculto, excepto cuando la celda que contiene la función está resaltada en la hoja de cálculo.
1 = Activado (por defecto) | Se visualizará el gráfico en todo momento.
#### Salidas
Devuelve | Una estructura de datos de trazado que contiene el gráfico.
PlotCross [TrazarCruz] | Sintaxis: PlotCro(Cruz.X,Cruz.Y,Cruz.Ángulo,Cruz.Alto,Cruz.Ancho,Nombre,Color,Mostrar) Traza una cruz sobre la imagen. #### Entradas
Parámetro | Descripción
--- | ---
Cross [Cruz] | Especifica las coordenadas de imagen de la cruz a trazar (De -16777216 a 16777216).
X | La coordenada X del centro de la cruz.
Y | La coordenada Y del centro de la cruz.
Angle [Ángulo] | La orientación de la cruz.
Alto | La altura de la cruz.
Ancho | La anchura de la cruz.
Name | Especifica una etiqueta de texto a visualizar con el gráfico en la imagen.
Color | Especifica el color del trazado del gráfico. (Por defecto: 0x32cd32, verde lima; Máx.: 0xffffff)
Mostrar | Especifica el modo de visualización de la superposición gráfica en la imagen.
0 = Desactivado | El gráfico estará oculto, excepto cuando la celda que contiene la función está resaltada en la hoja de cálculo.
1 = Activado (por defecto) | Se visualizará el gráfico en todo momento.
#### Salidas
Devuelve | Una estructura de datos de trazado que contiene el gráfico.
PlotLine | Sintaxis: PlotLine(Línea.X 0,Línea.Y 0,Línea.X 1,Línea.Y 1,Nombre,Color,Mostrar,Adorno punto inicial,Adorno punto final) Traza un segmento de línea en la imagen. #### Entradas
Parámetro | Descripción
--- | ---
Línea | Especifica las coordenadas de imagen de la línea a trazar ().
X 0 | La coordenada X del primer extremo de la línea.
Y 0 | La coordenada Y del primer extremo de la línea.
X 1 | La coordenada X del segundo extremo de la línea.
Y 1 | La coordenada Y del segundo extremo de la línea.
Name | Especifica una etiqueta de texto a visualizar con el gráfico en la imagen.
Color | Especifica el color del trazado del gráfico. (Por defecto: 0x32cd32, verde lima; Máx.: 0xffffff)
Mostrar | Especifica el modo de visualización de la superposición gráfica en la imagen.
0 = Desactivado | El gráfico estará oculto, excepto cuando la celda que contiene la función está resaltada en la hoja de cálculo.
1 = Activado (por defecto) | Se visualizará el gráfico en todo momento.
Adorno punto inicial | Especifica el adorno para el punto inicial de la línea.
0 = Ninguno (por defecto)
1 = Punta de flecha
Adorno punto final | Especifica el adorno para el punto final de la línea.
0 = Ninguno (por defecto)
1 = Punta de flecha
#### Salidas
Devuelve | Una estructura de datos de trazado que contiene el gráfico.
PlotPoint | Sintaxis: PlotPoint(Punto.X,Punto.Y,Nombre,Color,Mostrar) Traza un punto de mira en la imagen. #### Entradas
Parámetro | Descripción
--- | ---
Punto | Especifica las coordenadas de imagen del punto a trazar (De -16777216 a 16777216).
X | La coordenada X del punto.
Y | La coordenada Y del punto.
Name | Especifica una etiqueta de texto a visualizar con el gráfico en la imagen.
Color | Especifica el color del trazado del gráfico. (Por defecto: 0x32cd32, verde lima; Máx.: 0xffffff)
Mostrar | Especifica el modo de visualización de la superposición gráfica en la imagen.
0 = Desactivado | El gráfico estará oculto, excepto cuando la celda que contiene la función está resaltada en la hoja de cálculo.
1 = Activado (por defecto) | Se visualizará el gráfico en todo momento.
#### Salidas
Devuelve | Una estructura de datos de trazado que contiene el gráfico.
PlotString | Sintaxis: PlotString(Cadena,Punto.X,Punto.Y,Color,Mostrar) Traza una cadena de texto sobre la imagen. Sugerencia: Tras insertar la función PlotString en la hoja de cálculo, resalte la celda de la hoja de cálculo que contiene la función y utilice el cuadro de diálogo Formato de celdas para dar formato mediante fuente, tamaño de fuente y estilo de fuente a la celda de PlotString y a la cadena de texto trazada. #### Entradas
Parámetro | Descripción
--- | ---
Cadena | Especifica la cadena de texto a trazar.
Punto | Especifica las coordenadas de imagen de la cadena a trazar (De -16777216 a 16777216).
X | La coordenada X de la cadena.
Y | La coordenada Y de la cadena.
Color | Especifica el color del trazado del gráfico. (Por defecto: 0x32cd32, verde lima; Máx.: 0xffffff)
Mostrar | Especifica el modo de visualización de la superposición gráfica en la imagen.
0 = Desactivado | El gráfico estará oculto, excepto cuando la celda que contiene la función está resaltada en la hoja de cálculo.
1 = Activado (por defecto) | Se visualizará el gráfico en todo momento.
#### Salidas
Devuelve | Una estructura de datos de trazado que contiene el gráfico.
Matemáticas | Operador lógico | And | Sintaxis: And(Valor1, Valor2, ...) Devuelve el AND lógico de una lista de valores de longitud variable.
BitAnd | BitAnd(Valor1, Valor2, ...) Devuelve el resultado de aplicar la operación AND a nivel de bits a los valores. Nota: Solo procesa los 16 bits inferiores. Ejemplos BitAnd(45, 77) devuelve 13. 45 = 0000 0000 0010 1101 en binario. 77 = 0000 0000 0100 1101 en binario. Al comparar individualmente cada bit común de estos dos números binarios de 16 bits utilizando la operación AND, se obtiene 0000 0000 0000 1101, que = 13 en decimal.
BitNot | Sintaxis: BitNot(Valor) Devuelve el valor inverso a nivel de bits. Nota: Solo procesa los 16 bits inferiores. Ejemplos BitNot(45) devuelve 65490. 45 = 0000 0000 0010 1101 en binario. Al convertir cada 0 en un 1 y cada 1 en un 0 se obtiene 1111 1111 1101 0010 en binario, que es 65490 en decimal.
BitOr | Sintaxis: BitOr(Valor1, Valor2, ...) Devuelve el resultado de aplicar la operación OR a nivel de bits a los valores. Nota: Solo procesa los 16 bits inferiores. Ejemplos BitOr(45, 77) devuelve 109. 45 = 0000 0000 0010 1101 en binario. 77 = 0000 0000 0100 1101 en binario. Al comparar individualmente cada bit común en estos dos números binarios de 16 bits utilizando la operación OR, se obtiene 0000 0000 0110 1101, que = 109 en decimal.
BitXor | Sintaxis: BitXor(Valor1, Valor2, ...) Devuelve el resultado de aplicar la operación XOR (OR exclusivo) a nivel de bits a los valores. (XOR lógico el resultado es VERDADERO si uno y solo uno de los bits es VERDADERO. El resultado es FALSO si 2 o más bits son iguales). Nota: Solo procesa los 16 bits inferiores. Ejemplos BitXor(45, 77) devuelve 96. 45 = 0000 0000 0010 1101 en binario 77 = 0000 0000 0100 1101 en binario. 0110 0000 son los únicos bits no comunes entre 45 y 77, como se demuestra a continuación.
45 | 77 | XOR por bit | Bit XOR
--- | --- | --- | ---
0 | 0 | dos 0 ≥ XOR FALSE | 0 (FALSO)
0 | 1 | solo un 1 ≥ XOR VERDADERO | 1 (VERDADERO)
1 | 0 | solo un 1 ≥ XOR VERDADERO | 1 (VERDADERO)
0 | 0 | dos 0 ≥ XOR FALSE | 0 (FALSO)
1 | 1 | dos 1 ≥ XOR FALSO | 0 (FALSO)
1 | 1 | dos 1 ≥ XOR FALSO | 0 (FALSO)
0 | 0 | dos 0 ≥ XOR FALSE | 0 (FALSO)
1 | 1 | dos 0≥ XOR FALSO | 0 (FALSO)
0110 0000 = 96 en decimal.
If | Sintaxis: If(Cond, Valor1, Valor2) Devuelve el Valor1 si Cond es distinto de cero; en caso contrario, devuelve el Valor2. Nota: Si la condición o los argumentos hacen referencia a celdas vacías, se interpretan como cero (FALSO).
InRange | Sintaxis: InRange(Valor, Inicio, Final) Devuelve VERDADERO si Min(Inicio,Final) ≤ Valor ≤ Max(Inicio,Final).
InTolerance | Sintaxis: InTolerance(real, esperado, tolerancia %, margen) Determina si el valor real se encuentra dentro de los márgenes de tolerancia relativos a un valor esperado, y si la diferencia entre ambos valores es mayor que el margen.
Not | Sintaxis: Not(Valor) Devuelve 0 si el valor es distinto de cero o 1 si el valor es 0. (Lógica inversa) Ejemplos Not(-12345) devuelve 0. Not(3.14) devuelve 0. Not(2-1) devuelve 0. Not(1-1) devuelve 1.
OneShot | Sintaxis: OneShot(Val) Devuelve verdadero si Val es 1 en esta ejecución y era 0 en la ejecución anterior.
Or | Sintaxis: Or(Valor1, Valor2, ...) Devuelve 0 si todos los valores son cero; en caso contrario, devuelve 1. (OR lógico el resultado es VERDADERO si alguno de los valores es VERDADERO). Ejemplos Or(45, -77) devuelve 1. Or(-1, 0, 1) devuelve 1. Or(0, 1-1) devuelve 0.
Búsqueda Nota: Para los argumentos de función que requieren una cadena de texto, no se puede proporcionar la cadena directamente a través de If, Switch o Choose. Un ejemplo de cadena de texto no válida:, Len(If(...)) Una solución a este problema es colocar If, Switch o Choose en una celda separada y crear una referencia a dicha celda. Otra solución es cambiar el orden sintáctico: se puede introducir "If(Len( ) )" en una celda, obteniéndose así una cadena de texto válida. | Choose [Elegir] | Sintaxis: Choose(Índice, Valor0, [Valor1, ...]) Devuelve el valor del argumento indexado de una lista de longitud variable.
CountError [ContarErrores] | Sintaxis: CountError(Celda1, [Celda2, ...]) Devuelve el número de errores en una o varias celdas o intervalos de celdas.
ErrFree [SinError] | Sintaxis: ErrFree(Celda o intervalo de celdas) Convierte #ERR en celdas vacías a fin de suprimir la propagación de errores.
If | Sintaxis: If(Cond, Valor1, Valor2) Devuelve el Valor1 si Prueba es distinto de cero; devuelve el Valor2 si Prueba es cero.
MaxI | Sintaxis: MaxI(Valor0, [Valor1, ...]) Devuelve el índice del valor máximo de una lista de longitud variable de valores.
MinI | Sintaxis: MinI(Valor0, [Valor1, ...]) Devuelve el índice del valor mínimo de una lista de longitud variable de valores.
NthMaxI | Sintaxis: NthMaxI(N, Valor0, [Valor1, ...]) Devuelve el índice del enésimo valor más grande de una lista de longitud variable de valores.
NthMinI | Sintaxis: NthMinI(N, Valor0, [Valor1, ...]) Devuelve el índice del enésimo valor más pequeño de una lista de longitud variable de valores.
Switch [Cambiar] | Sintaxis: Switch(CasoABuscar, Predeterminado, Caso0, Valor0, [Caso1, Valor1, ...]) Devuelve el valor correspondiente al primer caso que coincida con CasoABuscar. Si el caso indexado es FALSO, devuelve el valor Predeterminado que se ha especificado. Si la fórmula contiene más de un caso que coincide con CasoABuscar, devuelve el valor correspondiente al primer caso coincidente. Ejemplo con Switch A4 = Switch(A2,-1,2, "C",3, "B",A3, "A") Si la celda A2=2, el valor devuelto en la celda A4 será C. Si la celda A2=3, el valor devuelto en la celda A4 será B. Si la celda A2=5, el valor devuelto a la celda A4 será el predeterminado, -1, porque no hay ningún Caso en la fórmula que coincida con el CasoABuscar.
X | Sintaxis: X(Celda) Devuelve el número de coordenadas X de una celda de la hoja de cálculo.
Y | Sintaxis: Y(Celda) Devuelve el número de coordenadas Y de una celda de la hoja de cálculo. Nota: Y A = 0.0 e Y Z = 25.0
Aritmética | Abs | Sintaxis: Abs(Valor) Devuelve el valor absoluto de Valor.
Exp | Sintaxis: Exp(Valor) Devuelve e elevado a la potencia indicada por Valor.
Mod | Sintaxis: Mod(Valor1, Valor2) Devuelve el resto de la división de Valor1 por Valor2.
Power [Potencia] | Sintaxis: Power(Base, Exp) Devuelve Base elevada a la potencia indicada por Exp.
Rand [Aleatorio] | Sintaxis: Rand(Evento) Devuelve un número aleatorio (0.0 a 1.0) al producirse el Evento de entrada. Cada nuevo evento ocasiona un nuevo número aleatorio. Nota: Rand debe ser el único elemento en la celda.
Round [Redondear] | Sintaxis: Round(Valor) Devuelve el Valor redondeado al número entero más cercano.
RoundDown [RedondearAMenos] | Sintaxis: RoundDown(Valor) Devuelve el Valor truncado al entero inferior más próximo.
RoundUp [RedondearAMás] | Sintaxis: RoundUp(Valor) Devuelve el Valor redondeado al entero superior más próximo.
Sqrt [Raíz] | Sintaxis: Sqrt(Valor) Devuelve la raíz cuadrada de Valor.
Sum [Suma] | Sintaxis: Sum(Valor1, [Valor2, ...]) Devuelve la suma de los valores indicados en la lista de longitud variable.
Trunc [Truncar] | Sintaxis: Trunc(Valor) Devuelve el Valor truncado a un entero (hacia cero). El resultado es el Valor sin la parte fraccionaria.
Operadores Nota: Cuando se insertan determinados fragmentos en la hoja de cálculo, la fórmula que aparece en la barra de herramientas de edición de tareas puede contener caracteres como !, &&, ||, ==, <>, >=, <= y !=. Estos caracteres son un código alternativo para los siguientes operadores lógicos y de comparación: | NOT | Sintaxis: ! NOT lógico
AND | Sintaxis: && AND lógico
OR | Sintaxis: || OR lógico
Equivalente a | Sintaxis: == Equivalente a
Distinto de | Sintaxis: <> (o !=) Distinto de
Igualdad | Sintaxis: = Igualdad
Desigualdad | Sintaxis: <> Desigualdad
Mayor que | Sintaxis: > Mayor que
Menor que | Sintaxis: < Menor que
Mayor o igual que | Sintaxis: >= Mayor o igual que
Menor o igual que | Sintaxis: <= Menor o igual que
Porcentaje | Sintaxis: % Porcentaje
Sumar | Sintaxis: + Sumar
Restar | Sintaxis: - Restar
Multiplicar | Sintaxis: * Multiplicar
División | Sintaxis: / División
Estadísticas | ComputeStats [CalcularEstadísticas] | Sintaxis: ComputeStats Calcula magnitudes estadísticas para un valor referenciado.
Max | Sintaxis: Max(Valor0, [Valor1, ...]) Devuelve el valor máximo de una lista de longitud variable de valores.
Mean [Media] | Sintaxis: Mean(Valor0, [Valor1, ...]) Devuelve el promedio de una lista de longitud variable de valores.
Min | Sintaxis: Min(Valor0, [Valor1, ...]) Devuelve el valor mínimo de una lista de longitud variable de valores.
NthMax | Sintaxis: NthMax(N, Valor0, [Valor1, ...]) Devuelve el enésimo valor más grande de una lista de longitud variable de Valores.
NthMin | Sintaxis: NthMin(N, Valor0, [Valor1, ...]) Devuelve el enésimo valor más pequeño de una lista de longitud variable de Valores.
SDev | Sintaxis: SDev(Valor0, Valor1, [Valor2, ...]) Devuelve la desviación estándar sesgada (en la que el denominador es N-1) de una lista de longitud variable de valores.
SDevUnbiased | Sintaxis: SDevUnbiased(Valor0, Valor1, [Valor2, ...]) Devuelve la desviación estándar no sesgada (en la que el denominador es N) de una lista de longitud variable de Valores.
Trigonometría | ACos | Sintaxis: ACos(Valor) Devuelve el arcocoseno del Valor en grados. Nota: -1 ≤ Valor ≤ 1
ASin [ASen] | Sintaxis: ASin(Valor) Devuelve el arcoseno del Valor en grados. Nota: -1 ≤ Valor ≤ 1
ATan | Sintaxis: ATan(Valor) Devuelve la arcotangente del Valor en grados, ±90.
ATan2 | Sintaxis: ATan2(DY,DX) Devuelve la arcotangente del vector (x,y) = (DY,DX) en grados, ±180.
Cos | Sintaxis: Cos(Ángulo) Devuelve el coseno del Ángulo en grados.
Degrees [Grados] | Sintaxis: Degrees(Radianes) Devuelve expresado en grados el valor del ángulo indicado en radianes.
Pi | Sintaxis: Pi Devuelve el valor de pi ≈ 3,142.
Radians [Radianes] | Sintaxis: Radians(Grados) Devuelve expresado en radianes el valor del ángulo indicado en grados.
Sin [Sen] | Sintaxis: Sin(Ángulo) Devuelve el seno del Ángulo en grados.
Tan | Sintaxis: Tan(Ángulo) Devuelve la tangente del ángulo en grados.
Estructuras | Circle [Círculo] | Sintaxis: Círculo(Posicionador.X,Posicionador.Y,Posicionador.Theta,Círculo.X,Círculo.Y,Círculo.Radio,Mostrar) Crea una estructura de círculo fijo. #### Entradas Nota: Los parámetros de Fixture (Posicionador) y Circle (Círculo) deben estar definidos dentro de los límites de la imagen; de lo contrario, la función devolverá #ERR.
Parámetro | Descripción
--- | ---
Fixture [Elemento posicionador] | Especifica el sistema de coordenadas de imagen en el que se ha definido el círculo.
X | El desplazamiento en X.
Y | El desplazamiento en Y.
Theta | La orientación.
Circle [Círculo] | Especifica el tamaño y la posición del círculo, en coordenadas del elemento posicionador.
X | El desplazamiento en X del círculo.
Y | El desplazamiento en Y del círculo.
Radius | El radio del círculo (1 a 16777216; por defecto = 100).
Mostrar | Especifica el modo de visualización de la superposición gráfica del círculo en la imagen.
0 = ocultar todo (por defecto) | No se visualizará la estructura circular a menos que la celda que contiene la función Circle esté resaltada en la hoja de cálculo.
2 = sólo gráficos de entrada | Se visualizará en todo momento la estructura circular.
#### Salidas
Devuelve | Una estructura de datos de círculo o #ERR si alguno de los parámetros de entrada no es válido.
Resultados | Cuando se inserta inicialmente el parámetro Circle en una celda, se crea una tabla de resultados en la hoja de cálculo.
#### Funciones de Vision Data Access Las siguientes funciones de Vision Data Access se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados.
X | GetX(Circle) | El desplazamiento en X del centro del círculo, en coordenadas de la imagen.
Y | GetY(Circle) | El desplazamiento en Y del centro del círculo, en coordenadas de la imagen.
Radius | GetRadius(Circle) | El radio del círculo.
Fixture [Elemento posicionador] | Sintaxis: Fixture(Posicionador.X,Posicionador.Y,Posicionador.Theta,Mostar) Crea una estructura de datos de Fixture. #### Entradas
Parámetro | Descripción.
--- | ---
Elemento posicionador | Especifica el sistema de coordenadas de la imagen en el que se define el elemento posicionador (Fixture).
X | El desplazamiento en X.
Y | El desplazamiento en Y.
Theta | La orientación.
Mostrar | Especifica el modo de visualización de la superposición gráfica del punto posicionador en la imagen.
0 = ocultar todo (por defecto) | No se visualizará gráficamente el punto posicionador a menos que la celda que contiene la función Fixture esté resaltada en la hoja de cálculo.
2 = sólo gráficos de entrada | Se visualizará en todo momento el punto posicionador.
#### Salidas
Devuelve | Una estructura de datos de Fixture o #ERR si alguno de los parámetros de entrada no es válido.
Resultados | Cuando se inserta inicialmente la función Fixture en una celda, se crea una tabla de resultados en la hoja de cálculo.
#### Funciones de Vision Data Access Las siguientes funciones de Vision Data Access se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados.
X | GetX(Posicionador) | Devuelve el desplazamiento en X del elemento posicionador, en coordenadas de la imagen.
Y | GetY(Posicionador) | Devuelve el desplazamiento en Y del elemento posicionador, en coordenadas de la imagen.
Angle [Ángulo] | GetAngle(Posicionador) | Devuelve el ángulo de orientación en el sistema de coordenadas de la imagen.
Line [Línea] | Sintaxis: Line(Posicionador.X,Posicionador.Y,Posicionador.Theta,Línea.X 0,Línea.Y 0,Línea.X 1,Línea.Y 1,Mostrar) Crea una estructura de línea fija. #### Entradas Nota: Los parámetros de Fixture y Line deben estar definidos dentro de los límites de la imagen; de lo contrario la función devolverá #ERR.
Parámetro | Descripción
--- | ---
Elemento posicionador | Especifica el sistema de coordenadas de la imagen en el que se define la línea posicionadora.
X | El desplazamiento en X.
Y | El desplazamiento en Y.
Theta | La orientación.
Línea | Especifica los extremos de la línea.
X 0 | El desplazamiento en X del primer extremo.
Y 0 | El desplazamiento en Y del primer extremo.
X 1 | El desplazamiento en X del segundo extremo.
Y 1 | El desplazamiento en Y del segundo extremo.
Mostrar | Especifica el modo de visualización de la superposición gráfica de la línea en la imagen.
0 = ocultar todo (por defecto) | No se visualizará la estructura de línea a menos que la celda que contiene la función Line esté resaltada en la hoja de cálculo.
2 = sólo gráficos de entrada | Se visualizará en todo momento la estructura de línea.
#### Salidas
Devuelve | Una estructura de datos de Line o #ERR si alguno de los parámetros de entrada no es válido.
Resultados | Cuando se inserta inicialmente la función Line en una celda, se crea una tabla de resultados en la hoja de cálculo.
#### Funciones de Vision Data Access Las siguientes funciones de Vision Data Access se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados.
X0 | GetX(Línea, 0) | El desplazamiento en X del primer extremo de la línea, en coordenadas de imagen.
Y0 | GetY(Línea, 0) | El desplazamiento en Y del primer extremo de la línea, en coordenadas de imagen.
X1 | GetX(Línea, 1) | El desplazamiento en X del segundo extremo de la línea, en coordenadas de imagen.
Y1 | GetY(Línea, 1) | El desplazamiento en Y del segundo extremo de la línea, en coordenadas de imagen.
Point [Punto] | Sintaxis: Point(Posicionador.X,Posicionador.Y,Posicionador.Theta,Punto.X,Punto.Y,Mostrar) Crea una estructura de puntos fija. #### Entradas
Parámetro | Descripción
--- | ---
Elemento posicionador | Especifica el sistema de coordenadas de la imagen en el que se define el punto.
X | El desplazamiento en X.
Y | El desplazamiento en Y.
Theta | La orientación.
Punto | Especifica la ubicación del punto, en coordenadas del elemento posicionador.
X | El desplazamiento en X de la cruz.
Y | El desplazamiento en Y de la cruz.
Nota: Los parámetros de Elemento posicionador y Punto deben estar definidos dentro de los límites de la imagen; de lo contrario, la función devolverá #ERR.
Mostrar | Especifica el modo de visualización del gráfico de superposición de puntos en la imagen.
0 = ocultar todo (por defecto) | La estructura de puntos estará oculta a menos que la celda que contiene la función Point esté resaltada en la hoja de cálculo.
2 = sólo gráficos de entrada | Se visualizará en todo momento la estructura de puntos.
#### Salidas
Devuelve | Una estructura de datos de Punto o #ERR si alguno de los parámetros de entrada no es válido.
Resultados | Cuando se inserta inicialmente la función Point en una celda, se crea una tabla de resultados en la hoja de cálculo.
#### Funciones de Vision Data Access Las siguientes funciones de Vision Data Access se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados.
X | GetX(Punto) | El desplazamiento en X del punto, en coordenadas de la imagen.
Y | GetY(Punto) | El desplazamiento en Y del punto, en coordenadas de la imagen.
Region [Región] | Sintaxis: Region(Posicionador.X,Posicionador.Y,Posicionador.Theta,Región.X,Región.Y,Región.Alto,Región.Ancho,Región.Ángulo,Región.Curva,Mostrar) Crea una estructura de Región fija. #### Entradas 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.
Parámetro | Descripción
--- | ---
Elemento posicionador | Especifica el sistema de coordenadas de la imagen en el que se define la región.
X | El desplazamiento en X.
Y | El desplazamiento en Y.
Theta | La orientación.
Region | Especifica la posición, el tamaño, la rotación y la curvatura (en caso de tratarse de una región anular, con forma de corona circular o de anillo). Las regiones se definen siempre en el sistema de coordenadas de un elemento posicionador.
X | El desplazamiento en X del origen, en coordenadas del elemento posicionador.
Y | El desplazamiento en Y del origen, en coordenadas del elemento posicionador.
Alto | La dimensión de la región en la dirección del eje X de la misma.
Ancho | La dimensión de la región en la dirección del eje Y de la misma.
Á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.
Mostrar | Especifica el modo de visualización de la superposición gráfica de Región en la imagen.
0 = ocultar todo (por defecto) | El gráfico de la estructura de Región estará oculto a menos que la celda que contiene la función Region esté resaltada en la hoja de cálculo.
2 = sólo gráficos de entrada | Se visualizará en todo momento el gráfico de la estructura de Región.
#### Salidas
Devuelve | Una estructura de datos de Region o #ERR si alguno de los parámetros de entrada no es válido.
Resultados | Cuando se inserta inicialmente la función Region en una celda, se crea una tabla de resultados en la hoja de cálculo.
#### Funciones de Vision Data Access Las siguientes funciones de Vision Data Access se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados.
X | GetX(Estructura, [Índice1], [Índice2]) | Devuelve una coordenada X. Nota: Índice2, Sólo bordes, especifica un extremo (0 o 1). Index2, ReadIDMax especifica la esquina del símbolo.
Y | GetY(Estructura, [Índice1], [Índice2]) | Devuelve una coordenada Y. Nota: Índice2, Sólo bordes, especifica un extremo (0 o 1). Index2, ReadIDMax especifica la esquina del símbolo.
High [Altura] | GetHigh(Región) | La dimensión de la región en la dirección del eje X de la misma.
Wide [Ancho] | GetWide(Región) | La dimensión de la región en la dirección del eje Y de la misma.
Ángulo | GetAngle(Región) | La orientación en coordenadas de la imagen.
Curve [Curva] | GetCurve(Región) | La desviación angular entre el eje X de la región y la línea limítrofe del lado opuesto.
Texto | String [Cadena] | Code [Código] | Sintaxis: Code(Texto) Devuelve el número entero correspondiente al código ASCII del primer carácter de una cadena. Ejemplo con Code Si la celda A2 contiene la cadena alfanumérica "ABC123", entonces la función Code(A2) devuelve 65.000 que es el código ASCII de "A".
Concatenate [Concatenar] | Sintaxis: Concatenate(Arg1, [Arg2, Arg3, ...]) Devuelve la concatenación de múltiples cadenas de texto alfanuméricas. Los argumentos numéricos se convierten automáticamente en textos. Nota: El sensor de visión In-Sight 2000-110/120/120C solo puede devolver datos de Pase/Fallo como datos de salida, siendo el valor devuelto 0 o 1. Ejemplo con Concatenate Si la celda A2 contiene la cadena alfanumérica "A1B1", la celda A3 contiene la cadena alfanumérica "C1D2" y la celda A4 contiene el número en punto flotante 4.556, entonces la función Concatenate(A2,A3,A4) devuelve "A1B1C1D24.556"
Exact [Igual] | Sintaxis: Exact(Texto1, Texto2) Devuelve 1 si Texto1 y Texto2 son idénticos, si no, 0. Nota: La función Exact distingue entre mayúsculas y minúsculas. Ejemplos con Exact Si la celda A2 contiene la cadena "ABC123" y la celda A3 contiene la cadena "ABC1234", entonces Exact(A2,A3) devuelve 0.000. Si la celda A2 contiene la cadena "VISIÓN" y la celda A3 contiene la cadena "VISIÓN", entonces Exact(A2,A3) devuelve 1.000
Find [Buscar] | Sintaxis: Find(BuscarTexto, TextoOrigen, [CarácterInicial]) Devuelve la posición indexada de la cadena Texto1 contenida en la cadena Texto2. La búsqueda del Texto1 comienza en la posición de CarácterInicial (especificación opcional) en el Texto2. Nota: La función Find distingue entre mayúsculas y minúsculas. Ejemplos con Find Si la celda A2 contiene la cadena "123" y la celda A3 contiene la cadena "ABC123", entonces Find(A2,A3,2) devuelve el valor del índice (de base cero) 3.000. La función Find(A2,A3,4) devuelve -1.000, porque no se puede encontrar la cadena completa "123" en la cadena "ABC123" si la búsqueda comienza en el índice 4.
Left [Izquierda] | Sintaxis: Left(Texto, NúmCaracteres) Devuelve el número indicado de caracteres (NúmCaracteres) comenzando por el extremo izquierdo de la cadena de texto. Ejemplo con Left Si la celda A2 contiene la cadena alfanumérica "ABC123", entonces la función Left(A2,2) devuelve la cadena "AB".
Len [Largo] | Sintaxis: Len(Texto) Devuelve el número de caracteres (bytes) que contiene una cadena de texto. Ejemplo con Len Si la celda A2 contiene la cadena alfanumérica "ABC123", entonces la función Len(A2) devuelve el valor entero 6.000.
Lower [Minusc] | Sintaxis: Lower(Texto) Devuelve Texto en minúsculas. Ejemplo con Lower Si la celda A2 contiene la cadena alfanumérica "ABC123", la función Lower(A2) devuelve la cadena "abc123".
Mid | Sintaxis: Mid(Texto, CarácterInicial, NúmCaracteres) Devuelve el texto a partir de la posición indexada por CarácterInicial, siendo la longitud del texto devuelto del número de caracteres especificado por NúmCaracteres. Ejemplo con Mid Si la celda A2 contiene la cadena alfanumérica "ABC123", entonces la función Mid(A2,2,2) devuelve la cadena "C1".
Replace [Reemplazar] | Sintaxis: Replace(TextoOrigen, CarácterInicial, NúmCaracteres, TextoNuevo) Devuelve el TextoOrigen modificado por el TextoNuevo en la posición indexada por CarácterInicial. Ejemplo con Replace Si la celda A2 contiene la cadena alfanumérica "ABC123" y la celda A3 contiene la cadena "123", entonces Replace(A2,0,3,A3) devuelve la cadena "123123".
Right [Derecha] | Sintaxis: Right(Texto, NúmCaracteres) Devuelve el número indicado de caracteres (NúmCaracteres) más próximos al extremo derecho de la cadena de texto. Ejemplo con Right Si la celda A2 contiene la cadena "ABC123", entonces Right(A2,2) devuelve la cadena "23".
Strcspn | Sintaxis: Strcspn(TextoOrigen, ListaDeCaracteres) Devuelve el índice de la posición en la que se encuentra el primer carácter del TextoOrigen que también está contenido en ListaDeCaracteres. Si TextoOrigen no contiene ningún carácter incluido en la ListaDeCaracteres, la función devuelve la longitud del TextoOrigen. Nota: La función Strcspn distingue entre mayúsculas y minúsculas. Ejemplo con Strcspn Si la celda A2 contiene la cadena "BLUE" y la celda A3 contiene los caracteres "RED", entonces Strcspn(A2,A3) devuelve el valor de índice 3.000, ya que 'E' es el primer carácter del TextoOrigen que está también en la ListaDeCaracteres.
Stringf [CadenaF] | Sintaxis: Stringf(CadenaDeFormato, [Texto o Valor, ...]) Devuelve una cadena de texto construida utilizando una de las cadenas de formato estándar de la biblioteca del lenguaje "C". Sugerencia: La función CadenaDeFormato es compatible con la mayoría de los parámetros CadenaFormato; utilice el cuadro de diálogo CadenaDeFormato para configurar automáticamente los parámetros en el In-Sight Explorer. Nota: El sensor de visión In-Sight 2000-110/120/120C solo puede devolver datos de Pase/Fallo como datos de salida, siendo el valor devuelto 0 o 1. La cadena de formato debe escribirse entre comillas ("). Los parámetros de una cadena de formato distinguen entre mayúsculas y minúsculas. Cuando se utiliza la función Stringf, la barra invertida "\" sirve para indicar que lo que sigue es un carácter de control de formato. Si una barra invertida no va seguida de un carácter de control ("n", "r" o "t"), se ignorará dicha barra. Para que se visualice una sola barra invertida, hay que introducir dos barras invertidas (Ejemplo: Stringf("C:\\InSight2\\") = "C:\InSight2\"). Los caracteres ASCII no imprimibles y los que son de control se visualizarán como símbolos o como texto "basura". Los parámetros de cadena de formato disponibles son:
%c | Devuelve el carácter ASCII correspondiente a un valor entero. Cuando se proporciona con una cadena de texto alfanumérico, devuelve el primer carácter. Ejemplos con Stringf y %c Si la celda A2 contiene el valor entero 65.000, entonces Stringf("%c",A2) devuelve el carácter "A" que es el que corresponde al código ASCII 65. La función Stringf("Valor = %c",A2) devuelve la cadena "Valor = A". Si la celda A2 contiene la cadena "123ABC", entonces Stringf("%c",A2) devuelve el carácter "1".
%d | Devuelve una cadena que contiene un valor entero. Ejemplos con Stringf y %d Si la celda A2 contiene el valor en punto flotante 123.456, entonces Stringf("%d",A2) devuelve la cadena numérica "123". La función Stringf("Valor = %d",A2) devuelve la cadena alfanumérica "Valor = 123". Si la celda A2 contiene la cadena "ABC123", entonces Stringf("%d",A2) devuelve la cadena numérica "65", o sea, el código ASCII para el carácter "A".
%e | Devuelve una cadena que contiene un valor en notación científica. El número de decimales puede especificarse insertando un punto decimal (.) y un número entre los parámetros % y e. Ejemplos con Stringf y %e Si la celda A2 contiene el valor en punto flotante 123.456, entonces Stringf("%e",A2) devuelve la cadena numérica "1.234560e+02". La función Stringf("%.1e",A2) devuelve la cadena numérica "1.2e+02" porque se especifica que debe haber solo un número tras el punto decimal.
%f | Devuelve una cadena que contiene un valor en punto flotante. El número de decimales puede especificarse insertando un punto decimal (.) y un número entre los parámetros % y f. Ejemplos con Stringf y %f Si la celda A2 contiene el valor en punto flotante 123.456, entonces Stringf("%f",A2) devuelve la cadena numérica "123.456001". La función Stringf("%.1f",A2) devuelve la cadena numérica "123.5" porque se especifica que debe haber solo un número tras el punto decimal.
%H | Devuelve una cadena que contiene el nombre específico de host del sensor In-Sight. Ejemplo con Stringf y %H Si una celda contiene la función Stringf("Host Name: %H") en un sensor In-Sight cuyo nombre de host es "is3k010203", dicha función devuelve la cadena alfanumérica "Host Name: is3k010203".
%I | Devuelve una cadena que contiene la dirección IP específica del sensor In-Sight. Ejemplo con Stringf y %I Si una celda contiene la función Stringf("Dirección IP: %I") en un sensor In-Sight cuya dirección IP es "198.232.26.1", dicha función devuelve la cadena alfanumérica "Dirección IP: 198.232.26.1".
%M | Devuelve una cadena que contiene la dirección específica de control de acceso al medio (MAC, por sus siglas en inglés) del sensor In-Sight. La dirección MAC es una dirección de hardware que identifica un nodo específico de una red. Cada sistema de visión In-Sight tiene asignada una dirección MAC única que no puede ser modificada. Por ejemplo, 00-d0-24-01-02-03. Para conocer la dirección MAC de un sistema de visión In-Sight, puede consultar la etiqueta de número de serie adherida al dispositivo. Otra posibilidad es que abra el cuadro de diálogo titulado Acerca de In-Sight Explorer. Ejemplo con Stringf y %M Si una celda contiene la función Stringf("Dirección MAC: %M") en un sensor In-Sight cuya dirección MAC es "00-d0-24-01-02-03", dicha función devuelve la cadena alfanumérica "Dirección MAC: 00:d0:24:01:02:03".
%N | Devuelve una cadena que contiene el número de serie específico del sensor In-Sight. Ejemplo con Stringf y %N Si una celda contiene la función Stringf("Número de serie: %N") en un sensor In-Sight cuyo número de serie es "Z01020304", dicha función devuelve la cadena alfanumérica "Número de serie: Z01020304".
%o | Devuelve una cadena que contiene el valor octal de un entero o del primer carácter de una cadena alfanumérica. Ejemplos con Stringf y %o Si la celda A2 contiene el valor entero 123.000, entonces Stringf("%o",A2) devuelve la cadena numérica "173", el valor octal del entero 123. Si la celda A2 contiene la cadena "ABC123", entonces Stringf("%o",A2) devuelve la cadena numérica "101", el valor octal del carácter "A".
%s | Devuelve una cadena con caracteres alfanuméricos anexados. Ejemplos con Stringf y %s Si la celda A2 contiene la cadena "ABC", entonces Stringf("%s123",A2) devuelve la cadena alfanumérica "ABC123". Si la celda A2 contiene la cadena numérica "123", entonces Stringf("%s.450",A2) devuelve la cadena numérica "123.450".
%T | Devuelve una cadena con el tipo de modelo específico del sensor In-Sight. Ejemplos con Stringf y %T Si una celda contiene la función Stringf("Tipo de modelo: %T") en un sensor In-Sight 5400, dicha función devuelve la cadena alfanumérica "Tipo de modelo: 5400".
%u | Devuelve una cadena que contiene un valor entero sin signo. Ejemplos con Stringf y %u Si la celda A2 contiene el valor en punto flotante 123.456, entonces Stringf("%u",A2) devuelve la cadena numérica "123". La función Stringf("Valor = %u",A2) devuelve la cadena alfanumérica "Valor = 123". Si la celda A2 contiene la cadena "ABC123", entonces Stringf("%u",A2) devuelve la cadena numérica "65", el código ASCII para el carácter "A".
%V | Devuelve una cadena que contiene la versión específica del firmware del sensor In-Sight. Ejemplo con Stringf y %V Si una celda contiene la función Stringf("Versión de Firmware: %V") en un sensor In-Sight que funciona con la versión de firmware 3.40.01, dicha función devuelve la cadena alfanumérica "Versión de Firmware: 3.40.01 (475)".
%x o %X | Devuelve una cadena que contiene el valor hexadecimal de un valor entero o del primer carácter de una cadena alfanumérica. Ejemplos con Stringf y %x Si la celda A2 contiene el valor entero 123.000, entonces Stringf("%x",A2) devuelve la cadena "7b", el valor hexadecimal del entero 123. Si la celda A2 contiene la cadena "ABC123", entonces Stringf("%x",A2) devuelve la cadena numérica "41", el valor hexadecimal del carácter "A".
Los siguientes parámetros de formato de cadena se utilizan principalmente para formatear textos. Por ejemplo, para formatear el texto de un mensaje de correo electrónico en la función WriteSMTP:
\x## | Inserta en el texto el carácter ASCII especificado por un número hexadecimal ##. Ejemplo con Stringf y \x## Si la celda A2 contiene Stringf("\x02123\x1bABC\03456"), entonces la celda mostrará: ("<STX>123<ESC>ABC<ETX>456").
\n | Inserta un salto de línea en el texto. Este parámetro se suele utilizar junto con \r (retorno de carro).
\r | Inserta un retorno de carro en el texto. Este parámetro se suele utilizar junto con \n (salto de línea).
\t | Inserta una tabulación en el texto.
Strspn | Sintaxis: Strspn(TextoOrigen, ListaDeCaracteres) Devuelve el índice de la posición del primer carácter del TextoOrigen que no está contenido en la ListaDeCaracteres. Si todos los caracteres del TextoOrigen están también en la ListaDeCaracteres, entonces la función devuelve la longitud del TextoOrigen. Nota: La función Strspn distingue entre mayúsculas y minúsculas. Ejemplo con Strspn Si la celda A2 contiene la cadena "RED" y la celda A3 contiene los caracteres "GREEN", entonces Strspn(A2,A3) devuelve el valor de índice (de base cero) 2.000, ya que 'D' es el primer carácter del TextoOrigen que no está contenido en la ListaDeCaracteres.
Strtol | Sintaxis: Strtol(EnteroComoTexto) Convierte en un número entero los primeros caracteres numéricos (decimales, hexadecimales y octales) de una cadena alfanumérica. Los caracteres hexadecimales deben comenzar con "0x", mientras que los caracteres octales deben comenzar con "0". Ejemplos con Strtol Decimales: Si la celda A2 contiene la cadena de texto "123ABC", entonces la función Strtol(A2) devuelve el valor entero 123.000. Hexadecimales: Si la celda A2 contiene la cadena de texto "0x123", la función Strtol(A2) devuelve el valor entero 291.000. "0x12AB" = 4.779.000, ya que "A" y "B" son caracteres hexadecimales. "0x12GB" = 18.000, ya que "G" no es un carácter hexadecimal. Octales: Si la celda A2 contiene la cadena de texto "0123ABC", la función Strtol(A2) devuelve el valor entero 83.000.
Substitute [Sustituir] | Sintaxis: Substitute(TextoOrigen, TextoAntiguo, TextoNuevo, [Ocurrencia]) Devuelve una cadena de texto obtenida sustituyendo con TextoNuevo cada parte con TextoAntiguo que se encuentra en el TextoOrigen. Si se especifica opcionalmente un índice de posición de Ocurrencia, entonces sólo se reemplazará el texto en la posición de ocurrencia indicada. Ejemplo con Substitute Si la celda A2 contiene la cadena de texto "ABC123123", la celda A3 contiene la cadena "123" y la celda A4 contiene la cadena "abc", entonces la función Substitute(A2,A3,A4,1) sustituye la segunda ocurrencia de "123" en el TextoOrigen y devuelve la cadena "ABC123abc".
Token | Sintaxis: Token(Texto, Delimitador, Ocurrencia) Devuelve el texto que se encuentra en el texto ubicado en el sitio indicado por el índice indicado de posición de la ocurrencia (en Ocurrencia). El Delimitador debe especificarse entre comillas (") en la función. Ejemplo con Token Si la celda A2 contiene la cadena delimitada por comas "A,B,C,1,2,3", entonces Token(A2,",",2) devuelve "C" porque C es el texto que se encuentra en el sitio indicado por el índice 2.
Trim [Recortar] | Sintaxis: Trim(Texto) Devuelve el texto sin espacios iniciales y finales, dejando sólo un espacio entre palabras (si hubiera varias). Se eliminan también todos los caracteres de control (retorno de carro, salto de línea, etc.). Ejemplo con Trim Si la celda A2 contiene la cadena " ABC 123 ", entonces Trim(A2) devuelve la cadena "ABC 123".
Upper [Mayusc] | Sintaxis: Upper(Texto) Devuelve el Texto escrito en mayúsculas. Ejemplo con Upper Si la celda A2 contiene la cadena alfanumérica "abc123", entonces la función Upper(A2) devuelve la cadena "ABC123".
Value [Valor] | Sintaxis: Value(TextoNumérico) Devuelve el texto numérico convertido en un valor en punto flotante. Se ignoran los subsiguientes caracteres no numéricos. Ejemplo con Value Si la celda A2 contiene la cadena numérica "123.4", entonces la función Value(A2) devuelve el valor en punto flotante 123.400. Nota: Una celda de In-Sight permite introducir un valor numérico de hasta 7 dígitos. Si la función Value hace referencia a un texto numérico que tiene más de 8 dígitos, el valor devuelto puede no ser exacto debido a las limitaciones impuestas al tipo de dato de punto flotante. Por ejemplo: A2 = '68456668 A3 = Value(A2) En este caso, la función devuelve 68456672.000.
Funciones de Vision Data Access | AutoLearnClassify | GetClassLabel [ObtenerEtiquetaClasificación] | Sintaxis: GetClassLabel (Estructura, [Índice], [Modelo]) Para utilizar esta función añada clases y a continuación añada imágenes a cada una de las clases Nota: Asegúrese de utilizar la palabra clave "Capturada" para indicar imagen actual. GetClassLabel devuelve la cadena asociada a cada clase.
GetModelHealth [ObtenerEstadoModelo] | Sintaxis: GetModelHealth(Estructura) Para utilizar esta función añada clases y a continuación añada imágenes a cada una de las clases. Nota: Asegúrese de utilizar la palabra clave "Capturada" para indicar imagen actual. GetModelHealth devuelve un número (0-100) que representa el estado "de salud" del modelo, indicándose con él la probabilidad de que el modelo sea correcto.
GetNClasses | Sintaxis: GetNClasses(Estructura) Para utilizar esta función añada clases y a continuación añada imágenes a cada una de las clases. Nota: Asegúrese de utilizar la palabra clave "Capturada" para indicar imagen actual. GetNClasses devuelve el número de clases.
GetNImages | Sintaxis: GetNImages(Estructura, [Índice], [Modelo]) Para utilizar esta función añada clases y a continuación añada imágenes a cada una de las clases. Nota: Asegúrese de utilizar la palabra clave "Capturada" para indicar imagen actual. GetNImages devuelve el número de imágenes en cada clase.
Blobs | GetAngle | Sintaxis: GetAngle(Blobs, Índice) Devuelve el ángulo del centro de masa de un blob (mancha o agrupación de píxeles contiguos) con respecto al centro de la región de interés (RDI) que define el área de la imagen a inspeccionar. El centro de masa de un blob representa el punto de equilibrio del mismo. Si se recortara una lámina de un material uniforme con la forma de dicho blob, el punto sobre el que se equilibraría la mancha sería el centro de masa. Cabe señalar que el centro de masa de un blob puede estar fuera del área de la propia mancha. Por ejemplo, supongamos que la región negra representada en la siguiente imagen es un blob que se ha identificado mediante la función ExtractBlobs [ExtraerBlobs]. El punto rojo representa el centro de masa del blob. Las coordenadas X e Y del centro de masa son valores devueltos por las funciones GetX y GetY de Vision Data Access, respectivamente.
GetArea | Sintaxis: GetArea(Blobs, Índice) Devuelve el área (en píxeles) de un blob (mancha). El área de una mancha se determina contando el número de píxeles que contiene. Por ejemplo, considérese la mancha ampliada que puede verse en la siguiente imagen: Tras contar el número de píxeles, podemos ver que dicha mancha tiene un área de 8 píxeles.
GetHeight | Sintaxis: GetHeight(Blobs, Índice) Devuelve la altura del blob (mancha) indexado(a).
CircleFit [EncuadreDeCírculo] | GetDistance | Sintaxis: GetDistance(CircleFit, Índice) Devuelve la distancia entre el punto indexado y el círculo. Si el valor es negativo, el punto está dentro del círculo. Si el punto indexado no es válido, se devuelve un #ERR.
GetMaxDist | Sintaxis: GetMaxDist(CircleFit) Devuelve la distancia entre el círculo y el punto más alejado del círculo. Si el valor es negativo, el punto está dentro del círculo.
GetMaxDistIndex | Sintaxis: GetMaxDistIndex(CircleFit) Devuelve el índice del punto más alejado del círculo.
GetNPointsUsed | Sintaxis: GetNPointsUsed(CircleFit) Devuelve el número de puntos utilizados para aproximar al círculo.
GetRadius | Sintaxis: GetRadius(CircleFit) Devuelve el radio del círculo.
GetSigma | Sintaxis: GetSigma(CircleFit) Devuelve la raíz cuadrada de la suma de los cuadrados de las distancias de los puntos al círculo dividida por el número de puntos.
Almacenamiento cronometrado de datos | GetCount | Sintaxis: GetCount(Delay) Devuelve el valor de recuento de una estructura de datos de Delay [Retardo].
GetErrorCount | Sintaxis: GetErrorCount(Count) Devuelve el recuento incremental de errores de una estructura de Count [Recuento] Se incrementa el contador cuando el Valor devuelto es menor que cero.
GetFailCount | Sintaxis: GetFailCount(Count) Devuelve el recuento incremental de fallos de una estructura de Count [Recuento] Se incrementa el contador cuando el Valor devuelto es igual a cero.
GetPassCount | Sintaxis: GetPassCount(Count) Devuelve el recuento incremental de pases (aprobados) de una estructura de Count [Recuento]. Se incrementa el contador cuando el Valor devuelto es mayor que cero.
GetTotalCount | Sintaxis: GetTotalCount(Count) Devuelve el número total de pases, fallos y errores de una estructura de Count [Recuento].
Color | GetActiveMatchClrColorName | Sintaxis: GetActiveMatchClrColorName(Colores, Índice) Devuelve el nombre del color activo indexado para una función MatchColor [ConcordanciaDeColor].
GetBlue [ObtenerAzul] | Sintaxis: GetBlue(Colores) Devuelve el componente azul del color promedio en la región de interés (RDI) para una función MatchColor.
GetColorLibraryName | Sintaxis: GetColorLibraryName(Estructura de color) Funciona con TrainExtractColor [EntrenarExtraerColor], TrainMatchColor [EntrenarConcordanciaDeColor], ExtractColor [ExtraerColor] y MatchColor [ConcordanciaDeColor]. Para las funciones TrainExtractColor y TrainMatchColor, devuelve el nombre de la biblioteca de colores que ha guardado la función. Para las funciones ExtractColor y MatchColor, devuelve el nombre de la función de entrenamiento Train a la que se hace referencia (p. ej., TrainExtractColor o TrainMatchColor, respectivamente).
GetConfidenceScore | Sintaxis: GetConfidenceScore(Colores) Devuelve la puntuación de confianza de la inspección actual para una función MatchColor [ConcordanciaDeColor]. Puntuación de confianza = ( s1 * (M - s2) - s2 * (M - s1)) / ( (M - s2) + (M - s1)), donde s1 es la mejor puntuación, s2 es la segunda mejor puntuación y M es una constante igual a 1.01. Cuanto mayor sea la puntuación de confianza, tanto mayor es la probabilidad de que la concordancia seleccionada es la mejor.
GetGreen | Sintaxis: GetGreen(Colores) Devuelve el componente verde del color promedio en la RDI para una función MatchColor.
GetHue | Sintaxis: GetHue(Colores) Devuelve el componente de matiz del color promedio en la RDI para una función MatchColor.
GetIntensity | Sintaxis: GetIntensity(Colores) Devuelve el componente de intensidad del color promedio en la RDI para una función MatchColor.
GetMatchClrColorByRank | Sintaxis: GetMatchClrColorByRank(Colores, Categoría) Devuelve el índice del color que concuerda con la categoría (0 a n-1) para una función MatchColor. El color de categoría 0 es el que tiene la puntuación más alta.
GetMatchClrColorState | Sintaxis: GetMatchClrColorState(Colores, NombreColor) Devuelve el estado del color especificado para una función MatchColor.
GetMatchClrDistByIndex | Sintaxis: GetMatchClrDistByIndex(Colores, Índice) Devuelve la distancia cromática del color indexado para una función MatchColor.
GetMatchClrDistByName | Sintaxis: GetMatchClrDistByName(Colores, Nombre) Devuelve la distancia cromática del color nombrado para una función MatchColor.
GetMatchClrScoreByIndex | Sintaxis: GetMatchClrScoreByIndex(Colores, Índice) Devuelve la puntuación del color indexado para una función MatchColor.
GetMatchClrScoreByName | Sintaxis: GetMatchClrScoreByName(Colores, Nombre) Devuelve la puntuación del color nombrado para una función MatchColor.
GetNActiveMatchClrColors | Sintaxis: GetNActiveMatchClrColors(MatchColorLib) Devuelve el número de colores de referencia que están activos en la función MatchColor a la que se hace referencia.
GetNTrainMatchClrColors | Sintaxis: GetNTrainMatchClrColors(MatchColorLib) Devuelve el número de colores almacenados por la función TrainMatchColor.
GetRed | Sintaxis: GetRed(Colores) Devuelve el componente rojo del color promedio en la RDI para una función MatchColor.
GetSaturation | Sintaxis: GetSaturation(Colores) Devuelve el componente de saturación del color promedio en la RDI para una función MatchColor.
GetTrainMatchClrColorName | Sintaxis: GetTrainMatchClrColorName(MatchColorLib, Índice) Devuelve el nombre del color almacenado e indexado para una función MatchColor.
GetMatchClrColorState | Sintaxis: SetMatchClrColorState(Colores, Habilitar, NombreColor1, [NombreColor2,...]) Devuelve el número de colores habilitados o deshabilitados para una función MatchColor. El estado de la celda de esta función está deshabilitado cuando esta se inserta en la hoja de cálculo; debe habilitarse condicionalmente mediante una función Button.
Controles | GetString | Sintaxis: GetString(ListBox) Devuelve la cadena de texto. Si se hace referencia a una celda que contiene la función ListBox (CuadroDeLista), devuelve la cadena de texto que se encuentra actualmente seleccionada en la lista.
Dist | GetDistance | Sintaxis: GetDistance(Dist) Devuelve el valor de la distancia.
GetErrorCode | Sintaxis: GetErrorCode(Estructura) GetErrorCode es una función de Vision Data Access que devuelve un código de diagnóstico de la mayoría de las estructuras y funciones. Nota: Si no hay ningún código de error disponible para el #ERR, GetErrorCode devolverá -1.
GetErrorString | Sintaxis: GetErrorString(Estructura) GetErrorString es una función de Vision Data Access que devuelve información diagnóstica de la mayoría de las estructuras y funciones.
GetValue | Sintaxis: GetValue(Estructura,[Índice],[Color]) Estructura hace aquí referencia a una celda que contiene una estructura de datos de HistColor, de Delay o Hist. El índice especifica opcionalmente la ubicación de la que deben tomarse los valores de histograma (solo para HistColor e Hist) Color especifica opcionalmente qué componente de color ha de utilizarse para extraer los datos de histograma (solo para ColorHist) GetValue es una función de Vision Data Access que devuelve información de las siguientes estructuras: HistColor. Delay [Retardo] Hist
Entrada/Salida | GetClock | Sintaxis: GetClock(Fecha y hora, Cadena de formato, [Local/GMT]) Devuelve la fecha y hora actuales en forma de una cadena construida a partir de una cadena de formato estándar de una estructura de datos de fecha y hora extraída de la biblioteca de "C" y que es la cadena que devuelve la función Now [Ahora].
Cadena de formato | Especifica el formato de presentación de la fecha y la hora. La cadena de formato por defecto es la de: mes/día/año hora:minuto:segundo y se representa de la forma siguiente: %m/%d/%Y %H:%M:%S Se admiten las siguientes variables:
%m | mes
%d | día
%Y | año
%H | hora
%M | minuto
%S | segundo
%3N | milisegundo
%6N | microsegundo
%9N | nanosegundo
Local/GMT | 0 = Local con horario de verano (por defecto) 1 = GMT (UTC) 2 = Local con hora estándar
Inspección de bordes | GetWidth | Sintaxis: GetWidth(InspeccionarAnchoBorde, Índice de calibre) Devuelve el valor de la anchura del borde dentro del calibre indexado; devuelve 0 si no se encuentra ningún borde dentro del calibre indexado.
Linefit [EncuadreDeLínea] | GetChi2 | Sintaxis: GetChi2(LineFit) Devuelve la suma de los cuadrados de las distancias de los puntos a la línea.
GetDistance | Sintaxis: GetDistance(LineFit, Índice) Devuelve la distancia entre el punto indexado y la línea.
GetMaxDist | Sintaxis: GetMaxDist(LineFit) Devuelve el punto más alejado de la línea.
GetMaxDistIndex | Sintaxis: GetMaxDistIndex(LineFit) Devuelve el índice del punto más alejado de la línea.
GetNPointUsed | Sintaxis: GetNPointUsed(LineFit) Devuelve el número de puntos utilizados para determinar la línea.
GetX | Sintaxis: GetX(Estructura, [Índice1], [Índice2]) Devuelve una coordenada X.
GetY | Sintaxis: GetY(Estructura, [Índice1], [Índice2]) Devuelve una coordenada Y.
Scripting | Get | Sintaxis: Get(Script/Get,Propiedad de objeto y o matriz,[Índice de la matriz]) Devuelve las propiedades de matrices y/u objetos obtenidas mediante una función Script u otra función Get. Nota: Esta función sólo está disponible en los sistemas de visión In-Sight que utilizan el firmware In-Sight de versión 5.1.0 o posterior. #### Resumen La función Get [Obtener] se utiliza para acceder a propiedades de objetos devueltas por una función Script. Requiere como mínimo dos argumentos: una referencia a una función Script u otra función Get que devuelva un objeto o matriz y, además, una cadena que indique la propiedad de un objeto o una ruta de acceso separada por puntos a una propiedad de un subobjeto. Opcionalmente, se puede incluir un tercer argumento para especificar el acceso a un índice de matriz de base cero cuando se hace referencia a una matriz. El valor devuelto por la función Get es el valor de la propiedad (o del elemento de matriz indexado) que puede ser cualquiera de los siguientes tipos: Un número verdadero (1) o falso (0) Una cadena Una estructura de datos binaria Una estructura de datos de Blobs, Bordes, Hist, IDMax o Patrones Un objeto de forma Una estructura de datos de objeto o matriz Nota: La función Get no admite la devolución de un valor nulo o no definido. #### Ejemplo con Get Para este ejemplo, una función Script en la celda B3 tiene un método de ejecución que devuelve un objeto:
    Tool.prototype.run = function(n) {
      this.updateStats(n);
      return {
        total: this._total;
    	stats: {
    	  avg: this._avg,
    	  range: {
    	    max: this._max,
    	    min: this._min
    	  },
    	  values: this._valueArray
    	}
       };
    };
Las siguientes funciones Get devolverían números simples (suponiendo que los valores devueltos son numéricos): Get(B3, "total") Get(B3, "stats.avg") Get(B3, "stats.range.max") Get(B3, "stats.range.min") La siguiente función Get devuelve el subobjeto "rango" que podría pasarse a otra función Script o Get: Get(B3, "stats.range") La siguiente función Get devuelve el elemento 37 de la matriz de valores: Get(B3, "stats.values", 37) #### Entradas
Parámetro | Descripción
--- | ---
Script/Get | Especifica una referencia a una función Script u otra función Get que devuelve una estructura de datos de un objeto o matriz.
Propiedad de objeto y/o matriz | Especifica una referencia a una propiedad de una estructura de datos de objeto, ya sea en forma de cadena (el nombre de la propiedad) o de una ruta de acceso separada por puntos a una propiedad de un subobjeto, o una estructura de datos de matriz.
[Índice de la matriz] | Un argumento opcional para especificar el índice de una matriz cuando se hace referencia a una estructura de datos de matriz.
#### Salidas
Devuelve | La función devuelve el valor de la propiedad (o elemento de matriz indexada), pudiendo ser este uno cualquiera de los siguientes tipos: Un número verdadero (1) o falso (0) Una cadena Una estructura de datos binaria Una estructura de datos de Blobs, Bordes, Hist, IDMáx o Patrones Un objeto de forma Una estructura de datos de objeto o matriz
Nota: La función no devolverá lo siguiente de una función Script: valor nulo, valor indefinido o sin instrucción de retorno (que se trataría como si fuese un objeto vacío).
Stats [Estadísticas] | GetLatest | Sintaxis: GetLatest(Estadísticas) Devuelve el valor más reciente utilizado para calcular las estadísticas.
GetMax | Sintaxis: GetMax(Estadísticas) Devuelve el valor más elevado utilizado para calcular las estadísticas.
GetMean | Sintaxis: GetMean(Estadísticas) Devuelve la media (el promedio) de los valores.
GetMin | Sintaxis: GetMin(Estadísticas) Devuelve el valor más pequeño utilizado para calcular las estadísticas.
GetErrorCount | Sintaxis: GetErrorCount(Estadísticas) Devuelve el número total de errores del valor al que se hace referencia.
GetNumSamples | Sintaxis: GetNumSamples(Estadísticas) Devuelve el número total de muestras utilizadas para los cálculos.
GetRange | Sintaxis: GetRange(Estadísticas) Devuelve el intervalo definido por los valores mínimo y máximo.
GetSDev | Sintaxis: GetSDev(Estadísticas) Devuelve la desviación estándar de los valores.
GetSum | Sintaxis: GetSum(Estadísticas) Devuelve la suma de los valores.
GetVariance | Sintaxis: GetVariance(Estadísticas) Devuelve la varianza de los valores.
Estructuras Nota: El argumento Estructura de las siguientes funciones debe hacer referencia a la estructura de datos devuelta por una función Annulus, Circle, Cross, Fixture, Line, Mask, Point o Region. Las estructuras válidas para cada una de estas funciones se presentan en las descripciones correspondientes. | GetCurve | Sintaxis: GetCurve(Estructura) Devuelve el valor de Curva de la estructura de Región indexada
GetNPoints | Sintaxis: GetNPoints(Estructura) La función GetNPoints se aplica a polígonos y devuelve el número de puntos.
Temporizador | GetAllTime | Sintaxis: GetAllTime(Imagen) Devuelve el tiempo requerido, expresado en milisegundos, para capturar la imagen y ejecutar la tarea o #ERR si el valor de entrada no es válido. Nota: El argumento debe utilizar la palabra clave Capturada con la que se hace referencia a la imagen que se ha capturado más recientemente. El valor devuelto por GetAllTime no incluye el tiempo de ejecución requerido para el sensor de película. La función GetAllTime y la barra de estado determinan el tiempo requerido de otra forma que el cuadro de diálogo de perfil de tarea. El cuadro de diálogo de perfil de tarea considera también el tiempo requerido para realizar los gráficos de resultados. Si se utiliza esta función en una fórmula, el valor devuelto variará en función de la ubicación de la celda. Por ejemplo, si GetAllTime(A0) es 80, 1*GetAllTime(A0) será también 80. Sin embargo, si la celda que contiene 1*GetAllTime(A0) está al comienzo de la tarea, el valor devuelto será casi el mismo que el que da GetTime(A0), la cual no incluye el tiempo de ejecución de otras herramientas. Si 1*GetAllTime(A0) está al final de la tarea, el valor devuelto tendrá en cuenta el tiempo de ejecución de toda la tarea. Para que se devuelva el valor correcto, cree una celda separada para GetAllTime(A0) únicamente y utilice una referencia a dicha celda en la fórmula. Por ejemplo, si crea GetAllTime(A0) en la celda B2, la fórmula 1*B2 devolverá el valor correcto independientemente de la ubicación de la celda. Si en la configuración de HMI se establece que el número máximo de aplicaciones conectadas al sistema de visión es igual o superior a 2, el valor devuelto por GetAllTime en el caso de sistemas de visión con firmware In-Sight 5.x.x será algo mayor que el devuelto con sistemas de visión que utilizan el firmware In-Sight 4.x.x. Además del tiempo requerido para la captura de imagen y la ejecución de la tarea, el valor de GetAllTime devuelto por los sistemas de visión con firmware In-Sight 5.x.x incluye también el tiempo requerido para la actualización de las vistas múltiples, mientras que el devuelto por los sistemas de visión con firmware In-Sight 4.x.x no lo incluye.
GetTime | Sintaxis: GetTime(Celda1, [Celda2, ...]) Devuelve el tiempo requerido, expresado en milisegundos, para ejecutar una lista de longitud variable de celdas o #ERR si el valor de entrada no es válido. Si se seleccionan varias celdas, devuelve la suma de todos los tiempos de ejecución correspondientes.