NOME
   WIP

VERSIONE
   2.62 BETA (21.9.2001)


AUTORE
   Gabriele Favrin (gabriele@favrin.net)


FINALITA'
   Infastidire gli utenti dei canali IRC visualizzando di volta in volta il
   brano ascoltato in quel momento ;-) (scherzo!)


REQUISITI SOFTWARE
   Richiede il client IRC AmIRC, la libreria rmh.library (reperibile su
   Aminet all'indirizzo http://it.aminet.net/pub/aminet/util/rexx/rmh.lha) e
   l'utilizzo di Amplifier, DeliTracker, SongPlayer o dei player shell mpega
   (per mp2/mp3) e GMPlay o AMidi (per i file midi). La disponibilita' di
   file da ascoltare e' vivamente consigliata ;-)


DISTRIBUZIONE E DISCLAIMER
   Questo software e' rilasciato sotto licenza
   GNU General Public Licence (GPL) versione 2.
   Consultare il file GPL.txt per maggiori informazioni.


INSTALLAZIONE
   * AmIRC

     Copiare wip.amirx e wipcfg.amirx nella directory rexx/ all'interno del
     cassetto di AmIRC.

     Lanciare AmIRC e configurare i seguenti alias:

     nome:    wip
     comando: /rx wip.amirx %p

     nome:    wipl
     comando: /rx wip.amirx LOCAL %p

     nome:    wipcfg
     comando: /rx wipcfg.amirx %p

     I comandi possono essere inseriti anche durante una sessione IRC
     (ricordarsi poi di salvare le impostazioni) utilizzando le seguenti
     linee:

     /alias wip /rx wip.amirx %p
     /alias wipl /rx wip.amirx LOCAL %p
     /alias wipcfg /rx wipcfg.amirx %p


   * Script aggiuntivi per AMidi, GMPlay e MPEGA

     Se non ci si serve di Amplifier, DeliTracker o SongPlayer ma di mpega
     AMidi o GMPlay, da shell o magari tramite Directory Opus o ToolManager,
     e' necessario modificarne l'utilizzo.

     A tal fine bisogna servirsi degli appositi script presenti
     nell'archivio, Start_MPEGA.rexx, Start_AMidi.rexx e Start_GMPLAY.rexx,
     che vanno copiati nella directory S:

     Questi script provvedanno a far suonare il file indicato generando
     contemporaneamente le informazioni necessarie a WIP.

     Gli script vanno personalizzati in base al path nel
     quale si trova il player ed alle relative opzioni di utilizzo.

     Da notare che, in Start_MPEGA, le opzioni -Nni sono necessarie per
     generare l'output che WIP visualizza. E' comunque possibile inserire
     altre opzioni di cui ci si serve abitualmente. Si ricorda che il player
     mpega supporta una configurazione ASCII (mpega.cfg) contenente le
     opzioni di piu' frequente utilizzo. Verificare che tale configurazione
     non contenga comandi che interferiscono con -Nni !

     Una volta adattati gli script se ne puo' configurare l'uso nei programmi
     di cui ci si serve abitualmente. Bastera' sostituire la linea che
     richiama MPEGA, PlayMIDI (il player shell del pacchetto AMidi) o GMPlay
     con il nome dello script relativo (ricordarsi di impostarne il flag S!).

     L'utilizzo di questi script offre anche il vantaggio di poter cambiare
     brano senza dover preventivamente interrompere l'esecuzione di un altro,
     purche' sia dello stesso tipo (midi o mpeg audio): gli script
     bloccano l'eventuale altro processo in funzione al momento della loro
     esecuzione.


UTILIZZO
   Durante l'uso di AmIRC e' possibile visualizzare il brano che si sta
   ascoltando. Per farlo, digitare "/wip" come si inserirebbe un qualsiasi
   altro comando IRC.

   WIP supporta le seguenti opzioni:

   LOCAL   - Mostra il risultato in locale invece che sul canale.
             Equivale a /wipl se e' stato configurato il relativo alias.

   NODIR   - Qualora non sia presente l'informazione sull'autore di un
   (o ND)    brano, WIP mostra il path nel quale il brano stesso si trova.
             Questa opzione evita l'eventuale visualizzazione della
             directory.

   NOGUESS - WIP cerca l'autore di un MP3 nel titolo del brano, qualora tale
   (o NG)    informazione non sia presente nell'apppsita ID3 tag. L'opzione
             NOGUESS disattiva questa funzionalita'.

   USER    - Invia il testo di WIP ad un utente invece che sul canale.
   (o TO)    Volendo e' possibile specificare un canale facendo precedere
             il nome da #. Se non ci si trova sul canale indicato, il
             il messaggio sara' ivi visualizzato solo se non e' attiva la
             modalita' N ("no external messages"). L'opzione e' alternativa
             ad ALL e ha priorita' sulla stessa.

   ALL     - Invia il testo di WIP su tutti i canali nei quali ci si trova.

   QUIET   - Riduce al minimo l'output locale di WIP.

   WIP visualizza in locale il messaggio che poi verra' inviato su IRC (se
   non si usa l'opzione LOCAL). A causa di un limite di AmIRC, solo i primi
   256 caratteri di un messaggio locale sono visualizzati. Il messaggio
   appare comunque correttamente su IRC.


CONFIGURAZIONE
   L'output di WIP e' completamente configurabile in base ai propri gusti o
   esgienze. Per operare le modifiche e' consigliabile servirsi dello script
   wipcfg.amirx.


   * Stili e colori

     Per definire gli stili e colori utilizzati nei vari testi e' sufficiente
     eseguire lo script specificando la stringa da modificare ed i relativi
     attributi. E' anche possibile inserire caratteri (ma non numeri, che non
     sarebbero rimossi) per valutare l'effetto finale. Per cancellare gli
     attributi di una stringa basta inserire, per esempio,
     /wipcfg stringa_da_modificare ""

     Le stringhe i cui attributi possono essere modificati sono:

     Comando           Stringa

     TITLE             Titolo o nome del file audio
     AUTHOR            Autore del file audio
     FORMAT            Formato del file audio
     DIR               Directory in cui si trova il file audio
     YEAR              Anno di realizzazione del file audio (solo MP3)
     NICK              Nick utilizzato dall'utente.
     INFO              Tutte le informazioni locali (ora, data, ecc).
                       Sostituisce TIME.

     E' possibile utilizzare liberamente grassetto, inverso, sottolineato
     ed i colori, di cui per praticita' riportiamo la tabella, basata sui
     quella del client PC mIRC e delle ultime versioni di AmIRC.

      0 Grigio chiaro
      1 Nero
      2 Blu scuro
      3 Verde scuro
      4 Rosso
      5 Marrone
      6 Viola
      7 Arancio
      8 Giallo
      9 Verde chiaro
     10 Ciano scuro
     11 Ciano
     12 Blu
     13 Lilla
     14 Grigio scuro
     15 Grigio chiaro

     Ecco alcuni esempi.

     NOTA BENE: il carattere "^" va sostituito con la pressione del tasto
     control.

     /wipcfg title ^b
       Il titolo del brano verra' mostrato in grassetto.

     /wipcfg author ^b^c8,1
       Il titolo del brano sara' mostrato in grassetto, con caratteri gialli su
       sfondo nero.

     /wipcfg format ""
       Il formato del file sara' visualizzato con il colore di base e senza
       attributi in quanto la stringa non ne contiene.


   * Informazioni

     E' possibile decidere quali informazioni devono essere presenti nel
     messaggio visualizzato da WIP. Per farlo si opera sulla stringa
     "TEXT" avvalendosi dei seguenti parametri:

     Parametro         Stringa visualizzata

     %t                Titolo o nome del file audio.
     %a                Autore del file audio.
     %f                Formato del file audio.
     %d                Directory nella quale si trova il file.
     %y                Anno di realizzazione del file audio (solo per MP3).
     %p                Programma utilizzato per ascoltare il file.
     %n                Nick utilizzato dall'utente.

     Sono inoltre disponibili alcune informazioni sul sistema dell'utente
     che saranno di indubbio interesse per le persone presenti sul
     canale ;-)

     %1                Ora (sostituisce %h).
     %2                Data.
     %3                Versione del Kickstart (env:kickstart).
     %4                Versione del Workbench (env:workbench).
     %5                Versione di AmIRC.

     In questo caso colori e attributi non devono essere utilizzati
     in quanto si sovvraporrebbero a quelli configurati nelle
     singole stringhe.

     Poiche' l'autore non e' sempre presente o individuabile, il testo che lo
     precede ("by", di default) viene visualizzato solo in certe occasioni.
     E' quindi necessario, qualora lo si voglia modificare, immetterlo a
     parte, nella stringa "TEXT2".

     Un esempio:

     /wipcfg text "Sto ascoltando %t (%f) %a %y !"
     /wipcfg text2 by

     Chi vuole dare maggiore risalto ai propri messaggi puo' attivare
     l'opzione BEEP (/wipcfg BEEP 1). In questo modo ad ogni messaggio di WIP
     sara' accodato il carattere ^G che su molti client IRC causa
     l'esecuzione di un suono di sistema. ATTENZIONE: con questa opzione WIP
     diventa veramente fastidioso e si puo' incorrere in flame e ban
     (allontanamento forzato dal canale IRC). Da usare solo se l'ambiente e
     gli altri connessi lo accettano, in caso contrario e' preferibile
     disattivarlo (/wipcfg BEEP 0) L'autore non si ritiene responsabile di
     eventuali abusi e blah blah blah ;-)


   * Modalita' di visualizzazione

     WIP consente anche di decidere come il messaggio dovra' essere
     visualizzato. Si puo' scegliere fra diverse forme tramite il comando
     /wipcfg DISPLAY nn

     nn e' un numero fra 0 e 4 con i seguenti significati:

     Comando           Funzione

     /wipcfg DISPLAY 0 Messaggio normale. Il messaggio apparira' agli altri
                       utenti come un qualsiasi altro intervento nel canale.

     /wipcfg DISPLAY 1 "Action". Agli utenti appare con il nick del mittente
                       all'inizio del messaggio. E' normalmente utilizzato
                       per descrivere, in terza persona singolare, l'azione
                       che si sta compiendo. Ad esempio "caio sta dormendo".

     /wipcfg DISPLAY 2 "Notice". A seconda del client IRC utilizzato il
                       messaggio puo' apparire in canale, in query o anche
                       accompagnato da una segnalazione acustica. Il modo
                       migliore per infastidire gli utenti, insomma... :-)

     /wipcfg DISPLAY 3 "Wallchop". Il messaggio viene inviato esclusivamente
                       agli utenti che sono dotati dello stato di operatore.

     /wipcfg DISPLAY 4 "Wallnop". Il messaggio viene inviato esclusivamente
                       agli utenti che non sono dotati dello stato di
                       operatore.

     Le modalita' 3 e 4 richiedono la presenza del plugin WallChop 2.1 o
     superiore.

     La visualizzazione in locale avviene sempre tramite un messaggio
     normale,


   * Varie

     Non tutti i canali sono uguali. In alcuni si puo' giocare, in altri no,
     in alcuni si e' utenti abituali, in altri, magari, ospiti o nuovi
     arrivati. Per evitare di inviare i messaggi di WIP ove non e' opportuno,
     e' disponibile l'opzione SKIPLIST utilizzabile per immettere i canali
     (separati da uno spazio) nei quali non va inviato il messaggio. WIP ne
     terra' conto sia in modalita' normale che usando l'opzione ALL.

     Esempi:

     /wipcfg skiplist "#canale1 #canale2"

     Inserisce nella lista di canali in cui non inviare il messaggio i canali
     #canale1 e #canale2. Poiche' e' presente uno spazio, vanno usate le
     virgolette.

     /wipcfg skiplist ""

     Azzera la lista di canali in cui non inviare il messaggio.


   * Gestione preferenze

     wipcfg.amirx opera come un normale tool di gestione preferenze e salva
     le impostazioni sia in ENV: che in ENVARC:, permettendo di modificare la
     configurazione anche per la sola sessione corrente. Oltre ai comandi
     gia' citati sono disponibili le classiche funzioni presenti nei
     programmi di preferenze.

     Comando           Funzione

     HELP              Visualizza la documentazione del programma.
     SAVE              Salva le modifiche apportate anche in ENVARC:.
                       Normalmente le modifiche sono memorizzate
                       esclusivamente in ENV: e vengono quindi perse al reset
                       o spegnimento della macchina.
     LASTSAVED         Recupera le impostazioni presenti in ENVARC: e le
                       rende operative copiandole in ENV:.
     RESET             Salva in ENV: (non ENVARC:) le impostazioni
                       di default.


