 Depurando com SpotLight

A ferramenta SpotLight ISaGRAF permite que o usuário defina listas de observação que podem ser exibidas como gráfico ou como listas durante a depuração. Itens gráficos devem ser ligados às variáveis do projeto ISaGRAF. O gráfico é tanto definido quanto animado "online".

Construindo a disposição gráfica

Apresentação da lista

Definindo a formatação do item

Comandos do menu "Arquivo"

Nota para usuários do ISaGRAF V3.2

Para forçar o valor de uma variável, clique duas vezes sobre o item na disposição gráfica ou de lista correspondente, ou pressione ENTER após a seleção.

Você também pode fechar o documento (negar qualquer modificação) utilizando o comando "Arquivo / Travar". Quando um documento é bloqueado, você ainda pode forçar variáveis clicando duas vezes no seu símbolo.


Construindo a disposição gráfica

Um gráfico é feito de figuras de fundo (bitmaps ou metafiles), e um conjunto de itens gráficos que serão animados durante a depuração. Para inserir o gráfico, as seguintes operações devem ser executadas: Insira as figuras de fundo, insira os itens gráficos, ligue os objetos com as variáveis do projeto.

Figuras de fundo Background pictures

Os seguintes itens gráficos po0dem ser inseridos na disposição gráfica:

Textos

 	Gráficos de barras unipolar e bipolar

Curvas

Ícones booleanos

Campos de bit

Quando a disposição gráfica está pronta, você pode modificá-la ou completá-la:

Selecionar, mover ou redimensionar itens

 	Agrupar itens / dissociar grupos

Definindo a formatação do item


Figuras de fundo

As figuras de fundo são arquivos "bitmap" (.BMP) ou "metafile" (.WMF). O número de figuras incluídas na disposição gráfica não está limitado. As figuras podem ser movidas ou redimensionadas na disposição gráfica. Eles não aparecem na disposição de lista. As figuras são construídas com outras ferramentas. SpotLight não inclui uma ferramenta de pintura. O comando "Opções / Cor de fundo" é utilizado para selecionar uma cor sólida para o espaço vazio na disposição gráfica.

Nota:	Bitmaps consomem uma grande quantidade de memória. É muito recomendável que se dimensione corretamente o tamanho da figura, e limitas o espaço não utilizado dentro do retângulo de bitmap.


Textos

Um item "único texto" é um texto escrito em um retângulo. O texto exibido é o valor da variável atrelada. Assim, tal item pode ser ligado a variável de cadeia de mensagem.

O retângulo no qual o texto é exibido pode ser preenchido com uma cor ou ficar transparente. A fonte de caractere utilizada para exibir texto é ajustada para amoldar-se com a altura do retângulo quando o item for redimensionado.


 	Gráficos de barras unipolar e bipolar

Um gráfico de barra é um retângulo com uma parte colorida que representa o valor numérico da variável atrelada. Opcionalmente, o resto do retângulo pode ser preenchido com uma cor. Um gráfico de barra pode ser horizontal ou vertical.

Gráficos de barras unipolar podem crescer em qualquer direção: para cima, para baixo, à esquerda ou à direita.

Gráficos de barras bipolares na direção positiva ou na negativa, de acordo com o valor de variável atrelada. No caso de um gráfico de barra bipolar, o valor máximo permitido é o mesmo para ambas as escalas, positiva e negativa.


Curvas

É possível inserir uma curva em um documento. Uma curva mostra a história da variável atrelada. Embora não seja uma ferramenta precisa de medida, pode dar informação útil de depuração sobre o sincronismo entre diversas variáveis.

Uma curva armazena os últimos 200 valores de uma variável. O número de amostras não é modificado quando o item de curva é redimensionado na disposição gráfica.


Ícones booleanos

