LAquis 3.0Introduo para utilizao e desenvolvimento de aplicativos

Software Supervisrio

Apostila 17/7/2008

Leo Consultoria e Desenvolvimento de Sistemas Ltda http//:www.lcds.com.br leao@lcds.com.br

ndiceIntroduo .................................................................................................... 4 Passo a passo ............................................................................................. 5 1 Pontos de leitura e escrita (tags). ........................................................ 5 2 Arquivo / Relatrio ............................................................................... 9 3 Objetos visuais .................................................................................. 12 4 Script visual e texto ......................................................................... 19 Planilha de pontos de Leitura e Escrita (Tags)........................................... 21 Configurao da Comunicao................................................................ 24 Frmula na planilha de tags .................................................................. 25 Definio do arquivo................................................................................ 26 Drivers ....................................................................................................... 27 Selecionar um Driver ............................................................................... 29 Campos especiais do equipamento......................................................... 30 Relatrio / Histrico.................................................................................... 31 Relatrio principal.................................................................................... 31 Criar relatrios a partir do modelo ........................................................... 31 Planilhas para relatrio e anlise............................................................. 32 Frmulas e comandos para planilhas LGX .............................................. 34 Bancos LB ............................................................................................... 35 Opo LB (ODBC)................................................................................... 36 Campos (estrutura).................................................................................. 36 Conexo/Tipo do banco de dados ........................................................... 37 Editar (Abrir tabela) ................................................................................. 38 Rede .......................................................................................................... 39 Servidor ................................................................................................... 39 Cliente ..................................................................................................... 40 Comunicao em Rede ........................................................................... 41 Objetos Visuais .......................................................................................... 42 Objetos para desenhos vetoriais ............................................................. 44 Inserir Objeto Visual ................................................................................ 45 Configurao do Painel ........................................................................... 46 Exemplos de objetos visuais ................................................................... 47 Criao e alterao de objetos visuais 2D (personalizar) ........................ 52 Janela da interface 3D ............................................................................... 54 Objetos da planta 3D............................................................................... 55 Objeto (arquivo 3D) ................................................................................. 56 Parede..................................................................................................... 57 Painel 3D................................................................................................. 57 Cano 3D .................................................................................................. 58 Objeto Visual 3D...................................................................................... 58 Criao e alterao de objetos visuais 3D (personalizar) ........................ 59 Menu principal............................................................................................ 60 Opes (Preferncias) ............................................................................... 63 Senha ........................................................................................................ 64 Script (texto e visual).................................................................................. 652

Eventos ................................................................................................... 69 Browser................................................................................................. 70 Acessando os "tags" da planilha de E/S (Objeto TAG) ............................ 71 Variveis.................................................................................................. 72 Operaes bsicas.................................................................................. 73 Comandos e expresses bsicas ............................................................ 74 Objetos Visuais........................................................................................ 78 Objeto Painel........................................................................................... 79 Objeto Planilha ........................................................................................ 80 Exemplo (OnDepoisVarreduras).............................................................. 81 Exemplo - Evento Global (script texto)..................................................... 82 Funes e objetos de memria................................................................ 83 Objeto Tabela.......................................................................................... 87 Funes e objetos de arquivos e banco de dados................................... 89 Funes de texto ..................................................................................... 95 Funes matemticas............................................................................ 103 Funes de bits ..................................................................................... 107 Funes de tempo................................................................................. 108 Funes de aplicativo ............................................................................ 112 Funes de comunicao...................................................................... 114 Funes de janelas de mensagens ....................................................... 117 Objeto GRID.......................................................................................... 118 Comandos principais da planilha de relatrios....................................... 119 Outras funes e objetos....................................................................... 120 Declare (script texto) ............................................................................. 121

3

IntroduoNo LAquis possvel tanto realizar aquisies de dados como tambm desenvolver programas especficos para as mais diversas aplicaes. Script / opes dos objetos

Painel (objetos visuais)

Planilha de pontos de leitura e escrita (tags)

A tela principal se divide em duas partes: a parte inferior, onde fica a planilha de pontos de entrada e sada ("tags") e a parte superior, painel onde se programam os objetos visuais. Na planilha de "tags" so definidas as variveis, arquivos, equipamentos, frmulas, escalas ou outras proprieades e parmetros criados pelo usurio para cada caso. Os objetos visuais podem ser usados tanto para o desenvolvimento de sistemas especficos atravs de "script" como tambm para o acompanhamento simples de uma aquisio de dados. Cada objeto pode estar relacionado a uma linha da planilha (tags). Para a gerao de relatrios e grficos de leituras armazenadas basta "clicar" sobre o boto selecionar uma das opes do "menu" "Dados e Relatrios". possvel utilizar interface em 3D. Veja em no captulo Planta 3D (introduo). ou

Exemplos teis: Alguns exemplos de aplicativos podem usados para entender o uso do software supervisrio LAquis. Estes exemplos esto disponveis na pasta principal do LAquis (LAquis\Apls\Exemplos\*.lqs). Para acessar estes exemplos selecione, no LAquis, a opo Abrir do menu Arquivo. Alguns deles: - planta3d.lqs (exemplo de planta 3D) - modeloteste.lqs e modeloteste2.lqs (exemplos simples para teste das funes bsicas do sistema) - modbus_teste.lqs (exemplo para teste de um ponto de leitura usando o protocolo modbus rtu) - simularelatrio5.lqs (exemplo de uso de objetos visuais, telas e relatrios)

4

Passo a passoSero apresentados 4 passos bsicos: 1 Definio dos pontos de E/S (tags). 2 Arquivo / Relatrio 3 Objetos Visuais 4 Scripts visual e texto

1 Pontos de leitura e escrita (tags).Defina os pontos de leitura e escrita na planilha de tags situada na parte inferior da tela principal. Esta planilha contm as informaes necessrias para definir as informaes que sero lidas ou escritas nos equipamentos. Estes tags podem ser tambm variveis genricas. Alguns dos campos principais para cada tag so: Nome, Ttulo, Valor, Driver (Equipamento), Arquivo, Param1, Param2, etc.... Escolha os drivers dos equipamentos a serem usados na coluna Driver (Equipamento). O driver pode ser definido arrastando o ponteiro do mouse com o boto esquerdo pressionado sobre a coluna Driver, ou clicando sobre o ttulo da coluna Driver para selecionar todos os tags desejados.

Ao soltar o boto do mouse a janela driver ser mostrada:

Planilha de pontos de leitura e escrita ou tags. O driver a ser escolhido depende do equipamento (hardware) utilizado. Para testar o funcionamento do software sem equipamento utilize, por exemplo, o driver DEMO. 5

Se, por exemplo, desejar comunicar com um equipamento que utilize o protocolo Modbus rtu escolha o driver MODBUS RTU.ldriver. O Param1 fica sendo o nmero do registro e o Param2 o nmero do n (Exemplo: Param1=400001. Param2=1). Veja a descrio dos parmetros do driver Modbus no captulo Drivers. Configure a comunicao (porta, velocidade, temporizao, etc....) no boto Config da janela Driver ou na coluna Config da planilha. Ao pressionar o boto Config da janela Driver a seguinte janela ser mostrada para configurao da porta serial:

Configure as caractersticas da comunicao. Exemplo de configurao para porta serial COM1: 1:9600,N,8,1. (porta serial 1, velocidade 9600, paridade nenhuma, bits de dados 8, bits de stop 1). Se o driver for OPC, ao clicar sobre o boto Config ser apresentada uma janela para definio do ProgID e Item ID do servidor OPC (opcionalmente para conexes remotas coloque o IP do servidor no campo Servidor):

- Defina as outras caractersticas do tag. Neste exemplo foram colocados o nome (valor1), ttulo (Valor 1), unidade ( Param1 (400001) e C), Param2 (1):

6

Exemplo com quatro tags: (sero lidos os quatro primeiro registros holding do equipamento do n 1 atravs do protocolo Modbus)

Se desejar testar o software e no tiver equipamento conectado ao computador utilize, por exemplo, o driver DEMO:

Para iniciar a leitura dos valores e testar a comunicao clique sobre o boto (play Iniciar aplicao). Na barra inferior ser apresentada uma mensagem de atualizao dos tags. Os valores devero ser mostrados na coluna Valor. Se houver erro de comunicao aparecer nesta coluna a mensagem ERRO e na coluna Status Erro de leitura. Para fins de melhor visualizao neste teste, clique no boto situado na parte superior do software. para mostrar os visores no painel

Para desligar a comunicao pressione o boto

(stop Parar aplicao). 7

Para testar a alterao de algum valor no equipamento associado ao tag utilize a coluna Set. Tecle enter ou saia da clula para efetuar a alterao.

Os tags podem ser tambm variveis para diversos fins. Utilize, por exemplo, o driver VAR.

Opcionalmente, os tags podem possuir outras caractersticas personalizveis conforme a aplicao. Para isso utilize o boto ou a opo do menu Editar Pontos de leitura e escrita (Tags) Personalizar colunas de parmetros.

Novas colunas podem ser criadas para os tags. Estas colunas so colocadas no final ( direita) da planilha. Neste exemplo foram criados dois campos a mais LI, LS, Alarme, Acao, Ocorrncia e Resp. Para adicionar o campo digite o nome do campo ou selecione na lista direita e clique sobre o boto Adicionar. No necessrio que o campo exista na lista direita. possvel criar quaisquer nomes de campos que desejar, desde que no contenham espaos ou caracteres especiais. Estes campos podero ser armazenados no arquivo que ser mostrado na seo a seguir. Todavia os campos LI, LS e Alarme, usados neste exemplo, tm significados pr-definidos no LAquis. LI e LS so respectivamente um limite superior e um limite inferior. Alarme um campo que retorna a condio do valor ter ultrapassados os limites. Entretanto, no necessrio utilizar estes campos para limites. Pode-se criar outras maneiras de fazer a mesma coisa. Por exemplo, pode-se criar campos como LSCritico, LSSeguranca, LICritico, LISeguranca, etc.... e a partir disso programar o aplicativo para respeitar os valores conforme as especificaes do processo.

Mais detalhes veja o captulo Planilha de Pontos de E/S(Tags). 8

2 Arquivo / RelatrioOs valores lidos e controlados nos tags podem ser gravados em arquivo. Para isso clique sobre a coluna Arquivo. Da mesma forma que o driver, o arquivo pode ser definido arrastando o ponteiro do mouse com o boto esquerdo pressionado sobre a coluna Arquivo, ou clicando sobre o ttulo da coluna Arquivo para selecionar todos os tags desejados.

Neste exemplo, os valores dos quatro tags sero armazenados no banco de dados TESTE.LB:

O intervalo de tempo em que os valores sero armazenados definido na coluna Intervalo:

Clique no boto

para iniciar a leitura com a gravao no banco de dados.

Observao: os dados (leituras), como padro, so gravados na sub-pasta dados dentro da pasta do aplicativo lqs. O nome dos arquivos, como padro, fica sendo .LBX. Neste exemplo TESTE060608.LBX. Note que ser possvel reconfigurar o banco para outros tipos de banco de dados. Para alterar a configurao do banco de dados utilize a opo do menu Dados e Relatrios Banco de dados / Arquivo (LB/ODBC) / Exportao. 9

