Se não pode deslocar-se até ao fim do texto abaixo, clica aqui.

Apresentação geral

Criação de um ficheiro cyloop.

Sintaxe : cylcree [nomeie_ficheiro_cyloop]

cylcree é uma manda interactiva que pede ao utente de definir todas as características de um ficheiro cyloop dantes de criar este ficheiro.

O nome do ficheiro cyloop a criar pode ser passado em parâmetro (com ou sem o sufixo .cyl).
Na ausência deste parâmetro, manda-a cylcree começa por pedir o nome do ficheiro a criar.

Depois começa uma série de questões/respostas que permite ao utente de definir todas as características do ficheiro cyloop que quer criar.

Para mais de detalhes sobre a criação de um ficheiro cyloop, ver esta página site.

Marcador da estrutura e do conteúdo de um ficheiro cyloop.

Sintaxe : cyldump [nomeie_ficheiro_cyloop]

cyldump anuncie as diferentes características de um ficheiro cyloop :

características do ciclo em curso,
características da variável,
dados armazenado para a cada um dos instantes do ciclo.

O nome de ficheiro cyloop a descarregador pode ser passado em parâmetro (com ou sem o sufixo .cyl).
Na ausência deste parâmetro, manda-a cyldump começa por pedir o nome deste ficheiro.

Incremento de uma variável de tipo contador.

Sintaxe : cylincr nomeie_ficheiro_cyloop

O parâmetro nomeie_ficheiro_cyloop é obrigatório.

cylincr permite incrementar a variável do ficheiro nomeie_ficheiro_cyloop ao instante corrente do ciclo em curso, quando esta variável é de tipo contador.

O incremento do contador é sistémico durante o primeiro telefonema de cylincr para um novo instante do ciclo.

Se outros telefonemas de cylincr ocorrem que duram o mesmo instante do ciclo, serão contabilizados ou ignorados segundo os características da variável.

Assim mesmo, em caso de mudança de ciclo desde o telefonema precedente de cylincr, um cálculo de ponderação é efectuado sobre os dados dos ciclos precedentes já armazenado, quando este cálculo tem sido previsto para a variável

Inserção de um novo valor em uma variável que não é de tipo contador

Sintaxe : cyladdval nomeie_ficheiro_cyloop valor

Os parâmetros nomeie_ficheiro_cyloop e valor são obrigatório.

cyladdval permite acrescentar o dado valor à variável do ficheiro nomeie_ficheiro_cyloop ao instante corrente do ciclo em curso, quando esta variável não é de tipo contador.

O adição do dado é sistémico durante o primeiro telefonema de cyladdval para um novo instante do ciclo.

Se outros telefonemas de cyladdval ocorrem que duram o mesmo instante do ciclo, serão contabilizados ou ignorados segundo os características da variável.

Assim mesmo, em caso de mudança de ciclo desde o telefonema precedente de cyladdval, um cálculo de ponderação é efectuado sobre os dados dos ciclos precedentes já armazenado, quando este cálculo tem sido previsto para a variável.

Geração de gráficos a marchar de um ficheiro cyloop

Sintaxe : cylgraph nomeie_ficheiro_cyloop nomeie_ficheiro_imagem opções_gerais descrições_traçadas

Os parâmetros nomeie_ficheiro_cyloop e nomeie_ficheiro_imagem são obrigatória.

cylgraph gera uma imagem nomeie_ficheiro_imagem a marchar do ficheiro nomeie_ficheiro_cyloop.

Opções gerais

Estas primeiras opções são todas facultativas e podem aparecer em qualquer ordem. Implicam as propriedades da imagem gerada.

[-h altura_gráfica] [-w largura_gráfico] [-H altura_imagem] [-W largura_imagem] [-T título_imagem] [-p]

-h permite precisar a altura altura_gráfica em pixels do gráfico integrado à imagem gerada.
Por defeito, esta altura é de 100 pixels, salvo se a altura total da imagem é fixada a um valor inferior.

-w permite precisar a largura largura_gráfico em pixels do gráfico integrado à imagem gerada.
Por defeito, esta largura é de 400 pixels, salvo se a largura total da imagem é fixada a um valor inferior.
.

-H permite precisar a altura altura_imagem em pixels da imagem.
Por defeito, esta altura é de 50 pixels ademais que a altura do gráfico.

-W permite precisar a largura largura_imagem em pixels da imagem.
Por defeito, esta largura é de 100 pixels ademais que a largura do gráfico. Por relatório à largura escolhida, é arredondada sempre ao múltiplo de 8 superior.

-T permite acrescentar acima da imagem gerada o título título_imagem

-p emanda de anunciar a escada vertical do gráfico baixo a forma de percentagens, dantes que baixo a forma de valores numéricos brutos.

Descrição dos traçados

A descrição dos traçados é constituída de uma série de opções que têm a forma seguinte :

-[m|M](t

espessura

|a)

cor

As opções que seguem permitem cada a uma descrever um traçado inclusive no gráfico.

Pode ter vários traçados (até 12). Neste caso, os diferentes traçado são inserir no gráfico na ordem no qual são mencionados. Quando vários traçados sobrepõem-se no gráfico, é o último traçado que é prioritário e que dará ao pixel sua cor.

-tespessura cor

-t

espessura

cor

os 2 primeiras carácteres de 00 a FF correspondem à luminosidade da componente vermelha (em síntese aditiva das cores),
os 2 carácteres seguintes, à luminosidade da componente verde,
os 2 últimos, à luminosidade da componente azul.

-a cor

cor

-t

-mtespessura cor

-t

-ma cor

-a

-Mtespessura cor

-t

-Ma cor

-a

Formatos de imagem

Manda-a cylgraph pode gerar imagens em de numeroso formato.
O formato da imagem gerada depende do sufixo do ficheiro nomeie_ficheiro_imagem passada em parâmetro.

No entanto, com o fim de dar suporte numerosos formatos de imagem, manda-a cylgraph apelado a manda-a convert do projecto ImageMagick.

Na ausência deste encarrego, as imagens são geradas ao formato bmp e os nomes do ficheiro imagem se terminam pelo sufixo .bmp

Configuração : o ficheiro sysfont

O ficheiro sysfont é um ficheiro sistema opcional do projecto cyloop.

Tem que ser criado sim necessário no momento da instalação de cyloop.

Este ficheiro não é útil que quando o computador não utiliza o jogo de carácteres UTF-8 (é a dizer quando a variável de médio ambiente $LANG não se termina por UTF-8).

Neste caso, é utilizado por manda-a cylgraph com o fim de utilizar o bom mapa de caracteres para inserir do texto nos gráficos gerados.

Implantação

Se os comandos realizáveis do projecto Cyloop são implantadas em /usr/bin como quase os demais comandos do sistema de exploração, o ficheiro sysfont tem que ser implantado em /usr/share/cyloop

No caso contrário, tem que ser implantado no mesmo directório que os ficheiros realizáveis do projecto Cyloop seja : (...)/cyloop/bin

Contido

O conteúdo do ficheiro sysfont limita-se ao nome de um ficheiro fundição (sem outro carácter dantes ou depois sobretudo dos alvos).

Os nomes de ficheiros fundição possível estão :

iso8859-2 iso8859-3 iso8859-4 iso8859-5 iso8859-6 iso8859-7 iso8859-8 iso8859-9 iso8859-10 iso8859-11 iso8859-13 iso8859-14 iso8859-15 iso8859-16 windows-1252
O nome iso8859-1 é autorizado igualmente, mas o ficheiro sysfont não é necessário se se utiliza este mapa de caracteres, já que é o mapa de caracteres por defeito.