# Utilizzo ## Comporre una carta Scrivere nome, costo, tipo, sottotipo, archetipo, codice, rarità e statistiche. I suggerimenti non sono vincoli: si possono usare diciture inventate. Stelle: da 0 (non stampate) a 7. Inserire uno o due attributi oppure lasciare vuoti i campi; i simboli personalizzati possono essere caratteri o brevi sequenze. Le zone restano sempre ferme. Il testo degli effetti è libero. Selezionare una parola e premere B, I oppure scegliere un colore o una dimensione. Tx rimuove gli stili dalla selezione. Annulla e Ripristina operano nella cronologia dell'editor di testo del browser; non sono una cronologia di tutti i campi della carta. L'incolla utilizza testo semplice per evitare stili estranei; applicare la formattazione dopo aver incollato. I campi keyword, condizioni, costi aggiuntivi e testo narrativo sono facoltativi. Il programma li aggiunge al riquadro effetti soltanto perché l'utente li ha compilati. Una keyword suggerita non viene inserita finché non si preme il comando di inserimento. L'adattamento riduce proporzionalmente i caratteri fino al minimo impostato. Se lo spazio non basta, appare un avviso: la bozza e il JSON mantengono tutto il testo, PNG e stampa sono bloccati. Ridurre la dimensione minima o abbreviare. I riquadri non vengono ingranditi. ## Illustrazioni Caricare PNG, JPEG o WebP, massimo 25 MB. Trascinare il file nel riquadro o selezionarlo dal computer. Trascinare sul canvas per spostare l'immagine; due dita consentono lo zoom. Sono disponibili anche cursori di zoom e posizione. Centra ripristina il ritaglio. Rimuovi elimina solo l'immagine della bozza. Le immagini caricate sono conservate nel progetto come data URL. Il codice dell'applicazione non contiene artwork Base64. Il campione incluso è un asset WebP locale ricavato dal riferimento allegato e può essere sostituito. ## Salvataggi e progetti La bozza si salva automaticamente dopo una breve pausa. Salva carta aggiorna la raccolta. Nuova apre una nuova bozza. Duplica crea una bozza con nuovo ID. La selezione di un'altra carta apre la copia salvata nella raccolta; per conservare le modifiche come carta, usare Salva carta prima di passare a un'altra miniatura. I progetti separano le raccolte. Il menu in alto cambia progetto; Nuovo progetto ne crea uno. La bozza di ciascun progetto è conservata durante il cambio. Backup include raccolte, immagini, progetti e bozza attiva. Importa aggiunge i contenuti e assegna nuovi ID alle carte già presenti. I salvataggi sono locali. Cancellare i dati del sito, navigare in modalità privata o esaurire lo spazio può impedirne la conservazione. Gli errori sono mostrati nell'interfaccia. Il backup JSON è il formato portabile e ripristinabile. ## Esportazioni Progetto JSON esporta la carta attiva, con formattazione, colori, immagini, ritaglio e dati tecnici. Backup esporta tutte le carte di tutti i progetti. JSON selezione usa le caselle delle miniature; senza selezione usa il progetto attivo. PNG in ZIP segue lo stesso criterio. I nomi dei file sono numerati per evitare collisioni fra carte omonime. Il PNG può essere esportato a tre risoluzioni. Lo zoom dell'anteprima non cambia la risoluzione del file. Tutti gli output passano per lo stesso renderer. La stampa usa celle da 63 × 88 mm: margini proporzionali conserva l'intera carta ritagliata, ritaglio riempie la cella tagliando le eccedenze. Selezionare A4 e scala 100% nel dialogo del browser. ## Dati tecnici Il JSON avanzato è un oggetto indipendente. Modificare la dicitura ATK stampata non cambia game.atk. Nome e descrizione tecnica vanno inseriti in game.name e game.effect se necessari. Non esiste un interprete che trasformi automaticamente il testo in abilità eseguibili. Gli altri campi di progetto, come condizioni, costi ed effetti ancora da implementare, possono essere annotati nelle note. L'esportazione tecnica filtra i campi non censiti e li elenca nel rapporto; il progetto completo li conserva. Il risultato è una base di integrazione, non un aggiornamento automatico di ARKANA. ## Importazioni precedenti Supportati raccolte cards, draft, singole carte e contenitori editor.card. Vengono conservati nomi liberi, attributi, statistiche, artwork, keyword e testi delle sezioni speciali, raccolti nel riquadro universale. I vecchi tag [color] sono convertiti in segmenti colorati; verificare comunque la distribuzione dei testi dei layout speciali. I progetti del nuovo editor mantengono integralmente la formattazione. Il precedente comando Salva HTML è sostituito dal backup JSON, perché l'applicazione ora è modulare. ## Controlli della versione 2 ATK e PV sono due campi numerici distinti, con frecce di incremento/decremento e digitazione diretta. Le diciture sono libere. In modalità automatica formano la barra inferiore; scegliere Statistiche personalizzate per scrivere l'intera frase. Passare alla modalità automatica ricompone la barra con i valori numerici, mantenendo indipendente game. Con Tipologia Scalare (anche Creatura + sottotipo Scalare) compaiono Dicitura scalare e Valore scalare. Il box SCALA è blu, a destra dell'illustrazione e sopra il riquadro Archetipo, in coordinate fisse. Il valore può essere una cifra o un testo libero. Con Tipologia Planeswalker compaiono Dicitura Lealtà e Valore Lealtà. La fascia inferiore mostra questi campi; ATK e PV vengono nascosti ma conservati. Tornando a Creatura, i precedenti valori e la modalità selezionata vengono ripristinati. Il colore automatico per tipologia è attivo inizialmente. I tipi riconosciuti applicano la palette corrispondente; quelli inventati conservano la palette corrente. Modificare manualmente un colore disattiva l'automatismo: cambiare tipo non sovrascriverà i colori. Ripristina palette applica i colori standard del tipo attuale senza cambiare la preferenza dell'automatismo. L'archetipo è centrato orizzontalmente; il suo centro verticale coincide con quello del testo Tipologia. I testi su due righe restano centrati nello stesso punto. Il carattere è ridotto solo se il testo non entra in una o due righe. I progetti v1 con statistiche riconoscibili come “ATK 1900 / PV 1600” acquisiscono i nuovi controlli mantenendo i valori. Le diciture non riconoscibili restano in modalità personalizzata. I colori esistenti sono preservati alla prima apertura e cambiano soltanto al successivo cambio tipo con automatismo attivo. ## Aggiornamento versione 3 La cornice esterna delimita il file esportato: sono rimossi i precedenti margini di 46 pixel a sinistra e 89 pixel in alto (con i corrispondenti margini a destra e in basso). Il nuovo PNG standard misura 932×1350, includendo l'intero spessore della cornice. Le opzioni 2× e 3× producono 1864×2700 e 2796×4050. Gli angoli esterni arrotondati sono trasparenti; nessun contenuto interno viene spostato o deformato. Il box SCALA passa da 76×76 a 104×78 unità interne; aumentano anche i caratteri della dicitura e del valore. I simboli attributo sono allineati verticalmente al centro del costo mana: tutti e tre i cerchi hanno diametro 90. Il nome stampato e suggerito è Stack. Le vecchie denominazioni Xyz e Xyz / Stack vengono convertite all'apertura; game.extraKind mantiene il valore tecnico xyz quando presente. I permanenti Aura, Enchantment, Equipaggiamento e Artefatto usano la stessa palette. I Creature ordinari usano il rosso esatto RGB 155,80,60. Le carte salvate con colore automatico attivo adottano le palette aggiornate; quelle con automatismo disattivato conservano i colori manuali. Per uniformarle usare Ripristina palette della tipologia. ## Aggiornamento versione 4 La palette standard dei Creature, Scalari ed Evoluzioni è unificata: sfondo RGB 140,70,54 (#8c4636), scritte e linee quasi nere (#100a08), box effetti avorio. Il valore è stato scelto come lieve scurimento del precedente RGB 155,80,60. Le carte con automatismo attivo adottano i nuovi colori; quelle con colori manuali li conservano. Per applicare i nuovi colori a una carta personalizzata usare Ripristina palette della tipologia. Il pallino del costo usa sempre lo stesso sfondo della carta, anche quando la palette è personalizzata. Il box SCALA resta blu come indicatore distinto, mentre tutta la carta Scalare utilizza la palette dei Creature. Rimangono invariati formato ritagliato ed esportazioni. ## Aggiornamento versione 5 Creature ordinari, Scalari ed Evoluzioni adottano RGB 168,135,97. Le stelle sono sempre gialle su fondo nero, anche con palette personalizzate. I bordi delle sezioni sono più spessi e il riquadro del nome usa esattamente lo sfondo del box effetti; il nome adotta il colore del testo scuro. La sezione codice/rarità è rimossa sia dalla carta sia dal pannello grafico. I progetti precedenti restano importabili: eventuali metadati storici sono preservati nel JSON, ma non vengono stampati. La barra ATK/PV è estesa da sinistra a destra nella fascia inferiore, con testo centrato. Per i Planeswalker, lo stesso spazio ospita Lealtà. Gli sfondi di tutte le tipologie usano un gradiente orizzontale leggero: estremità sinistra scurita dell'8%, centro nel colore base della palette ed estremità destra schiarita dell'8%. I riquadri nel colore della carta e il costo mana condividono lo stesso gradiente, calcolato nelle stesse coordinate. Nome ed effetti conservano lo sfondo avorio uniforme; stelle gialle e dischi neri restano invariati. Il gradiente compare anche con colori personalizzati. ### Modalità Full art Nel pannello Illustrazione e ritaglio attivare “Illustrazione a tutto sfondo (Full art)”. L'immagine riempie l'intera carta fino alla cornice e sostituisce l'area circolare. Restano disponibili zoom, spostamento e Centra; il ritaglio è salvato insieme all'opzione. Nome, effetti, tipologia e statistiche rimangono nelle stesse posizioni, con pannelli leggermente traslucidi per mantenere leggibilità. Il gradiente leggero è applicato anche alla modalità Full art. Deselezionando l'opzione si torna all'illustrazione circolare. Anteprima, miniature, PNG e stampa condividono la stessa resa; l'output conserva le dimensioni 932×1350 e i multipli previsti. ## Aggiornamento versione 6 Il colore base dei Creature, Scalari ed Evoluzioni è RGB 118,50,28 (#76321c), su cui viene applicato il gradiente già previsto. Tutte le palette usano il nero puro per testi e bordi. Colori personalizzati e formattazioni di singole parole sono preservati: per applicare i nuovi valori standard, usare Ripristina palette della tipologia. In Opzioni grafiche è disponibile Font della carta. Scegliere Georgia, Times New Roman, Arial, Verdana, Trebuchet MS o Courier New. Il carattere selezionato si applica a nome, tipologia, archetipo, effetti, costi, statistiche e indicatori. La formattazione delle singole parole (grassetto, corsivo, colore e dimensione) rimane attiva. Il font è salvato nel progetto e utilizzato anche in miniature, PNG e stampa. I progetti precedenti usano inizialmente Georgia. Sono font di sistema: se un carattere non è installato viene usato il relativo fallback serif, sans-serif o monospace, senza download esterni. I simboli degli attributi sono gialli (#ffd700) come le stelle e hanno linee spesse il doppio rispetto alla versione precedente. Le dimensioni e l'allineamento dei cerchi rimangono invariati. ## Aggiornamento versione 7 Il contrasto automatico è attivo inizialmente: i colori di testi e bordi sono scelti in base alla luminanza dello sfondo effettivo. Il corpo carta e gli indicatori scuri usano elementi chiari; i box chiari hanno testo scuro. Stelle e simboli degli attributi conservano il giallo esplicitamente richiesto. I colori applicati manualmente a singole parole restano invariati. Tutti i riquadri testuali usano il colore del nome e degli effetti, compresi Archetipo, ATK/PV o Lealtà e SCALA. Il cerchio mana resta un indicatore nel colore della carta. In Full art i pannelli mantengono la traslucenza leggera prevista. Le palette standard sono schiarite: Creature, Scalari ed Evoluzioni RGB 155,101,72; Aura, Enchantment, Equipaggiamento e Artefatto RGB 179,149,105. I colori personalizzati con automatismo disattivato sono conservati. Il nuovo controllo Contrasto automatico di testi e bordi si trova in Opzioni grafiche; modificare manualmente il colore di testi/cornici disattiva questo automatismo. Non sono stati eseguiti test finali per la versione 7, come richiesto dall'utente. I risultati delle versioni precedenti non certificano questa versione. ## Aggiornamento versione 8 Le nuove carte iniziano in Full art con font Segoe UI. I progetti già salvati mantengono le scelte esplicite di modalità e font. Tutti i bordi sono neri, indipendentemente dal contrasto dei testi e dalla palette. Gli angoli sono più squadrati ma conservano una curvatura. I simboli degli attributi sono neri e mantengono temporaneamente le forme precedenti, in attesa della selezione della griglia. ATK, PV e LEALTÀ (incluse le diciture personalizzate associate ai controlli) sono in grassetto, mentre i numeri restano regolari. Sono disponibili anche Palatino, Garamond, Tahoma, Segoe UI, Gill Sans, Impact, Consolas e Arial Black, oltre ai sei font precedenti. I font utilizzano quelli installati nel dispositivo e i rispettivi fallback. La griglia docs/design/GRIGLIA_ICONE.png contiene cinque righe: A Naturalistico, B Silhouette, C Incisione, D Araldico, E Fantasy. Le colonne sono 1 Fuoco, 2 Acqua, 3 Terra, 4 Aria, 5 Tenebra. Le icone sono proposte vettoriali originali e non sono ancora applicate: si può scegliere un set intero oppure combinare codici, ad esempio A1, C2, B3, D4, E5. Non sono stati eseguiti test finali sulla versione 8. ## Aggiornamento versione 9 Gli attributi usano i cinque simboli scelti nella tabella dell'utente: Fuoco 01 (fiamma), Aria 07 (vortice), Acqua 01 (goccia), Terra 20 (germoglio su onde) e Tenebra 06 (emblema alato). Le forme originali sono state estratte come asset PNG neri con trasparenza e sono incluse in assets/attributes. Sono usate anche dalle carte precedenti quando il campo Simbolo personalizzato è vuoto. Un simbolo personalizzato compilato conserva la priorità. Le immagini derivano dal riferimento raster fornito e conservano il dettaglio disponibile nella tabella; non sono reinterpretazioni generate. Non sono stati eseguiti test finali su questa versione. ## Aggiornamento versione 10 Il font predefinito delle nuove carte è Segoe UI. Le carte salvate mantengono il font selezionato. Il simbolo TENEBRA utilizza il numero 20 della tabella fornita, in nero. I cerchi mana e attributi hanno raggio 54 anziché 45; la fascia del nome termina sotto il centro del cerchio mana, senza sporgenze laterali. Versione 13: tipologia e archetipo hanno riquadri identici di 435 × 88, allineati e con uguali angoli e margini interni. Riquadro SCALA ingrandito a 156 × 116, con etichetta e valore più grandi. Versione 14: centro del gruppo dei due attributi allineato alla stella singola (y=519); centri dei simboli a y=452 e y=586. Un attributo singolo è centrato a y=519. Versione 15: la terminologia dell’editor utilizza Creatura e Creature. Le tipologie dei progetti precedenti vengono convertite alla nuova denominazione. Gli identificatori tecnici ARKANA (ad esempio monster) restano compatibili con il gioco attuale. Nessuna modifica al repository del gioco.