Se os campos Resp, Ocorrencia e Acao forem criados neste exemplo, eles podero ser do tipo texto. Para isso faa o seguinte: 1 Pressione o boto para parar a execuo. 2 Selecione o menu Dados e Relatrios Banco de dados / Arquivo (LB/ODBC). 3 Pressione o boto Campos. 4 V at os campos Resp, Ocorrencia e Acao. Na coluna Tipo coloque 1 Texto. 5 Pressione o boto OK e confirme a converso. Tendo alguns dados j gravados no banco de dados j possvel criar os relatrios. Um dos relatrios pode ser considerado o principal, e o que ser mostrado a seguir. Para gerar um relatrio dos dados gravados, clique sobre o boto Abrir relatrio principal (Histrico / Leituras). ou no menu Dados e Relatrios

Na primeira vez, nesta fase de desenvolvimento, aparecer uma janela para escolha do modelo do formato de relatrio:

10

Cada modelo de relatrio tem um fim especfico. Os formatos tambm podem ser criados e modificados conforme a necessidade da aplicao. Veja mais sobre os formatos de relatrio no captulo Gerao de Relatrios. Exemplo de modelo Amostragem: Exemplo de modelo Limites e ocorrncias (se os campos Resp, Acao e Ocorrencia forem usados como texto, neste caso possvel inserir informao de ocorrncias e aes no prprio relatrio e armazen-las no arquivo):

Exemplo de modelo Individual Simples: Se desejar fazer o grfico clique sobre o boto Grfico. Se quiser imprimir com vrias colunas para economizar folha, utilize a opo colunas no boto Imprimir.

Exemplo de modelo Individual Simples visualizando apenas o grfico:

O nome do formato do relatrio principal fica sendo Conexo .lgx. Neste exemplo fica sendo Conexo TESTE.lgx. Novos relatrios: Para criar novos relatrios utilize a opo do menu Dados e Relatrios Criar relatrio.... Para abrilos utilize o menu Dados e Relatrios Abrir relatrio... ou crie um boto associado ao relatrio criado (Veja o prximo passo objetos visuais). Novos formatos de relatrios: possvel tambm personalizar os relatrios e tambm criar novos modelos. Opo do Menu Dados e Relatrios Editar/desenvolver relatrio ou boto .

Veja mais detalhes sobre os relatrios no captulo Gerao de Relatrios e sobre os arquivos/banco de dados em Opo LB (ODBC). 11

3 Objetos visuaisNa parte superior da janela principal do software est situado o painel de objetos visuais. Neste painel so programados os objetos e controles visuais que podero servir de interface para o usurio. Selecione o objeto desejado e coloque no painel. Para isso clique sobre o cone do objeto na barra de ferramentas ou escolha o objeto na janela direita, na aba Objeto, quando nenhum objeto estiver sendo selecionado. Clique sobre o painel ou arraste o ponteiro do mouse com o boto esquerdo pressionado para desenhar o objeto.

Objeto displaytext (visualizao) Objeto LEditar (alterao de valores)

No exemplo acima foi adicionado um objeto displaytext, para visualizao de valores, e um objeto LEditar para alterao de valores. Cada objeto visual pode estar associado a um tag. Para isso clique duas vzes sobre o objeto ou selecione a propriedade Frmula do objeto.

Selecione o tag a ser associado ao objeto. No exemplo acima, o tag valor2. 12

Os objetos visuais tm diversas propriedades. No exemplo a seguir foi includo um boto uma vez sobre o boto aparecero suas propriedades na janela direita.

. Ao clicar

No exemplo acima foram alteradas as seguintes as propriedades Texto (com o valor Relatrio) e Relatrio (com o valor 1 Relatrio do tag). A propriedade Texto, neste caso, o ttulo do boto. A propriedade Relatrio com o valor 1 significa que ao pressionar o boto, ser mostrado o relatrio principal do aplicativo atual associado ao tag do boto. Outra propriedade importante do boto Comando. Quando o boto for pressionado o valor do tag relacionado ser o valor da propriedade Comando. Veja tambm as propriedades Pagina, PopupPagina e AlterarTag. Veja as propriedades do boto no tpico Exemplos de Objetos Visuais. Exemplo de objeto visual termmetro. Os limites superior e inferior podem ser associados planilha.

13

Exemplo de objeto visual Figura. Este objeto visual pode ter diversas finalidades. Botes de dois estados, informao de estado, simples ilustrao, etc.... No exemplo abaixo a Figura configurada como boto de duplo estado (propriedade Duplo estado):

Quando o aplicativo for executado este objeto visual se tornar como um boto (propriedade Clique altera). Ao clicar sobre este objeto, o estado do tag associado ser alterado para valores que alternam entre 0 e 1. Sua visualizao alterada conforme a propriedade Estado atual. O nome da figura deve ter o formato .emf ou bmp. Neste caso, vlvulaazul1.emf e vlvulaazul2.emf. O nmero de estados neste caso 2.

14

No exemplo abaixo a Figura configurada conforme um boto com animao (propriedade Duplo estado desmarcada):

Quando o aplicativo for executado este objeto visual tambm se tornar como um boto (propriedade Clique altera). Ao clicar sobre este objeto, o estado do tag associado ser alterado para valores que alternam entre 0 e 1. Mas quando a propriedade estado atual se torna 1 ento o objeto entra em estado de animao variando de 1 at o nmero de estados. O nome da figura tambm deve ter o formato .emf ou bmp. Neste caso, motorverde1.emf e motorverde2.emf. Para todos os casos se for desejada apenas a visualizao do sinal, sem a interveno do usurio, ento a propriedade Clique altera deve ser desmarcada. Para utilizao dos objetos 3D veja o captulo Janela da Interface 3D . Veja os exemplos modeloteste2.lqs e grupospginas.lqs para conhecer o objeto ObjetoPagina. Para criar novos objetos visuais utilize um dos trs editores: Script, 2D ou 3D. Mais detalhes sobre objetos visuais veja o captulo Objetos Visuais.

15

Para desenhar no painel utilizando objetos vetoriais clique sobre o boto

.

Clique duas vezes sobre o objeto para editar suas propriedades. Ser mostrada a seguinte janela:

possvel tambm associar o valor de tags para algumas das propriedades do objeto. Por exemplo, desenhe um objeto escala e desenhe um objeto polgono conforme abaixo:

Clique duas vezes sobre o objeto polgono para abrir suas propriedades. Clique sobre a clula da coluna tag associada coordenada MY (ponto mdio no eixo vertical do objeto). Selecione o tag e clique em OK.

Ao executar o aplicativo, a posio do polgono vai variar conforme o tag dentro da escala definida. Mais detalhes dos objetos vetoriais veja o tpico Objetos para desenhos vetoriais .

16

possvel definir grupos de objetos baseados em um painel padro. Uma das formas de fazer isso utilizando o objeto ObjetoPagina .

1 Defina objetos em uma das pginas do painel (a partir da pgina 1)

2 Associe os objetos aos tags. Podem ser tags dentro de um grupo. 3 Coloque (na pgina 0) o objeto ObjetoPagina. 4 Associe o objeto ObjetoPagina a um tag ou grupo.

Mais detalhes veja os exemplos modeloteste2.lqs e grupospginas.lqs.

Como editar ou criar novos objetos visuais?Existem 3 formas principais de se criar ou editar objetos visuais: 1 Script. 2 Editor 2D. 3 Editor 3D. 1 Script: Selecione o objeto. Clique sobre o boto Opes do Objeto. Para editar clique em Cdigo fonte. Para criar clique em Novo.... 2 Editor 2D: Menu Editar - Painel Editor de objetos 2D simples. Veja os exemplos disponveis no menu Arquivo Abrir. 3 Editor 3D: Menu Editar Interface 3D Editor de objetos 3D. Veja os exemplos disponveis no menu Arquivo Abrir. Os objetos 3D tambm podem ser arquivos do tipo X3D. Mais detalhes sobre objetos visuais veja o captulo Objetos Visuais.

17

Para edio de uma interface simples de planta em 3D, faa o seguinte: 1 Defina os painis colocando os objetos visuais a partir da pgina 1.

2 Na pgina 0 coloque os objetos vetoriais 3D para definir a planta.

Parede 3D

Painel 3D

3 Clique sobre o boto

. A interface ficar desta forma:

Mais detalhes sobre a utilizao dos objetos 3D veja o captulo Janela da Interface 3D Veja tambm o exemplo planta3d.lqs. Mais detalhes sobre objetos visuais veja o captulo Objetos Visuais.

.

18

4 Script visual e textoScripts so seqncias de instrues ou programas usados para personalizar as aes do aplicativo para atender o processo. Eles so executados dentro dos eventos disponveis no sistema. Existem dois tipos principais de script no LAquis: visual e texto. O script visual uma linguagem que funciona de forma grfica, anloga a um fluxograma. J o script texto uma linguagem semelhante ao Basic. Exemplo de Script Visual Exemplo de simples atribuio de valor a um tag usando o script visual (note que uma operao simples como a que ser usada neste exemplo no requer necessariamente o uso de script este exemplo ser apresentado apenas para entender o princpio do script). Coloque um boto no painel. Escolha a aba Linguagem Visual e selecione o evento OnClick. Selecione a opo comandos situada na barra de ferramentas:

Clique sobre a rea quadriculada. Ser mostrada uma janela com uma lista de comandos, funes e variveis disponveis. Selecione ento o TAG motor.

Clique em OK. 19

O editor da linguagem visual ter uma caixa relacionada ao tag motor. Ficar assim:

Selecione agora a opo nmero situada na barra de ferramentas:

Clique sobre a rea quadriculada. Ser colocada uma caixa relacionada a uma constante numrica:

Clique duas vezes sobre a constante, coloque o nmero 1 e tecle enter. A constante ser 1. Agora, para associar o valor da constante ao tag motor faa a seqncia de dois passos: 1 Clique sobre a ponta no lado direito da constante 1. 2 Clique sobre a ponta no lado esquerdo do tag motor. Vai ficar desta forma:

Est pronto o exemplo. O que vai ocorrer na execuo do aplicativo ser o seguinte. No momento que o usurio pressionar o boto, o tag motor ter o seu valor 1. Exemplo de Script texto Selecione a aba Script texto. Digite motor = 1.

Note que uma operao simples como esta, usada neste exemplo, no requer necessariamente o uso de script este exemplo foi colocado apenas para entender o princpio do script. A mesma coisa poderia ser feita, apenas colocando no objeto boto o valor 1 na sua propriedade Comando. As possibilidades que o script oferece so muitas. Operaes, condies, iteraes, etc... Para conhec-las estude o captulo Scripts. 20

Planilha de pontos de Leitura e Escrita (Tags)A programao de uma aquisio simples pode ser feita na planilha situada na parte inferior do programa.

Cada linha desta planilha pode ser um tag relacionado a um ponto de entrada ou sada conectado ao instrumento, frmula, varivel, etc... dependendo do driver. A planilha contm os seguintes campos (colunas) como "default" (podem-se criar quantas colunas forem necessrias a mais*):

