Domande frequenti

Risposte rapide alle domande più comuni su MotioForge Studio.

Configurazione iniziale

D: Per iniziare, quali sono i passaggi essenziali?

R: 1. Crea un dominio (Schermata iniziale). 2. Configura le porte seriali (COM). 3. Aggiungi gli elementi (servo, switch, audio). 4. Apri l'editor principale e crea la prima animazione. Vedi Guida rapida per i dettagli.

D: Dove salva MotioForge Studio i miei progetti?

R: Nella cartella domini, che configuri dal menu Impostazioni → Percorsi... della schermata iniziale. Di default è %LOCALAPPDATA%\ARES\domains. Ogni dominio è una sottocartella con file JSON.

D: Posso condividere un progetto con un'altra persona?

R: Sì. Copia l'intera cartella del dominio su una chiavetta USB o cloud (OneDrive, Google Drive, ecc.). L'altra persona la mette nella sua cartella dominio radice e MotioForge la legge. I percorsi audio sono relativi, quindi funziona anche su computer diversi (se i file audio sono nella stessa cartella).

Timeline e animazioni

D: Come cambio la velocità di riproduzione della timeline?

R: Non esiste una "velocità di riproduzione" globale. La velocità è definita per ogni segmento servo (0–100). Per accelerare tutto, seleziona tutti i segmenti, fai clic destro e riduci il valore di velocità nei segmenti singoli.

D: Come faccio a creare un'animazione che si ripete continuamente?

R: Apri le Proprietà animazione (fai clic destro sull'animazione nella Schermata iniziale). Attiva l'opzione Ciclo continuo. Quando avvii la riproduzione, l'animazione si ripete finché non la fermi.

D: Qual è la durata massima di un'animazione?

R: Non c'è limite teorico. La durata è data dal segmento più lontano nel tempo. Puoi creare animazioni di ore, ma il file rimane compatto (sono solo dati JSON).

D: Posso copiare un'animazione da un dominio a un altro?

R: Non direttamente dall'interfaccia. Apri la cartella del dominio, copia il file della animazione da domain/animations/<id>/ in un altro dominio, e riavvia MotioForge.

D: A cosa serve la Partenza ritardata casuale?

R: La Partenza ritardata casuale è una proprietà dell'animazione che aggiunge un ritardo casuale all'inizio della riproduzione. Quando abilitata, tutti i segmenti vengono decalati temporalmente di un valore randomico. Questo è utile per creare comportamenti naturali e non meccanici. Ad esempio, il battito delle palpebre: invece di battere gli occhi sempre ogni 5 secondi in modo preciso, puoi configurare un'animazione con partenza ritardata casuale (es. 4–6 secondi) così il movimento appare spontaneo e realistico ogni volta che l'animazione viene avviata. Configura questa opzione nelle Proprietà dell'animazione (fai clic destro sull'animazione nella Schermata iniziale).

Gestione dei segmenti

D: Come inserisco un segmento sulla timeline?

R: 1. Tieni premuto Shift. 2. Clicca e trascina orizzontalmente sulla pista dell'elemento desiderato. 3. Rilascia: il segmento viene creato. L'altezza verticale a cui inizi il trascinamento determina la posizione iniziale del servo (alto = posizione alta, basso = posizione bassa). Vedi La timeline per più dettagli.

D: Come sposto uno o più segmenti?

R: 1. Clic sinistro sul segmento per selezionarlo. 2. Per selezionare più segmenti contemporaneamente: Ctrl+clic sinistro per aggiungere altri segmenti alla selezione. 3. Clicca e trascina su un segmento selezionato per spostare tutti i segmenti selezionati. Se trascini l'estremità sinistra o destra, ridimensioni il segmento anziché spostarlo.

D: Come modifico le proprietà di un segmento?

