﻿Polivoks — emulación del sintetizador Polivoks: instalación y uso
=================================================================

Formatos:
- Windows x64: Polivoks.vst3 (para su DAW) y Polivoks.exe (aplicación independiente).
- macOS 10.15 o posterior, Apple Silicon e Intel: Polivoks.component (Audio Unit para Logic Pro,
  GarageBand, MainStage), Polivoks.vst3 (Ableton Live, Bitwig, Reaper, Cubase y otras DAW)
  y Polivoks.app (aplicación independiente).


INSTALACIÓN — WINDOWS
---------------------
1. Copie la carpeta Polivoks.vst3 completa en
   C:\Program Files\Common Files\VST3\
2. Ableton Live: Options -> Settings (Preferences en versiones anteriores) -> Plug-Ins:
   active «Use VST3 Plug-In System Folders» y haga clic en «Rescan».
3. El plugin aparece en el navegador, en Plug-Ins -> VST3 (posiblemente en la carpeta
   Ivan Abrosimov). Arrástrelo a una pista MIDI.

Sin DAW: Polivoks.exe es una aplicación independiente con teclado en pantalla.
Options -> Audio/MIDI Settings: elija su interfaz de audio y su teclado MIDI.

Windows puede mostrar una advertencia de SmartScreen para Polivoks.exe porque el programa no está
firmado. Haga clic en «Más información» (More info) -> «Ejecutar de todas formas» (Run anyway).


INSTALACIÓN — macOS
-------------------
1. Copie los archivos:
     Polivoks.component -> ~/Library/Audio/Plug-Ins/Components/
     Polivoks.vst3      -> ~/Library/Audio/Plug-Ins/VST3/
   (La carpeta ~/Library está oculta: en el Finder, use Ir -> Ir a la carpeta…
   (Go -> Go to Folder…) y escriba la ruta).
2. El plugin aún no está firmado con un certificado de Apple, por lo que macOS bloquea los
   archivos descargados de Internet. Ejecute estos comandos una sola vez en 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. Busque Ivan Abrosimov -> Polivoks;
   si no ha superado la validación, haga clic en «Reset & Rescan Selection».
   El plugin se encuentra en AU Instruments -> Ivan Abrosimov -> Polivoks.
4. Ableton Live y otras DAW en Mac usan Polivoks.vst3: active VST3 en los ajustes de plugins de
   la DAW y vuelva a escanear.


DÓNDE SE GUARDAN SUS DATOS
--------------------------
- Sus presets (*.polivoks):
    Windows: Documents\Polivoks\Presets
    macOS:   ~/Library/Audio/Presets/Ivan Abrosimov/Polivoks
- Valoraciones (ratings.xml), asignaciones predeterminadas de MIDI Learn (midi-map.xml), idioma
  y la marca de primer inicio (settings.xml):
    Windows: %APPDATA%\Polivoks
    macOS:   ~/Library/Application Support/Polivoks


CONTROLES
---------
- Todos los mandos están dispuestos como en el panel original. Un doble clic devuelve el mando a
  su valor predeterminado.
- El plugin incluye una guía detallada de cada control: engranaje arriba a la derecha ->
  pestaña GUÍA (en los 13 idiomas).
- Interruptor RETENER (abajo a la derecha, en la sección del amplificador; «ВКЛ.» en el
  original): arriba (ON) — las notas tocadas siguen sonando después de soltar las teclas; un
  acorde nuevo, tocado tras soltar todas las teclas, sustituye al retenido; al activarlo, suena
  la última nota tocada (si todavía no se ha tocado nada, silencio hasta la primera nota).
  Abajo (OFF) — modo normal.
- Interruptor SALIDA: ON — el sonido pasa, OFF — el plugin queda silenciado.
- La rueda de modulación (CC1) o un pedal de expresión (CC11) funciona como pedal de corte, igual
  que en el original.
- El pitch bend y el pedal de sostenido funcionan, aunque el original no tenía ninguno de los
  dos.
- Entrada externa: el plugin tiene una entrada de audio, pero que la DAW envíe audio a la entrada
  de un instrumento depende de la DAW (aún no comprobado en Ableton). El nivel de entrada se
  ajusta con el mando EXTERNA; junto con RETENER (toque una sola nota), el filtro funciona como
  efecto.

Barra superior (no existe en el original)
De izquierda a derecha: BIBLIOTECA, ◀ nombre del preset ▶, valoración, GUARDAR, APOYA AL AUTOR;
a la derecha, TEMPO y el engranaje.

Teclado inferior
- Rango MIDI completo (C-1…G9), 4 octavas en pantalla. Desplácese con las flechas de los
  extremos, la rueda del ratón o un gesto en el touchpad. Haga clic con el ratón en una tecla
  para tocar una nota.


IDIOMA DE LA INTERFAZ
---------------------
- 13 idiomas: inglés, chino, hindi, español, árabe, francés, bengalí, portugués, indonesio, urdu,
  ruso, alemán, japonés.
- Se elige en la ventana «Acerca de» o en los ajustes (engranaje -> pestaña GUÍA ->
  IDIOMA DE LA INTERFAZ). Se traducen: las etiquetas del panel, la barra superior, la biblioteca,
  los ajustes, los nombres de los presets de fábrica, la guía, y los nombres y valores de los
  parámetros que muestra la DAW. El logotipo «ПОЛИВОКС» se mantiene como en el original.
