﻿Polivoks — emulação do sintetizador Polivoks: instalação e uso
==============================================================

Formatos:
- Windows x64: Polivoks.vst3 (para a sua DAW) e Polivoks.exe (aplicativo independente).
- macOS 10.15 ou posterior, Apple Silicon e Intel: Polivoks.component (Audio Unit para Logic Pro,
  GarageBand, MainStage), Polivoks.vst3 (Ableton Live, Bitwig, Reaper, Cubase e outras DAWs)
  e Polivoks.app (aplicativo independente).


INSTALAÇÃO — WINDOWS
--------------------
1. Copie a pasta Polivoks.vst3 inteira para
   C:\Program Files\Common Files\VST3\
2. Ableton Live: Options -> Settings (Preferences em versões antigas) -> Plug-Ins:
   ative “Use VST3 Plug-In System Folders” e clique em “Rescan”.
3. O plugin aparece no navegador em Plug-Ins -> VST3 (possivelmente na pasta
   Ivan Abrosimov). Arraste-o para uma faixa MIDI.

Sem DAW: o Polivoks.exe é um aplicativo independente com teclado na tela.
Options -> Audio/MIDI Settings: escolha a sua interface de áudio e o seu teclado MIDI.

O Windows pode exibir um aviso do SmartScreen para o Polivoks.exe porque o programa não é
assinado. Clique em “Mais informações” (More info) -> “Executar assim mesmo” (Run anyway).


INSTALAÇÃO — macOS
------------------
1. Copie os arquivos:
     Polivoks.component -> ~/Library/Audio/Plug-Ins/Components/
     Polivoks.vst3      -> ~/Library/Audio/Plug-Ins/VST3/
   (A pasta ~/Library fica oculta: no Finder, use Ir -> Ir para a Pasta… (Go -> Go to Folder…)
   e digite o caminho.)
2. O plugin ainda não é assinado com um certificado da Apple, por isso o macOS bloqueia arquivos
   baixados da internet. Execute estes comandos uma vez no Terminal:
     xattr -dr com.apple.quarantine ~/Library/Audio/Plug-Ins/Components/Polivoks.component
     xattr -dr com.apple.quarantine ~/Library/Audio/Plug-Ins/VST3/Polivoks.vst3
     xattr -dr com.apple.quarantine /path/to/Polivoks.app
3. Logic Pro: Logic Pro -> Settings -> Plug-in Manager. Encontre Ivan Abrosimov -> Polivoks;
   se ele não passou na validação, clique em “Reset & Rescan Selection”.
   O plugin fica em AU Instruments -> Ivan Abrosimov -> Polivoks.
4. O Ableton Live e outras DAWs no Mac usam o Polivoks.vst3 — ative o VST3 nas configurações de
   plug-ins da DAW e faça uma nova varredura.


ONDE SEUS DADOS FICAM ARMAZENADOS
---------------------------------
- Seus presets (*.polivoks):
    Windows: Documents\Polivoks\Presets
    macOS:   ~/Library/Audio/Presets/Ivan Abrosimov/Polivoks
- Avaliações (ratings.xml), mapeamentos padrão do MIDI Learn (midi-map.xml), idioma e o
  indicador de primeira execução (settings.xml):
    Windows: %APPDATA%\Polivoks
    macOS:   ~/Library/Application Support/Polivoks


CONTROLES
---------
- Todos os knobs estão dispostos como no painel original. Um clique duplo retorna o knob ao valor
  padrão.
- Um guia detalhado de cada controle está embutido no plugin: engrenagem no canto superior
  direito -> aba GUIA (nos 13 idiomas).
- Chave SEGURAR (embaixo à direita, na seção do amplificador; “ВКЛ.” no original):
  para cima (ON) — as notas tocadas continuam soando depois que você solta as teclas; um acorde
  novo, tocado depois de soltar todas as teclas, substitui o que está seguro; ao ligar, soa a
  última nota tocada (se nada foi tocado ainda — silêncio até a primeira nota).
  Para baixo (OFF) — modo normal.
- Chave SAÍDA: ON — o som passa, OFF — o plugin fica mudo.
- A roda de modulação (CC1) ou um pedal de expressão (CC11) funciona como pedal de corte, como no
  original.
- O pitch bend e o pedal de sustain funcionam, embora o original não tivesse nenhum dos dois.
- Entrada externa: o plugin tem uma entrada de áudio, mas se a sua DAW envia áudio para a entrada
  de um instrumento depende da DAW (ainda não verificado no Ableton). O nível de entrada é
  ajustado com o knob EXTERNA; junto com SEGURAR (toque uma nota), o filtro funciona como efeito.

Barra superior (não existe no original)
Da esquerda para a direita: BIBLIOTECA, ◀ nome do preset ▶, avaliação, SALVAR, APOIE O AUTOR;
à direita — TEMPO e a engrenagem.

Teclado embaixo
- Faixa MIDI completa (C-1…G9), 4 oitavas na tela. Role com as setas nas pontas, com a roda do
  mouse ou com um gesto no touchpad. Clique em uma tecla com o mouse para tocar uma nota.


IDIOMA DA INTERFACE
-------------------
- 13 idiomas: inglês, chinês, hindi, espanhol, árabe, francês, bengali, português, indonésio,
  urdu, russo, alemão, japonês.
