Editor

L'editor ha cinque aree: a sinistra le schede Livelli, Variabili, Media e Impostazioni (in più Ventoview bot per il chat bot e Scorciatoie per il modulo Scorciatoie), al centro la tela, a destra le proprietà del livello selezionato e in basso la timeline.

La scheda aperta sta in basso con il suo nome e si unisce all'area, le altre stanno sopra come piccole caselle con icona – passandoci sopra si vede il nome. Accanto alla scheda “Livelli” ci sono gli strumenti Apri tutti / Chiudi tutti (gruppi), Seleziona tutti, Deseleziona e ✦ Effetti; se la colonna è stretta si avvicinano, prendono nomi brevi e alla fine finiscono nel menu “⋯”.

Livelli

Livello	A cosa serve
Testo	Qualsiasi testo con variabili, es. Ora: {zeit}. Colori nel testo con [farbe=#ff0000]rosso[/farbe].
Immagine / Video	File tuoi (scheda Media) o immagini dei moduli. Alt mentre trascini le maniglie ritaglia. Forma: rettangolo (angoli anche singoli), cerchio/ovale, esagono, rombo, triangolo, stella, cuore. La cornice con larghezza, colore e stile (linea, trattini, punti, doppia) segue la forma. Sfocatura: quante ne vuoi una sopra l'altra (“+ Sfocatura”) – intera, bordo (centro nitido), un lato (alto/basso/sinistra/destra con portata), punto focale (cerchio nitido intorno a un punto) o tilt-shift (fascia nitida). Ognuna con intensità, morbidezza e “Inverti”.
Suono	Suona dal suo inizio nella timeline. Invisibile nell'overlay.
Pannello	Rettangolo con colore, sfumatura, angoli e cornice – es. come sfondo. “Solo bordo” (accanto al colore della cornice) rende il pannello trasparente.
Forma	15 forme (stella, anello, arco, freccia, cuore, fumetto, onda …) con regolazioni proprie come punte, spessore o angolo dell'arco. Anche qui c'è “Solo bordo”.
Gruppo	Cartella per più livelli, presente in ogni editor. Seleziona i livelli e “Raggruppa” (Ctrl+G) – oppure trascina i livelli sul gruppo nella lista. Un clic su un elemento seleziona l'intero gruppo: spostare, allineare, copiare, nascondere ed eliminare valgono per tutti. Un solo elemento: doppio clic sulla tela o clic nella lista. Ctrl+Shift+G o “Sciogli” lo scioglie di nuovo. In “Trasforma” il gruppo ha posizione, larghezza/altezza %, rotazione e opacità propri – agiscono su tutto il contenuto senza cambiare i livelli (un livello tolto torna com'era). Come un livello, anche il gruppo ha effetti (agiscono su tutti i livelli adatti al suo interno, es. effetti audio solo su suono/video) e keyframe: ◆ su ogni valore o “+ Traccia keyframe” per opacità, spostamento, dimensione, rotazione e i cursori degli effetti. Le sue tracce durano per tutta la lunghezza del design.
Modello	Incorpora un intero design salvato (modulo Link).
Barra, visualizer, coriandoli, cornice	Arrivano con i moduli (Musica, Stream-Chat, Alerts, Cornici …) e compaiono solo nell’editor di quel modulo o appena il modulo è fonte dati.
Lista	Mostra le ultime voci di una lista una sotto l'altra – la Stream-Chat, gli ultimi tasti premuti (Basic) o qualsiasi altra lista di un modulo (in “Fonte”). Più recenti in alto o in basso, con numero e durata. “Per riga s” stabilisce quanto resta ogni riga – contando dalla più recente: “3, 2, 0.5” = la più recente 3 s, sopra 2 s, in cima 0,5 s. “Esempio” sono righe visibili solo nell'editor finché non ci sono dati reali.

Sulla tela