Canal: Nmero do canal relacionado linha da planilha. Pode ser o n ou endereo fsico do equipamento ou apenas um identificador nmerico. Opcionalmente defina o n ou endereo do equipamento na coluna Param1 com a sintaxe n=;. Veja a coluna Param1. Nome: Nome do "tag". Ser o nome da varivel utilizada pela frmula, objeto visual ou script para acessar o seu valor. Se no houver nome o "tag" ser acessado por x. (Exemplo: x1) Para acessar outras colunas do mesmo tag utilize o ponto. (Exemplos: x1.setpoint, temperatura1 = x1.Fator*x2 ) Ttulo: Ttulo ou descrio do significado do "tag". Se o ttulo no estiver em branco este ser enviado para todos os objetos visuais relacionados linha. Esta descrio tambm ser armazenada ao lado de cada leitura armazenada no arquivo AQ ou LB separado no campo ttulo. Pode ser usado tambm como um comentrio de eventos no decorrer do processo de aquisio. [...] Unidade da grandeza Valor. Valor: Valor do "tag". Set: Valor do "Set Point" do instrumento ou entrada para alterao do valor do "tag". Param1 e Param2 Valores numricos de dois principais parmetros do instrumento. (Exemplo: Alarme1, Alarme2, Endereo, etc...). (Exemplo do Param1 no caso MODBUS: 400001) Status: Descrio do status atual da leitura. (Exemplo: Erro de leitura) Arquivo: Nome do arquivo ou banco onde as leituras sero armazenadas. Para alterar todos os arquivos no grupo selecionado clique sobre o cabealho "Arquivo". Mais detalhes sobre o arquivo veja aqui. Driver: Nome do "driver" ou instrumento conectado ao sistema ou, se o "tag" for apenas uma varivel, utilize VAR. Ao selecionar o "driver" possvel definir a configurao para comunicao. Veja a coluna "config" abaixo. Para alterar todos os drivers na planilha ou no grupo selecionado clique sobre o cabealho "Driver". Varreduras: Nmero mximo de leituras que sero armazenadas no arquivo. Tempo: Tempo mximo permitido de aquisio no arquivo. Intervalo: Intervalo de tempo entre cada gravao ou leitura (dependendo da opo definida em "Leitura contnua"). Inter. Alarme: Intervalo de tempo entre cada leitura de alarme. Incio: (opcional) Hora de incio da aquisio no formato hh:mm:ss. (ex: 9:00:00) Fim: (opcional) Hora de trmino da aquisio no formato hh:mm:ss. (ex: 12:00:00) Frmula: Frmula ou escala relacionada ao tag. O resultado da frmula ser constantemente atualizado em Valor. Se quiser utilizar uma simples escala utilize o smbolo * (Exemplo: *0.01). Para saber mais sobre o uso da frmula clique aqui. Config: Configurao da comunicao relacionada ao "tag". Se nada for preenchido ento adotada a configurao "default" definida no menu "Configurao" - "Porta". Caso seja OPC ento o formato servidor->item. Formato da configurao na coluna "config" para porta de comunicao: porta ou dispositivo:velocidade,paridade,bits de dados,bits de stop. Exemplo: COM1:9600,N,8,1. Esta configurao pode ser definida no momento em que for selecionado o "driver". 21

Indica se o "tag" estar em pausa ou no. Para desligar basta clicar novamente sobre o boto. Inicia a gravao do "tag" no arquivo relacionado. Para desligar basta clicar novamente sobre o boto. Parar a aquisio em todas as linhas da planilha.

Colunas opcionais: *Se for necessrio possvel criar colunas personalizadas definindo outras propriedades para os "tags". Estas colunas tambm podem ser gravadas no arquivo de aquisio se os campos tiverem sido criados. Exemplos: limites de segurana, nome do produto, ocorrncia, no conformidade, etc... Para criar novas colunas utilize a opo no menu "Editar" - "Colunas de parmetros". Estes nomes devem ser sucintos e de preferncia sem acento para que sejam fceis de acessar atravs de frmulas ou "scripts". Importante: Alguns dos nomes de colunas personalizadas esto reservados: - Alarme: Define valor do alarme para o "tag". "Default": 0 = Desligado; 1 = Maior que LS; 0 - Menor que LI. As colunas LI e LS so usadas como "default" para os limites. Opcionalmente para criar um outro critrio de alarme atravs de uma frmula digite o smbolo = e escreva a frmula nesta coluna. Exemplo 1: "=(x30)". Neste exemplo o alarme ser acionado se o valor do "tag" for menor que 10 ou maior que 30. Exemplo 2: "=(x.LSE)". Neste exemplo o alarme ser acionado se o valor do "tag" for menor que o valor na coluna LIE ou maior que o valor na coluna LSE. Para definir valores para cada expresso opcionalmente faa como este exemplo: =(x30)#3 (x>10)*(xitem.

Ao pressionar o boto "Config" a seguinte janela apresentada:

24

Frmula na planilha de tagsA frmula pode ser usada na planilha (coluna frmula) ou em objetos visuais. Tanto no script como na frmula possvel acessar os "tags" definidos na planilha atravs de seus nomes. Exemplos: Presso, Temperatura1.setpoint. Os "tags" que no possuem nomes definidos, seus valores relacionados s linhas e colunas da planilha podem ser usados atravs de variveis pr-definidas do tipo: x[.coluna] Exemplo de variveis pr-definidas: x - Valor da mesma linha. x1 - Valor da primeira linha. x2 - Valor da segunda linha. x1.setpoint - Setpoint do "tag" da primera linha. x3.produto - Coluna produto (criada pelo usurio) do "tag" da terceira linha. ... Exemplos de frmulas: x1*1.7 + 3 Celsius + 273.16 Farenheit > 100 O nome da varivel relativo ao "tag" tambm o mesmo definido na coluna Nome da planilha de programao.

Ex: Celsius + 273.16 Frmulas em geral: Os operadores so: + - * / > < >= >" (na janela Cliente&Servidor do "menu" "Arquivo"). Escolha um diretrio na rede que seja comum entre os microcomputadores clientes e servidor. Todos os micros devero ser capazes de ler e gravar neste diretrio. O nome do diretrio ser armazenado no arquivo LAquis.INI do "Windows" local ou no INI do LQS atual. 2 - Utilize o nmero do IP para comunicao via TCP. No servidor utilize a opo que se encontra no menu Arquivo - Servidor TCP. No cliente coloque o valor do IP ao invs de selecionar o nome.

41

Objetos Visuais

Os objetos visuais so dispostos no painel para o desenvolvimento de aplicativos especficos e tambm para o acompanhamento e controle dos "tags".

Consulte os Principais objetos visuais Consulte os Objetos para desenho vetorial .

Para associar o objeto a um "tag" (ou sua propriedade) clique duas vzes sobre o objeto, ou com o boto direito do "mouse" escolha a opo "Tag" do objeto (digite, se necessrio, uma frmula):

Se desejar associar o valor do "tag" utilize apenas "x1" ou o nome do "tag" (Exemplo: P1 ou nivel). Se quiser associar valores de outras colunas do mesmo "tag" utilize o ponto ou o "combo" ao lado do nome. (Exemplo: x1.param1 ou x1.setpoint). Se necessrio digite uma frmula. Consulte os Principais objetos visuais

42

Para alterar suas propriedades, clique sobre o boto "Opes do objeto" ou utilize a janela ao lado do painel. Para cada tipo de objeto, diferentes caractersticas podero ser alteradas como: cores, tamanhos de letra, casas visveis, alarmes, etc.

Os ttulos dos objetos so definidos pela coluna "Ttulo" da planilha de "tags". Se a clula do ttulo correspondente a um objeto estiver vazia ento a indicao ser "x". Exemplo: "x30", ou seja, este objeto est relacionado linha 30. Este nome (x30) poder ser usado em frmulas (x30*2 + 10). Para alterar o cdigo fonte do objeto visual utilize o boto Editar. Consulte os Principais objetos visuais Para se alternar entre a visualizao automtica e manual dos objetos visuais utilize o boto .

Viso automtica

43

Objetos para desenhos vetoriais

Objetos usados para desenhos vetoriais. Os objetos para desenhos vetoriais so tratados de forma diferente dos objetos visuais normais. A edio de objetos para desenhos vetoriais ativada atravs do boto Utilizao: 1 - Podem ser combinados para gerao de novos objetos visuais 2 - Plantas para gerao de interfaces em 3D. 3 - Animaes. 4 - Simples ilustraes. .

Tipos de objetos para desenhos vetoriais: Geral: Cano ou fio. (O cano pode ser usado na planta para interface em 3D tambm) Polgono. Elipse. Cubo (projetado em 2D). Cilindro (projetado em 2D). Retngulo com borda arredondada. Planta para interface em 3D: Parede 3D. Painel 3D. Objeto (arquivo) 3D. Gerao de objetos: Escala Texto simples Clique duas vzes sobre o objeto para editar seus atributos.

44

Atributos dos objetos para desenhos vetoriais:

Nome: Nome do objeto para desenho vetorial. Visvel: Visibilidade do objeto vetorial. Linha: Existncia da linha de contorno principal. Cor (da linha): Cor da linha de contorno principal. Espessura: Espessura da linha de contorno principal. Estilo: Estilo da linha de contorno principal. Preenchimento: Existncia do preenchimento do objeto. Cor (do preenchimento): Cor do preenchimento do objeto vetorial. Padro (do preenchimento): Padro do preenchimento do objeto vetorial. Preenchimento 2 (para gradiente): Existncia de gradiente de cor no preenchimento do objeto. Cor (do preenchimento 2): Cor destino do gradiente de cor no preenchimento do objeto. Dimenses: Atravs destas propriedades possvel associar as dimenses e posies do objeto aos "tags". A relao matemtica do valor da dimenso e o "tag" pode ser definida nas colunas "e.x1", "e.y1", "e.x2", "e.y2" ou na coluna escala. X1: Posio do lado esquerdo do objeto. Y1: Posio do lado superior do objeto. Largura: Largura do objeto. Altura: Altura do objeto. X2: Posio do lado direito do objeto. Y2: Posio do lado inferior do objeto. MX: Posio mdia do objeto na horizontal. MY: Posio mdia do objeto na vertical.

Inserir Objeto Visual

1 - Escolha um objeto da parte superior da tela, logo abaixo do menu, "clicando" no mesmo. Para um primeiro contato com o programa, recomendamos o visor com ponteiro ou o termmetro. 2 - Na rea limpa entre o "menu" e a planilha, segure o boto do "mouse" e arraste, gerando um 45

retngulo, soltando boto o "mouse" aps o trmino. O objeto escolhido dever aparecer dentro do retngulo. 3 - Ajuste a altura e a largura do objeto para melhor visualizao. 4 - Crie outros objetos, de forma similar. A cada objeto criado, o programa ir associ-lo a um canal de forma seqencial. 5 - Para associar manualmente o objeto visual a um dos canais da planilha: selecione o objeto, "clique" duas vezes sobre este e escolha o "tag". 6 - Para alterar as propriedades do objeto selecione o objeto, utilize a janela ao lado ou "clique" duas vezes sobre este e "clique" no boto "Opes do objeto...". Todo o objeto visual possui a propriedade Frmula. Exemplo: x1*2+5 onde x1 o valor da primeira linha da planilha de "tags". O valor apresentado pelo objeto ser o resultado da frmula. Se desejar associar o prprio valor do "tag" utilize apenas "x1" ou o nome do "tag" (Exemplo: temperatura1). Se quiser associar valores de outras colunas do mesmo "tag" utilize o ponto (Exemplo: x1.param1 ou x1.setpoint) Para alternar entre a visualizao automtica e manual dos objetos visuais utilize o boto .

Configurao do PainelConfigurao do painel de objetos visuais do LAquis:

Figura: esta opo permite selecionar uma figura de fundo para o painel (tela) atrs dos objetos visuais. Lado a lado: se esta opo estiver ativada, a figura disposta na tela lado a lado repetidamente. Se desativada, a figura ser disposta no canto superior esquerdo. Janela: Largura e Altura - possvel definir o tamanho da tela (em pixels) quando a aplicao for executada. Pr visualizao: se esta opo estiver ativada, possvel visualizar a figura selecionada na rea de trabalho no momento em que est sendo escolhida. Fundo normal: se esta opo estiver ativada, a cor da tela de fundo se torna cinza. Se desativada, o fundo recebe o preenchimento de um padro.