Um item "ícone booleano" é utilizado para exibir um estado binário. Um arquivo ícone (.ICO) é definido para o valor FALSE ou 0. Outro ícone é para todos os valores diferentes de zero. Como o SpotLight não inclui um editor de ícone, os arquivos de ícone devem ser preparados com outra ferramenta.


Campos de bit

Um item "campo de bit" mostra em um painel gráfico os 32 bits de um valor inteiro. O bit menos significativo sempre é exibido à direita. Não é recomendado utilizar o campo de bit para outros tipos de dados como valores analógicos reais, já que a informação exibida pode conduzir a confusões.


Selecionar, mover ou redimensionar itens

A seleção de objetos gráficos é necessária para a maioria dos comandos de edição. O SpotLight habilita a seleção de um ou mais objetos existentes na área de gráfico. Para selecionar objetos, o botão "selecione" (botão com uma seta) deve estar ativo na barra de ferramentas de editor. Para selecionar um objeto, o usuário tem que simplesmente clicar sobre seu símbolo. Para selecionar uma lista de objetos, arraste o mouse na área de desenho para selecionar uma área retangular. Todos os objetos gráficos que estiverem dentro do retângulo de seleção são marcados como "selecionado". Um objeto selecionado tem desenhado pequenos quadrados pretos ao redor de seu símbolo gráfico.

Ao fazer uma nova seleção, qualquer objeto previamente selecionado passa a não selecionado. Para remover a(s) selecão(ões) existente(s), simplesmente clique duas vezes com o mouse sobre uma área vazia fora do retângulo que limita os objetos selecionados.

Para mover objetos, você tem que selecioná-los primeiro. Então coloque o cursor do mouse na borda do item selecionado e arraste para outro local.

Para redimensionar um objeto, você tem que selecioná-lo primeiro. Então coloque o cursor do mouse sobre um dos pequenos retângulos exibidos na borda de seleção, e arraste na direção apropriada para redimensionar o objeto. Figuras também podem ser redimensionadas. Neste caso, o bitmap ou metafile correspondente é esticado para amoldar-se ao novo retângulo de item especificado.


 	Agrupar itens / dissociar grupos

Você pode agrupar itens de forma que eles possam ser gerenciados como um item. Para compor um grupo, selecione os itens na disposição gráfica e execute o comando "Editar / Agrupar". O comando "Editar / Dissociar" é utilizado para restabelecer itens do grupo selecionado como separados.

Um grupo pode conter uma figura. Um grupo também pode conter outro grupo.

Quando itens são agrupados, os seus estilos não podem mais ser modificados. Itens do grupo são ainda exibidos, mas não podem ser utilizado (com duplo clique) para modificar o valor de variáveis fixas.

Um grupo aparece só como uma linha na disposição de lista.


Definindo a formatação do item

O estilo gráfico e as configurações de um item existente podem ser modificados, clicando duas vezes sobre o seu símbolo na área gráfica, ou executando o comando "Edita / Determinar estilo do item" quando o item é selecionado em disposição gráfica ou de lista. A caixa de diálogo "Estilo" também é aberta quando um novo item é acrescentado ao documento. Agrupa os seguintes pedaços de informação a ser selecionado pelo usuário:

Estilos e configurações do gráfico:

O estilo de exibição (texto único, gráfico de barra, curva…) de um item pode ser modificado dinamicamente. Quando as cores de primeiro plano e de fundo são utilizadas, elas podem ser personalizados utilizando as caixas correspondentes. Quando estilo é "ícone booleano", o nome do caminho de arquivos.ICO correspondentes tem que ser especificado. Utilize os botões "…" perto destes controles para varrer os arquivos ícone existentes no disco.

Lógica:

Este é o valor máximo que pode ser exibido em gráficos de barra e curvas. Para gráficos de barra bipolares e curvas, o mesmo valor absoluto é utilizado para o eixo positivo e negativo.

Nome da variável:

Quando o campo "Nome" é o campo ativo, pressionando o botão "…" botão perto do controle de edição permite que o usuário localize os nomes das variáveis declarados no dicionário de projeto.

Legenda:

Uma legenda pode ser exibida perto de um item gráfico em disposição gráfica. Você pode personalizar o local do texto da legenda (topo, em baixo, esquerda ou direita) e seus conteúdos. Legenda pode ser qualquer combinação do nome variável e seu valor formatada como texto. A personalização de legenda não tem nenhum efeito em disposição de lista.

Variável de comando:

Se a opção "Variável de comando" está configurada, o usuário pode modificar o valor da variável atrelada durante a depuração clicando duas vezes sobre o item símbolo gráfico.


Comandos do menu "Arquivo"

O menu "Arquivo" contém os comandos que permitem o usuário gerenciar o documento completo.

O comando "Novo" do menu  "Arquivo" começa a edição de um novo documento. O número de documentos definido para um projeto não está limitado pelo ISaGRAF. Antes de editar o novo gráfico, o anteriormente aberto é fechado. O SpotLight não pode ser utilizado para editar vários gráficos ao mesmo tampo. Porém, podem ser abertas várias janelas SpotLight simultaneamente com cada uma editando um documento diferente.

O comando "Abrir" do menu "Arquivo" permite que o usuário feche o documento atualmente editado e comece a editar outro documento do projeto atual. O novo documento selecionado substitui o atual na janela de edição. Ao selecionar o novo documento, o botão "Apagar" pode ser utilizado para apagar um arquivo existente para limpar o diretório de projeto. Os arquivos ícone e bitmap referenciados em um gráfico não é apagado quando este o é.

O comando "Salvar" do menu "Arquivo" armazena o documento atualmente editado no disco. Se é um novo documenta sem título, o usuário tem que dar um nome antes de salvá-lo. O nome de um documento tem que estar conforme as seguintes regras :

•	O comprimento do nome não pode exceder 8 caracteres

•	O primeiro caractere deve ser uma letra

•	Os seguintes devem ser letras, algarismos ou o caractere de sublinha "_"

•	O nome não faz distinção entre maiúscula/minúscula

O comando "Salvar como" do menu "Arquivo" permite que o usuário armazene o documento atualmente editado com outro nome.


Apresentação da lista

A qualquer momento você pode trocar da disposição gráfica para de lista, e vice-versa, pressionando este botão. Você também pode utilizar o comando  "Opções / Visualização Por lista/Gráfica".

Na disposição de lista, são mostrados itens em uma caixa de lista clássica. A altura de cada item é calculada de acordo com seu estilo de desenho. Figuras (bitmaps e metafile) não são visíveis a partir da disposição de lista. Uma seleção está disponível na disposição de lista, e deveria ser utilizado para configurar estilo de item ou modificar o valor de uma variável. Seleção múltipla e comandos que a utilizam não estão disponíveis neste modo.

 	Você pode reordenar os itens na lista que utiliza os comandos  "Editar / Mover para cima na lista" ou "Editar / Mover para baixo na lista". O item a ser movido deve ser selecionado na lista.


Nota para usuários do ISaGRAF V3.2

SpotLight pode ler gráficos e listas de diagramas de tempo construídos com as ferramentas ISaGRAF V3.0 ou V3.2. Tais arquivos aparecem na caixa de diálogo "Abrir", com a descrição de suas origens. Os arquivos podem ser lidos e livremente modificados com o SpotLight.

Ao abrir um gráfico ISaGRAF V3.2, o documento é automaticamente marcado como "Travado". Remova a opção "Travar" do menu "Arquivo" se você quiser fazer mudanças no gráfico.

Quando um gráfico ISaGRAF 3.2 ou lista de diagrama de tempo está aberta, o SpotLight sempre propõe salvá-lo em formato SpotLight nativo. A caixa de diálogo "Salvar Como" está sistematicamente aberta ao fechar tal documento.