LIMITAZIONI (?)
   * AUTOMATISMI

     WIP e' ispirato ai plugin mIRC, Pirch e X-Chat. La differenza
     sostanziale e' che WIP non svolge l'operazione in automatico come i suoi
     cugini per PC.

     Non si tratta di una vera e propria limitazione del programma, quanto
     invece di una ben precisa scelta: mostrare in IRC il brano che si sta
     ascoltando puo' essere divertente ma alla lunga stanca chi deve sorbirsi
     continui messaggi. E un conto e' farlo ogni tanto, altra cosa e', per
     esempio, cambiare 10 brani in 5 minuti (e capita, proprio come quando si
     fa zapping in TV o fra le radio) e inviare ogni volta le informazioni
     nel canale!

     Per questa ragione WIP non automatizza l'operazione: scegliete in pace
     cosa volete sentire e, quando ne avrete voglia, fatene partecipi gli
     altri. Tanto fra alias, tasti funzione e bottoni utente, AmIRC rende
     comunque agevole l'operazione.

   * COMPATIBILITA'

     Attualmente WIP non puo' funzionare in congiunzione con AmigaAMP e
     PlayGUI in quanto tali programmi non dispongono dei comandi ARexx
     necessari per conoscere il titolo del brano che si sta ascoltando.