46

Exemplos de objetos visuaisSo estes alguns dos principais objetos visuais: DisplayText Mostrador de valores. LEditar Editor de valores. Figura Figura para fundo, duplo estado ou animao. Boto Boto de ativao de evento. LTexto Texto explicativo. LCombo Editor de valores com combo. MGrfico Grfico para acompanhamento em tempo real.

Barra Barra com limites. - TChave Chave de duplo estado. - Check Chave de duplo estado em formato de boto e luz. - Acrescenta Boto para acrescenta novo registro LB. - Lista Boto para listar registros LB. - Tanque Tanque de nvel. - Funil - Tanquefechado - PID Boto para controle PID sobre o "tag" relacionado. - Receita Boto para execuo de receita (tempos e "setpoints") sobre o "tag" relacionado. Gauge Gauge ponteiro analgico. Termometro Termmetro com escala. Mostrador digital Mostrador de valores numricos imitando LCD.

DisplayTextDisplayText Mostrador de valores (ou texto).

- Principais: Nome: Nome do objeto. 47

Frmula (tag): Nome do "tag" ou frmula indicando o valor associado ao objeto. Ttulo: Ttulo opcional do objeto. Cor: Cor do texto ou valor. Cor de fundo: Cor de fundo do objeto. Visibilidade: se 0 o objeto est invisvel, caso contrrio estar visvel. Pode ser includa uma frmula. (Exemplo x7>30) Atualizao: Menor intervalo de tempo, em milissegundos, da atualizao do objeto. - Especficas: Tamanho ttulo: Tamanho do ttulo do objeto. Borda: 1 - Utilizar borda ao redor do objeto. 0 - No utilizar borda. Formato: Formato do texto ou valor a ser visualizado no objeto. Exemplo: 0.2f Alinhamento: Alinhamento do texto. 0 - esquerda. 1 - centro. 2 - direita. 3 - preenchimento. Mostra Erro: 1 - Mostra informao de erro de leitura. 0 - Fica invisvel se houver erro de leitura.

LEditarLEditar Editor de valores (ou texto).

Propriedades: - Principais: Nome: Nome do objeto. Frmula (tag): Nome do "tag" ou frmula indicando o valor associado ao objeto. Ttulo: Ttulo opcional do objeto. Cor: Cor do texto ou valor. Cor de fundo: Cor de fundo do objeto. Visibilidade: se 0 o objeto est invisvel, caso contrrio estar visvel. Pode ser includa uma frmula. (Exemplo x7>30) Atualizao: Menor intervalo de tempo, em milissegundos, da atualizao do objeto. - Especficas: Texto: Texto do editor de valores. Tamanho: Tamanho do texto. Se 0 o tamanho fica sendo proporcional altura do editor. Transparente: Se 1 o fundo transparente. Alinhamento: Alinhamento do texto. 0 - esquerda. 1 - centro. 2 - direita. 3 - preenchimento. Fonte: Fonte do texto. Bold: 1 - Texto em negrito. 0 - Texto normal. Itlico: 1 - Texto em itlico. 0 - Texto normal. Borda3D: Se 1 desenha uma borda ao redor do objeto. Editar: Se 0 no permite a editar o valor. Normalmente est em 1. EditarTexto: Texto que aparece na janela opcional de edio (dois cliques). Comando: Comando interno a ser enviado para a planilha de "tags". Formato: Formato do texto a ser visualizado no objeto. Exemplo: %0.2f Planilha: Se 0 o valor objeto no atualizado conforme o "tag" na planilha. Normalmente est em 1. Mximo: Mximo valor numrico permitido. Mnimo: Mnimo valor numrico permitido.. Passo: Passo numrico a ser usado no "spin" da janela opcional de edio (dois cliques). Editor: Se 0 no utilizado o editor no painel e sim apenas a janela de edio. Normalmente est em 1.

48

FiguraFigura Figura para fundo, duplo estado ou animao.

Se a figura estiver associada a um "tag" ento seu valor 1 ou 0 ir determinar se a figura estar em estado de animao, duplo estado ou parada. Para definir uma animao ou duplo estado, utilize arquivos com valores numricos aps seus nomes. Exemplo: Motor001.emf, Motor002.emf e Motor003.emf. A propriedade Estados define o nmero mximo de estados ou quadros para animao. Veja o exemplo canos1.lqs. Propriedades: Nome: Nome do objeto. Frmula (tag): Nome do "tag" ou frmula indicando o valor associado ao objeto. Transparente: Se selecionado o fundo transparente. Tamanho fixo: A figura mantm seu tamanho original fixo. Borda: Desenha uma borda ao redor da figura. Visibilidade: se 0 o objeto est invisvel, caso contrrio estar visvel. Pode ser includa uma frmula. (Exemplo x7>30) Estados: Nmero mximo de estados habilitados para a figura. (0 .. n) Estado atual: Nmero do estado atual (se houver mais de um estado). Duplo estado: Define se os estados compreendem uma animao ou apenas dois estados. "Clique" altera: Alterna o valor do "tag" associado ao objeto em 1 ou 0 se o usurio clicar sobre figura. Antialias: Suaviza as linhas do "metafile". Utilize a caixa abaixo das propriedades para escolher a figura.

49

BotoButton Boto de ativao de evento.

Propriedades: - Principais: Nome: Nome do boto. Frmula (tag): Nome do "tag" ou frmula indicando a linha da planilha de "tags" associada ao boto. Cor: Cor do boto. Visibilidade: se 0 o boto est invisvel, caso contrrio estar visvel. Pode ser includa uma frmula. (Exemplo x7>30) - Especficas: Texto: Texto que ser mostrado no boto. Comando: Valor que ser colocado no "tag" associado ao boto. Margem: Largura da borda em alto relevo do boto. Letra: Tamanho da fonte que ser usada no texto mostrado no boto. Cor do texto: Cor do texto mostrado no boto. Bold: Tipo da letra do texto mostrado no boto: 1 - Negrito. 0 - Normal. Pagina: Numero da pgina que ser selecionada no painel de objetos visuais quando o boto for pressionado. o mesmo que usar o comando script Painel.Pagina = pgina. Relatrio: Se for preenchido pode assumir dois tipos valores: a) Se for 1 ento ao pressionar o boto ser mostrado o relatrio .lgx "default" da linha da planilha de "tags" associada ao boto. b) Nome do relatrio .lgx que ser apresentado pressionar o boto. PopupPagina: Numero da pgina do painel que ser acionada como popup quando o boto for pressionado. o mesmo que usar o comando script Painel.Popup(pgina). AlterarTag: Altera os tags dos objetos da pgina escolhida para o tag ou grupo do boto. A pgina pode ser escolhida na propriedade Pagina ou PopupPagina. o mesmo que usar o comando script Painel.AlteraTodosOsTagsDaPagina(pgina,nome).

MGrficoMGrafico Grfico para acompanhamento em tempo real.

Propriedades: - Principais: Nome: Nome do objeto. Frmula (tag): Nome do "tag" ou frmula indicando o valor associado ao objeto. Ttulo: Ttulo opcional do objeto. 50

Cor: Cor da primeira curva. Cor de fundo: Cor de fundo do grfico. Visibilidade: se 0 o objeto est invisvel, caso contrrio estar visvel. Pode ser includa uma frmula. (Exemplo x7>30) Atualizao: Deve ser sempre 0. No caso do grfico utilize a propriedade "Sampling". - Especficas: Mximo: Mximo valor superior da escala no eixo Y. Mnimo: Mnimo valor inferior da escala no eixo Y. Auto Escala: Se 1 a escala automtica. Seno os limites Mximo e Mnimo sero usados. Cor da Grade: Cor da grade na parte interior do grfico. DivisesX: Nmero de divises na escala do eixo X. DivisesY: Nmero de divises na escala do eixo Y. Pontos: Nmero mximo de pontos permitidos no grfico. Reinicia: Se 1 as curvas so apagadas e o grfico pode reiniciar o acompanhamento. FormatoTempo: Formato em que os valores de tempo no eixo X sero mostrados. Exemplo: hh:nn:ss DeltaTempo: Intervalo mximo de tempo que os valores sero mostrados no grfico. CorTexto: Cor dos nmeros e textos no grfico. Sampling: Menor intervalo de tempo, em milissegundos, da atualizao do grfico. Somente no caso deste grfico de acompanhamento deixe a propriedade Atualizao em 0 e utilize o "Sampling". Espessura: Espessura das linhas do grfico. Borda: Se 1 desenhada uma borda 3D ao redor do grfico. TamanhoLetra: Tamanho das letras e dos nmeros colocados no grfico. TamanhoTtulo: Tamanho do ttulo colocado sobre o grfico. Cor2: Cor da curva 2. Cor3: Cor da curva 3. Cor4: Cor da curva 4. Cor5: Cor da curva 5. UsarLegenda: Se 1 a legenda (definida nas propriedades abaixo) mostrada. Legenda1: Texto da legenda para curva 1. Legenda2: Texto da legenda para curva 2. Legenda3: Texto da legenda para curva 3. Legenda4: Texto da legenda para curva 4. Legenda5: Texto da legenda para curva 5. FixoX: Se 1 fixa o eixo X, seno realiza a rolagem como se fosse um papel.

51

Criao e alterao de objetos visuais 2D (personalizar)Existem duas maneiras de se criar ou editar objetos e controles visuais 2D: - Editor de objetos visuais 2D simples: Menu Editar Painel Editor de objetos visuais 2D simples. - Editor de objetos script texto: Clique duas vezes sobre o objeto. Selecione opes do objeto. Clique em Cdigo fonte. Os arquivos de objetos 2D ficam preferencialmente dentro da pasta objs (c:\Arquivos de Programas\LAquis\objs\....\..).

52

Planta 3D (introduo)

O LAquis oferece a possibilidade de gerar interfaces em 3 dimenses. Defina uma planta em 2 dimenses e associe os tags correspondentes:

A planta ento transformada em uma interface 3D: (boto

)

53

Janela da interface 3DPara acessar a janela da interface 3D utilize o boto . Se desejar iniciar a tela automaticamente ao iniciar o aplicativo marque a opo Mostrar planta 3D ao iniciar no menu Configurao Opes.

No modo geral, onde a cmera est posicionada de forma a ter um panorama geral da planta 3D, "clique" com o boto esquerdo do "mouse" sobre a rea da qual se deseja aproximar. Se desejar, utilize opcionalmente o "Mapa" para posicionar a cmera. Para mover a cmera arraste com o ponteiro do "mouse" sobre a interface 3D com o boto do "mouse" pressionado quando o cursor estiver sobre o cho ou pressionando o boto direito. Durante a execuo, para "clicar" sobre um objeto utilize o boto esquerdo do "mouse". No exemplo planta3d.lqs, disponvel na pasta do LAquis, possvel "clicar" sobre os motores, vlvulas, chaves e painis. Botes principais: Grava (ou edita) posies pr-definidas da cmera. Geral: Posiciona a cmera para um panorama geral da planta 3D. Para se aproximar de alguma rea especfica "clique" com o boto esquerdo do "mouse" sobre a interface 3D ou clique sobre o boto de posio da cmera pr-definida. Mapa: Planta em 2D para posicionar a cmera. < ou >: Vira a cmera para esquerda ou para a direita. Atualizao: Seleciona o intervalo de tempo em milissegundos entre cada atualizao da interface 3D durante a execuo. Gerais: Inicia o aplicativo. Pra o aplicativo. Inicia o aplicativo com a opo de gravao em arquivo ou banco de dados. Relatrio dos dados gravados no banco. 54

