Come creare un file dei temi grafici per WinRAR
            ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

                   Aggiornato al 12 giugno 2005


1. Introduzione
~~~~~~~~~~~~~~~

Il file del tema grafico non è altro che un archivio in formato RAR 
contenente sia un insieme di immagini grafiche sia il file 
"winrar_theme_description.txt".



2. Formato del nome
~~~~~~~~~~~~~~~~~~~

Il file del tema deve avere l'estensione ".theme.rar", quindi il relativo 
formato è:

   [nome_base].[qualsiasi_testo].theme.rar

WinRAR crea una cartella per un determinato tema grafico utilizzando come 
nome quanto inserito in [nome_base], per questo è importante selezionare 
per questa voce un nome univoco per evitare sovrapposizioni con altri temi 
installati.
La parte [qualsiasi_testo] viene semplicemente ignorata da WinRAR. Potete 
usarla, ad esempio, per descrivere la versione del tema.
Di seguito 2 possibili nomi di temi grafici:

   Neve.ver21.theme.rar  - verrà installato nella cartella 'Themes\Neve'

   Marina.theme.rar      - verrà installato nella cartella 'Themes\Marina'



3. Il file "winrar_theme_description.txt"
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

L'archivio del tema grafico deve contenere il file 
winrar_theme_description.txt nella cartella principale.
Questo è un semplice file di testo e deve contenere i seguenti comandi:

a) Comando 'title'

   Sintassi:

      title=[titolo_del_tema]

   dove [titolo_del_tema] è una frase di testo che viene visualizzata come 
   nome del tema nel menu "Opzioni" + "Temi". Se realizzate un tema con 
   versioni che differiscono per la dimensione delle icone, è una buona 
   idea inserire questo valore nel testo del titolo .

   Esempi:

      title=Neve 32x32

      title=Neve 48x48

      title=Marina


b) Comando 'about'

   Sintassi:

      about=[descrizione_del_tema]

   dove [descrizione_del_tema] è una frase di testo visualizzata nel 
   pannello raggiungibile da "?" > "Informazioni su WinRAR". Ad esempio 
   può riportare i diritti d'autore o il nome dell'autore del tema.
   Potete utilizzare il carattere '\n' per dividere la descrizione su due 
   linee alla posizione desiderata. Non inserite più di un carattere '\n' 
   perché lo spazio riservato è di sole 2 linee, e non inserite una frase 
   troppo lunga altrimenti non ci starà nello spazio assegnato.

   Esempi:

      about=Marina, by Pietro
  
      about(C) 2004 AlexDesignStudio.\nwww.AlexDesignStudio.com.

c) Comando 'background'

   Il colore predefinito che definisce le aree trasparenti nella barra 
   degli strumenti è il nero, ma potete usare il bianco, se vi serve, 
   aggiungendo l'istruzione:

      background=255

   Da notare che il colore di sfondo è importante anche se l'immagine è a 
   32 bit ed ha il canale alfa. Non tutte le versioni di Windows o le 
   modalità video supportano le immagini a 32 bit; in alcune situazioni, 
   ad esempio con Windows 98, WinRAR deve trattarle come se fossero delle 
   immagini a 24 bit.


4. File grafici
~~~~~~~~~~~~~~~

L'archivio del tema deve contenere i seguenti file grafici (larghezza x altezza).

Nella cartella radice:

AboutLogo.bmp   - 261x49 - il logo nel pannello "Informazioni su WinRAR"
DiskOff.ico     - 16x16 - icona di "disco inattivo" nella barra di stato
DiskOn.ico      - 16x16 - icona di "disco attivo" nella barra di stato
DragCopy.cur    - 32x32 - cursore di "copia file" per trascina&lascia
DragMove.cur    - 32x32 - cursore di "muovi file" per trascina&lascia
DragNo.cur      - 32x32 - cursore di "rilascio proibito" per 
                          trascina&lascia 
Estimate.bmp    - 48x48 - l'immagine per "Stima rapporto di compressione" 
                          nel pannello "Informazioni sul file"
File.ico        - 16x16 - icona per "tipo file sconosciuto"
FolderUp.bmp    - 16x16 - pulsante "vai al livello precedente" nella barra 
                          degli strumenti
PasswordOff.ico - 16x16 - icona "Parola chiave non attiva" nella barra di 
                          stato
PasswordOn.ico  - 16x16 - icona "Parola chiave attiva" nella barra di stato
RAR.ico         - 16x16,32x32,48x48 - icona generica dei file RAR
RarSmall.bmp    - 13x13 - icona dei file RAR per il menu contestuale in 
                          "Esplora risorse"
REV.ico         - 16x16,32x32 - icona per i volumi di ripristino
Setup.ico       - 16x16 - icona per l'elenco "Installazione applicazioni" 
                          di Windows