- Algunas DAW solo vuelven a leer los nombres de los parámetros después de recargar el plugin o
  el proyecto.


ACERCA DEL PLUGIN Y APOYO AL AUTOR
----------------------------------
- En el primer inicio de cada formato (VST3 en una DAW, AU en Logic, la aplicación independiente)
  aparece la ventana «Acerca de» (en inglés de forma predeterminada; el idioma se elige en la
  lista de la parte superior de la ventana). Ciérrela con «Continuar»; no volverá a aparecer.
- Para abrirla de nuevo, haga clic en APOYA AL AUTOR en la barra superior: allí encontrará las
  donaciones y los contactos.
- Las condiciones de uso están en la carpeta License (un archivo en su idioma).


PRESETS
-------
- BIBLIOTECA (o un clic en el nombre del preset) abre la lista. Haga clic en una fila para cargar
  el preset.
  Filtros a la izquierda: TODOS / DE FÁBRICA / DEL USUARIO, VALORACIÓN MÍNIMA (1–5 estrellas),
  búsqueda por nombre y descripción. Las flechas ◀ ▶ recorren los presets respetando estos
  filtros.
- Valoración: haga clic en una estrella para valorar; vuelva a hacer clic en la misma estrella
  para borrar la valoración.
  Puede valorar en la lista y en la barra superior. Las valoraciones son comunes a todas las
  instancias del plugin en este equipo.
- GUARDAR almacena el sonido actual como preset propio. Si el nombre ya existe, el preset se
  sobrescribe (un aviso se lo indica). Los presets propios se eliminan en la biblioteca:
  ELIMINAR y, a continuación, ¿ELIMINAR?.
- Sus presets están en la carpeta de presets (véase «Dónde se guardan sus datos»; botón
  ABRIR CARPETA DE PRESETS en la biblioteca). Puede copiarlos de un equipo a otro.
- Un asterisco y MODIFICADO junto al nombre indican que el sonido difiere del preset guardado.
- Los presets no guardan el tempo ni el interruptor SALIDA.


TEMPO
-----
- PROYECTO — el tempo y la cuadrícula vienen de la DAW. MANUAL — ajuste el tempo en el campo de
  la derecha: arrastre hacia arriba/abajo (con Shift, en pasos finos), use la rueda del ratón o
  haga doble clic y escriba un número (30–300 BPM).
- La aplicación independiente no tiene proyecto, por lo que solo dispone del campo de tempo
  manual.
- Si la DAW no comunica el tempo, el plugin usa su propio tempo.

Sincronización con el tempo
- Modulador: el botón SINC. TEMPO bajo el mando VELOCIDAD. Cuando está encendido, el mando
  VELOCIDAD se convierte en DIVISIÓN: de 4 compases a 1/32, con valores con puntillo (.) y
  tresillos (T). El tempo actual y su origen se muestran a la derecha. En el modo PROYECTO,
  durante la reproducción, la fase del modulador sigue la cuadrícula del proyecto; con el
  transporte detenido, el modulador sigue funcionando al mismo tempo.
- Ciclos de envolvente: el interruptor MODO ENV. del filtro y del amplificador tiene tres
  posiciones: Una vez / Bucle / TEMPO. En la posición TEMPO, la envolvente se reinicia en cada
  división de la cuadrícula (mando DIVISIÓN contiguo) mientras se mantiene pulsada una tecla o
  RETENER está activado.


ENGRANAJE ARRIBA A LA DERECHA
-----------------------------
Se abre un panel en el lado derecho de la ventana (la ventana se ensancha). Pestañas:
- GUÍA — se abre primero: selección de idioma y una guía detallada de todos los parámetros en el
  idioma elegido (se puede hacer clic en el índice). El idioma se aplica a todo el plugin.
- MIDI — MIDI Learn (véase más abajo).

MIDI Learn (engranaje -> pestaña MIDI)
Muchas DAW (por ejemplo, Ableton con Push) asignan por sí mismas los parámetros a un controlador;
en ese caso, MIDI Learn no es necesario. Resulta útil cuando la DAW no lo hace.
1. Engranaje -> pestaña MIDI -> ACTIVAR MIDI LEARN: los mandos se iluminan.
2. Haga clic en un mando o interruptor: queda seleccionado.
3. Mueva un mando de su controlador: la asignación queda hecha y el número de CC aparece en el
   mando.
- En este modo, un clic derecho sobre un control asignado elimina su asignación; en la lista de
  la derecha, cada asignación tiene una cruz.
- Para salir del modo: SALIR en el banner situado sobre el panel, el botón de los ajustes o Esc.
- Las asignaciones se guardan con el proyecto. GUARDAR COMO ASIGNACIONES PREDETERMINADAS: las
  nuevas instancias del plugin se inician con ellas (archivo midi-map.xml, véase «Dónde se
  guardan sus datos»).
- El controlador debe llegar a la pista MIDI del plugin (en Ableton: la entrada de la pista es su
  controlador y Monitor está en In, o en Auto con la grabación armada). Si el mismo controlador
  está asignado en el MIDI Map de Ableton (Ctrl+M en Windows, Cmd+M en Mac), Ableton lo capta
  antes que el plugin.
- Un CC asignado controla solo el parámetro: si asigna CC1 (rueda de modulación) o CC64
  (sostenido), su función habitual queda desactivada para este plugin.