Objetos da planta 3DOs objetos de desenho vetorial para a planta 3D so: Parede 3D. (obrigatrio para a gerao de interfaces 3D) Painel 3D. Objeto 3D. Cano.

Objetos visuais 3D tambm podem ser gerados a partir de script texto conforme os objetos visuais normais. Veja tambm: Exemplo disponvel na pasta do LAquis: "planta3d.lqs"

55

Objeto (arquivo 3D)Objeto (arquivo) 3D: Define um objeto lido de um arquivo. O arquivo pode ser .objeto3d, padro .x3d ou .lobj3d.

Para criar novos objetos 3D utilize o programa editordeobjetos3D.exe na pasta do LAquis. Se desejar utilizar outros softwares para criao de objetos 3D utilize o formato X3D (exemplo Blender). Para escolher o arquivo ou alterar outras propriedades clique duas vzes sobre o objeto 3D.

Arquivo: Nome do arquivo objeto3d ou x3d. Cor base: Altera a cor principal do objeto 3D. Tag (opcional): Associa o objeto 3D ao tag escolhido. Estados: Nmero de estados para animao. Os estados so definidos pelo nmero no nome do arquivo (exemplo vlvula1.x3d e vlvula2.x3d). Estado: Nmero do estado atual do objeto. Varia de 1 a nmero de estados. Se o valor do tag for diferente de 0 o objeto estar em animao. Duplo estado: Altera entre estado 1 e 2 quando o objeto 3D for "clicado" (alterando tambm o tag). Se no estiver ativado ento utilizada a animao de 1 at o nmero de estados. Se o valor do tag for 0 o objeto estar em estado 1. Se no seu estado ser 2. Pgina para edio do tag (opcional): Associa o objeto 3D a uma pgina (tela) do painel. Veja tambm: Exemplo disponvel na pasta do LAquis: "planta3d.lqs"

56

ParedeParede 3D: Define as paredes na interface 3D. Obrigatrio para a gerao de interfaces em 3D.

As paredes tambm delimitam o tamanho da planta.

Painel 3DPainel 3D:

Define um painel com os objetos visuais definidos em uma das pginas ou telas do painel principal. Para escolher a tela/pgina ou alterar outras propriedades clique duas vzes sobre o painel 3D.

57

Tela a ser associada ao bloco 3D: Esta pgina ser colocada em um cubo 3D representando o painel. Tag (opcional): Associa os objetos visuais da pgina ao tag (ou grupo) especificado.

Cano 3DCano. Define um cano 3D conforme a figura abaixo. Para alterar a cor ou espessura clique duas vzes sobre o cano 3D.

Objeto Visual 3DObjetos visuais 3D podem ser gerados atravs de script texto da mesma forma que os objetos visuais normais.

Exemplo

Pasta3D\tanque3d:

58

Criao e alterao de objetos visuais 3D (personalizar)Existem duas maneiras de se criar ou editar objetos e controles visuais 3D: - Editor de objetos 3D: Menu Editar Painel Interface 3D - Editor de objetos 3D. (formato lobj3d) - X3D: O software aceita objetos no formato X3D. Este formato pode ser gerado por diversos aplicativos de design 3D. (Exemplo Blender). Os arquivos de objetos 3D ficam preferencialmente dentro da pasta Plan3D (c:\Arquivos de Programas\LAquis\Plan3D\....\..).

59

Menu principalArquivo Novo Abrir Abre o arquivo LQS. Este arquivo (em conjunto com ELS INI LQX) contm todas as informaes especficas de uma aplicao. Salvar Salva o arquivo LQS. Se no houver arquivo nenhum aberto ento necessrio digitar o seu nome. Salvar Como Salva o arquivo LQS obrigando a digitao do seu caminho e nome. Distribuio/Executvel Gerao de executvel para distribuio da aplicao. Cliente Servidor Opes para comunicao em rede atravs de arquivos ou cliente TCP. Servidor TCP Servidor de comunicao em rede atravs de TCP. Editar Copiar Copia para a rea de transferncia as clulas selecionadas na planilha de "tags" ou os objetos visuais marcados. Colar Cola da rea de transferncia sobre a planilha de "tags" ou objetos visuais, dependendo de quem est selecionado no momento. Personalizar colunas de Parmetros Insere colunas a mais na planilha de "tags". Estas colunas podem ser novas propriedades ou outras variveis do mesmo "driver". Veja mais detalhes sobre a Planilha de "Tags". Acrescentar linha (tag) Acrescenta uma linha na planilha de tags. Pode ser feito manualmente na prpria planilha. "Driver" / Equipamento do tag Altera o "driver" ou tipo do tag da linha selecionada. Pode ser feito manualmente na prpria planilha clicando sobre a(s) clula(s) na coluna "driver" correspondente ao tag desejado. "Driver" / Equipamento do grupo Altera o "driver" ou tipo do tag do grupo selecionado ou de todos os tags. Pode ser feito manualmente na prpria planilha clicando sobre o ttulo da coluna "driver". Bloquear "split" Bloqueia o "split" que divide o painel de objetos visuais e a planilha de "tags". Outras opes da planilha de tags Abre um menu com opes de edio da planilha de "tags". Se desejar utilize o boto direito do "mouse" sobre a planilha. Outras opes da grupo de tags Abre um menu com opes de edio do grupo de "tags". Se desejar utilize o boto direito do "mouse" sobre as abas abaixo da planilha. Desenho (Objetos vetoriais / Planta para interface 3D) Passa para o modo de edio dos objetos de desenho. Estes podem ser usados para criar a planta

Para trs Passa o objeto visual marcado para trs dos outros objetos. Para frente Passa o objeto visual marcado para frente dos outros objetos. Selecionar Tudo Seleciona todos os objetos visuais. Trancar objetos Bloqueia ou desbloqueia no painel a movimentao dos objetos visuais na edio. Trancar figuras Bloqueia ou desbloqueia no painel a movimentao das figuras. Estas ficam em segundo plano permitindo editar os outros objetos visuais. Apagar objeto do painel Apaga o objeto visual marcado. Grade Define o tamanho da grade no painel para desenho dos objetos visuais. Pgina 60

3D.

Seleciona a pgina do painel de objetos visuais. Podem ser utilizadas as abas abaixo da barra de ferramentas. Tabela de objetos visuais Passa do modo de visualizao por painel de objetos visuais para tabela automtica (e vice-versa). Nomes dos objetos Permite editar em uma planilha os nomes, associaes e posies dos objetos visuais do painel. Janela da interface 3D... Abre a janela da interface 3D se houver planta definida. Editor de objetos 3D Abre o editor de objetos 3D para serem usados na interface 3D. Para usar os objetos criados utilize na planta 3D o objeto 3D. Opes do objeto visual Seleciona a pasta de opes e propriedades do objeto visual no canto direito do painel. Script visual (Linguagem visual) Seleciona a pasta da linguagem (script) visual no canto direito do painel. Script texto Seleciona a pasta do "script" texto no canto direito do painel. Selecionar "driver" ou tipo do tag Altera o "driver" ou tipo do tag da linha selecionada. Pode ser feito manualmente na prpria planilha clicando sobre a(s) clula(s) na coluna "driver" correspondente ao tag desejado. Desenvolver novo driver (ldriver) Abre o editor LDriver para desenvolvimento de "drivers". Drivers (Script texto e ldriver) Abre o editor de "drivers" no formato "script" texto e ldriver. Janelas da linguagem visual (LVarObj) Mostra todas as janelas do script visual "LVarObj" ativas na aplicao. Mais detalhes sobre "script" visual aqui. Fecha todas as janelas (LVarObj) Fecha todas as janelas do script visual "LVarObj" ativas na aplicao. Compilar tudo (script texto) Compila o script texto de toda aplicao atual gerando um arquivo compilado LQX. Execuo Iniciar aplicao Inicia a aplicao atual (sem necessariamente ligar a gravao em arquivo). Iniciar gravao Inicia a aplicao atual ligando automaticamente a gravao em arquivo se houver. Parar aplicao Pra a aplicao atual. OPC Cliente Mostra uma janela com as conexes atuais OPC cliente. Dados e Relatrios Abrir Relatrio (Histrico / Leituras) Abre a janela de relatrios ou planilha de leituras gravadas em arquivo. Criar relatrio... Cria relatrios a partir de modelos pr-definidos. Abrir outro relatrio.... Abre o relatrio com o formato (planilha LGX) especificado. Editar/desenvolver relatrio (Planilhas para anlise) Abre a janela da planilha LGX para edio de modelos de relatrio e anlise de dados. Banco de Dados / Arquivo (LB / ODBC) / Exportao Abre a janela para edio manual das estruturas de bancos LB e ODBC. Configurao Equipamento (driver) Abre uma janela contendo as variveis disponveis no driver da linha selecionada na planilha de "tags" Alterao de senha Permite criar ou alterar senha para proteo da edio da aplicao atual. Protegido Protege a aplicao atual impedindo digitao na planilha de "tags" e outras opes. Tempo entre varreduras Define um intervalo de tempo adicional em milissegundos entre as varreduras. Este intervalo de tempo geralmente 0 (inexistente). Tempo da animao 61

Define o intervalo de tempo em milissegundos entre cada quadro das animaes. Tempo do evento "OnTimer" Define o intervalo de tempo em milissegundos em que o evento "OnTimer" ser executado novamente. Nmero mximo de pontos (tags) Define o nmero mximo de pontos da planilha de "tags". Painel Configurao de propriedades visuais do painel. Porta Configurao da comunicao global para todos "tags" na planilha que no tiverem sido configurados. Utilize a coluna "config" na planilha para configurar individualmente. Opes Opes e preferncias gerais. Botes: Abrir: Abre o arquivo LQS. Este arquivo (em conjunto com ELS INI LQX) contm todas as informaes especficas de uma aplicao. Salvar: Salva o arquivo LQS. Se no houver arquivo nenhum aberto ento necessrio digitar o seu nome. Abrir relatrio/histrico principal: Abre a janela de relatrios ou planilha de leituras gravadas em arquivo. Editar/desenvolver relatrio - planilhas para anlise: Abre a janela da planilha LGX para relatrio e anlise de dados. Iniciar aplicao: Inicia a aplicao atual (sem necessariamente ligar a gravao em arquivo). Parar aplicao: Pra a aplicao atual. Iniciar gravao: Inicia a aplicao atual ligando automaticamente a gravao em arquivo se houver. Tabela de objetos visuais (automtica): Passa do modo de visualizao por painel de objetos visuais para tabela automtica (e vice-versa). Desenho (objetos vetoriais e 3D): Modo de edio usando objetos vetoriais para desenho ou planta 3D.

62

