 SpotLight

La herramienta SpotLight de ISaGRAF permite definir al usuario listas de observación (watch) que pueden ser presentadas bien como dibujos gráficos o como listas durante la depuración. Los items gráficos deben estar enlazados a variables del proyecto ISaGRAF. El dibujo gráfico se define y anima "en línea".

Construyendo la composición gráfica

La composición de lista

Definiendo el estilo del ítem

Comandos del menú "Fichero"

"Nota para usuarios de ISaGRAF V3.2

Para forzar el valor de una variable, hacer doble click en el ítem correspondiente de la composición gráfica o lista, o pulse INTRO cuando esté seleccionado.

Se puede también bloquear el documento (denegar cualquier modificación) utilizando el comando "Fichero / Bloquear". Cuando un documento este bloqueado, se pueden forzar variables haciendo doble click sobre su símbolo.


Construyendo la composición gráfica

Un diagrama esta constituido por dibujos de fondo (bitmaps o metafiles), y un conjunto de items gráficos que serán animados durante la depuracion. Para crear el diagrama, se deben realizar las siguientes operaciones: Insertar dibujos de fondo, insertar items gráficos, enlazar objetos a las variables del proyecto.

Dibujos de fondo

Se pueden insertar los siguientes items gráficos en la composición gráfica:

Presentación solo texto

 	Gráficos de barras unipolares y bipolares

Curvas

Iconos booleanos

Campos de bits

Cuando la composición gráfica está preparada, se puede modificar o completar

Seleccionar, mover o redimensionar items

 	Agrupar items / desasociar grupos

Cambiar el estilo de items


Dibujos de fondo

Los dibujos de fondo son ficheros "bitmap" (.BMP) o "metafile" (.WMF). El número de dibujos incluidos en la composición gráfica no está limitado. Los dibujos se pueden mover o redimensionar en la composición gráfica. No aparecen en la composición de lista. Los dibujos se construyen con otras herramientas. SpotLight no incluye una herramienta de dibujo. El comando "Opciones / Color de fondo" se utiliza para seleccionar un color sólido para el espacio vacío en una composición gráfica.

Nota:	Los bitmaps consumen una elevada cantidad de memoria. Es altamente recomendable dimensionar correctamente el dibujo, y limitar el espacio no utilizado dentro del rectángulo del bitmap.


Presentación solo texto

Un ítem "solo texto" es un texto escrito en un rectángulo. El texto presentado es el valor de la variable asociada. Así, dicho ítem puede estar enlazado a una variable cadena de mensaje.

El  rectángulo donde se presenta el texto puede bien estar coloreado o bien ser transparente. Cuando se redimensiona el ítem la fuente de caracteres empleada para presentar el texto se ajusta para encajarse a la altura del rectángulo.


Graficos de barras unipolares y bipolares
 	Gráficos de barras unipolares y bipolares

Un gráfico de barras es un rectángulo con una parte coloreada que representa el valor numérico de la variable asociada. Opcionalmente, el resto de la barra puede estar coloreada. Un gráfico de barras puede ser bien horizontal o vertical.

Los gráficos de barras unipolares pueden crecer en cualquier dirección, hacia arriba, hacia abajo, a la izquierda, a las derecha.

Los gráficos bipolares pueden crecer bien en dirección positiva o negativa, según el valor de la variable asociada. En el caso de un gráfico bipolar el valor máximo permitido es el mismo para ambas escalas positiva y negativa.


Curvas

Es posible insertar una curva en un documento. Una curva muestra la historia de la variable asociada. Aunque no es una herramienta de medida precisa, sí puede dar una información de depuración sobre la sincronización entre varias variables.

Una curva almacena los 200 últimos valores de la variable. El número de muestras no cambia cuando se redimensiona el ítem curva en la composición gráfica.


Iconos booleano
Iconos booleanos

