Chapter 5. Automatização e Programação com o Kwave

O Kwave, desde a sua primeira versão, usa uma linguagem de comandos de texto interna. Esta linguagem de comandos é usada internamente para o tratamento dos menus, o controlo da interface, para os efeitos incorporados e para a invocação de 'plugins'. Os comandos serão descritos mais tarde na secção da Referência de Comandos.

Sintaxe Geral

  • Todos os comandos consistem num nome de comando e numa lista de parâmetros opcional entre parêntesis, dependendo do comando.

  • Os caracteres permitidos para os nomes dos comandos são as letras, números e os dois-pontos. Os comandos fazem distinção entre maiúsculas e minúsculas e são sempre em minúsculas.

  • Os parâmetros dentro de uma lista de parâmetros são separados por vírgulas.

  • Os parâmetros numéricos poderão ser dados como números de vírgula fixa ou flutuante, usando o ponto como separador decimal.

  • Os parâmetros de texto normalmente são recortados (todos os espaços em branco no início e no fim são removidos). Se isto não for o pretendido, poderá envolver os textos entre aspas ("). Se um parâmetro de texto tiver caracteres especiais (como o ,, ;, # ou o próprio \), estes caracteres especiais terão de ser antecedidos de um \.

  • Poderá concatenar vários comandos numa lista de comandos, usando um ; como separador.

Exemplo:

fileinfo(Comentários,"Isto é um comentário de \"exemplo\".")

Este exemplo consiste no comando fileinfo e tem dois parâmetros: a palavra-chave Comentários e o texto "Isto é um comentário de \"exemplo\".". (Estes parâmetros são explicados na secção correspondente, na referência de comandos).