- Escolha o idioma na janela “Sobre” ou nas configurações (engrenagem -> aba GUIA ->
  IDIOMA DA INTERFACE). São traduzidos: os textos do painel, a barra superior, a biblioteca, as
  configurações, os nomes dos presets de fábrica, o guia e os nomes e valores dos parâmetros
  exibidos pela sua DAW. O logotipo “ПОЛИВОКС” continua como no original.
- Algumas DAWs só releem os nomes dos parâmetros depois que o plugin ou o projeto é recarregado.


SOBRE O PLUGIN E COMO APOIAR O AUTOR
------------------------------------
- Na primeira execução de cada formato (VST3 em uma DAW, AU no Logic, o aplicativo independente)
  aparece a janela “Sobre” (em inglês por padrão; escolha o idioma na lista no topo da janela).
  Feche-a com “Continuar” — ela não aparecerá de novo.
- Para abri-la novamente, clique em APOIE O AUTOR na barra superior: lá estão as doações e os
  contatos.
- Os termos de uso estão na pasta License (um arquivo no seu idioma).


PRESETS
-------
- BIBLIOTECA (ou um clique no nome do preset) abre a lista. Clique em uma linha para carregar o
  preset.
  Filtros à esquerda: TODOS / DE FÁBRICA / DO USUÁRIO, AVALIAÇÃO MÍNIMA (1–5 estrelas), busca
  por nome e descrição. As setas ◀ ▶ percorrem os presets respeitando esses filtros.
- Avaliação: clique em uma estrela para avaliar; clique de novo na mesma estrela para remover a
  avaliação.
  Você pode avaliar na lista e na barra superior. As avaliações são compartilhadas por todas as
  instâncias do plugin neste computador.
- SALVAR guarda o som atual como seu próprio preset. Se o nome já existir, o preset é
  substituído (um aviso informa você). Exclua seus presets na biblioteca: EXCLUIR e depois
  EXCLUIR MESMO?.
- Seus presets ficam na pasta de presets (veja “Onde seus dados ficam armazenados”; botão
  ABRIR PASTA DE PRESETS na biblioteca). Você pode copiá-los entre computadores.
- Um asterisco e MODIFICADO ao lado do nome indicam que o som difere do preset salvo.
- Os presets não guardam o andamento nem a chave SAÍDA.


TEMPO
-----
- PROJETO — o andamento e a grade vêm da sua DAW. MANUAL — defina o andamento no campo à
  direita: arraste para cima/baixo (segure Shift para ajuste fino), use a roda do mouse ou
  clique duas vezes e digite um número (30–300 BPM).
- O aplicativo independente não tem projeto, por isso tem apenas o campo de andamento manual.
- Se a DAW não informar o andamento, o plugin usa o próprio andamento.

Sincronização com o andamento
- Modulador: o botão SINC. ANDAMENTO abaixo do knob VELOCIDADE. Quando ele está aceso, o knob
  VELOCIDADE vira DIVISÃO: de 4 compassos a 1/32, incluindo valores pontuados (.) e quiálteras
  (T). O andamento atual e a origem dele aparecem à direita. No modo PROJETO, durante a
  reprodução, a fase do modulador segue a grade do projeto; com a reprodução parada, o modulador
  continua rodando no mesmo andamento.
- Loops de envelope: a chave MODO ENV. no filtro e no amplificador tem três posições —
  Uma vez / Loop / TEMPO. Na posição TEMPO, o envelope reinicia a cada divisão da grade (knob
  DIVISÃO ao lado) enquanto uma tecla estiver pressionada ou SEGURAR estiver ligado.


ENGRENAGEM NO CANTO SUPERIOR DIREITO
------------------------------------
Um painel se abre no lado direito da janela (a janela fica mais larga). Abas:
- GUIA — abre primeiro: escolha do idioma e um guia detalhado de todos os parâmetros no idioma
  selecionado (o sumário é clicável). O idioma vale para o plugin inteiro.
- MIDI — MIDI Learn (abaixo).

MIDI Learn (engrenagem -> aba MIDI)
Muitas DAWs (por exemplo, o Ableton com Push) mapeiam os parâmetros para um controlador por conta
própria — nesse caso, você não precisa do MIDI Learn. Ele ajuda quando a sua DAW não faz isso.
1. Engrenagem -> aba MIDI -> ATIVAR MIDI LEARN — os knobs se acendem.
2. Clique em um knob ou chave — ele fica selecionado.
3. Mova um knob no seu controlador — o mapeamento está feito, e o número do CC aparece no knob.
- Neste modo, clique com o botão direito em um controle mapeado para remover o mapeamento; a
  lista à direita tem um X para cada mapeamento.
- Para sair do modo: SAIR no banner acima do painel, o botão nas configurações ou Esc.
- Os mapeamentos são salvos com o projeto. SALVAR COMO MAPEAMENTOS PADRÃO — novas instâncias do
  plugin já começam com eles (arquivo midi-map.xml, veja “Onde seus dados ficam armazenados”).
- O controlador precisa chegar à faixa MIDI com o plugin (no Ableton: a entrada da faixa é o seu
  controlador, Monitor em In, ou em Auto com a gravação armada). Se o mesmo controlador estiver
  atribuído no MIDI Map do Ableton (Ctrl+M no Windows, Cmd+M no Mac), o Ableton o captura antes
  do plugin.
- Um CC mapeado controla apenas o parâmetro: se você mapear o CC1 (roda de modulação) ou o CC64
  (sustain), a função habitual deles fica desativada para este plugin.