R: 1. Clic sinistro sul segmento per selezionarlo. 2. Apri il menu Segmenti nella barra dei menu. 3. Scegli Proprietà Segmento. Si apre l'editor dettagliato dove puoi modificare posizione angolare, velocità, curva di accelerazione, durata, tipo di movimento e altri parametri dipendenti dal tipo di segmento (servo, audio, switch).

D: Come cambio le dimensioni e la posizione finale di un segmento?

R: Ci sono due metodi: 1. Graficamente sulla timeline: Trascina l'estremità sinistra (per cambiare l'inizio) o l'estremità destra (per cambiare la fine). L'altezza del segmento rappresenta la posizione angolare iniziale. 2. Numericamente: Seleziona il segmento e apri Menu Segmenti → Proprietà Segmento, dove puoi inserire tempi esatti (inizio/fine in ms) e posizioni (0–180°).

D: Come associo un segmento audio a un servo per controllare il volume?

R: MotioForge Studio lo fa in automatico: 1. Fai doppio clic sul segmento audio per aprire l'editor del segmento audio. 2. Attiva Associa un servo al volume e scegli il servo (es. quello della bocca). 3. Imposta volume minimo e massimo. 4. Premi Genera segmenti servo: i segmenti del servo vengono creati seguendo il volume dell'audio. Finché il collegamento è attivo, la traccia del servo è bloccata.

D: Come associo un segmento audio a più servo/switch per controllare le frequenze?

R: Nell'editor del segmento audio, sezione Associazione frequenze, associa un servo a ciascuna banda (bassi, medi, alti) e imposta le soglie di taglio in Hz. Con Esclusivo attivo, in ogni istante muove il suo servo solo la banda dominante. Poi premi Genera segmenti servo. Uno stesso servo non può essere collegato sia al volume sia a una banda di frequenza.

Porte e connessioni

D: Non vedo la porta COM che collego. Cosa faccio?

R: 1. Verifica che il dispositivo sia acceso e collegato via USB. 2. Apri Gestione dispositivi (Windows) e controlla quale COM è assegnata. 3. In MotioForge Studio, seleziona il dominio, apri la scheda Porte e imposta quella COM nel campo Dispositivo seriale. 4. Se ancora non funziona, scarica il driver del dispositivo.

D: La porta è collegata ma MotioForge non la vede. Perché?

R: Il driver USB potrebbe mancare o essere rotto. Controlla su Gestione dispositivi se c'è un punto esclamativo giallo accanto al dispositivo. Se sì, scarica il driver corretto dal sito del produttore.

D: Posso collegare più dispositivi diversi?

R: Sì. Configura più porte in MotioForge (una per ogni dispositivo). Negli elementi, assegna ogni servo/switch alla porta corretta. Durante il playback, MotioForge parla a tutte le porte in parallelo.

D: Cosa significano gli errori nella Console porte?

R: Apri la console porte con Ctrl+Shift+C per vedere i messaggi in tempo reale. Leggi Risoluzione problemi per interpretare i messaggi di errore specifici.

Elementi (Servo, Switch, Audio)

D: Qual è la differenza tra SERVO_BUS e SERVO_PWM?

R: SERVO_BUS sono servo digitali seriali (es. Waveshare ST3215) collegati in catena sullo stesso bus, ognuno con un indirizzo (ID) diverso; forniscono posizione, velocità e accelerazione controllate. SERVO_PWM sono servo analogici comandati da un segnale PWM, su un pin dedicato della scheda oppure su un canale di un espansore PCA9685 (I2C, fino a 16 servo per modulo).

D: Posso usare un servo normale (non "animatronica")?

R: Sì. Un servo è un servo. MotioForge sposta qualsiasi servo tra 0–180°. La differenza è nel come lo usi per creare animazioni realistiche e sincronizzate.

D: Come aggiungo un file audio a un'animazione?

R: 1. Crea una traccia SOUND sulla timeline. 2. Crea un segmento audio (Shift + trascinamento). 3. Apri l'editor del segmento e seleziona il file (.wav, .mp3, .ogg). 4. Il file deve essere in dominio/audio/ oppure specifica il percorso completo.

