@database 002cfad8-0 @master /GMPGUI/GMPGUI-Eng.guide @$VER: 1.6 @author "Andrea Fiorito" @(c) "" @remark Created with Heddley v1.1 (c) Edd Dumbill 1994 @node "Main" "GMPlay GUI V1.6" @next "Introduction" @{fg fill}@{bg shine}·····@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}······@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}···@{bg back} @{fg fill}@{bg shine}···@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}····@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}···@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}·····@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg text}@{b}_@{ub} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}·····@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg text}@{b}\ / | |_ @{ub} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg text}@{b}\/ |.|_|@{ub} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}·····@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}··@{bg back} @{fg fill}@{bg shine}····@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg shine}·@{bg back} @{fg fill}@{bg text}·····@{bg back}@{fg text} @{"      Introduzione      " link "Introduction" 0} @{fg fill}@{bg text}··@{bg back} @{fg fill}@{bg text}·@{bg back}@{fg text} @{"       Disclaimer       " link "Disclaimer" 0} @{b}@{fg fill}Autore:@{ub}@{fg text} @{fg fill}@{bg text}··@{bg back} @{fg fill}@{bg text}··@{bg back}@{fg text} @{"    Sistema Richiesto   " link "SystemRequirements" 0} @{fg fill}@{bg text}··@{bg back}@{fg text} @{"      Installazione     " link "Installation" 0} @{b}@{fg shine}A n d r e a@{ub}@{fg text} @{fg fill}@{bg text}··@{bg back} @{fg fill}@{bg text}···@{bg back} @{fg fill}@{bg text}·@{bg back} @{fg fill}@{bg text}·@{bg back} @{fg fill}@{bg text}··@{bg back}@{fg text} @{"      Funzionamento     " link "HowItWorks" 0} @{fg fill}@{bg text}··@{bg back} @{fg fill}@{bg text}··@{bg back} @{fg fill}@{bg text}·@{bg back} @{fg fill}@{bg text}·@{bg back} @{fg fill}@{bg text}··@{bg back}@{fg text} @{" Informazioni Tecniche " link "TechnicalInfo" 0} @{b}@{fg shine}F i o r i t o@{ub}@{fg text} @{fg fill}@{bg text}··@{bg back} @{fg fill}@{bg text}··@{bg back} @{fg fill}@{bg text}·@{bg back} @{fg fill}@{bg text}·@{bg back} @{fg fill}@{bg text}··@{bg back}@{fg text} @{" Notizie Su GMPGUI " link "AboutGMPG" 0} @{fg fill}@{bg text}··@{bg back} @{fg fill}@{bg text}··@{bg back} @{fg fill}@{bg text}·@{bg back} @{fg fill}@{bg text}·@{bg back} @{fg fill}@{bg text}··@{bg back}@{fg text} @{"    Un po' di Storia    " link "TheNews" 0} @{fg fill}@{bg text}·····@{bg back} @{fg fill}@{bg text}····@{bg back} @{fg fill}@{bg text}··@{bg back}@{fg text} @{"        L'Autore        " link "TheAuthor" 0} @endnode @node "Introduction" "Introduzione" @next "Disclaimer" Introduzione... Come noto, Amiga si e` affacciata come si deve al mondo dei MIDI files, grazie al ben noto programma GMPlay. Tuttavia, nelle sue prime versioni almeno, GMPlay non possiede alcuna interfaccia grafica con la quale l'utente puo` facilmente settarne i parametri necessari. L'unico modo consiste nell'intervenire mediante riga di comando e impostare GMPlay volta per volta. Ho per questo motivo piu` volte cercato di trovare un rimedio efficace, per ovviare a questo annoso inconveniente. Dagli sforzi mossi lungo questa strada e` nato GMPGUI, che sta per: General MIDI Player Graphic User Interface. @endnode @node "Disclaimer" "Disclaimer" @next "SystemRequirements" @prev "Introduction" Naturalmente l'uso di questo programma e` a vostro esclusivo carico. Non mi assumo alcuna responsabilita` riguardo i possibili problemi derivanti dal suo utilizzo. Ma non ci dovrebbero essere problemi, dal momento che l'ho testato senza particolari inconvenienti, sul mio Amiga 1200 @endnode @node "SystemRequirements" "Sistema Richiesto" @next "Installation" @prev "Disclaimer" -@{fg highlight}Kickstart@{fg text} 2.0 o superiore -I comandi @{fg highlight}DOS@{fg text}: Break Delete Filenote Run Search Status -Le @{fg highlight}librerie@{fg text}: diskfont.library mathieeedoubbas.library mathieeedoubtrans.library rexxsyslib.library -Le @{fg highlight}font@{fg text} di caratteri: Topaz/8 (@{fg fill}@{"virtualmente" link "Installation"}@{fg text}) Topaz/11 I comandi DOS, le librerie e le font di caratteri fanno parte dei dischi di sistema (tuttavia la topaz 11 fa parte dell'archivio, per sicurezza). @{b}Attenzione@{ub}: se GMPGUI non rintraccia i Comandi DOS su menzionati, non ----------- funzionera` correttamente! @endnode @node "Installation" "Installazione" @next "HowItWorks" @prev "SystemRequirements" Ci sono 2 modi possibili: @{b}@{fg highlight}Automatica@{ub}@{fg text} o @{b}@{fg highlight}Manuale@{ub}@{fg text} @{b}Automatica@{ub}: e` sufficiente avviare il file di installazione 'Install-GMPGUI' @{b}Manuale@{ub} : basta seguire le indicazioni di seguito elencate * Copiare il file 'GMPGUI' con la relativa icona nella directory desiderata * Copiare i comandi DOS mancanti in C: (ad esempio), se non presenti * Copiare tutte le librerie occorrenti in LIBS: , se non presenti * Copiare i files 'Topaz/11' e 'Topaz.font' in FONTS: , se non presenti @{b}@{fg fill}NOTA@{ub}@{fg text}: E` necessario che la font di caratteri Topaz 8 @{b}non@{ub} sia presente in @{b}-----@{ub} FONTS: in quanto altera l'interfaccia grafica del programma. Perchè tutti i pulsanti piu` piccoli utilizzano il Topaz 11 scalato, onde risparmiare spazio sull'interfaccia. @endnode @node "HowItWorks" "Funzionamento" @next "TechnicalInfo" @prev "Installation" "Installation" GMPGUI è facile da usare. Una volta caricato, sia da Workbench che da CLI, si regolano i parametri desiderati, relativi al MIDI File selezionato, quindi si puo` procedere all'ascolto, cliccando sul tasto 'Play MIDI File'. Il programma richiama GMPlay (che deve trovarsi in GM:) impostandolo secondo i dati forniti dall'utente. @{b}@{fg fill}Significato e Uso dei vari gadgets@{ub}@{fg text} ==================================== [@{b}@{fg highlight}Directory@{ub}@{fg text}] Questo pulsante permette di selezionare il file da caricare che viene subito controllato per verificarne il formato MIDI. E` possibile richiamare questo pulsante in qualunque momento. Inoltre se si seleziona un nuovo MIDI File in fase di ascolto, GMPGUI ne evidenzia la presenza visualizzando la scritta '(next)' all'estrema destra del campo di visualizzazione dei file. [@{b}@{fg highlight}Volume@{ub}@{fg text}] [@{b}@{fg highlight}Frequency@{ub}@{fg text}] [@{b}@{fg highlight}Priority@{ub}@{fg text}] Sono i tre slider con cui si regolano Volume, Frequenza e Priorità del MIDI File selezionato. E` anche possibile utilizzare i campi alla loro destra, impostando con la tastiera i singoli valori. [@{b}@{fg highlight}Verbosity@{ub}@{fg text}] Questa sezione consta di due tasti: · @{b}MIDIFile Info@{ub} Se attivato prima di cliccare sul pulsante 'Directory', il programma fornisce il tipo ed il numero di voci del MIDI File caricato; se però il file è compresso (ad esempio in modalità XPK) GMPGUI visualizza il relativo messaggio d'errore. Inutile dire che questa funzione rallenta un po' il caricamento dei file. · @{b}GMPlay Output@{ub} Con questo tasto è possibile visualizzare in una finestra supplementare l'output di GMPlay, il quale viene lanciato in modalità VERBOSITY. [@{b}@{fg highlight}Mono@{ub}@{fg text}] Questo gadget consente di suonare il MIDI File in MONO, sfruttando così questa nuova caratteristica implementata in GMPlay 1.3 . [@{b}@{fg highlight}Force XG@{ub}@{fg text}] Questo tasto consente di forzare il playing del MIDI File nella modalità Yamaha XG, sfruttando così quest'altra nuova caratteristica. [@{b}@{fg highlight}Local@{ub}@{fg text}] Con GMPlay 1.3 è adesso possibile usufruire della possibilità di mantenere i settaggi relativi a ciascun MIDI File nei commenti del file stesso. Il tasto 'Local' consente di usufruire di questa nuova caratteristica in due modi: Ad ogni caricamento GMPGUI controlla che nei commenti del file ci sia la stringa 'GMPlay'; se ciò è vero, nel campo posto sopra il tasto 'Default' compare la scritta 'LOC ON', altrimenti rimane la stringa 'LOC OFF'. @{b}1@{ub}) All'attivazione del tasto (e finchè resta attivo) il programma accede ai commenti del MIDI File e verifica che contengano dei dati utili; se è così, tali dati vengono usati per impostare i parametri sulla finestra principale e la scritta 'USE LOC' compare nel già menzionato campo. @{b}2@{ub}) Quando si lancia GMPlay (se il tasto 'Local' è attivo) i dati comunque impostati nella finestra principale vengono salvati come commenti nel MIDI File stesso, così sarà possibile richiamarli in una fase successiva. Comodo no? => Allo stesso modo, se il tasto 'Local' non è attivo, ma dopo il caricamento compare la scritta 'LOC ON', è possibile ugualmente utilizzare i settaggi salvati nei commenti del file semplicemente attivando il tasto 'Local'. Disabilitando il tasto, GMPGUI ripristina i settaggi impostati prima di attivare la funzione 'Local'. [@{b}@{fg highlight}Default@{ub}@{fg text}] Premendo su questo pulsante GMPGUI riparametrizza tutto secondo i settaggi normali d'avvio. [@{b}@{fg highlight}Play MIDI File@{ub}@{fg text}] Non c'è bisogno di particolari spiegazioni, questo pulsante lancia GMPlay con tutte le regolazioni fissate sulla finestra principale. [@{b}@{fg highlight}Stop Playing@{ub}@{fg text}] Dà un taglio netto all'ascolto, interrompendo così l'esecuzione. [@{b}@{fg highlight}QUIT@{ub}@{fg text}] Ovvero: pulsante di chiusura! @{b}@{fg highlight}N O T E@{ub}@{fg text} ========= Tutti i gadgets hanno attivazione immediata, sebbene GMPGUI non sia stato scritto propriamente in Assembly! Se tuttavia durante il funzionamento l'uso della GUI risultasse un po'... ...«molliccio» ciò è da imputarsi pressochè esclusivamente (fino a prova contraria naturalmente) alle caratteristiche hardware dell' Amiga in uso. Suonare i MIDI file su Amiga non è una cosa facilissima, benchè Alessandro De Luca e Christian Buchner ci abbiano donato tale facilià grazie a GMPlay. Pertanto se Amiga rallenta...abbiate pazienza! O, come dicono altrove: «Non sparate sul pianista!» @endnode @node "TechnicalInfo" "Informazioni Tecniche" @next "AboutGMPG" @prev "HowItWorks" GMPGUI e` stato interamente realizzato mediante il programma 'CanDo 2.00' della INOVAtronics Inc. Tutti gli algoritmi utilizzati sono stati ideati da me, in diverse settimane di intenso lavoro. Attenzione: dal momento che non mi e` stato possibile trovare direttamente un modo per mettere GMPGUI nelle condizioni di capire se e quando GMPlay inizia e/o termina il play dei MIDI File, ho utilizzato uno stratagemma. L'effetto e` il seguente: GMPGUI ha un'imprecisione di circa 3-7 secondi nel conteggio del tempo trascorso dall'inizio dell'ascolto e impiega un massimo di 6 secondi, per rendersi conto che questo e` concluso. Pertanto la durata totale di un MIDI File e` approssimata, per eccesso o per difetto, di qualche secondo, ;-| mentre occorrono da 0 a 6 secondi, per potere ricominciare una sessione d'ascolto. Sorry! ;-( (Ad ogni modo interrompere GMPlay e` immediato). Quindi se a intervalli regolari l'hard disk si mette in movimento, non allarmatevi! :-9 E` del tutto regolare: GMPGUI sta solo informandosi! Tecnicamente il programma crea nella directory 'RAM:T' 3 files: il primo contiene la task dove gira GMPlay, il secondo fornisce lo status di tutte le task, il terzo, se non ha lunghezza zero, indica al programma che GMPlay sta ancora lavorando. @endnode @node "AboutGMPG" "Sul Programma" @next "TheNews" @prev "TechnicalInfo" GMPGUI è ora @{fg highlight}cardware@{fg text}, ma qualsiasi altra donazione sarà sicuramente ben accetta, nonchè gradita! Specie di questi tempi. Inviate pure donazioni, commenti e suggerimenti agli @{"indirizzi" link "TheAuthor" 0} indicati di seguito. L'intervallo di tempo che GMPGUI deve attendere prima di iniziare il conteggio del tempo d'ascolto è meglio gestito se è attivo il tasto 'MIDIFile Info'. Infatti entra in funzione un algoritmo che determina, in accordo a vari parametri relativi al MIDI File, un tempo medio d'attesa più preciso di quello di default (circa 23 secondi). Per visualizzare correttamente il titolo di un MIDI File è possibile non solo spezzare ciascuna parola componente il titolo con il trattino "_", ma anche «evidenziare» ogni parola scrivendone in maiuscolo l'iniziale. Esempio: Field_of_Gold.mid <--- @{b}@{fg highlight}Field of Gold@{fg text}@{ub} ---> FieldOfGold.mid Premendo il tasto destro del mouse GMPGUI va in iconify-mode, cioè viene ridotta la finestra alle dimensioni della barra di trascinamento. Inoltre la barra titolo del workbench cambia, visualizzando il nome del MIDI file in ascolto. Per usufruire di questa funzione è conveniente premere il tasto destro del mouse per circa mezzo secondo, specie se GMPlay necessita di molto tempo macchina. Ripremendo il tasto destro del mouse si riporta la GUI alle dimensioni originali e la barra titolo all' intestazione iniziale. @endnode @node "TheNews" "Un po' di Storia" @next "TheAuthor" @prev "AboutGMPG" @{b}@{fg highlight}H i s t o r y@{fg text}@{ub} V1.3 12 Febbraio 1997 - La prima release (apparsa su Aminet) V1.4 18 Giugno 1997 - Migliorata la temporizzazione e il conteggio della durata dell'ascolto - Il riconoscimento del formato del file caricato è ora piu` preciso - GMPGUI ora indica la presenza di un secondo file caricato - Le routine per la linea di comando di GMPlay sono ora piu` veloci - Sono stati inseriti i pulsanti 'Mono' e 'XG' - Ottimizzato il campo 'ON-OFF' per l'uso con il tasto 'XG' - Indicazione piu` dinamica delle informazioni della parte inferiore V1.5 4 Luglio 1997 - GMPGUI mostra in-ogni-caso il nome del file in ascolto - Ottimizzato il campo 'ON-OFF' per l'uso con il tasto 'Local' - Funzione 'Local' per il salvataggio e il caricamento dei settaggi per ciascun MIDI File e in maniera facoltativa - Piccole migliorie a livello grafico e software (qua e là) V1.6 06 Ottobre 1997 - Il nome del file in ascolto è ora mostrato per esteso, senza trattini e spazi inutili - Le varie parole del file in ascolto vengono spaziate anche secondo le iniziali, se nel nome del file queste sono maiuscole - Corretto un bug relativo alla funzione 'Local', connesso all'acquisizione dei dati da salvare - Eliminate le ridondanze, in fase di salvataggio, della funzione 'Local' - Ampliata ed ottimizzata la funzione 'Local' - Corretta l'intestazione sulla barra Workbench - Aggiunte alcune informazioni mancanti nella guide e corrette alcune imprecisioni - Ampliato l'iconify-mode con la visualizzazione del nome del MIDI file in ascolto nella barra titolo del workbench - Modificata l'icona del programma - Corretto un bug relativo alla visualizzazione della stringa (next), in uscita dall'iconify-mode - Migliorato il refresh della finestra in uscita dall'iconify-mode @endnode @node "TheAuthor" "L'Autore" @next "Main" @prev "TheNews" Sono uno studente di Ingegneria Elettronica dell'Universita` di Catania, ho 23 anni e mi piace molto trovare il modo per fare funzionare qualsiasi cosa, nel migliore dei modi. Anche per questo programmare, specie in maniera semplice ma efficace, e` uno dei miei «pallini» @{b}@{fg fill}Come contattarmi@{ub}@{fg text}: *E-Mail : s180676@studenti.ing.unict.it (Nuovo indirizzo dal 15/7/97) *Snail-Mail: Andrea Fiorito via Plebiscito 873 95124 Catania (ITALY) @{fg highlight}NOTA@{fg text}: Proprio nel periodo in cui è apparso su Aminet GMPGUI13 (Febbraio '97) nella mia università è stato formattato l'hard disk contenente il mio account. Pertanto chi mi avesse inviato i suoi messaggi è per forza di cose invitato a riscrivermi, se desidera una mia risposta. Grazie! Se dovesse accadere di nuovo provate quindi a ricontattarmi: sono un tipo che ama andare a fondo nelle cose e risponderò a tutti. @endnode