# A Interface do Sonic Pi

O Sonic Pi tem um interface muito simples para programar música. Vamos passar algum tempo explorando-a.

- A - Controles de Reprodução
- B - Controles do Editor
- C - Informação e Ajuda
- D - Editor (de código)
- E - Painel de Opções
- F - Vizualizador de Logs
- G - Sistema de Ajuda
- ‘H’ - Osciloscópio
- F - Vizualizador de cues

## A. Controles de Reprodução

Estes botões rosa são os controlos principais para reproduzir e parar sons. O botão Run serve para reproduzir o código no editor, Stop para parar todas as reproduções, Save para guardar o código num ficheiro externo e Record para gravar (num ficheiro WAV) o som que estiver a tocar.

## B. Controles do Editor

Estes butões laranja permitem manipular o editor de código. Os butões de Tamanho + e “Tamanho -“permitem fazer com que o texto seja maior e mais pequeno.

## C. Informação e Ajuda

Estes botões azuis dão-te acesso a informação, ajuda e opções. O botão Info abre a janela de informação que contém informação sobre o Sonic Pi em si – a equipa, histórico de actualizações, contribuidores e a comunidade. O botão Ajuda abre e fecha o sistema de ajuda (F) e o botão Opções abre e fecha a janela das opções que te permitem controlar alguns parâmetros básicos do sistema.

## D. Editor (de código)

Esta é a área onde irá escrever o seu código e compor/tocar a sua música. Trata-se de um editor de texto simples onde pode escrever código, apagá-lo, ou modificá-lo. Pense no que é uma versão básica do Word ou do Google Docs. O editor irá mudar de cores automaticamente tendo em conta as propriedades do código. Pode parecer estranho em primeiro lugar, mas brevemente irá chegar à conclusão que isto é bastante útil. Por exemplo, irá ficar a saber que algo é um número, no instante, em que o caracter assumir a cor base azul

## E. Painel de Opções

O Sonic Pi suporta um número de preferências que podem ser acedidas ao carregar no botão Prefs. Isto abre o painel das opções que inclui várias opções alteráveis. Alguns exemplos são forçar o mono mode, inverter o stereo, activar/desactivar logs e também um slider para o volume e selector de audio no Raspberry Pi.

## F. Visualizador de logs

Quando corres o teu código, vai ser mostrada informação sobre o que o programa está a fazer no Vizualizador do log. Por defeito, verás uma mensagem por cada som que crias com a hora exacta a que começou a tocar. Isto é útil para debugging e perceber o que o teu código está a fazer.

## G. Sistema de Ajuda

Uma das partes mais importantes da interface do Sonic Pi, é o sistema de ajuda que aparece por baixo da janela. Isto pode ser exibido através do botão azul intitulado “Help”. O sistema contém informação de ajuda acerca de todos os aspectos do SOnic Pi, incluindo este tutorial, e uma lista dos sintetizadores e samples disponíveis, assim como efeitos e uma lista completa de todas as função que o Sonic Pi disponibiliza para fins de criação musical

## H. Osciloscópio

O osciloscópio permite visualizar a forma de onde do sinal de áudio reproduzido. É possível observar fcilmente a forma de uma onda triangular e constatar que o sinal se aproxima de parece uma forma de onda triangular e que um beep básico tem uma curva de sinosoidal. É também possível constatar a diferença entre um som alto e um som calmo através do tamanho das linhas. Existem três osciloscópios com os quais é possível trabalhar-se - o pré-definido é uma combinação do osciloscópio para o canal esquerdo e direito. Existe um osciloscópio estéreo que desenha um osciloscópio com linhas separadas para cada canal. Finalmente, existe um osciloscópio com curva Lissajous que permite ver a relação de fase entre o canal esquerdo e direito e permite desenhar imagens bonitas a partir da forma do som (https://en.wikipedia.org/wiki/Lissajous_curve).

## F. Visualizador de logs

Todos os eventos internos e externos (chamados ‘cues’ no Sonic Pi) são automaticamente registrados no Visualizador de Cues. Por exemplo, se tiver um controlador MIDI conectado e pressionar um dos seus botões, ira aparecer um novo evento no Visualizador de Cues a dizer o nome do controlador e que botão foi pressionado. Quando tiver aperfeiçoado as bases para fazer e produzir sons, poderás “cue” sons ou secções inteiras de som baseado em eventos como estes. Um evento “cue” ‘e apenas uma indicação que algo aconteceu. Por exemplo, todas às vezes que um loop “activo” se repete, envia um “cue” evento que ‘e registado no Visualizador de Cues. Todos os eventos como mensagens MIDI e/ou mensagens de OSCiladores de outros programas ou computadores também são apresentados no Visualizador de Cues. Também ‘e possível de gerar diretamente eventos “cue” usando a função `cue`. Qualquer evento registado no Visualizador de Cues pode ser usado para accionar qualquer funcionalidade. Isso é abordado com mais detalhes nas secções 10 a 12 deste tutorial.