Un  ítem "Icono booleano" se utiliza para presentar un estado binario. Se define un fichero icono (.ICO) para FALSO o valor 0. Se define otro icono para el resto de los valores distinto a cero. Como SpotLight no incluye un editor de iconos, los ficheros de iconos deben ser preparados con otra herramienta.


Campos de bits

Un ítem  "campo de bits" muestra en un panel gráfico los 32 bits de un valor entero. El bit menos significativo siempre se presenta a la derecha. No se recomienda el uso de campo de bits para otro tipo de datos como valores analógicos reales, ya que la información presentada puede inducir a confusiones.


Seleccionar, mover o redimensionar items

La selección de objetos gráficos se necesita para la mayoría de los comandos de edición. SpotLight permite la selección de uno o más objetos gráficos existentes en el área del diagrama. Para seleccionar objetos, el botón de "selección" (botón con una flecha) debe estar seleccionado en la barra de herramientas del editor. Para seleccionar un objeto, el usuario simplemente tiene que hacer click en su símbolo. Para seleccionar una lista de objetos, arrastre el ratón en el área de dibujo para seleccionar un área rectangular. Todos los objetos gráficos que intersectan el rectángulo de selección se marcan como "seleccionados". Un objeto seleccionado se dibuja con pequeños cuadrados negros alrededor de su símbolo gráfico.

Haciendo una nueva selección, cualquiera de los objetos previamente seleccionados se deseleccionan. Para deshacer la(s) selección(es) actual(es), simplemente hacer click con el ratón en un área vacía fuera del rectángulo que bordea los objetos seleccionados.

Para mover objetos, primero tienen que estar seleccionados. Poner entonces el cursor en el borde del ítem seleccionado y arrastrarlo a otra posición.

Para redimensionar un objeto, primero tiene que estar seleccionado. Poner entonces el cursor en uno de los pequeños rectángulos presentados en el borde de selección, y arrastrar en la dirección apropiada para redimensionar el objeto. Los dibujos también pueden redimensionarse. En tal caso, el bitmap o metafile  se modifica para encajar el nuevo rectángulo de ítem especificado.


 	Agrupar items / desasociar grupos

Se puede agrupar items juntos de forma que se manejen como un solo ítem. Para hacer un grupo, seleccionar items en la composición gráfica y ejecutar el comando  "Edición / Grupo". Se utiliza el comando "Edición / Desasociar" para restaurar los items del grupo seleccionado como separados.

Un grupo puede contener un dibujo. Un grupo puede contener también otro grupo.

Cuando se agrupan los items, su estilo ya no puede ser cambiado. Los items del grupo se siguen presentando, pero no se pueden utilizar (con doble click) para modificar el valor de las variables asociadas.

En la composición de lista un grupo aparece como una sola línea


Definiendo el estilo del ítem

El estilo gráfico y la configuración de un ítem existente se puede modificar, haciendo doble click sobre su símbolo en el área gráfica, o ejecutando el comando "Edición / Establecer Estilo de ítem" cuando el ítem está seleccionado en la composición gráfica o de lista. Se abre también la ventana de diálogo "Estilo" siempre que se añade un ítem al documento. Este diálogo agrupa las siguientes opciones  a seleccionar por parte del usuario.

Estilo gráfico y configuración:

El estilo de presentación (solo texto, gráfico de barra, curva…) de un ítem se puede cambiar dinámicamente. Cuando se utilizan los colores de fondo y relieve, se pueden personalizar usando las cajas de selección correspondientes. Cuando el estilo es "icono booleano", se debe especificar la ruta de acceso de los ficheros .ICO correspondientes. Utilice los botones "..." próximos a estos controles para explorar los ficheros de iconos existentes en el disco.

Escala:

Este es el máximo valor que se puede presentar en los gráficos de barras y curvas. Para gráficos de barras y curvas, se utiliza el mismo valor absoluto para ambos ejes positivo y negativo.

Nombre de variable:

