129 lines
3.7 KiB
Markdown
129 lines
3.7 KiB
Markdown
# 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
|
|
|
|
```nsis
|
|
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:**
|
|
|
|
```nsis
|
|
newadvsplash::show 3000 0 0 -2 "$PLUGINSDIR\catch.gif"
|
|
```
|
|
|
|
```nsis
|
|
newadvsplash::show /NOUNLOAD 1000 600 400 0xFF6410 /BANNER "$TEMP\spltmp.bmp"
|
|
```
|
|
|
|
### 2) Ferma splash
|
|
|
|
```nsis
|
|
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
|
|
|
|
```nsis
|
|
newadvsplash::play /NOUNLOAD [/LOOP] FileName
|
|
```
|
|
|
|
- `FileName` - file audio da riprodurre (con estensione, wav, mp3...).
|
|
- Stringa vuota "" ferma l'audio.
|
|
|
|
### 4) Ottieni handle finestra
|
|
|
|
```nsis
|
|
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
|
|
|
|
```cmd
|
|
cd nsAdvsplash
|
|
python build_plugin.py
|
|
```
|
|
|
|
I DLL vengono copiati in `dist/{platform}/newadvsplash.dll`.
|
|
|
|
### Opzioni build
|
|
|
|
```powershell
|
|
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](README.md) for the English version.*
|