- OperaOmnia - by OiPaz - Versione 2.22 per Sistemi Windows a 32 bit URL: http://web.mclink.it/OiPaz/ eMail: OiPaz@mclink.it --- 0. Sommario ----------------------------------------------------- 0. Sommario 1. Introduzione 2. Per i Legulei 3. Requisiti di Sistema 4. INSTALLAZIONE 5. DISINSTALLAZIONE 6. Istruzioni per l'Uso 7. Per gli Sviluppatori! 8. Elenco delle Versioni Pubblicate 9. Critiche, Suggerimenti, Bug-Report A. Ringraziamenti --- 1. Introduzione ------------------------------------------------- OperaOmnia è un versatile programma per gestire raccolte di musiche, testi e immagini, ottimizzato per l'MP3 e l'utilizzo su supporti non riscrivibili come i CD-R. OperaOmnia si occupa automaticamente di catalogare i contenuti multimediali del disco per permetterne una consultazione diretta e intuitiva. Gli eventuali aggiornamenti saranno disponibili all'indirizzo http://web.mclink.it/OiPaz/ --- 2. Per i Legulei ------------------------------------------------ OperaOmnia è *FREEWare!*. Ciò implica che NON si deve pagare nulla all'Autore e che non ci si deve aspettare alcun tipo di supporto. NON viene inoltre fornita assolutamente alcuna garanzia, né implicita né esplicita, sia sul funzionamento del programma quanto su eventuali danni da esso provocati. In particolare l'Autore declina ogni responsabilità per le famigeratamente frequenti incompatibilità reciproche tra i componenti software di produzione Microsoft. Chiunque può utilizzare e/o ridistribuire OperaOmnia a condizione che non richieda alcuna somma di denaro in cambio, fatta eccezione per le spese del supporto e di spedizione che, tuttavia, devono essere documentate. Altra condizione per la libera distribuzione di OperaOmnia è che venga sempre fornito unitamente ai seguenti file (.inf e .ocx sono nascosti): AutoRun.inf -Avvio automatico del CD-R Leggimi.txt -Questo file di documentazione ReadMe.txt -Leggimi.txt in inglese RichTX32.ocx -Controllo aggiuntivo [Varie]\VB6 Setup.exe -Installazione delle librerie necessarie al Visual Basic --- 3. Requisiti di Sistema ----------------------------------------- OperaOmnia richiede un PC multimediale IBM-compatibile dotato di almeno un processore Pentium 100 MHz (o equivalente). OperaOmnia gira in ambiente Windows a 32 bit e non necessita di particolari risorse oltre alle normali librerie "RunTime" del Visual Basic v6.0 le quali, all'occorrenza, sono incluse nel file [Varie]\VB6 Setup.exe OperaOmnia richiede infine un programma esterno per suonare i brani musicali. Nella directory [Varie] dovrebbe essere presente una distribuzione completa di WinAMP, ma va bene qualunque altro programma purché sia in grado di gestire le PlayList in formato M3U. --- 4. INSTALLAZIONE ------------------------------------------------ Prima di installare alcunché è bene provare almeno una volta a far partire OperaOmnia: non è escluso che funzioni senza bisogno di altro! In caso contrario basterà eseguire il file [Varie]\VB6 Setup.exe e attenersi alle istruzioni fornite. Potrà anche essere necessario, una volta per tutte, registrare il file RichTX32.ocx digitando, da una finestra DOS, il comando: regsvr32 RichTX32.ocx Nel caso regsvr32.exe non venga trovato, occorrerà fornirne il percorso completo (generalmente è posto nella sottodirectory SYSTEM, o SYSTEM32, della directory principale di Windows). È poi possibile (e consigliabile) creare un collegamento al file OperaOmnia.exe del CD-R nel Menu Avvio o nel Desktop di Windows. Se il programma non dovesse partire automaticamente (all'inserimento del CD-R nel lettore) si potrà usare quest'ultimo link per farlo avviare. Altrimenti sarà sufficiente un doppio click sull'icona del programma. Prima di creare un collegamento all'eseguibile è opportuno consultare il §6 per avere l'elenco completo dei parametri utilizzabili nella linea di comando. Se non fosse già installato e registrato serve anche un programma per suonare i brani musicali. Nella directory [Varie] dovrebbe essere presente una distribuzione completa di WinAMP, ma si può utilizzare qualunque altro programma in grado di gestire le PlayList in formato M3U. --- 5. DISINSTALLAZIONE --------------------------------------------- Se, per qualche inimmaginabile ragione, OperaOmnia non piacesse, lo si può chiudere (se è in esecuzione) e... basta! OperaOmnia infatti NON lascia alcuna sporcizia in giro, né sull'HD né sul Registry, quindi teoricamente non necessita di disinstallazione. Però, se si sono aggiunti dei collegamenti all'eseguibile nel Menu Avvio o nel Desktop, o se si sono dovute installare le librerie del Visual Basic, si potranno cancellare i primi e disinstallare le seconde; queste ultime tramite l'usuale "Installazione Applicazioni" del Pannello di Controllo di Windows, ma con attenzione: potrebbero essere necessarie anche ad altri programmi! --- 6. Istruzioni per l'Uso ----------------------------------------- Selezionare gli album e i brani che interessano e poi premere l'apposito bottone "Play" per suonarli! Tenendo premuto il tasto si potranno fare selezioni multiple (nelle liste degli album o dei brani); tenendo premuto il tasto verranno automaticamente suonati i brani scelti. Se i brani fossero in formato MPEG-Audio OperaOmnia indicherà automaticamente la durata totale di quelli selezionati. Se gli album selezionati avessero associate note o immagini queste verranno visualizzate nelle apposite caselle. OperaOmnia può essere chiamato con i seguenti parametri nella linea di comando (n indica il numero di pixel): /L:n -larghezza iniziale; /A:n -altezza iniziale; /X:n -posizione orizzontale iniziale; /Y:n -posizione verticale iniziale; /MAX -ingrandisce la finestra principale; /AZ -ordina i brani alfabeticamente; /2 -dimezza la finestra principale; /3 -nasconde le immagini; /DUPLICATI -visualizza solo i brani duplicati; /ORIGINALI -visualizza solo i brani originali; /ROOT:percorso -specifica l'indirizzo della directory ove cercare i contenuti multimediali; /? o /H o /HELP -mostra le informazioni su OperaOmnia. Le maiuscole e gli spazi separatori sono facoltativi. Gli eventuali parametri errati verranno ignorati. Il programma può essere utilizzato anche senza Mouse, tramite l'usuale interfaccia a caratteri fornita da Windows. Oltre a quelli standard sono anche attivi i seguenti tasti: - corrispondono ai dieci bottoni della finestra principale di OperaOmnia, ordinati dall'alto verso il basso; cambia lo stato del bottone di selezione/deselezione degli album; fa la stessa cosa con i brani; dimezza/ raddoppia le dimensioni della finestra principale; o visualizzano la finestra delle informazioni; inverte le selezioni nelle liste degli album o dei brani. Per il resto l'uso di OperaOmnia dovrebbe essere intuitivo e immediato. Ogni bottone ha la propria descrizione (visibile tenendoci sopra, fermo, il puntatore del Mouse per qualche istante) che ne illustra il funzionamento. --- 7. Per gli Sviluppatori! ---------------------------------------- Per realizzare CD-R che utilizzino OperaOmnia si DOVRANNO includere tutti i file elencati nel §2 unitamente a OperaOmnia.exe stesso. Poiché quest'ultimo analizza i contenuti della propria directory, e delle sue sottodirectory, è opportuno che sia piazzato nella directory root del CD-R. Nel seguito della trattazione questo sarà dato sempre per scontato (ma, nel caso che lo si volesse piazzare altrove, sarà necessario solo aggiornare il file AutoRun.inf). Inoltre è consigliabile (ma non obbligatorio) mettere nella directory [Varie] la distribuzione completa di un player per PlayList in formato M3U. Ci si dovrà poi attenere alle seguenti regole: a) Mettere nella directory [Varie] una immagine di 480x480 pixel, in formato JPEG o GIF o BMP, con estensione rispettivamente .jpg o .gif o .bmp; questa, ritagliata automaticamente da OperaOmnia a forma di CD-R, sarà la "copertina" del programma. Inoltre il nome del file comparirà nella barra del titolo del programma stesso. Il file può essere vuoto. Si sconsiglia di usare file GIF con trasparenza poiché questo rallenterebbe l'avvio del programma. b) Nella lista degli album compaiono tutte e sole le directory il cui nome cominci con una "[" seguita da alcuni caratteri (da uno a cinque) e da una "]". Si dovrebbe sempre fare in modo che tutte le directory siano univocamente identificabili dai caratteri racchiusi tra le parentesi quadre iniziali. Per esempio può essere consigliabile usare il formato: [nnnn_] Xxx dove nnnn è un numero di quattro cifre (generalmente indicante l'anno) e il "_" può essere sostituito da una lettera dell'alfabeto quando vi siano più directory con lo stesso anno, in modo da distinguerle fra loro. Xxx è il titolo opzionale; anche i due spazi prima del titolo sono opzionali. La directory [Varie] compare nella lista solamente se contiene della musica (si veda il punto successivo). Ogni altra directory verrà ignorata. c) I contenuti di ciascuna delle directory/album sopra elencate vanno ordinati così: -tutti i brani musicali devono stare in una sottodirectory di nome Brani e devono avere l'estensione di 3 caratteri; -tutti i testi (in formato TXT) devono stare in una sottodirectory di nome Testi e devono avere l'estensione .txt; Nella lista dei brani compaiono solo quelli forniti del file di testo; -tutte le immagini (in formato JPEG o GIF o BMP) devono stare in una sottodirectory di nome Immagini e devono avere l'estensione .jpg o .gif o .bmp; le animazioni GIF non sono supportate. Ogni altra sottodirectory verrà ignorata. Eventuali PlayList precompilate e altri elementi non utilizzati direttamente da OperaOmnia possono essere inseriti a piacimento. d) Il nome del file del testo deve essere identico (tranne che nell'estensione) a quello del rispettivo file musicale e può avere uno qualunque dei seguenti formati: nn) Xxx nn. Xxx nn - Xxx Xxx dove nn indica il numero progressivo di traccia in DUE cifre; gli altri simboli hanno il significato già descritto. Ove presenti i due spazi sono obbligatori. L'ultimo formato elencato (quello libero) è fortemente sconsigliato in quanto non consentirebbe di ordinare cronologicamente la lista dei brani. È anche possibile utilizzare il formato descritto nel §7.b per i nomi delle directory (consigliato solo per i brani raccolti nella directory [Varie]). e) Le eventuali note di ciascun album vanno messe in un file (in formato TXT) di nome Nota.txt all'interno della sottodirectory Testi. È anche possibile inserire, nella directory [Varie], un testo introduttivo a tutta la raccolta (in formato TXT o RTF, con estensione .txt o .rtf). Se si usa il formato RTF il font dell'ultimo carattere del file (che può essere anche uno spazio vuoto) sarà quello usato nella visualizzazione di tutti gli altri testi e note della raccolta. f) Le immagini devono essere quadrate; la dimensione è libera. Se un album non possiede immagini, o non vi è alcun album selezionato, verrà visualizzata l'immagine utilizzata come "copertina" (si veda il §7.a). g) Può capitare che uno stesso brano debba comparire in più directory/album. In tal caso, per risparmiare spazio, basterà includere nel CD-R il file musicale una volta sola e sostituirlo nelle altre directory con un Link. Questo deve essere un file di testo, ma con estensione .OO, contenente nella prima (e unica) riga l'indirizzo completo, relativo all'eseguibile di OperaOmnia, del file musicale effettivamente incluso. h) La traduzione di un brano viene automaticamente messa a fronte del testo in lingua originale solo se vi è abbastanza spazio e se il file TXT ha la struttura: Testo in lingua originale (di K righe) (Riga vuota) -+----+---------+----+- (Riga vuota) Traduzione (di K righe) Si noti che, prima del separatore, ci sono sedici spazi vuoti. Questo è (o almeno dovrebbe essere) tutto! Altrimenti fare delle prove e degli esperimenti, e soprattutto analizzare il contenuto di una raccolta multimediale gestita da OperaOmnia già realizzata e funzionante, dovrebbe aiutare a chiarire ogni eventuale ulteriore dubbio. --- 8. Elenco delle Versioni Pubblicate ----------------------------- Versione 2.22 - 22 febbraio 2000 Aggiunto il parametro /MAX. Riattivata l'autovisualizzazione delle immagini quando è selezionato un unico album. Invertito il funzionamento del tasto . Eliminate le routine di gestione (non funzionanti) per il formato RTF nei testi dei brani. Piccole variazioni estetiche. Versione 2.21 - 21 febbraio 2000 Aggiunto il file ReadMe.txt in inglese. Riunificate le due caselle dei testi e delle note. Sostituito il tasto con il tasto . Scambiate tra di loro le funzionalità del click destro e sinistro nella finestra di presentazione. Eliminato un bug nel gestore del parametro /?. Eliminato un bug nel calcolo della durata dei brani. Eliminato un bug nella gestione dei bottoni di de/selezione degli album e dei brani. Piccole variazioni estetiche. Versione 2.20 - 11 novembre 1999 Aggiunta l'indicazione, accanto ai brani duplicati, dell'album di origine. Attivati il tasto destro del Mouse, il doppio click e la tastiera per chiudere la finestra di avvio. Sostituito il file Setup.exe difettoso. Eliminati i bottoni "OK" e "Leggimi" dalla finestra di avvio (che adesso è spostabile). Eliminati alcuni sporadici difetti di visualizzazione. Piccole variazioni estetiche. Versione 2.11 - 2 novembre 1999 Migliorata la gestione dei tasti e nelle selezioni degli album e dei brani. Compilato in codice nativo con Visual Basic v6.0. Eliminato un bug nell'aggiornamento delle immagini alla pressione del tasto . Versione 2.10 - 2 ottobre 1999 Aggiunta la possibilità di visualizzare solo gli album e i brani originali oppure solo i duplicati. Aggiunta la gestione dei tasti e nelle selezioni degli album e dei brani. Aggiunta la gestione dei tasti e nella selezione delle immagini. Il tasto e la freccia nera ora funzionano anche quando la finestra principale è massimizzata. OperaOmnia non elenca più (tra gli album) le directory prive di contenuti musicali. Piccole variazioni estetiche. Versione 2.00 - 1 settembre 1999 Prima versione distribuita pubblicamente. Versione 1.59 - 1 maggio 1999 Prima versione sperimentale dimostrativa completa. --- 9. Critiche, Suggerimenti, Bug-Report --------------------------- Tutte le critiche, i suggerimenti e (soprattutto) i bug-report sono ben accetti e vanno inviati a OiPaz@mclink.it È consigliabile specificare "OperaOmnia" nel soggetto del messaggio, riportando anche la versione e alcune informazioni sull'ambiente Windows e Visual Basic in uso. --- A. Ringraziamenti ----------------------------------------------- L'Autore desidera ringraziare chiunque lo abbia aiutato con idee e preziosi suggerimenti, nonché i beta tester. Grazie per la vostra pazienza! :-) E, ovviamente, grazie a Laura!! Buon divertimento!!! --------------------------------------------------------------------- OperaOmnia è un marchio registrato di OiPaz. ;-> Visual Basic e Windows sono marchi registrati di Microsoft. ---------------------------------------------------------------------