D: Il file audio non si riproduce. Perché?

R: 1. Il file esiste nel percorso salvato? Controlla dominio/audio/. 2. È un formato supportato? Solo WAV, MP3, OGG. Converti altri formati (AIFF, WMA, ecc.) in WAV. 3. Il dispositivo audio predefinito di Windows è attivo? Controlla in Windows → Impostazioni → Suono.

Assistente AI

D: Come apro l'assistente AI?

R: Premi F2 da qualsiasi finestra di MotioForge Studio. Oppure dal menu Aiuto → Chiedi all'AI.

D: Quale modello Ollama dovrei usare?

R: Dipende dalle tue risorse:

• tinyllama (~600 MB) — il più leggero, se hai <8 GB di RAM.
• phi3 (~2 GB) — buon equilibrio, per 8–12 GB di RAM.
• llama3.2 (~2 GB) — consigliato per iniziare.
• mistral (~4 GB) — risposte elaborate, richiede 12+ GB di RAM libera.

D: Ollama blocca tutto il mio PC. Cosa faccio?

R: Stai usando un modello troppo pesante. Cambia a uno più leggero (vedi sopra). Se anche tinyllama blocca, Ollama potrebbe non essere adatto al tuo hardware. Passa al backend Claude API (Preferenze → Assistente AI).

D: Claude API è gratuito?

R: No, è a pagamento (pay-as-you-go), ma il costo è minimo. Una sessione tipica di 10 domande costa <0,01 €. Accedi a console.anthropic.com per impostare un limite di spesa mensile.

D: L'assistente AI ha accesso ai miei file di progetto?

R: No. Legge solo: la documentazione ufficiale, le ultime righe del log (errori), e le tue domande. Nessun file di progetto è condiviso per privacy.

D: Posso condividere la mia API key di Anthropic?

R: No! La API key è personale. Chiunque la possieda può consumare il tuo credito. Se l'hai condivisa, disabilitala subito in console.anthropic.com → API Keys.

Playback e runtime

D: Come funziona il processo di animazione sulla timeline grafica?

