nsis-plugin-nsadvsplash/README_IT.md

NewAdvSplash NSIS Plugin

Versione personale modificata

---

Descrizione Originale

NewAdvSplash.dll - plug-in che permette di visualizzare uno splash screen negli installer NSIS con effetti di dissolvenza (win2k/xp) e trasparenza. Può contemporaneamente riprodurre file audio wav/mp3.

Utilizzo

1) Mostra splash screen

newadvsplash::show [/NOUNLOAD] Delay FadeIn FadeOut KeyColor [/BANNER] [/PASSIVE] [/NOCANCEL] FileName

Parametri:

• Delay - tempo (millisecondi) di visualizzazione dell'immagine
• FadeIn - tempo per la scena di fade in
• FadeOut - tempo per la scena di fade out
• KeyColor - colore usato per la trasparenza, può essere qualsiasi valore RGB (es. R=255 G=100 B=16 -> KeyColor=0xFF6410). Usare KeyColor=-1 se non c'è colore trasparente. Se KeyColor=-2 e il tipo è gif, il plug-in tenta di estrarre il colore di trasparenza dall'header del file.
• /BANNER - restituisce il controllo all'installer subito dopo l'attivazione del plug-in.
• /NOCANCEL - disabilita il comportamento default 'exit on user click'.
• /PASSIVE - non forza la finestra splash in primo piano.
• FileName - nome file immagine splash (con estensione!). Tipi supportati: Bmp, gif e jpg.

Esempi:

newadvsplash::show 3000 0 0 -2 "$PLUGINSDIR\catch.gif"

newadvsplash::show /NOUNLOAD 1000 600 400 0xFF6410 /BANNER "$TEMP\spltmp.bmp"

2) Ferma splash

newadvsplash::stop [/WAIT | /FADEOUT]

• Senza opzioni termina il banner.
• Con /WAIT attende la fine.
• Con /FADEOUT forza la chiusura con effetto fade out.

3) Riproduci audio

newadvsplash::play /NOUNLOAD [/LOOP] FileName

• FileName - file audio da riprodurre (con estensione, wav, mp3...).
• Stringa vuota "" ferma l'audio.

4) Ottieni handle finestra

newadvsplash::hwnd /NOUNLOAD
Pop $0 ; $0 è ora l'handle della finestra

Compatibilità

• Base - Win95 e successivi.
• Fadein/fadeout - win2k/winxp.

Crediti

• Codice originale - Justin
• Convertito in plugin DLL da Amir Szekely (kichik)
• Dissolvenza e trasparenza di Nik Medved (brainsucker)
• Supporto gif e jpeg, /BANNER e /CANCEL, supporto mp3 - Takhir Bedertdinov

---

⚠️ Differenze nella versione personale

Nuova architettura supportata: x64 (amd64-unicode)

L'originale supportava solo:

• x86-ansi (Plugins\newadvsplash.dll)
• x86-unicode (Unicode\plugins\newadvsplash.dll)

La versione personale aggiunge il supporto per:

• amd64-unicode (x64)

File aggiunti

• build_plugin.py - Script Python per compilare il plugin per tutte le architetture
• src/exdll.h - Header per l'API NSIS extern DLL
• src/NewAdvSplash.vcxproj - Progetto Visual Studio aggiornato per VS2022 e x64

File rimossi

I file DLL precompilati sono stati rimossi dalla distribuzione in quanto vengono generati dalla compilazione:

• Plugins/newadvsplash.dll
• Unicode/plugins/newadvsplash.dll

Compilazione

cd nsAdvsplash
python build_plugin.py

I DLL vengono copiati in dist/{platform}/newadvsplash.dll.

Opzioni build

python build_plugin.py --config x86-unicode      # Solo un'architettura (x86-ansi|x86-unicode|x64-unicode|all)
python build_plugin.py --vs-version 2026         # Versione VS specifica (2022|2026|auto)
python build_plugin.py --clean                   # Pulizia dist/ prima della build
python build_plugin.py --install-dir "C:\NSIS\Plugins"  # Copia in directory NSIS aggiuntiva
python build_plugin.py --verbosity minimal       # Verbosità MSBuild (quiet|minimal|normal|detailed|diagnostic)

Modifiche funzionali

Nessuna modifica funzionale rispetto all'originale. Le modifiche riguardano solo l'infrastruttura di build e il supporto x64.

---

See README.md for the English version.