Plugin
Cosa sono i Plugin?
I plugin sono piccoli pezzi di software ognuno dei quali aggiunge una particolare caratteristica a MuseScore. Abilitando un plugin, una nuova opzione di menu viene aggiunta al menu Plugin: successivamente, quando questa opzione viene selezionata, il plugin esegue un particolare compito nella partitura.
Alcuni plugin sono pre-installati con MuseScore – vedere Plugin installati di default (sotto). Si possono trovare molti altri plugin nell’archivio plugin: alcuni funzionano con MuseScore 3, altri solo con le vecchie versioni di MuseScore, e altri ancora con tutte le versioni. Per distinguere gli uni dagli altri: i file di codice dei plugin di MuseScore 3.x e 2.x hanno estensione .qml; per le versioni più vecchie l’estensione è .js.
Attenzione. I plugin possono potenzialmente contenere codice dannoso o nocivo, che può compromettere o danneggiare le partiture o il sistema. I plugin sono interamente non controllati (tranne quelli installed by default). È quindi necessario fidarsi dell'autore oppure controllare personalmente il codice.
Installazione
Nota: Alcuni plugin per funzionare possono richiedere l'installazione di altri componenti (font, per esempio). Controllare la documentazione del plugin per maggiori informazioni.
La maggior parte dei plugin sono forniti come archivi ZIP: scaricare il file .zip del plugin e decomprimetelo (unzip) in una delle directory menzionate sotto (a seconda del proprio sistema operativo). Se il plugin è fornito direttamente come file .qml non compresso, scaricarlo semplicemente e metterlo in una delle stesse directory.
Una volta che un plugin è installato, per poterlo utilizzare deve essere abilitato in Gestione plugin - vedere Abilitare/disabilitare i Plugin.
Windows
Su Windows, i nuovi plugin dovrebbero essere installati in %HOMEPATH%\Documents\MuseScore3\Plugins. In alternativa, specificare una cartella diversa nel file Preferenze.
I Plugin installati di default si trovano in %ProgramFiles%\MuseScore 3\Plugins (o %ProgramFiles(x86)%\MuseScore 3\Plugins per la versione a 32-bit) e in %LOCALAPPDATA%\MuseScore\MuseScore 3\plugins su Windows 7 e successivi. Queste cartelle non dovrebbero essere modificate.
macOS
Su macOS, i nuovi plugin dovrebbero essere installati in ~/Documents/MuseScore3/Plugins. In alternativa, specificare una cartella diversa nelle Preferenze di MuseScore.
I Plugin installati di default si trovano nel pacchetto MuseScore in /Applications/MuseScore 3.app/Contents/Resources/plugins (per trovare i file nel pacchetto dell’applicazione, cliccare con il tasto destro del mouse su Preferenze in MuseScore 3.app e scegliere "Show package contents"), e in ~/Library/Application Support/MuseScore/MuseScore 3/plugins. Queste cartelle non dovrebbero essere modificate.
Linux
Su Linux, i nuovi plugin dovrebbero essere installati in ~/Documents/MuseScore3/Plugins. In alternativa, specificare una cartella diversa nelle Preferenze di MuseScore.
I Plugin installati di default si trovano in /usr/share/mscore-3.x/plugins e in ~/.local/share/data/MuseScore/MuseScore3/plugins. Queste cartelle non dovrebbero essere modificate.
I nomi delle directory potrebbero essere leggermente diversi, a seconda della lingua del proprio sistema operativo.
Abilitare/disabilitare i Plugin
Per poter accedere ai plugin installati dal menu Plugins, devono essere abilitati in Gestione Plugin:
Lo si fa semplicemente spuntando la casella appropriata. Questo aggiunge il nome del plugin alla lista nel file Menù Plugin.
Creare/modificare/eseguire i plugin
È possibile creare nuovi plugin, modificarne di esistenti ed eseguirli tramite il Creatore plugin:
La documentazione di tutti gli elementi disponibili può essere trovata anche qui.
Plugin installati di default
Alcuni plugin sono preinstallati con MuseScore, ma non sono abilitati di default. Vedere Abilitare/disabilitare i Plugin (sopra) per abilitare i plugin.
(N.d.R.: alcuni dei plugin demo sono stati creati con precedenti versioni di MuseScore e non sono ancora stati aggiornati, ragione per cui potrebbero non funzionare con la versione 3.6)
ABC Import
Questo plugin importa testo ABC da un file o dagli appunti e lo converte in MusicXML. È richiesta la connessione a Internet perché il plugin utilizza un servizio web esterno per la conversione.
Notes → Color Notes
Questo plugin dimostrativo colora le note nella gamma selezionata (o nell'intera partitura), a seconda della loro altezza. Colora la testa di tutte le note in tutti i pentagrammi e voci secondo la convenzione di Boomwhackers. Ogni tonalità ha un colore diverso. C e C♯ hanno un colore diverso. C♯ e D♭ hanno lo stesso colore.
Per colorare tutte le note di nero, basta eseguire nuovamente il plugin (sulla stessa selezione). Si potrebbe altresì usare il plugin 'Remove Notes Color' plugin.
Create Score
Questo plugin demo crea una nuova partitura. Crea una nuova partitura per pianoforte con note da 4 quarti: C, D, E, F. È un buon inizio per imparare a realizzare una nuova partitura e aggiungere note da un plugin.
helloQml
Questo plugin dimostrativo illustra alcuni compiti di base.
Notes → Note Names
Questo plugin attribuisce il nome alle note in un intervallo selezionato o per l'intera partitura. Mostra i nomi delle note (come testo di rigo) secondo le impostazioni linguaggio di MuseScore: voci 1 e 3 note sopra il rigo; voci 2 e 4 note sotto il rigo; e note dell'accordo in un elenco separato da virgole, a partire dalla nota più alta.
Panel
Questo plugin demo crea un pannello GUI.
random/random2
Creano una partitura random.
run
Questo plugin demo esegue un comando esterno. Probabilmente funzionerà solo su Linux.
scorelist
Questo plugin di test itera attraverso l'elenco delle partiture.
ScoreView
Plugin dimostrativo per dimostrare l'uso di una ScoreView
Walk
Questo plugin di test percorre tutti gli elementi in una partitura