# Manual do &minuet;

## Introdução

Bem-vindo ao &minuet;: o aplicativo do &kde; 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.

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

## Usando o &minuet;

Nas próximas três seções - Iniciando o &minuet;, Assistente de Configuração do &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 de programas do &kde; clicando no ícone do lançador de aplicativos na barra de ferramentas, 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).

### Assistente de Configuração do &minuet;

Ao executar o &minuet; pela primeira vez, será apresentado um Assistente de Configuração que verifica se todas as dependências necessárias para lidar com arquivos &MIDI; estão devidamente instaladas no seu sistema. O &minuet; usa o TiMidity++/Freepats como infraestrutura padrão de &MIDI;. Dessa forma, o Assistente de Configuração avalia se essas tecnologias estão devidamente instaladas e configuradas.

Assistente de Configuração da primeira execução do &minuet;

Se todos os testes do Assistente de Configuração passarem com sucesso, o &minuet; iniciará e interromperá automaticamente o TiMidity++ durante a inicialização e finalização da aplicação, respectivamente. Você pode executar o Assistente de Configuração novamente, a qualquer momento, acessando a opção Configuração Executar o Assistente de Configuração .

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

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

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.

Controles do reprodutor MIDI

- Oferece as funcionalidades básicas para lidar com dados &MIDI;. O &minuet; é capaz de reproduzir arquivos &MIDI; arbitrários, escolhendo a opção Arquivo Abrir e depois clicando no botão `reproduzir` . A execução poderá ser pausada clicando no botão de `pausar` e retomada clicando novamente no botão `reproduzir`. O botão `parar` interrompe a reprodução &MIDI;. Os controles do reprodutor de &MIDI; também oferecem barras deslizantes para alterar o volume , o tempo e a afinação da reprodução &MIDI; atual.

Á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 a apresentação do exercício, bem como um conjunto das respostas possíveis para o 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 de resposta. 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 a 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 `nova pergunta`.

## Criando novos exercícios do &minuet;

Os exercícios do &minuet; são definidos em arquivos de especificação de exercícios, 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 para organizar 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, na pasta `/usr/share/minuet/exercises/`, ou localmente na pasta `~/.local/share/minuet/exercises/` do usuário.

## Configuração do &minuet;

Algumas configurações de &MIDI; do &minuet; poderão ser realizadas em Configurações Configurar o Minuet :

Configuração do &minuet;

O parâmetro `TiMidity++` contém o caminho completo do programa TiMidity++. Esse caminho é ajustado automaticamente pelo Assistente de Configuração do &minuet;, caso o seu ambiente esteja em boas condições, mas você pode fornecer a sua própria configuração se assim desejar.

Os `parâmetros do TiMidity++` definem os parâmetros a serem utilizados ao iniciar o serviço do TiMidity++. Você deve usar o valor fornecido pelo Assistente de Configuração do &minuet;, a menos que tenha um bom motivo para alterá-lo.

Finalmente, o parâmetro `Porta MIDI de saída` indica a porta que o &minuet; deverá usar para reproduzir os eventos &MIDI;. Novamente, o Assistente de Configuração do &minuet; já fornece valores apropriados para este parâmetro, mas fique à vontade para alterá-los se estiver usando outros sequenciadores &MIDI;, como por exemplo, o fluidsynth.

## 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;

## Instalação

### Requisitos

Para poder usar corretamente o &minuet;, você precisa de algumas bibliotecas do &kf5; 5.18 (CoreAddons, I18n, XmlGui, ConfigWidgets, DocTools, KIO). Além disso, o &minuet; utiliza o biblioteca Drumstick para as funcionalidades &MIDI;.

&documentation.index;