CREDITI
   L'autore desidera ringraziare le persone che, a vario titolo, hanno
   "contribuito" (direttamente o... molto indirettamente) allo sviluppo ed
   alla crescita di WIP.


   * I betatester "storici", prodi sperimentatori delle prime versioni
     (in ordine alfabetico):

     AlenPPC
     Clc
     d|MiX
     Fabius
     Fantasies
     FranZ
     Lecta
     [Tlo^SM]
     ShInKurO


   * Le persone che non condividono l'esistenza di questo programma, perche'
     temono l'abuso o le conseguenze dell'utilizzo di massa dello stesso e
     ipotizzano scenari apocalittici. E' grazie alle vostre insistenze e
     "pressioni" se WIP e' cresciuto... fino al rilascio pubblico. ;-)

     Jekill
     Hexxae
     Hdg


   * Gli autori dei programmi su cui WIP si appoggia:

     Alessandro De Luca e Christian Buchner        GMPlay
     Oliver Wagner                                 AmIRC
     Peter Kunath e Frank Riffel                   DeliTracker
     Simone -Wiz- Tellini                          WallChop (plugin AmIRC)
     Rdiger Hanke                                 AMidi
     K-P Koljonen                                  HippoPlayer
     Stphane Tavenard                             Songplayer e mpega
     Thorsten Hansen                               Amplifier


   * E anche gli amici, che mi mettono sempre di buon umore!
     (in ordine assolutamente sparso)

     Vale11, Falcon3, Fabio883, ShInKurO, Wavexx, Walcom (che mi fa morir dal
     ridere), [FranZ], Nickwar, Nati^89 (che e' la figlia di Jekill, vedi
     sopra :), Mixy, Recoba, Amicus, Mau2000, Fiffa, Zak883, Salware & i
     suoi fratelli, ecc...


STORIA
   Modifiche dall'ultima beta pubblica (2.32):

   + Supporto per una lista di canali in cui non visualizzare i messaggi.
   + Supporto di AMidi (tramite uno script esterno che controlla il
     comando PlayMidi).
   + Numerose migliorie interne atte a velocizzare e rendere piu'
     espandibile il programma.
   + Aggiunto il supporto di HippoPlayer. Attualmente pero' non
     qualcosa sembra funzionare bene...
   + Migliorata la compatibilita' con le buggose routine di rilevazione
     ID3 TAG di AMplifier.
   + Aggiunti i placeholder %1, %2, %3, %4 e %5.
   - Eliminati un po' di bugghini...

   La cronologia dettagliata delle modifiche e' presente nei file
   wip.history.txt e wipcfg.history.txt
