# Manual do &minuet;

## Introdução

Bem-vindo ao &minuet;: o aplicativo para ensino de música. O &minuet; tem como objetivo ajudar alunos e professores em diversos aspectos da educação musical, tais como treinamento de ouvido, leitura à primeira vista, solfejo, escalas, ritmo, harmonia e improvisação. O &minuet; faz uso intenso de recursos &MIDI; para oferecer um conjunto completo de funcionalidades referentes a alterações de volume, tempo e afinação, o que o torna uma ferramenta valiosa tanto para músicos amadores como para profissionais.

O &minuet; oferece um conjunto amplo de exercícios para treinamento de ouvido e novos exercícios poderão ser facilmente adicionados para ampliar suas funcionalidades e adaptá-lo a diversos contextos de educação musical.

Janela principal do &minuet; Exercícios do &minuet; para treinamento de ouvido com o uso de acordes

## Usando o &minuet;

Nas próximas duas seções - Iniciando o &minuet; e Exercícios do &minuet; - apresentaremos os passos necessários para deixar o &minuet; pronto para execução.

### Iniciando o &minuet;

Você pode iniciar o &minuet; a partir do lançador de aplicativos. Abra o menu global clicando no ícone do lançador de aplicativos na área de notificação, localizado no canto inferior esquerdo da sua tela. Com o menu aberto, mova o ponteiro do mouse para o item de menu Aplicativos Educação Diversos &minuet; (Software para Ensino de Música) a partir do menu global ou com &Alt;F2 e digitando `minuet` no campo de entrada.

### Exercícios e fluxo de trabalho do &minuet;

A interface de usuário do &minuet; é composta de quatro componentes principais:

Janela principal do &minuet; Componentes da interface do &minuet;

Menu de navegação

- Permite a navegação pelas categorias de exercícios do &minuet; e a seleção de um exercício em particular. O menu de navegação é criado dinamicamente, a partir de arquivos de especificação de exercícios descritos em Criar exercícios. Os exercícios do &minuet; são agrupados de acordo com classes como, por exemplo, intervalos, escalas e acordes.

Área de Teclado

- Exibe os eventos de `note on` do &MIDI; lidos a partir de um arquivo &MIDI; ou da execução de um exercício.

Área de Exercício

- Apresenta, para um determinado exercício, os botões que controlam sua apresentação, bem como um conjunto das respostas possíveis do exercício. A execução de um exercício é iniciada ao clicar no botão Nova pergunta. Um intervalo/acorde/escala aleatório é reproduzido pelo &minuet; e depois espera-se que o aluno escolha uma resposta dentre as apresentadas na grade. O &minuet; sempre apresenta - como um pequeno círculo branco na Área de Teclado - a primeira nota do intervalo/escala selecionado ou a nota principal do acorde selecionado. Ao passar o ponteiro do mouse sobre uma possível resposta, o &minuet; apresenta a sua representação visual correspondente na Área de Teclado. As notas restantes da resposta em questão são apresentadas como pequenos círculos, cujas cores são as mesmas do botão da resposta. O aluno poderá ouvir o exercício novamente clicando no botão Reproduzir pergunta, clicar no botão da resposta escolhida ou então obter a resposta correta clicando no botão Desistir Uma nova execução do mesmo exercício pode ser iniciada clicando novamente no botão Parar pergunta e clicando novamente o botão Nova pergunta.

## Criando novos exercícios do &minuet;

Os exercícios do &minuet; são definidos em arquivos de especificação, escritos no formato &JSON;:

    {
      "exercises": [
        {
          "name": "Intervalos",
          "root": "21..104",
          "playMode": "scale",
          "children": [
            {
              "name": "Intervalos Melódicos Ascendentes",
              "children": [
                {
                  "name": "Segundas",
                  "options": [
                    {
                      "name": "Segunda Menor",
                      "sequenceFromRoot": "1"
                    },
                    {
                      "name": "Segunda Maior",
                      "sequenceFromRoot": "2"
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }

Os arquivos de especificação de exercícios do &minuet; contêm um objeto &JSON; raiz, que contém a lista `exercises`. Essa lista descreve uma estrutura hierárquica de exercícios, agrupada por categorias. Cada categoria/exercício tem um nome. Os objetos &JSON; das categorias contêm uma propriedade chamada `children`, que descreve as subcategorias/exercícios que pertencem a essa categoria. Os objetos &JSON; dos exercícios contêm uma propriedade chamada `options`, que define as possíveis respostas para este exercício. Na execução de cada exercício, o &minuet; seleciona aleatoriamente uma resposta dentre as possíveis e aguarda o aluno clicar no botão de resposta que corresponde à resposta selecionada.

Qualquer (sub)categoria pode definir um parâmetro `root`, que define o intervalo a partir do qual a nota inicial do intervalo/acorde/escala será escolhido aleatoriamente para todos os exercícios desta categoria. Esse intervalo corresponde aos números das notas no padrão &MIDI; e segue o formato `<valor-mín>..<valor-máx>`. O exemplo apresentado acima usa toda a faixa do teclado como notas fundamentais possíveis (21..104). O parâmetro `playMode` indica como as possíveis respostas deverão ser tocadas: como `scale` (escala - uma nota após a outra) ou como `chord` (acorde - todas as notas tocadas simultaneamente).

Cada opção do exercício define um nome e a sequência de notas que deverá ser reproduzida a partir da nota fundamental selecionada aleatoriamente na execução de cada exercício. Essa sequência de notas é definida como distâncias relativas à nota fundamental, descrevendo o intervalo que cada nota forma com a nota fundamental. Por exemplo, para uma escala maior, a sequência de notas é 2 4 5 7 9 11 12, que define respectivamente a estrutura característica da escala maior tom tom semitom tom tom tom semitom. O parâmetro `sequenceFromRoot` pode conter qualquer número de notas. Da mesma forma, o núcleo do &minuet; garante que apenas as respostas em que todas as notas que estiverem dentro da faixa do teclado sejam selecionadas aleatoriamente.

Para oferecer uma melhor infraestrutura na organização de um grande conjunto de arquivos de especificação de exercícios, o núcleo do &minuet; suporta o uso de diversos arquivos de especificação, os quais são combinados automaticamente para compor a hierarquia final de exercícios do menu de Navegação. Os exercícios são corretamente combinados desde que os diferentes arquivos de especificação usem o mesmo nome de (sub)categoria ao definir os exercícios. Por enquanto, o &minuet; não oferece nenhuma interface gráfica para criar as especificações de exercícios, sendo necessário criar manualmente estes arquivos &JSON;. Os arquivos de especificação de exercícios do &minuet; podem ser instalados globalmente no sistema ou localmente, na pasta `minuet/exercises/` localizada no ``qtpaths` `--paths GenericDataLocation``

## Créditos e Licença

&minuet;

Direitos autorais do programa 2016 &Sandro.Andrade; &Sandro.Andrade.mail;

Direitos autorais da documentação © 2016 &Sandro.Andrade; &Sandro.Andrade.mail;

Tradução de André Marcelo Alvarenga alvarenga@kde.org

&underFDL; &underGPL;
&documentation.index;