• Spostare: trascina. Il livello si aggancia a bordi e centri della tela e di altri livelli (guide rosa). Alt = senza aggancio.
• Dimensione: con le maniglie. Gli angoli del testo scalano anche il carattere, le immagini mantengono le proporzioni (Shift = libero).
• Ruotare: maniglia rotonda in alto, Shift = passi di 15°.
• Scala % (a destra in “Posizione e dimensione”, cursore + numero): ingrandisce o rimpicciolisce l'intero livello con contenuto, cornice ed effetti – intorno al centro, senza cambiare larghezza, altezza o dimensione del carattere. Doppio clic sul cursore = 100 %. Con ◆ anche come traccia keyframe (es. reagire a un valore).
• Livelli sovrapposti: un clic seleziona quello in alto. Ctrl + clic sullo stesso punto seleziona quello sotto – ogni altro Ctrl-clic scende di uno. Un livello selezionato resta selezionato durante il trascinamento, anche se un altro è sopra.
• Selezionarne più: Shift + clic (nella lista livelli anche Ctrl + clic) o traccia un riquadro sulla tela vuota. Poi spostali, allineali o distribuiscili insieme.
• Bloccare la direzione: sopra la tela Libero / ↔ / ↕ – oppure Alt + G passa all'opzione successiva (libero → solo laterale → solo su/giù → libero). Shift durante il trascinamento usa la direzione principale.
• Regolare le aree: trascina i divisori tra le aree, doppio clic li ripristina. La colonna sinistra è larga almeno 250 px.
• Zoom: Alt + rotella – verso il mouse. La percentuale sopra la tela riadatta. Uno zoom impostato da te resta, anche se allarghi una colonna – l'immagine resta ferma.
• Spostare la tela ingrandita: rotella, Shift + rotella o trascina con il tasto centrale premuto. Se non si vede tutto, la tela ha un discreto bordo viola tutto intorno.
• Si può cliccare solo ciò che è visibile: i livelli non attivi nel momento attuale (timing, condizione, attivatore) non si possono cliccare sulla tela – nella lista livelli e nella timeline sì.
• Livelli fuori dalla tela si possono afferrare anche accanto e riportare dentro.

Griglia

Sopra la tela “Griglia” (tasto G). Due tipi:

• px: dimensione fissa delle celle in pixel, es. 20.
• Dividi: divide la tela in celle uguali – numero affiancate × una sotto l'altra. 2 × 1 dà una linea esattamente al centro, 3 × 3 i terzi. Trascinando, il bordo sinistro, il centro o il bordo destro si agganciano alla linea più vicina.

Con la griglia si agganciano anche le maniglie durante il ridimensionamento, Shift + freccia salta alla linea successiva, Alt disattiva brevemente l'aggancio.

Variabili

Nella scheda “Variabili” ci sono tutti i valori dei tuoi moduli. Un clic inserisce la variabile nel testo selezionato – o ne crea uno nuovo. In “Impostazioni → Fonti dati” aggiungi altri moduli, così le loro variabili sono disponibili nel design. Le tue variabili le crei nell'app in “Keywords”.

Condizioni

Ogni livello e ogni gruppo può avere condizioni – costruite come la logica nel codice:

• Condizione: variabile, confronto, valore – es. {cputemp} maggiore di 80. Confronti: è, non è, è uno di, non è nessuno di, contiene, maggiore/minore, almeno/al massimo.
• E / O: tra due voci c'è il collegamento – un clic lo cambia. E = devono valere tutte, O = ne basta una.
• Blocco ( ): raggruppa condizioni tra parentesi, con E/O propri all'interno. I blocchi si possono annidare.
• In alto una riga mostra come l'editor la legge, es. (tipo = sub E mesi > 3) O (tipo = giftsub).
• Gruppi: le loro condizioni valgono per tutti i livelli al loro interno – in aggiunta alle loro. Così accendi molti livelli insieme.

Keyframe e valori che reagiscono

Accanto a ogni campo numerico di un livello c'è un ◆: un clic crea una traccia keyframe per quel valore. Scorre nel tempo, segue un regolatore o reagisce a un valore live (musica, temperatura, chat …). Tutto qui: Timeline e keyframe e Reagire a un valore.

Timing e animazioni

In “Timing” stabilisci se un livello è sempre visibile o solo da–a. Per mostrare e nascondere ci sono dissolvenza, scorrimento, zoom, tendina in tutte le direzioni, dal centro, cerchio, sfocatura, comparsa, rotazione, caduta e apertura. Per andamenti personalizzati: keyframe.

Libreria effetti

All'estrema destra dei livelli, “✦ Effetti” apre una colonna proprio accanto ai livelli (la tela si sposta). In alto una ricerca, sotto le schede Preferiti e Tutti, con le sezioni Tutti · Audio · Immagine · Animazione:

• Immagine: bianco e nero, seppia, tonalità, saturazione, contrasto, inverti (negativo), chiaro ↔ scuro (inverte la luminosità, i colori restano), bagliore, ombra, aura (pulsante), contorno, luce, vignetta (immagine/video), dissolvenza (gradiente) e sfocatura graduale – direzione in gradi, inizio, lunghezza e curva (uniforme, prima veloce o prima lenta).
• Animazione: oscillare, pulsare, doppio battito, fluttuare, pendolo, ruotare, sfarfallio, arcobaleno, glitch – girano sempre. Con “Continuo” (a sinistra del volume) non saltano indietro alla fine del loop.
• Audio (suono e video): ovattato (passa-basso), telefono (passa-alto), eco, riverbero, distorsione, stereo. Il riverbero ha wet (riverbero) e dry (originale) separati, durata, pre-delay, morbidezza (da brillante a ovattato), taglio dei bassi, decadimento e ampiezza stereo. Gli effetti audio finiscono anche nell'esportazione video e WAV.

• ☆ a sinistra su una scheda rende l'effetto un preferito.
• I pacchetti di effetti dall'hub (cornice tratteggiata) applicano più effetti insieme, es. “Cassetta VHS”.
• Il cestino al passaggio del mouse rimuove un effetto o un pacchetto dalla lista – puoi recuperarlo nell'hub. I livelli che lo usano già lo mantengono.
• “Altro nell'hub” apre altri pacchetti di effetti.

Trascina un effetto su un livello o gruppo nella lista – oppure seleziona livelli o un gruppo e clicca “+”. Su un gruppo l'effetto resta al gruppo e agisce su tutti i livelli adatti al suo interno senza modificarli. Appare poi rientrato sotto il livello; a destra nelle proprietà lo regoli, lo spegni o cambi l'ordine. ◆ accanto a un cursore crea una traccia keyframe, es. bianco e nero da 0 a 100 % in due secondi o l'eco tramite un regolatore MIDI.

Scambiare un effetto: il nome in alto nella scheda è una selezione – un altro effetto della stessa categoria lo sostituisce, i regolatori uguali mantengono valore e keyframe. Sbloccare un’area (lucchetto nella scheda, per gli effetti immagine): l’effetto agisce solo in un rettangolo – X, Y, larghezza, altezza (e per i filtri un bordo morbido), tutto animabile con ◆. Con “Segui elemento” l’area si sposta e si ridimensiona con l’elemento (valori in % della sua dimensione) – es. bianco e nero solo sulla metà inferiore di un’immagine, che resta così quando sposti o ingrandisci l’immagine. Senza, l’area resta fissa sulla tela. Sulla tela una cornice tratteggiata mostra l’area: trascina la linguetta = sposta, l’angolo = dimensione.

Effetti

• Visibile % con direzione della tendina e bordo morbido – taglia il livello come una tendina, ideale con una traccia keyframe.
• Sfocatura per l'intero livello.

Attivatori

In “Impostazioni → Attivatori” crei regole, es. “noob 3× in 10 s”, “!hype” in chat o una scorciatoia. I livelli che assegni a un attivatore appaiono solo quando scatta – il loro timing conta da quel momento. “Anteprima” lo riproduce nell'editor, “Prova in chat” anche nel tuo software di streaming. Le scorciatoie hanno una scheda propria – vedi Scorciatoie.

Con il modulo Basic ci sono anche pressione tasto e clic del mouse (dalla visualizzazione tasti): ogni nuova voce di quel tipo attiva, “Solo per” limita a tasti precisi (separati da virgola, vuoto = qualsiasi).

Animazioni attivate

Ogni elemento – livello o gruppo – può avere animazioni proprie: come animazione di entrata o uscita in Timing o avviate da una condizione, mentre la timeline continua normalmente.

• Creare: a destra in “Animazioni attivate” o con il fulmine nella riga dell’elemento nella timeline.
• Modificare: “Apri timeline” mostra una timeline solo per questa animazione, da 0 s alla sua durata (nel campo in alto dove di solito c’è “Durata del loop”). Area di loop, griglia, zoom e inserire tempo funzionano come sempre. Con ◆ accanto a ogni valore crei tracce. Ha l’aspetto e il funzionamento della timeline normale: l’elemento come riga (la freccia apre le tracce), la barra è l’animazione – trascinare il bordo destro cambia la durata, quello sinistro taglia l’inizio. Tutto il resto resta com’è in quel momento. “Fatto” riporta indietro. Copiata o dalla libreria, posizione, rotazione e dimensione si adattano al nuovo elemento.
• Avvio: con un attivatore (parola in chat, comando, scorciatoia, pressione tasto, clic del mouse …), quando cambia una variabile, quando una condizione è soddisfatta – o “senza attivatore”, solo come entrata/uscita.
• Entrata/uscita: per elementi non “sempre visibili” scegli in Timing sotto “Entrata” o “Uscita” un’animazione dell’elemento o una dalla libreria. La sua durata diventa la durata. Per i gruppi si trova nella loro sezione “Entrata/uscita” – il loro tempo va dal primo all’ultimo livello.
• Insieme alla timeline: se la timeline anima lo stesso valore, agiscono entrambe: opacità e dimensione si moltiplicano, spostamento, rotazione e sfocatura si sommano. Campi come la dimensione del carattere e i regolatori degli effetti li prende l’animazione. Alla fine tutto torna dolcemente al valore normale entro “Ritorno” (secondi). Se l’attivatore torna, ricomincia da capo.
• Copiare e incollare: “Copia” sull’animazione, poi seleziona un altro elemento e premi Ctrl+V (o “Incolla” sul fulmine). Se qualcosa non va – ad es. la dimensione del carattere su un’immagine – ricevi un messaggio e non cambia nulla. Altrimenti una finestra mostra cosa viene animato, quali effetti si aggiungono e se usarla come entrata, uscita o con un attivatore.
• Rinominare ed eliminare: il nome è in alto nell’animazione (a destra). Il cestino lì – o “Elimina” nel menu del fulmine – la rimuove insieme ai suoi keyframe; se era scelta come entrata o uscita, lì poi non è più impostata nessuna transizione.