Opes (Preferncias)Menu "Configurao" - "Opes" Estas opes devem ser alteradas com muito cuidado. As alteraes podem alterar o desempenho do sistema. - Armazenar dimenses do grfico: Mantem as ltimas dimenses das janelas do grfico aps seu fechamento. Padro: Ativada. - Utilizar arquivo compilado: Se existir o arquivo LQX correspondente aplicao atual ento este usado para sua execuo. Seno a compilao realizada a cada incio da aplicao. Padro: Ativada. - Arquivo referenciado pelo canal: Define a chave primria dos arquivos de leitura como sendo o nmero do canal do "tag". Seno usado o nome do "tag" Padro: Ativada. - Armazenar colunas especiais: Armazena nos arquivos de leitura as colunas de parmetros especiais se existirem os campos no banco LB. Estas colunas so definidas no menu "Editar" - "Colunas de Parmetros". Padro: Ativada. - Todos os processos em paralelo: Toda a comunicao com o equipamento externo definido nos "drivers" executada em tarefa "thread" separada. Alm de melhorar o desempenho do sistema possvel utilizar mais de uma porta de comunicao no mesmo instante. Padro: Ativada. - Aguardar leitura aps algum "set": Marca o "tag" no estado "Aguarde" durante o perodo de tempo em que esta sendo "setado". Padro: Ativada. - Ler valor aps algum set: Fora leitura do tag logo aps toda vez que for alterado. Padro: Ativada. - Forar o set sncrono: Executa a alterao dos tag entre as varreduras sem interromper as tarefas em paralelo. Padro: Desativada. - Forar o set assncrono: Fora a execuo da alterao dos tag imediatamente interrompendo as tarefas em paralelo. Padro: Desativada. - No realizar primeira gravao: Esperar o tempo definido na coluna "Tempo" para gravar a primeira varredura no arquivo de leituras. Seno em todo incio de aplicao gravada uma varredura. Padro: Desativada. - Alterar dados dos subitens conforme "tag" principal: Ao alterar um "tag" que possui subitens identados abaixo, seus dados correspondentes so alterados para o mesmo valor tambm. Padro: Desativada. - LOG das alteraes: Grava no arquivo LOG.TXT as aes realizadas pelo usurio ou "sets" realizados pelo sistema. Padro: Desativada. - Mostrar posio da varredura: Mostra o "tag" sendo atualizado no momento na planilha. Padro: Desativada. - Mostrar planta 3D ao iniciar: Mostrar a janela com a planta 3D no incio da execuo do aplicativo. Padro: Desativada. - Objeto invisvel se houver erro na comunicao: Torna o objeto invisvel quando ocorre erro de comunicao no tag associado. Padro: Ativada.

63

SenhaPara proteger algumas opes do "LAquis" possvel utilizar uma senha. Esta senha definida na opo "Alterao de senha" no menu "Configurao".

Para alterar a senha: Digite a senha antiga no texto superior. Se esta no existe deixe em branco. Digite a senha nova repetindo-a nos dois espaos reservados abaixo.

64

Script (texto e visual)LCDS - Basic Script Para criar aplicaes avanadas o LAquis oferece duas opes de desenvolvimento: - Script Visual: linguagem visual (LVAROBJ). - Script Texto: linguagem semelhante ao Basic. Script Visual:

- Script Texto:

Nestas linguagens possvel acessar os "tags" definidos na planilha atravs de seus nomes. No script texto se no houver nome definido na planilha utilize x. (Exemplo x1) Se desejar acessar outras colunas dos "tags" utilize o ponto. (Exemplo x1.setpoint) Exemplo: Crie um boto. Programe sua ao atravs do script. Execute a aplicao. Ao clicar neste boto o script programado ser executado.

OBS: Os "drivers" de comunicao tambm podem ser desenvolvidos atravs de "script" ou da linguagem "ldriver". 65

Script VisualO script visual (LVAROBJ) permite desenvolver programas atravs de uma linguagem visual. Cada objeto visual corresponde a um comando, operao, constante, varivel, etc... No exemplo abaixo o valor 7 colocado no tag x2. A sintaxe equivalente no script texto x2=7.

Os pinos de sadas dos valores sempre ficam direita do objeto. Os pinos de entrada ficam esquerda.

66

Objetos principais disponveis para utilizao: Acessa os objetos e comandos do LAquis. Escolha atravs do "browser". "Browser" de objetos:

"Browser" de comandos:

67