Cuando esté activo el campo "Nombre", pulsando el botón "..." próximo al control de edición se permite al usuario encontrar los nombres de las variables declaradas en el diccionario del proyecto.

Título (Caption):

Se puede presentar un título cercano al ítem gráfico en la composición gráfica. Se puede personalizar la posición del texto del título (superior, inferior, izquierda o derecha) y su contenido. El título puede ser cualquier combinación del nombre de la variable y su valor formateado como texto. La personalización del título no tiene ningún efecto sobre la composición de lista.

Control de variable (Command variable):

Si está activa la opción "Control de variable", el usuario puede modificar el valor de una variable enlazada durante la depuración haciendo doble click en el símbolo gráfico del ítem.


Comandos del menú "Fichero"

El menú "Fichero" contiene los comandos que permiten manejar el documento completo al usuario

El comando "Nuevo" del menú "Fichero" inicia la edición de un nuevo documento. ISaGRAF no limita el número de documentos definidos para un proyecto. Antes de editar un nuevo proyecto, se cierra el documento previamente abierto. SpotLight no se puede emplear para editar varios diagramas simultáneamente. Sin embargo,  se pueden abrir simultáneamente múltiples ventanas  SpotLight que se usan cada una para editar un documento diferente.

El comando "Abrir" del menú "Fichero" permite al usuario cerrar el documento editado actualmente e iniciar la edición de otro documento del proyecto actual. El documento nuevo seleccionado reemplaza el actual en la ventana de edición. Con objeto de limpiar el directorio de proyecto, cuando se selecciona un nuevo documento, se puede utilizar el botón "Borrar" para borrar algún fichero existente. Los ficheros de iconos y bitmaps referenciados en un diagrama no se borran cuando se borra el diagrama.

El comando "Guardar" del menú "Fichero" almacena en el disco el documento editado actualmente. Si es un documento nuevo sin título, el usuario debe asignarle un nombre antes de salvarlo. El nombre de un documento tiene que cumplir con las siguientes normas:

- La longitud del nombre no puede exceder 8 caracteres

- El primer carácter debe ser una letra

- Las restantes tienen que ser letras, dígitos o el carácter de subrayado '_'

- Los nombres son insensibles al uso de mayúsculas o minúsculas

El comando "Guardar como" del menú "Fichero" permite al usuario almacenar bajo otro nombre el documento actualmente editado


La composición de lista

Pulsando este botón, se puede cambiar en cualquier momento entre composición gráfica y lista. También se puede utilizar el comando "Opciones / Distribución de listas / gráficos".

En la composición de lista, los items se muestran en un listado clásico (list box). El tamaño de cada ítem se calcula de acuerdo a su estilo gráfico. Los dibujos (bitmaps y metafiles) no son visibles desde la composición de lista. Existe una función de selección en la composición de lista, que deberá ser utilizada para definir el estilo de un ítem o para cambiar el valor de una variable. En este modo no están disponibles selecciones y comandos múltiples

 	Los items de la lista se pueden reordenar usando los comandos "Edición / Subir / Bajar en la lista". Se deberá seleccionar el ítem a mover en la lista.


Nota para usuarios de ISaGRAF V3.2

Spotlight puede leer gráficos y listas de diagramas de tiempo construidos con las herramientas de ISaGRAF V3.0 o V3.2. Dichos ficheros aparecen en la ventana de diálogo "Abrir", con la descripción de su origen. Los ficheros se pueden leer y modificar libremente con SpotLight.

Cuando se abre un gráfico de ISaGRAF V3.2, el documento se marca automáticamente como "Bloqueado". Eliminar la opción "Bloqueo" del menú "Fichero" si se quieren hacer cambios en el gráfico.

Cuando se abre un gráfico o una lista de diagramas de tiempo de ISaGRAF 3.2, SpotLight siempre propone guardarlos en el formato nativo de SpotLight. La ventana de diálogo "Guardar como" se abre sistemáticamente cuando se cierra un documento de este tipo.