Libreria “Animazioni”: il pulsante con il fulmine accanto a “✦ Effetti” presso i livelli. Contiene animazioni pronte di Ventoview (dissolvenza, comparsa, entrata in volo, impulso, oscillazione, illuminazione …) e le tue – con ricerca, preferiti e i filtri Entrata · Uscita · All’attivatore. Trascina su un elemento o clicca “+” per inserirle. Le tue le salvi con “Salva” su un’animazione (nome e a cosa serve); restano nell’app e valgono per tutti i design (app Ventoview 0.0.4 o più recente). Le tue le elimini lì con il cestino.

Esempio: il modello Basic “Tasti e mouse” – sopra la riga più in basso c’è “Dissolvenza (gradiente)” con un’area propria, un’animazione fa apparire dolcemente la nuova riga a ogni tasto (tastiera e mouse separati).

Ripetere e nascondere

In “Impostazioni” i moduli offrono comportamenti pronti, es. “Una volta per alert” (il design viene riprodotto una volta per evento, più eventi uno dopo l'altro) o “Nascondi quando non suona nulla”.

Prova

Se non è selezionato nulla, il lato destro ha due pagine: Design e Prova. In Prova simuli ciò che può succedere nello stream. Si vedono solo i test adatti al design – al modulo dell'editor o a una fonte dati (es. scorciatoie solo se c'è Scorciatoie). Il centro diventa la finestra di test: lì gira l'overlay vero così come appare nello stream.

• Messaggio in chat: nome e testo, es. !elo. Appare nell'overlay della chat, attiva gli attivatori di parole e comandi, e il chat bot mostra cosa risponderebbe (se vuoi, scrive davvero).
• Evento dello stream: follow, abbonamento, resub (mesi), abbonamenti regalo (numero), bits (quantità), raid (spettatori), punti canale – con nome, livello e messaggio.
• Scorciatoia: attiva con un clic qualsiasi scorciatoia dell'app.
• Prova valori: imposta qualsiasi variabile su un valore di test, es. grado o temperatura CPU – solo nell'editor, per verificare condizioni e testi.
• Test rapidi dei moduli (prima in Impostazioni).

Gli eventi passano dall'app come quelli veri – anche nel tuo software di streaming. I valori di test valgono solo nell'editor e spariscono ricaricando.

Modelli

“Modelli” in alto mostra i modelli del modulo – quelli standard e tutto ciò che hai preso dall'hub. Al passaggio del mouse × rimuove un modello dalla lista (quelli standard vengono solo nascosti). “Altro nell'hub” apre l'hub direttamente ai modelli di questo modulo – lì recuperi anche quelli rimossi. Un design vuoto lo inizi con “Nuovo”.

Media

Nella scheda “Media” ci sono le immagini, i video e i suoni dei moduli e i tuoi (carica, trascina sulla tela – diventa subito un livello – oppure trascina dal PC sulla scheda “Media” – finisce solo nei tuoi media). Ogni sezione si può comprimere dal suo titolo. I suoni mostrano nome, forma d'onda e un pulsante rotondo ▶ per ascoltarli (uno alla volta). Il volume si regola con il cursore 🔊 a destra sopra la timeline.

Salvare

“Salva” (Ctrl+S) memorizza il design nell'app. Con il campo di selezione in alto apri i design salvati, “Nuovo” ne inizia uno vuoto. Per condividerlo: Condividere modelli.