Constante numrica. Constante texto. Invoca um outro arquivo .LVAROBJ LVAROBJ) LVAROBJ) Varivel nmero (pode ser utilizada como parmetro de entrada ou sada de um arquivo Varivel texto (pode ser utilizada como parmetro de entrada ou sada de um arquivo

Vai para (ou GoTo). Flecha que aponta para o prximo passo ou comando. Comentrio simples. Operaes matemticas bsicas: Realiza a operao entre as duas entradas e retorna o resultado. retorna o resultado. Executa a funo matemtica sobre a entrada e

Executa a frmula digitada. As variveis antes do simbolo "=" so sadas e as outras variveis so entradas. Executa uma funo desenvolvida em "script" texto no evento . Digite o nome da funo (parmetros). Outras operaes: Concactena as duas entradas texto.

Define um bloco condicional. Se a entrada recebe 1 ento o interior do bloco executado. Define um bloco de repetio. Possui duas entradas opcionais. - Se a primeira entrada recebe 1 ento o bloco de repetio continua. Se receber 0 ento pra. - A segunda entrada recebe o nmero de vzes que o bloco ser repetido. Pra a execuo do script visual atual. Retorna 1 se a comparao entre as duas entradas for

verdadeira.

Executa a operao lgica entre as duas entradas e retorna 1 se for verdadeiro. Inverte a entrada entre 1 e 0.

68

EventosPara editar um programa atravs de script clique sobre o boto LS ou selecione um objeto e utilize a janela ao lado.

No script possvel acessar os "tags" definidos na planilha atravs de seus nomes. Se no houver nome definido na planilha utilize x. (Exemplo x1) Se desejar acessar outras colunas (propriedades) dos "tags" utilize o ponto. (Exemplo x1.setpoint) Existem dois tipos de eventos onde os scripts podem ser executados: eventos gerais e eventos nos objetos. No item "Evento" encontram-se as seguintes opes para os eventos gerais: define as funes que sero usadas em toda sua aplicao; OnStart define o que acontece no incio da aplicao; OnAntesVarreduras define o que acontece antes das varreduras na planilha; OnDuranteVarreduras define o que acontece durante as varreduras; OnDepoisVarreduras define o que acontece depois das varreduras; OnFinish define o que acontece na hora que termina. Para acessar os eventos de cada objeto ento selecione o nome respectivo no item Objeto. No momento em que o objeto desejado for selecionado a lista de eventos ser atualizada para: OnClick define o que acontece quando o usurio clica sobre o objeto. OnMouseDown define o que acontece quando o boto do mouse pressionado sobre o objeto. OnMouseMove define o que acontece quando o mouse arrastado sobre o objeto (pressionado). OnMouseUp define o que acontece quando o boto do mouse "despressionado" sobre o objeto. OnKeyDown define o que acontece quando uma tecla pressionado sobre o objeto. OnKeyPress define o que acontece quando uma tecla pressionado sobre o objeto. OnKeyUp define o que acontece quando uma tecla "despressionado" sobre o objeto. OnCommand define o que acontece quando ocorre um evento especfico do objeto. Observaes: Nos eventos OnKeyDown, OnKeyPress e OnKeyUp o programador pode utilizar a varivel Key para retornar a tecla pressionada. O nmero o cdigo da tabela ANSI. No evento OnCommand o programador recebe as informaes no objeto Event: Event.Value, Event.Object, Event.Command e Event.Pointer. O significado de cada uma destas propriedades determinada pelo objeto. 69

BrowserPara consultar os tags, objetos e comandos disponveis utilize a opo browser. Na janela do script texto clique no boto "F4 - Browser" ou tecle F4. Na janela do script visual selecione o objeto .

Selecione o tag, objeto ou comando desejado. Dica: Se quiser, digite o incio do nome do comando. Uma janela apresentar uma pesquisa dos comandos disponveis.

70

Acessando os "tags" da planilha de E/S (Objeto TAG)Como ler ou escrever em um "tag" da planilha de pontos de leitura e escrita (ou suas propriedades): Script visual: e clique sobre o editor. Aparecer uma janela com "tags", Selecione o objeto "comandos" objetos e comandos. Escolha o "tag" desejado (ou tambm sua propriedade) e clique em OK.

Exemplos:

(associa o valor 1 ao tag x1)

(retorna, na varivel y, o LI do tag valor4) Script texto: possvel acessar os "tags" definidos na planilha simplesmente atravs de seus nomes, sem utilizar o nome objeto tag, (pode-se utilizar o browser - tecla F4). Exemplo: niveldoliquido. Se no houver nome definido na planilha utilize x. (Exemplo x1) Se desejar acessar outras colunas (propriedades) dos "tags" utilize o ponto. (Exemplo x1.param1). Exemplos: x = x1 x5 = x t = Temperatura1*100 x = x7.LimiteSuperior x = Tag(3) s = Tag$(7) c = Tag(7).Canal (retorna o valor do tag x1 na varivel x) (associa o valor x no tag x5) (retorna na varivel t o valor do tag Temperatura1 x 100 ) (retorna na varivel x o valor da propriedade LimiteSuperior do tag x7) (retorna o valor do tag da linha 3 da planilha na varivel x) (retorna o valor texto do tag da linha 7 da planilha na varivel s) (retorna o valor do tag da linha 7 da planilha na varivel c)

Se desejar forar a leitura do "tag" executando o "driver" correspondente execute a propriedade atualiza. Exemplo: x1.atualiza Para utilizar um "tag" como uma simples varivel, sem um equipamento externo, utilize o "driver" VAR. 71

VariveisVariveis podem ser criadas e utilizadas livremente dentro do script em atribuies de valores ou como parmetros de funes. Os tags tambm podem ser usados como variveis (genricas ou associadas a um equipamento). Existem dois tipos de variveis: - Texto - Nmero Script visual: Variveis: Varivel nmero (pode ser utilizada como parmetro de entrada ou sada de um arquivo Varivel texto (pode ser utilizada como parmetro de entrada ou sada de um arquivo

LVAROBJ) LVAROBJ) Constantes:

Constante numrica. Constante texto. Concactenao de texto: Concactena as duas entradas texto. Exemplo:

Script texto: Para criar variveis numricas: Inicialize a varivel como nmero. Exemplo: x = 0 y = 7.43675 w = &HEEBBFF ' em hexa i = &B011010011101111111 ' em binrio y=y+1 As variveis nmero podem ser calculadas atravs dos operadores + - * / ou atravs de diversas funes matemticas pr-definidas. Para criar variveis texto: Inicialize a varivel como texto. Exemplo: s = "" texto1 = "supervisrio" Converte nmero em texto: s = CStr( x ) Converte texto em nmero: x = Val( s ) As constantes de texto so definidas entre aspas. Os textos podem ser concactenados utilizando o 72

operador +. Exemplo de concatenao de texto: s = "Realizados " + CStr( x ) + " teste(s). " (Para usar variveis texto no comando If utilize o operador ==. - veja Expresso If) As variveis texto tambm podem funcionar como memrias ou pacotes de bytes. Podem ser usadas para comunicao ou tratamento de dados binrios. (veja funes como BytesToStr) Diversos tipos de manipulao de texto (string) podem ser realizados atravs de funes pr-definidas (veja as funes para manipulao de strings no captulo Texto). Ateno: os nomes dos "tags" j so variveis pr-definidas. Veja o tpico Acessando os "tags".

Operaes bsicasVariveis numricas: Script texto: = : Associa. Ex:

y = 1 .Script visual:

. Ex:

.

Script texto: + : Soma. Ex: y

= y + 1 .Script visual:

Ex:

.

Script texto: - : Subtrao. Ex:

y = y 1 .Script visual:

Ex:

.

Script texto: * : Multiplicao. Ex:

y = y*2 .Script visual:

Ex:

.

Script texto: / : Diviso. Ex: Variveis texto:

y = y / 2 .Script visual:

Ex:

.

Script texto: = : Associa. Ex: s

= texto .Script visual:

. Ex:

.

Script texto: + : Concactena texto (string). Exemplo: s

= s + texto .

Script visual:

. Exemplo:

.

73

Comandos e expresses bsicas

Expresso If (Condio)A expresso If indica uma deciso baseada numa condio. Exemplo1: Script visual:

Script texto: If Then ... End If If ( x1 = 2 ) Then mensagem1 = "valor 2" End If Se x1 igual a dois ento mensagem1 ser: "valor 2". Exemplo2: Script visual:

Script texto: No caso de uma varivel texto no script texto utilize o operador "==". If Not ( resposta1 == "ERR" ) Then x8 = 3 End If Se resposta1 igual a "ERR" ento x7 ser 3.

74

Exemplo3: Script visual:

Script texto: Expresso com Else e ElseIf: If x1 > 3 Then x8 = 3 ElseIf x1 = 1 Then x8 = 1 Else x8 = 2 End If

For

Script texto: O comando For indica uma repetio onde a varivel recebe valores de n1 at n2.

No exemplo acima o valor de i varia de 1 at 10. A expresso s = s + Chr( i ) ser executada 10 vezes. Script visual:

75

Expresso While (repetio, loop, iterao)A expresso While indica uma repetio baseada numa condio. Sintaxe: While ... WEnd Exemplo: leitura = 1 x=0 While ( leitura = 1 ) And ( x 20 then painel.texto2.valor="Ultrapassou 20" else painel.texto2.valor="" end if Explicao do script acima: Se o "Valor" lido no primeiro tag (x1), ou seja, na linha 1 da planilha, for maior que 20, ento o texto do objeto "texto2" ser "Ultrapassou 20". Seno (se "Valor" no for maior que 20) o texto do objeto "texto 2" ser vazio.

81

Exemplo - Evento Global (script texto)Script texto: Exemplo de utilizao do evento .

No evento "Global" criamos a funo dobro(x), especificando que: "dobro" igual a duas vezes a varivel x. x2 = dobro(x1) Por exemplo, no evento OnClick de um boto programamos: - x igual ao valor do texto do objeto "textcontrol" - y igual ao dobro de x. - O valor do objeto "texto1" ser o valor de y, ou seja, o resultado da funo dobro(x). Ou seja; se x (valor do objeto "textcontrol1") for igual a 5, y (valor do objeto "texto1") ser igual a 10.

82

Funes e objetos de memria

Objeto globalO objeto Global permite criar variveis que podem ser acessadas em todos os eventos do LAquis. Script visual: Objeto "comandos" Sintaxe: Global. [ = valor ] Exemplo: Global.Variavel = 5 Global.Teste = 2 ' Em outro local da aplicao: x = Global.Variavel y = Global.Teste Observao: Global.Variavel = 5 o mesmo que StoreValue(5, "Variavel") . Tipo Objetos. Item Memria.

Objeto MemoryO objeto Memory contm as propriedades e mtodos necessrios para a acessar e manipular dados numa rea de memria. possvel criar blocos de dados, arrays e campos especiais tendo como base um ponteiro de memria. Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Exemplo 1:

Exemplo 2:

Propriedades e mtodos disponveis no objeto Memory:

Alloc (tamanho): Aloca uma rea de memria com o tamanho especificado. p = Memory.Alloc ( 255 ) Free (p, tamanho): Libera a rea de memria apontada pelo ponteiro p. Memory.Free ( p, 255 ) 83

ReAlloc (p, tamanho): Realoca a rea de memria p para outro tamanho sem perder os dados. Byte (p, posio): L ou escreve um byte numa posio da memria apontada pelo ponteiro p. Double (p, posio): L ou escreve um double (8 bytes) numa posio da memria apontada pelo ponteiro p. Long (p, posio): L ou escreve um long (4 bytes) numa posio da memria apontada pelo ponteiro p. Integer (p, posio): L ou escreve um integer (2 bytes) numa posio da memria apontada pelo ponteiro p. Word (p, posio): L ou escreve um word (2 bytes) numa posio da memria apontada pelo ponteiro p. PChar (p, posio): L ou escreve um pchar (texto) numa posio da memria apontada pelo ponteiro p. Comandos de alta velocidade: MemoryWriteLong ( p, posicao ) Escreve um long (4 bytes) numa posio apontada pelo ponteiro p. MemoryWriteByte ( p, posicao ) Escreve um byte (1 byte) numa posio apontada pelo ponteiro p. MemoryWriteDouble ( p, posicao ) Escreve um double (8 bytes) numa posio apontada pelo ponteiro p. MemoryWriteWord ( p, posicao ) Escreve um word (2 bytes) numa posio apontada pelo ponteiro p. MemoryReadLong ( p, posicao ) Retorna um long (4 bytes) de uma posio apontada pelo ponteiro p. MemoryReadByte ( p, posicao ) Retorna um byte (1 byte) de uma posio apontada pelo ponteiro p. MemoryReadDouble ( p, posicao ) Retorna um double (8 bytes) de uma posio apontada pelo ponteiro p. MemoryReadWord ( p, posicao ) Retorna um word (2 bytes) de uma posio apontada pelo ponteiro p.

StoreValueComando StoreValue ( valor, nome ) Armazena um valor numrico dentro de uma rea de memria global referenciada por um nome. A funo RestoreValue usada para acessar este nmero. Opcionalmente utilize o objeto Global para acessar estes valores. (Objeto Global) Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Parmetros: valor: nome: Nmero a ser armazenado na memria global. Nome que ser usado como referncia para acessar o nmero atravs da funo RestoreValue.

Exemplo: "" StoreValue ( 30, "teste" ) ... x = RestoreValue ( "teste" ) "" No exemplo acima a varivel x recebe o valor 30.

84

RestoreValuevalor = RestoreValue ( nome ) L um valor numrico armazenado numa rea de memria global referenciado por um nome. O comando StoreValue usado para armazenar este nmero. Opcionalmente utilize o objeto Global para acessar estes valores.(Objeto Global) Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Exemplo: StoreValue ( 30, "teste" ) ... x = RestoreValue ( "teste" ) No exemplo acima a varivel x recebe o valor 30.

ExistsValuex = ExistsValue ( nome ) Retorna True se o nmero referenciado pelo nome existe na memria global gravado pelo comando StoreValue . Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Exemplo: ... If ExistsValue ( "teste" ) Then x = RestoreValue ( "teste" ) ... ... End If

ClearValueComando ClearValue ( nome ) Desassocia a varivel referenciada pelo nome da memria global. Para fins de desempenho a rea de memria no desalocada e pode servir de espao para novos armazenamentos pelo comando StoreValue. Se desejar desalocar a parte da memria global que no est sendo utilizada basta invocar o comando CompactStoredValues. Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Exemplo: StoreValue ( 30, "teste1" ) StoreValue ( 40, "teste2" ) StoreValue ( 50, "teste3" ) ... ClearValue ( "teste2" ) ... CompactStoredValues

FreeStoredValuesComando FreeStoredValues Libera a memria global utilizada para armazenar as variveis atravs do comando StoreValue. 85

Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Exemplo: StoreValue ( 30, "teste" ) ... x = RestoreValue ( "teste" ) ... FreeStoredValues

CompactStoredValuesComando CompactStoredValues Compacta a memria global utilizada para armazenar as variveis atravs do comando StoreValue. A compactao s til se algumas das variveis forem eliminadas da memria atravs do comando ClearValue. As lacunas que no foram preenchidas depois so desalocadas da memria global. Script visual: Objeto "comandos". Tipo Objetos. Item Memria. Exemplo: StoreValue ( 30, "teste1" ) StoreValue ( 40, "teste2" ) StoreValue ( 50, "teste3" ) ... ClearValue ( "teste2" ) ... CompactStoredValues

86

Objeto Tabela

O objeto Tabela contm as propriedades e mtodos para a manipulao de uma tabela em formato de planilha. Nesta tabela podem ser apresentados os resultados de operaes realizadas na aplicao ou at mesmo servir de entrada de dados. Uma vez criada a tabela possvel gerar relatrios na tela, impressos ou para exportao. Script visual: Objeto "comandos". Tipo Objetos. Item Tabela.

O ttulo da tabela: "Relatrio" O nmero de colunas: 3 O nmero de linhas: NumLeituras + 1 O valor de determinada clula (seguindo a sequncia - linha,coluna):Linha 0, coluna 0 = "#" , e assim sucessivamente. Tabela.Mostra: o que define o tamanho, ou seja, a resoluo da tabela, no exemplo - 320 por 480.

Propriedades e mtodos disponveis no objeto ArquivoTexto: Nome: Nome da tabela. 87

Titulo: Ttulo da janela onde ser apresentada a tabela. Colunas: Nmero de colunas da tabela. Linhas: Nmero de linhas da tabela. ColunasFixas: Nmero de colunas fixas (em cinza) esquerda da tabela. LinhasFixas: Nmero de linhas fixas (em cinza) no topo da tabela. Celula (coluna, linha): L ou escreve o contedo da clula na coluna e linha especificada. CorTexto (coluna, linha): Cor do texto na clula correspondente coluna e linha especificada. Cor (coluna, linha): Cor do fundo da clula correspondente coluna e linha especificada Largura (coluna): Largura em pixels da coluna especificada na tabela. Altura (linha): Altura em pixels da linha especificada na tabela. Visivel: Torna a tabela visvel ou no. Mostra ( [x1, y2,] dx, dy ): Apresenta a tabela para o usurio e no permite eventos no plano inferior. MostraNormal ( [x1, y2,] dx, dy ): Apresenta a tabela para o usurio. Salva ( arquivo ): Grava os dados da tabela em arquivo texto. Abre ( [ y [, x ],] arquivo, [ajusta] ): Abre o arquivo texto e dispe os dados na tabela nas posies especificadas. ApagaLinha (linha): Apaga a linha especificada da tabela. InsereLinha (linha): Insere uma linha na posio especificada. Libera: Libera a memria alocada para a tabela atual. LiberaTodas: Libera a memria alocada para todas as tabelas criadas. Coluna: L ou define a posio da coluna do cursor na tabela. Linha: L ou define a posio da linha do cursor na tabela. SomenteLeitura: Se True a tabela no poder ser alterada pelo usurio. BordaFixa: Se True o tamanho da janela onde est a tabela no poder ser ajustado.

88

Funes e objetos de arquivos e banco de dados

Objeto LBPropriedades: LB.Data Determina a data relacionada do banco para o caso de arquivos BANCO.LDB. Caso contrrio LB.Data = 0. Ex: LB.Data=int(now) LB.Abre(arquivo_ldb) Abre o arquivo .ldb indicado e retorna opcionalmente um nmero relacionadp ao banco. Ex: banco = LB.Abre("TESTE.LDB") LB.BancoNumero(banco) Seleciona o banco aberto atravs do seu nmero. Ex: LB.BancoNumero(banco) LB.Filtro(sql_ou_critrio) Filtra e seleciona os registros de acordo com o comando SQL ou o critrio no formato LBanco. Para selecionar todos os registros basta fazer LB.Filtro(""). Ex: LB.Filtro("VALOR > 30") LB.Registros Retorna o nmero de registros selecionados pelo Filtro. Ex: x = LB.Registros LB.Posicao Retorna ou determina a posio atual do banco em funo do filtro. Varia de 0 at Registros-1. Ex: LB.Posicao=0 LB.PosicaoReal Retorna ou determina a posio real fsica atual do banco. Varia de 0 at Registros-1 quando o filtro vazio. Ex: x=LB.PosicaoReal LB.NovoRegistro Posiciona o banco para acrescentar novo registro. Ex: LB.NovoRegistro LB.Le L o registro apontado pela posio atual. Os dados podem ser retornados pelos mtodos Campo e CampoN. Ex: LB.Le LB.Grava Grava os dados no registro apontado pela posio atual. Os dados so definidos pelos mtodos Campo e CampoN. Ex: LB.Grava LB.Campo(nome_do_campo) Retorna ou define o valor do campo no formato texto. Ex: LB.Campo("OBS")="Acima do limite" LB.CampoN(nome_do_campo) Retorna ou define o valor do campo no formato numrico. Ex: LB.CampoN("TEMPO")=now LB.Titulo(nome_do_campo) Retorna o ttulo do campo. Ex: s=LB.Titulo("CODIGO") 89

LB.Tipo(nome_do_campo) Retorna o tipo do campo. Os tipos so: 0-Nmero,1-Texto,2-AutoInc,3-Data/Hora,4-Binrio. Ex: x=LDB.Tipo("VALOR") LB.Formato(nome_do_campo) Retorna o formato do campo. Ex: s=LB.Formato("VALOR") LB.Campos Retorna o nmero de campos do banco atual. Ex: n=LB.Campos LB.NomeDoCampo(indice_do_campo) Retorna o nome do campo a partir do ndice que varia de 0 at LB.Campos-1. Ex: s=LB.NomeDoCampo(0) LB.Ordena(campo_de_ordenao) Ordena os registros filtrados utilizando o campo de ordenao especificado. Ex: LB.Ordena("TEMPO") LB.FechaBanco(banco) Fecha o banco especificado. Ex: LB.FechaBanco(banco) LB.Fecha Fecha o banco atual. Ex: LB.Fecha LB.Tabela Apresenta a tabela de edio do banco. Ex: LB.Tabela LB.TabelaDoLB(banco,texto,data) Retorna o nome da tabela do LB sem abrir o banco. Texto e data so parmetros opcionais para o nome da tabela. Ex: s=LB.TabelaDoLB("Banco.LB","",0) LB.PastaDoLB(banco,pastadefault) Retorna a pasta dos arquivos de dados sem abrir o banco. Pastadefault a pasta que ser colocada no lugar de "". Ex: s=LB.PastaDoLB("Banco.LB",App.AplPath) LB.Mostra(largura,altura,campos,pesquisa,alterar,adicionar,imprimir,utilizarpesquisa) Mostra a janela para listagem ou edio dos dados de um banco. Ex: LB.Mostra(565,383,"TESTE.LB","",0,0,1,0)

90

Objeto Ini Ini.ReadNumberA funo Ini.ReadNumber ( arquivoini, sesso, campo, valordefault ) O mtodo ReadNumber do objeto Ini l um valor numrico dentro de um campo numa sesso do arquivoini. Script visual: Objeto "comandos". Tipo Comandos. Item Ini. Exemplo: x = Ini.ReadNumber ( App.Path + "TESTE.INI", "CONFIGURAO", "Altura", 0 )

Ini.ReadStringtexto = Ini.ReadString ( arquivoini, sesso, campo, valordefault ) O mtodo ReadString do objeto Ini retorna o valor texto lido a partir de um campo dentro de um sesso no arquivoini. Script visual: Objeto "comandos". Tipo Comandos. Item Ini. Exemplo: s = Ini.ReadString ( App.Path + "TESTE.INI", "CONFIGURAO", "Ttulo", "" )

Ini.WriteStringComando Ini.WriteString ( arquivoini, sesso, campo, valor ) O mtodo WriteString do objeto Ini escreve um valor texto dentro de um campo numa sesso do arquivoini. Script visual: Objeto "comandos". Tipo Comandos. Item Ini. Exemplo: Ini.WriteString ( App.Path + "TESTE.INI", "CONFIGURAO", "Ttulo", "Aplicao X" )

Ini.WriteNumberComando Ini.WriteNumber ( arquivoini, sesso, campo, valor ) O mtodo WriteNumber do objeto Ini escreve um valor numrico dentro de um campo numa sesso do arquivoini. Script visual: Objeto "comandos". Tipo Comandos. Item Ini. Exemplo: Ini.WriteNumber ( App.Path + "TESTE.INI", "CONFIGURAO", "Altura", 100 )

91

Objeto ArquivoTextoO objeto ArquivoTexto contm as propriedades e mtodos necessrios para a manipulao de arquivos texto. Script visual: Objeto "comandos". Tipo Comandos. Item ArquivoTexto. Exemplo 1:

Exemplo 2:

Propriedades e mtodos disponveis no objeto ArquivoTexto: Abre (arquivo): Abre o arquivo e retorna seu handle. n = ArquivoTexto.Abre("teste.txt") Fecha (harquivo): Fecha o arquivo. ArquivoTexto.Fecha( n ) Eof [(harquivo)]: Retorna True se chegou o fim do arquivo texto. Fim = ArquivoTexto.Eof Le [(harquivo)]: L e retorna uma linha de texto. texto = ArquivoTexto.Le Grava ( [harquivo,] texto): Grava uma linha de texto. Acrescenta ( [harquivo,] texto ): Acrescenta (append) uma linha de texto.

92

Objeto ArquivoBinO objeto ArquivoBin contm as propriedades e mtodos necessrios para a manipulao de arquivos binrios de formato livre. possvel ler ou gravar blocos de memria de qualquer tamanho. Script visual: Objeto "comandos". Tipo Comandos. Item ArquivoBin. Exemplo 1:

Exemplo 2:

Propriedades e mtodos disponveis no objeto ArquivoBin: Abre (arquivo): Abre o arquivo e retorna seu handle. n = ArquivoBin.Abre("teste.bin") Fecha (harquivo): Fecha o arquivo. ArquivoBin.Fecha( n ) Registros (harquivo): Retorna o nmero de bytes do arquivo. r = ArquivoBin.Registros( n ) Posicao (harquivo): Posiciona o arquivo no byte especificado. ArquivoBin.Posicao (n) = 31 LeBloco ( harquivo, ponteiro, tam ): L um bloco de bytes e armazena na memria apontada pelo ponteiro. GravaBloco ( harquivo, ponteiro, tam ): Grava um bloco de bytes armazenados na memria apontada pelo ponteiro. Le (harquivo): L e retorna apenas um byte. Grava (harquivo): Grava apenas um byte.

93

Objeto DialogO objeto Dialog contm as janelas para a entrada de nomes de arquivos por parte do usurio. Script visual: Objeto "comandos". Tipo Comandos. Item Arquivos. Mtodos disponveis no objeto Dialog: Open [ (caminhoinicial [, filtro] ) ]: Apresenta uma janela para a entrada de um arquivo a ser aberto. Save [ (caminhoinicial [, filtro] ) ]: Apresenta uma janela para a entrada de um arquivo a ser gravado. Tando o mtodo Open como o mtodo Save retornam o nome do arquivo digitado ou escolhido. Se o texto retornado for vazio ento significa que o usurio cancelou a operao. Exemplo: Dim nome nome = Dialog.Open ( App.Path, "Arquivos Texto (*.txt)|*.txt|Todos os Arquivos (*.*)|*.*" ) If Not ( nome == "" ) Then ArquivoTexto.Abre ( nome ) ... ... End If ' Se o usurio no cancelou ' Utiliza o arquivo definido pela varivel nome

FileExistsvalor = FileExists ( arquivo ) Retorna True se o arquivo especificado existe. Script visual: Objeto "comandos". Tipo Comandos. Item Arquivos. Exemplo: x = FileExists ( App.Path + "arquivo.dat" ) se este arquivo existe ento x recebe o valor True.

KillComando Kill ( arquivo ) Apaga o arquivo especificado do disco. Script visual: Objeto "comandos". Tipo Comandos. Item Arquivos. Exemplo: Kill ( App.Path + "arquivo.dat" )

94

Funes de texto

Funo Valx = Val ( texto ) A funo Val retorna o valor numrico correspondente ao texto. Script visual: Objeto "comandos" Exemplo: . Tipo Comandos. Item Texto.

Funo CStrtexto = CStr ( nmero ) A funo CStr retorna o texto correspondente a um valor numrico. Script visual: Objeto "comandos". Tipo Comandos. Item Texto. Exemplo:

95

Funo Midtexto resultante = Mid ( texto, posio inicial, posio final ) A funo Mid retorna uma parte do texto. Exemplo: Mid ("Palavra",3,5) retorna os caracteres de 3 a 5, ou seja, "lav". A posio 1 o primeiro caracter, a posio 2 o segundo, e assim por diante. Exemplo:

Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

Funo CopyStringtexto resultante = CopyString ( texto, posio inicial, n ) A funo CopyString retorna uma cpia dos n caracteres partir da posio inicial indicada. Exemplo: s = CopyString ( "Teste da funo CopyString", 10, 6 ) Retorna em s a palavra "funo". Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

Funo LeftStexto resultante = LeftS ( texto, n ) A funo LeftS retorna uma cpia dos n caracteres esquerda do texto. Exemplo: s = LeftS ( "Teste da funo left", 5 ) Retorna em s a palavra "Teste". Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

96

Funo RightStexto resultante = RightS ( texto, n ) A funo RightS retorna uma cpia dos n caracteres direita do texto. Exemplo: s = RightS ( "Teste da funo", 6 ) Retorna em s a palavra "funo". Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

Funo DeleteStringtexto resultante = DeleteString ( texto, posio inicial, n ) A funo DeleteString retorna uma cpia do texto eliminando n caracteres partir da posio inicial. Exemplo: s = DeleteString ( "Teste da funo", 7, 3 ) Retorna em s o texto "Teste funo". Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

Funo BytesToStrstring = BytesToStr ( byte1, byte2, byte3, ... ) A funo BytesToStr retorna um texto (string) com os bytes indicados. Este string funciona como uma memria ou um pacote de bytes. usado para comunicao ou tratamento de dados binrios. Exemplo: s = BytesToStr ( 0, 5, canal, &HF3, 13, 10 ) Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

97

Funo LenA funo Len retorna o nmero caracteres na varivel texto. Script visual: Objeto "comandos". Tipo Comandos. Item Texto. Exemplo:

Funo InStrposio = InStr ( texto, expresso ) A funo InStr retorna a posio de uma expresso dentro de uma varivel ou constante texto. Se a expresso no for encontrada ento a posio 0. A posio 1 o primeiro caracter, a posio 2 o segundo, e assim por diante. Script visual: Objeto "comandos". Tipo Comandos. Item Texto. Exemplo:

Se desejar procurar a partir de uma posio inicial use: posio = InStrPos ( posio inicial, texto, expresso )

Funo StrToNumbernmero = StrToNumber ( texto, posio inicial, posio final ) A funo StrToNumber converte parte de um texto (string como seqncia de bytes) para nmero byte, word ou long. Exemplo: x = StrToNumber ( s, 5, 6 ) Retorna em x no formato word (2 bytes) o valor determinado pelos bytes 5 e 6 do string s. Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

98

Funo NumberToStrstring = NumberToStr ( nmero [,bytes] ) A funo NumberToStr converte um nmero para texto (string) como uma seqncia de bytes, word ou long. Este string funciona como uma memria ou um pacote de bytes. usado para comunicao ou tratamento de dados binrios. Exemplo: s = "" s = NumberToStr ( x, 2 ) Retorna em s dois bytes do valor x no formato word. Script visual: Objeto "comandos". Tipo Comandos. Item Texto.

Funo Formattexto = Forma