Capítulo 4. Automatização e programação com o Kwave

O Kwave desde a sua primeira versão usa uma linguagem de comando de texto interno. Essa linguagem de comando é usada internamente para manipulação de menus, controle da GUI, efeitos incorporados e invocações de plugin. Os comandos serão descritos mais adiante na seção Referência de comandos.

Sintaxe geral

  • Todos os comandos consistem em um nome de comando e uma lista de parâmetros opcional entre parênteses, dependendo do comando.

  • Os caracteres permitidos para nomes de comandos são letras , números e ponto e vírgula . Ainda, os comandos diferenciam letras maiúsculas de minúsculas e estão sempre em minúsculas.

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

  • Os parâmetros numéricos podem ser dados como números de ponto fixo ou números de ponto flutuante, usando um ponto como separador decimal.

  • Os parâmetros de cadeias de caracteres são automaticamente aparados (todo o espaço em branco no início e no final é removido). Se não desejar que isso aconteça, coloque-os entre aspas duplas ("). Se um parâmetro de cadeia de caracteres contiver caracteres especiais (como ,, ;, # ou uma \), esses caracteres especiais precisam ser precedidos de uma \.

  • Múltiplos comandos podem estar associados a uma 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\" .". (esses parâmetros são explicados na seção correspondente de referência de comando).