
			 - OperaOmnia - by OiPaz - 


		Versione 2.23 per Sistemi Windows a 32 bit

			    URL: www.oipaz.net
			  eMail: OiPaz@oipaz.net




 --- 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://www.oipaz.net/




 --- 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  <CTRL> si potranno fare selezioni
	multiple  (nelle  liste  degli  album  o dei  brani);  tenendo
	premuto il  tasto  <SHIFT>  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;
		/TESTI		-visualizza solo i testi;
		/IMMAGINI	-visualizza solo 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: <F1>-<F10>
	corrispondono ai dieci bottoni della  finestra  principale  di
	OperaOmnia,  ordinati  dall'alto  verso  il  basso;  <CTRL+F1>
	cambia lo stato del  bottone  di  selezione/deselezione  degli
	album; <CTRL+F3> fa la stessa cosa con i brani; <F11> dimezza/
	raddoppia le dimensioni della  finestra  principale;  <F12>  o
	<CTRL+I>  visualizzano  la  finestra delle informazioni; <DEL>
	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.23 - 23 febbraio 2001
		Aggiunto il parametro /IMMAGINI.
		Rinominato il parametro /3 in /TESTI.
		Aggiornati URL e indirizzo eMail di OiPaz.
		Piccole variazioni estetiche.

	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 <CTRL>.
		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 <INS> con il tasto <F11>.
		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  <SHIFT>  e  <CTRL>
			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 <INS>.

	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 <SHIFT> e <CTRL>  nelle
			selezioni degli album e dei brani.
		Aggiunta la gestione dei tasti <SHIFT> e <CTRL>  nella
			selezione delle immagini.
		Il tasto <INS> 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@oipaz.net

	È  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.
 ---------------------------------------------------------------------