R:Il processo di animazione in MotioForge Studio si basa su una timeline grafica progettata per essere intuitiva, eliminando la necessità di scrivere codice o gestire complessi fogli di calcolo. Il flusso di lavoro si ispira ai software di montaggio video o di produzione musicale, ma invece di lavorare su fotogrammi o note, l'operatore gestisce posizioni angolari e comandi hardware reali. Ecco i dettagli tecnici del funzionamento: Piste dei motori: All'interno di un'animazione, ogni servomotore configurato nel sistema viene visualizzato come una pista orizzontale dedicata. Disegno dei segmenti: Il movimento si crea tracciando dei segmenti direttamente sulla pista trascinando il mouse. I parametri del segmento definiscono il movimento: L'altezza del segmento rappresenta la posizione angolare (l'angolo di rotazione) del motore. La larghezza del segmento determina la durata del movimento nel tempo. Editing e precisione: È possibile aggiungere un numero illimitato di segmenti, oltre a poterli modificare, copiare e affinare singolarmente per ottenere il comportamento desiderato. Questo sistema garantisce un controllo preciso su posizione, velocità e accelerazione di ogni componente. Sincronizzazione multicanale: La timeline permette di coordinare decine di servomotori contemporaneamente. Oltre ai motori, è possibile inserire in sincronia: Uscite digitali come luci LED, relè, attuatori pneumatici o interruttori. File audio coordinati, con la possibilità di generare automaticamente movimenti labiali (lip-sync) basati sulla voce o sulla musica. Esecuzione in tempo reale: Una caratteristica fondamentale è l'anteprima istantanea. Premendo il tasto play, il software invia i comandi all'hardware in tempo reale, permettendo di vedere immediatamente come si muove il personaggio o l'oggetto senza fasi intermedie di compilazione. È possibile interrompere la riproduzione in qualsiasi momento e spostare il cursore (playhead) su ogni punto della timeline per rimettere a punto l'animazione.

D: Come faccio a fermarne il playback di un'animazione?

R: Premi Stop (Shift+F5) o il pulsante Stop nella toolbar dell'editor principale. Se il playback è in un ciclo continuo, premi Stop per interromperlo.

D: Posso regolare i servo durante il playback?

R: No. Durante il playback, i servo seguono i segmenti esattamente come programmato. Fermalo, modifica i segmenti, e riavvia.

D: Il playback si sincronizza con l'audio?

R: Sì. Quando riproduci un'animazione con segmenti audio, il timing è sincronizzato con la riproduzione audio. Usa questo per sincronizzare servo con dialoghi o musica.

D: Posso riprodurre un'animazione in ciclo continuo?

R: Sì, è assolutamente possibile riprodurre un'animazione in ciclo continuo con MotioForge Studio. Il software offre flessibilità nella gestione della riproduzione delle sequenze create: Modalità di esecuzione: Quando aggiungi un'animazione a un dominio, puoi impostarla affinché venga eseguita una sola volta, su attivazione esterna oppure in ciclo continuo. Applicazioni pratiche: Questa funzione è ideale per scenari che richiedono movimenti ripetitivi senza intervento manuale, come nel caso di elementi decorativi nelle vetrine dei negozi o figure animatroniche nei parchi tematici. Messa a punto: Anche durante la fase di creazione sulla timeline, puoi gestire il playhead per ripetere i cicli di prova e affinare il movimento fino a ottenere il risultato desiderato. In sintesi, la gestione dei cicli è una funzione nativa del sistema che permette di automatizzare completamente il movimento dei servomotori e dei dispositivi collegati.

D: Come si attiva un'animazione tramite un comando esterno?

R: In MotioForge Studio, l'attivazione di un'animazione tramite un comando esterno è una delle modalità di esecuzione previste dal sistema per rendere le installazioni interattive o automatizzate. Il processo può avvenire in diversi modi, a seconda del contesto d'uso: Tipologie di trigger: È possibile avviare le sequenze tramite un trigger manuale (premendo un tasto nel software) oppure un trigger software. Automazione e sensori: In contesti come i parchi tematici, le animazioni possono essere attivate automaticamente, ad esempio al passaggio di un visitatore (tramite sensori collegati). Input interattivi: In scenari come le escape room, gli oggetti di scena possono reagire direttamente agli input dei partecipanti, come il giro di una chiave meccanica o altri tipi di attivatori fisici gestiti dalla logica del software. Controllo remoto: L'animazione può anche essere controllata a distanza da un operatore in remoto. Come si configura Questa impostazione viene definita durante la creazione dell'animazione all'interno del Dominio hardware (il passo 2 del flusso di lavoro). In questa fase, puoi decidere se quel determinato progetto debba essere eseguito una sola volta, restare in ciclo continuo o attendere, appunto, un'attivazione esterna per partire.

Performance e troubleshooting

D: MotioForge è lento quando carico un dominio grande. Come lo accelero?

R: 1. Verifica che il dominio sia sul disco locale (non cloud). 2. Chiudi altri programmi per liberare RAM. 3. Se ha molti segmenti (>10000), suddividilo in due domini più piccoli. 4. Aggiorna MotioForge all'ultima versione.

D: Come faccio il backup dei miei progetti?

R: Copia la cartella del dominio (ad es. ARES/mio_dominio/) su una chiavetta USB, cloud (OneDrive, Google Drive), o disco esterno. MotioForge ha anche una funzione Backup nella Schermata iniziale.

D: Posso ripristinare un progetto da un backup?

R: Sì. Se il backup è stato fatto con il menu Backup della schermata iniziale, usa Backup → Ripristina backup.... In alternativa copia la cartella del dominio dal backup nella cartella domini (Impostazioni → Percorsi...): MotioForge Studio la riconoscerà automaticamente.

D: Cosa faccio se un file di progetto è corrotto?

R: 1. Chiudi MotioForge. 2. Ripristina il backup. 3. Se non hai backup, contatta il supporto. I file JSON possono essere editati manualmente se conosci la struttura.

Lingua e impostazioni

D: Come cambio la lingua di MotioForge?

R: Vai in Preferenze → Lingua, scegli italiano, inglese o cinese (中文), e riavvia MotioForge Studio.

D: Come cambio il tema (colori)?

R: Vai in Preferenze → Tema e scegli tra i temi disponibili (Blu, Scuro, ecc.).

D: Dove trovo i file di log per diagnosticare errori?

R: Il log è in %LOCALAPPDATA%\ARES\logs\ares.log. Apri questo file con un editor di testo per vedere i messaggi di errore, oppure usa il menu Log → Copia/Esporta cartella log... per inviarlo al supporto. L'assistente AI (F2) legge automaticamente le ultime righe del log.

Licenza e distribuzione

D: Qual è la differenza tra BETA e PRODUZIONE?

R: BETA — Versione gratuita con scadenza (per testing e valutazione). Nessuna licenza richiesta. PRODUZIONE — Versione per clienti finali con licenza valida. Licenza include email dell'utente, scadenza personalizzata e binding hardware opzionale.

D: Cosa significa "hardware binding"?

R: Se la licenza ha binding hardware, funziona solo sul computer dove è stata generata. Il binding include email + fingerprint hardware + versione. Se provi a usarla su un computer diverso, ricevi errore "Licenza per computer diverso". Protegge da copia non autorizzata su altri PC. Puoi richiedere una licenza senza binding se lavori su più computer.

D: Quando scade la licenza?

R: La licenza ha una data di scadenza specifica (esempio: 2027-06-30). Verifica la scadenza in Preferenze → 🔐 Licenza. Quando scade, MotioForge Studio non si avvia e mostra il messaggio "Licenza scaduta". Rinnova la licenza prima della scadenza.

D: Come rinnovo la licenza?

R: 1. Visita Preferenze → 🔐 Licenza e clicca "📧 Richiedi licenza a supporto". 2. Compila il modulo con email e informazioni di pagamento. 3. Riceverai una nuova licenza via email. 4. Incolla la nuova licenza in Preferenze → 🔐 Licenza e clicca "✓ Verifica licenza". Fatto! ✅

D: Cosa faccio se ricevo "Licenza per computer diverso"?

R: La licenza è legata a un computer diverso (hardware binding). Opzioni: 1. Usa MotioForge sul computer originale dove è stata generata la licenza. 2. Contatta il supporto e richiedi una licenza senza binding hardware (per multi-computer). 3. Richiedi una nuova licenza generata per questo computer.

D: Quanto tempo impiega il supporto a generare la licenza?

R: Il supporto risponde entro 24 ore. Dopo verifica del pagamento, la licenza viene generata e inviata via email. Se il pagamento è tracciabile tramite causale del bonifico, i tempi sono più veloci.

D: Come trovo la versione di MotioForge?

R: Apri Aiuto → Informazioni su MotioForge (in fondo al menu Help). Vedrai la versione Build e la scadenza Beta. La versione è necessaria per la richiesta di licenza.

Firmware DEIMOS

D: Come aggiorno il firmware della scheda DEIMOS?

R: Collega la scheda via USB, apri DEIMOS → Carica firmware DEIMOS nella schermata iniziale, scegli pacchetto e porta e clicca Carica. Il processo richiede 30–60 secondi. Non spegnere il PC durante l'upload.

D: Il firmware non si carica. Cosa faccio?

R: 1. Verifica che la scheda sia collegata e alimentata. 2. Controlla di aver scelto la porta COM corretta nel dialogo di caricamento (usa Aggiorna se l'hai appena collegata). 3. Prova a caricare di nuovo. Se ancora non funziona, riavvia la scheda.