SFX.ico         - 16x16,32x32 o più grande - icona del modulo auto-estraente 
                                             (vedi note seguenti)
SFXLogo.bmp     - 93x302 - Logo del modulo autoestraente al momento 
                           dell'esecuzione
SortDown.bmp    - 13x13 - immagine per ordinamento decrescente 
                          nell'intestazione di una colonna
SortUp.bmp      - 13x13 - immagine per ordinamento crescente 
                          nell'intestazione di una colonna
Tray.ico        - 16x16 - icona nell'area di notifica per "WinRAR in 
                          secondo piano" (solo 16 colori)
WizardLogo.bmp  - 64x64 - logo dei pannelli dell'operazione assistita

Nella cartella dal nome "Toolbar":

Add.bmp       - Pulsante "Archivia" della barra degli strumenti
Benchmark.bmp - Pulsante "Valutazione HW" della barra degli strumenti
Comment.bmp   - Pulsante "Commenta" della barra degli strumenti
Convert.bmp   - Pulsante "Converti" della barra degli strumenti
Delete.bmp    - Pulsante "Elimina" della barra degli strumenti
Exit.bmp      - Pulsante "Esci" della barra degli strumenti
Extract.bmp   - Pulsante "Estrai" della barra degli strumenti
ExtractTo.bmp - Pulsante "Estrai in" della barra degli strumenti
Find.bmp      - Pulsante "Trova" della barra degli strumenti
Info.bmp      - Pulsante "Info" della barra degli strumenti
Lock.bmp      - Pulsante "Blocca" della barra degli strumenti
Print.bmp     - Pulsante "Stampa" della barra degli strumenti
Protect.bmp   - Pulsante "Proteggi" della barra degli strumenti
Repair.bmp    - Pulsante "Ripara" della barra degli strumenti
Report.bmp    - Pulsante "Rapporto" della barra degli strumenti
SFX.bmp       - Pulsante "Autoestraente" della barra degli strumenti
Test.bmp      - Pulsante "Verifica" della barra degli strumenti
View.bmp      - Pulsante "Visiona" della barra degli strumenti
VirusScan.bmp - Pulsante "Anti Virus" della barra degli strumenti
Wizard.bmp    - Pulsante "Assistente" della barra degli strumenti

Note:

a) Benchè sia meglio mantenere le dimensioni originali, la dimensione di 
   molte immagini può essere leggermente cambiata senza compromettere 
   l'aspetto di WinRAR. Potete verificare sperimentalmente il risultato di 
   questi cambiamenti se necessario.

b) Potete utilizzare qualsiasi ragionevole dimensione per le icone della 
   barra degli strumenti. WinRAR la individuerà automaticamente.

c) Potete usare delle immagini a 24-bit e 32-bit con canale alfa per i 
   pulsanti della barra degli strumenti e per il pulsante di "Livello 
   precedente". In caso di immagini a 24-bit usate il colore nero per 
   definire le aree trasparenti.

d) Un file di tema può includere un solo insieme di pulsanti della barra 
   degli strumenti. Se volete distribuire un tema con i pulsanti di 
   dimensioni differenti, create uno o più differenti file di tema.

e) Utilizzate il colore grigio RGB(192,192,192) nelle immagini SortUp.bmp 
   e SortDown.bmp per definire le aree trasparenti.

f) La profondità dei colori non è limitata per tutte le icone tranne per 
   Tray.ico, la quale deve essere a 16 colori. WinRAR usa l'icona Tray.ico 
   solo per quelle versioni di Windows dove solitamente un'icona a 256 
   colori non viene visualizzata correttamente.

g) Se volete creare un'icona SFX.ico compatibile con Win9x, questa deve 
   avere una dimensione di 16x16 o 32x32 pixel, a 16 o 256 colori. Potete 
   usare altre dimensioni e profondità di colore se non vi interessa la 
   compatibilità con Windows 9x ma solo quella con Windows 
   NT/2000/XP/2003. In questo caso l'icona SFX.ico verrà ignorata sotto 
   Windows 9x.

h) E' permesso omettere molte immagini dall'archivio; in questo caso WinRAR 
   utilizzerà quelle predefinite. L'unica eccezzione è il file Add.bmp in 
   quanto WinRAR lo utilizza per determinare la dimensione delle icone, 
   quindi deve essere presente.


5. Contatti
~~~~~~~~~~~

Inviate eventuali richieste d'informazioni sui temi grafici di WinRAR 
(in inglese) a dev[at]rarlab.com
(Sostituite [at] con il carattere @).

Se il vostro tema è basato sull'ideazione gafica di qualcun'altro, per 
usare il tema con WinRAR dobbiamo avere anche l'autorizzazione del 
proprietario originale dei diritti sul lavoro grafico. Siete pregati 
d'inviarci una copia di questa autorizzazione via email.