



              ******     ******    *******      ***     *******
             *      *   *      *   *      *    *   *     *     *
             *          *          *      *   *     *    *     *
              ******    *    ***   *******    *******    ******
                    *   *      *   *   *      *     *    *     *
             *      *   *      *   *    *     *     *    *     *
              ******     ******    *     *    *     *   *******

                 ( The Sample Grabber © 1993 DAIRYMEN SOFT )



                           - Scritto in AMOS V1.36 -

                                       Da

                                Pietro Ghizzoni



    --------------------------------------------------------------------

    Rispettate il Copyright dei samples o moduli che otterrete con Sgrab

    --------------------------------------------------------------------


                         Caratteristiche del programma
                         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


     Quello che hai appena ricevuto é uno dei migliori (o il migliore?) dei
     samples ripper attualmente in circolazione. Ecco un breve elenco delle
     sue caratteristiche:

     - Consumo memoria CHIP zero ( Vedi paragrafo nel `Menu Special' )

     - Comodo ed intuitivo `displayer' sullo stile di AudioMaster

     - Possibilità di usufruire di comode ed utili funzioni di Zoom

     - Possibilità di leggere il contenuto dei dischi anche Non-Standard

     - Possibilità di caricare file compressi con il Powerpacker

     - Possibilità di poter rippare anche moduli dei tracker più diffusi
       ( Pro/Noise/Star/Soundtracker )

     - Diversi ( !? ) formati per il salvataggio dei samples: IFF e RAW

     - Disposizione di alcune funzioni per l'editing dei samples ( Cut,
       Paste, Reverse.... )

     - Comodissima gestione dei samples in formato IFF-8SVX

     - Possibilità di caricare ed ascoltare moduli musicali ( e mentre li
       ascoltate, tramite apposita funzione, potrete appropriarvi degli
       strumenti utilizzati )

     - Possibilità di gestire 50 ( Cinquanta!! ) samples contemporaneamente

     - Effetti quasi speciali: Loop sample ecc.

     - Possibilità di ascoltare il contenuto della memoria Fast e di
       grabbare i samples in essa contenuti, utilizzando solo 512 Bytes di
       memoria Chip per l'ascolto ! ( Magico Double-Buffering )

     - ed altre bellissime funzioni !


                                   FreeWare
                                   ~~~~~~~~


     Questo programma è FreeWare, se ti piace ed intendi usarlo devi ....
     usarlo senza problemi, e darlo a tutti i tuoi amici!!!

     L'unico obbligo che avete ( se così lo possiamo chiamare...) è quello
     di contattarmi e farmi sapere cosa ne pensate di Sgrab ( Facile no? )
     Il mio indirizzo è riportato nel paragrafo `Suggerimenti'

     Un'ultima cosa:

     Se siete in possesso di files originali che descrivono un formato
     musicale non ancora supportato da Sgrab ( Es: Future Composer o Sound
     Monitor ) oppure di un formato in cui vi piacerebbe salvare i samples,
     non dovrete far altro che inviarmeli, così facendo contribuirete alla
     crescita di Sgrab ed in più sarete utenti registrati ( ...il materiale
     deve essere ORIGINALE e COMPLETO! ). Come utenti registrati riceverete
     ( appena disponibile ) l'ultima versione di Sgrab, e inoltre il vostro
     nome  comparirà nella  sezione `ringraziamenti' rendendo  pubblica la
     vostra preziosa collaborazione!!


                            Come usare il programma
                            ~~~~~~~~~~~~~~~~~~~~~~~


     Sgrab appartiene alla famiglia dei programmi "ripper", tra cui i più
     famosi sono quelli musicali ( chi non ne ha almeno uno ? ) che vi
     permettono di poter rippare ad altri programmi quelle stupende musiche
     a cui AMIGA ci ha abituato. Ma i samples non sono belli? La risposta è
     SI, e con Sgrab li avrete tutti a  vostra disposizione !


                                 Come funziona
                                 ~~~~~~~~~~~~~


     Tutti i samples che Amiga suona nei giochi o demo devono essere
     memorizzati da qualche parte nella memoria. Sgrab vi permette di
     suonare il contenuto della memoria attraverso gli speakers della
     vostra televisione o monitor. Tutto quello che voi dovrete fare è
     ascoltare quello che uscirà dagli speakers finché non sentirete lo
     strumento, voce o sample che volevate salvare. Quando avrete
     localizzato con precisione il sample in memoria potrete ovviamente
     salvarlo ( oooooh! ) dove più vi aggrada nel formato che preferite.


                              Possibili impieghi
                              ~~~~~~~~~~~~~~~~~~


     Ci sono 4 differenti possibilità di utilizzo:


     1) Analizzare la memoria dopo un reset.
     --------------------------------------

     Questo metodo va utilizzato per quei programmi o demo dai quali non vi
     è la possibilità di uscire.  Molti di questi programmi non  cancellano
     il  contenuto  della  memoria  dopo  un reset del sistema,  quindi non
     dovrete far altro che resettare  e  caricare  subito  dopo  Sgrab  per
     raccogliere il vostro bottino. Siate sicuri di caricare Sgrab prima di
     qualsiasi altro  programma che potrebbe  rovinare i samples  che sono
     in memoria.


     2) Normale analisi della memoria.
     ---------------------------------

     Quando utilizzate programmi che fanno uso di samples, ma che non
     disabilitano il multitasking, non dovrete far altro che caricare anche
     Sgrab e cercare in memoria i samples che vi interessano.


     3) Analisi di un file.
     ----------------------

     Con questo metodo potrete caricare in memoria un qualsiasi file per
     poi controllare se in esso erano contenuti dei samples.  Se il file  è
     stato  compattato con un qualsiasi cruncher l'operazione è inutile.  (
     Ad eccezione dei file compressi con il Powerpacker )


     4) Lettura del disco.
     ---------------------
     Sfortunatamente ci sono anche quei giochi che dopo un reset si
     preoccupano di pulire per bene la memoria lasciandoci a bocca
     asciutta. Che fare? E' molto semplice, poiché Sgrab vi offre la
     possibilità di leggere direttamente il contenuto di un qualsiasi
     disco, in cui per forza si trovano i samples.  Se l'ideatore del gioco
     non ha salvato i samples in qualche strano formato state sicuri che li
     troverete.


                              Usare il programma
                              ~~~~~~~~~~~~~~~~~~


     Per  caricare  Sgrab  bisogna  digitare  da CLI Sgrab2.4 e poi premere
     return. MOLTO IMPORTANTE: Quando cliccherete sul gadget di  profondità
     di Sgrab sarà necessario premere AMIGA( Sinistro )-A per richiamare il
     programma ( Questo perché AMOS non fa uso dei normali screen Intuition
     ).  Se  il  programma  appena  avviato  vi  mostra una schermata nera,
     premete 2 volte AMIGA-A  e  tutto  andrà  a  posto  (  ...misteri  del
     compilatore ). IMPORTANTE:appena avviato Sgrab chiuderà ( se possibile
     ) lo  schermo del Workbench. IMPORTANTE: se tenete premuto il pulsante
     destro  ( dopo aver APPENA avviato Sgrab ),  attiverete  la Sgrab Hunt
     Window che vì permetterà di rippare qualsiasi modulo rimasto in
     memoria. La  particolarità di  questa finestra è che si tratta  di una
     normale finestra Intuition che verrà aperta prima dello schermo di
     Sgrab ( quindi prima che venga allocata della memoria CHIP!! ), con la
     conseguenza che nessun modulo verrà rovinato!!. Il suo funzionamento è
     identico alla funzione Hunt Module di Sgrab ( Vedi `Menu Special' ).


                                    Gadgets
                                    ~~~~~~~


     Appena avviato il programma vi  si  presenterà  davanti  la  schermata
     principale in perfetto stile 2.0 che ora descriverò:
     Cominceremo dalle 18 icone poste su 2 file che trovate sulla  sinistra
     del vostro schermo:


     "St"  START
     -----------

     - PULSANTE SINISTRO:
     Setta la locazione iniziale ( START ) del sample che volete salvare

     - PULSANTE DESTRO:
     Vi  sposterete  alla  locazione  di  memoria  contenuta in START ( per
     usufruire di tale funzione dovrete definire prima anche  la  locazione
     finale ( END ) del sample ).


     "En"  END
     ---------

     - PULSANTE SINISTRO:
     Setta la locazione finale ( END ) del sample che volete salvare.

     - PULSANTE DESTRO:
     Vi  sposterete  alla  locazione  di  memoria  contenuta  in  END ( per
     usufruire di tale funzione dovrete prima anche definire  la  locazione
     iniziale ( START ) del sample ).


     "Pl"   PLAY ALL
     ---------------

     - PULSANTE SINISTRO:
     Appena premuta l'icona,  il programma vi farà ascoltare  il  contenuto
     della  memoria  CHIP  partendo dalla locazione corrente fino alla fine
     della vostra memoria (CHIP).  Per interrompere l'ascolto é sufficiente
     ripremere  nuovamente  l'icona Pl.  Questa operazione é indispensabile
     quando, appena avviato il programma,  volete scoprire se in memoria vi
     sono dei samples. Quando sentirete il sample o strumento che cercavate
     ricliccate tempestivamente su questa icona, e vi troverete grosso modo
     alla  locazione  in cui avete l'avete sentito.  Per meglio definire la
     locazione iniziale usare l'icona "Po" e il `displayer'

     - PULSANTE DESTRO:
     Rispetto  alla locazione di memoria in cui vi trovate vi sposterete in
     avanti di tanti bytes quanti indicati in Length. Indispensabile quando
     dovrete  trovare  la  locazione  finale  ( END ) del sample che volete
     salvare. ( Vedi paragrafo `Aiuti' )


     "Po"   PLAY ONLY
     ----------------

     - PULSANTE SINISTRO:
     Con questa icona ascolterete il contenuto della memoria che va da
     START a END ( cioè il sample che avete definito ). Se non avete
     precedentemente fissato queste 2 locazioni vi verrà segnalato un
     messaggio di errore.

     - PULSANTE DESTRO:
     Ascolterete il contenuto della memoria che va dalla locazione corrente
     (  indicata  nella  apposita  finestra  "Location"  )  alla  locazione
     corrente   più   i  bytes  indicati  in  Length.   Indispensabile  per
     individuare con esattezza l'inizio o la fine  di  un  sample.  (  Vedi
     paragrafo `Aiuti' )


     "J1"   Jump 1
     -------------

     - PULSANTE SINISTRO:
     Sposta il segnale numero 1 alla locazione corrente. Successivamente
     potrete tornare alla locazione in cui è posto il segnale.

     - PULSANTE DESTRO:
     Vi sposterete alla locazione in cui è posto il segnale numero 1.


     "J2"   Jump 2
     -------------

     - PULSANTE SINISTRO:
     Sposta il segnale numero 2 alla locazione corrente. Successivamente
     potrete tornare alla locazione in cui è posto il segnale.

     - PULSANTE DESTRO:
     Vi sposterete alla locazione in cui è posto il segnale numero 2.


     "Fm"   Free Memory
     ------------------

     - PULSANTE SINISTRO:
     Visualizza il massimo blocco allocabile di memoria CHIP e  di  memoria
     FAST assieme alla memoria effettivamente libera.

     - PULSANTE DESTRO:
     Nessun significato.


     "Lm"   Load Music
     -----------------

     - PULSANTE SINISTRO:
     E' l'equivalente di Load, ma in questo caso potrete caricare in
     memoria un qualsiasi modulo in formato Star-Pro-Noisetracker che
     potrete ascoltare mentre avidamente vi impossesserete dei suoi
     strumenti.  Per interrompere la musica è sufficiente premere la barra.
     ATTENZIONE: Se nel `Menu Prefs' l'opzione "Ctrl Modulo" é disattivata,
     non verrà controllato se effettivamente quello che viene caricato è un
     modulo musicale in formato Pro-Star-Noisetracker, perciò siate sicuri
     di ciò che caricate poiché potrebbe verificarsi ( quasi sempre... )
     qualche GURU/Software Failure....

     - PULSANTE DESTRO:
     Nessun significato.


     "Sm"   Sample
     -------------

     - PULSANTE SINISTRO:
     Memorizza  nel buffer il sample da voi definito ( cioè i dati compresi
     tra START e END ),  permettendovi  di  identificarne  un  altro  senza
     perdere quello precedente. Il numero dei samples che avete memorizzato
     e le loro caratteristiche li trovate elencati nella finestra in  basso
     a sinistra.  ATTENZIONE:  il sample non viene salvato fisicamente,  ma
     solo la sua locazione iniziale e finale vengono salvate,  quindi  ogni
     modifica  che  apporterete al sample non potrà essere ricuperata.  Per
     richiamare un sample memorizzato nel  buffer  bisogna  cliccare  nella
     finestra  "  Selected  Sample  "  e  digitare  il  numero  del  sample
     desiderato. ATTENZIONE:  Quando richiamate un sample dal buffer quello
     corrente verrà perso ( NON FISICAMENTE!! ma solo la locazione iniziale
     e quella finale da voi definite andranno perse,  e verranno sostituite
     da quelle del sample che avete richiamato. )

      - PULSANTE DESTRO:
     Richiamerete dal buffer il sample successivo a quello corrente.


     "Sa"   Save
     ------------

     - PULSANTE SINISTRO:
     Salva su disco il sample corrente ( quello definito tra START e END ).
     Se le 2 locazioni non sono definite vi verrà segnalato un messaggio di
     errore.

     - PULSANTE DESTRO:
     Nessun significato.


     "Lo"   Load
     -----------

     - PULSANTE SINISTRO:
     Carica in memoria un file da disco per analizzare se al suo interno vi
     sono dei samples.  ATTENZIONE:   parte dei dati  in  memoria  verranno
     persi.  Tutti  i  samples  memorizzati nel buffer verranno cancellati.
     Quindi prima di caricare qualsiasi cosa siate SICURI di  aver  salvato
     su DISCO i samples già rippati.

     - PULSANTE DESTRO:
     Nessun significato.


     "8x"  8SVX
     ----------

     - PULSANTE SINISTRO
     Partendo  dalla locazione memorizzata nel puntatore 8SVX ( vedi dopo )
     cercherà in memoria tutti i samples in formato IFF 8SVX, facendo tutto
     il lavoro al vostro posto con precisione assoluta.

     - PULSANTE DESTRO
     Partendo dalla locazione memorizzata nel puntatore 8SVX ( vedi dopo  )
     cercherà  in  memoria tutti i samples in formato IFF 8SVX,  salvandoli
     automaticamente nel buffer.


     "Rd"  Read Disk
     ---------------

     - PULSANTE SINISTRO
     Questa  funzione  vi  permette di leggere il contenuto di un qualsiasi
     disco,  per poi analizzare se fra i dati letti vi sono dei samples. La
     traccia  iniziale e quella finale sono  riportate nelle finestre Start
     Track e End Track.  Quando cliccate su questa icona i parametri  Start
     Track  e  End  track  vengono  settati  automaticamente  dal computer,
     massimizzando i risultati in base alla memoria CHIP libera.  Dopo aver
     letto  qualcosa dal disco basterà premere l'icona Po (pulsante destro)
     e sentirete  se  avete  trovato  qualche  sample,  in  caso  contrario
     continuate a leggere le tracce rimanenti finché non avrete letto tutto
     il disco. State sicuri che qualcosa troverete !!
     Una  volta  terminata  la  lettura  il  parametro  Start  Track  viene
     eguagliato al parametro End Track,  così facendo quando riprenderete a
     leggere il disco inizierete da dove avete precedentemente smesso.
     ( I parametri Start Track e End Track possono  anche  essere  indicati
     manualmente usando l'opzione Leggi Disco/Manuale  del `Menu Special' )

     - PULSANTE DESTRO
     Nessun significato


     "Cu"  Cut
     ---------

     - PULSANTE SINISTRO
     Rappresenta una delle funzioni  elementari per l'editing dei samples:
     dopo  aver fissato la locazione iniziale e quella finale dell'area che
     volete rimuovere cliccate  su  questa  icona,  e  il  contenuto  dell'
     area da  voi  definita vera trasferito in un banco provvisorio in FAST
     ( se non avete memoria FAST non potrete utilizzare questa funzione ).

     - PULSANTE DESTRO
     Nessun significato.


     "Pa"  Paste
     -----------

     - PULSANTE SINISTRO
     Collocherà  alla  locazione corrente il contenuto del banco di memoria
     FAST  precedentemente  creato  mediante  la  funzione  Cut  o   Store.
     ATTENZIONE:  questa  funzione  é molto rischiosa,  poiché rischiate di
     sovvrascrivere dati di altri programmi con  conseguente  incasinamento
     del sistema che andrà in crash al 99.99999999% dei casi.  Quindi siate
     sicuri di collocare i dati in un area sicura ( per esempio su parte di
     un sample rimasto in memoria dopo un reset del sistema ).

     - PULSANTE DESTRO
     Nessun  significato.


     "Sr"  Store
     -----------

     - PULSANTE SINISTRO
     E'  l'equivalente di Cut,  l'unica differenza é che i dati in CHIP non
     verranno rimossi, ma semplicemente copiati in FAST.

     - PULSANTE DESTRO
     Nessun significato.


     "Re"  Reverse
     -------------

     - PULSANTE SINISTRO
     Altra elementare  funzione per  l'elaborazione dei  samples:  tramite
     questa funzione invertirete il sample lungo l'asse delle X.  Es: Se il
     sample fosse uguale a "ABCDE",  dopo tale funzione diventerebbe uguale
     a"EDCBA".

     - PULSANTE DESTRO
     Nessun significato.


     "Hm"  Hunt Module
     -----------------

     - PULSANTE SINISTRO
     Cerca in memoria un modulo in formato Pro/Sound/Noise/Startracker a 16
     o  31  strumenti.   La  ricerca  dei  moduli  a  16  strumenti  non  é
     precisissima ma la maggior parte delle volte funziona egregiamente!  (
     comunque ben  difficilmente  troverete  in  circolazione  moduli  così
     antiquati ).  ATTENZIONE: Sgrab pur salvando moduli a 16 strumenti NON
     é in grado di suonarli! Quando Sgrab avrà trovato un modulo in memoria
     ve  ne visualizzerà il nome e la lunghezza,  poi vi farà ascoltare gli
     ipotetici strumenti.  Se quello che sentirete sono dei suoni  distorti
     vorrà  dire che il modulo é rovinato e quindi non meritevole di essere
     salvato. Quando Sgrab avrà trovato un modulo dovrete scegliere tra:


     1) Salva
     --------

     Salva il modulo su disco.


     2) Cancella
     -----------

     Cancella dalla struttura  del  modulo  in  memoria  alcuni  dati,  con
     conseguenza  che  ad  una  futura  ricerca Sgrab non rileverà più quel
     modulo.


     3) Prosegui
     -----------

     Continua a cercare in memoria altri moduli.


     4) Quit
     -------

     Esce dalla funzione senza svolgere alcuna attività.


     - PULSANTE DESTRO
     Nessun significato


                                 Menu Options
                                 ~~~~~~~~~~~~


     1) Unità S/D
     ------------

     Seleziona quale sarà l'unità sorgente/destinazione. Tutte le
     operazioni  di  lettura/scrittura   verranno   effettuate   sull'unità
     prescelta. Default ( DF0 ). E' possibile effettuare la scelta anche da
     tastiera:  il tasto I seleziona il drive Interno,  mentre il  tasto  E
     seleziona il drive esterno ( se lo avete.... )
     ATTENZIONE:  é  possibile,  sfruttando  il  requester,  utilizzare  un
     qualsiasi device come sorgente, ma per quanto riguarda la destinazione
     sarete VINCOLATI all'utilizzo del drive esterno o  interno!!    Quindi
     non  potrete  utilizzare  il disco fisso come destinazione,  e neppure
     potrete indicare una particolare directory in cui  salvare  i  samples
     (Es:  DF0:Mysample),  ma  dovrete  accontentarvi  di  DF1  o DF0!  Non
     lamentatevi,  dato che  questa  limitazione  é  posta  per  il  vostro
     interesse,  poiché  limita  al minimo l'uso del requester ed il vostro
     lavoro ( Ogni volta che richiamate il requester una buona parte  della
     vostra  memoria CHIP viene cancellata, perdendo così i samples in essa
     contenuti! )


     2) About
     --------

     Visualizza informazioni sul programma e l'autore.


                                 Menu Special
                                 ~~~~~~~~~~~~


     1) Vuota Buffer
     ---------------

     Tutti i samples memorizzati nel buffer verranno cancellati. ( dal
     buffer non dalla memoria !)


     2) Salva Buffer
     ---------------

     Tutti i samples contenuti nel buffer verranno salvati su disco.
     Esistono due possibilità per il salvataggio:

     1) Singolo: ogni sample verrà salvato individualmente

     2) Libreria: tutti i samples verranno salvati in un unico file

     Se nel `Menu Prefs' é attivata la funzione Ctrl Buffer potrete
     scegliere quali samples salvare e quali no.


     3) Play Buffer
     --------------

     Potrete ascoltare il contenuto del buffer con estrema facilità.


     4) IFF 8SVX >> ( da tastiera = F )
     ----------------------------------

     Partendo dalla locazione memorizzata nel puntatore 8SVX ( vedi dopo  )
     cercherà in memoria tutti i samples in formato IFF 8SVX, facendo tutto
     il lavoro al vostro posto con precisione assoluta.


     5) IFF 8SVX << ( da tastiera = B )
     ----------------------------------

     Partendo dalla locazione memorizzata nel puntatore 8SVX ( vedi dopo  )
     cercherà  a ritroso nella memoria tutti i samples in formato IFF 8SVX,
     facendo tutto il lavoro al vostro posto con precisione assoluta.


     6) 8SVX > Buffer ( da tastiera = 8 )
     ------------------------------------

     Partendo dalla locazione memorizzata nel puntatore 8SVX ( vedi dopo  )
     cercherà  in  memoria tutti i samples in formato IFF 8SVX,  salvandoli
     automaticamente nel buffer.


     7) Leggi Disco
     --------------

     Questa funzione vi permette di leggere il contenuto  di  un  qualsiasi
     disco,  per poi analizzare se fra i dati letti vi sono dei samples. La
     traccia iniziale e quella finale sono  riportate nelle finestre  Start
     Track  e  End  Track. Default  ( 0-16 ) Ovviamente tali valori possono
     essere modificati a piacimento.  Per  ogni  traccia  che  viene  letta
     necessitano  11264  bytes di memoria CHIP,  quindi prima di tentare di
     leggere troppe tracce ed ottenere un messaggio d'errore del tipo  "Out
     of  memory"  fate i conti con la vostra memoria CHIP.  Dopo aver letto
     parte del disco basterà premere  l'icona  Po  ed  ascoltare  se  avete
     trovato  qualcosa  di  interessante,  in  caso  contrario continuate a
     leggere le tracce rimanenti finché non avrete letto  tutto  il  disco.
     Per facilitarvi la vita esistono due comode funzioni:

     1) Automatico: i parametri Start Track e End Track vengono settati dal
     computer in base  alla  quantità  di  memoria  CHIP  libera  (  METODO
     CONSIGLIATO )

     2) Manuale:  verrano  lette le tracce da voi indicate in Start Track e
     End Track ( da tastiera = M )


     8) Puntatore 8SVX
     -----------------

     Quando iniziate la ricerca di samples in formato IFF tale ricerca  non
     inizia dalla locazione corrente,  ma bensì dalla locazione memorizzata
     nel puntatore 8SVX. Appena avviato il programma il puntatore è fissato
     alla  locazione  0,  ma  se verranno trovati dei samples in memoria si
     sposterà  automaticamente  alla  locazione  dell'ultimo   sample   IFF
     identificato.  Volendo potete cambiare la posizione del puntatore 8SVX
     scegliendo tra:

     1) Reset: Riporta il puntatore alla locazione 0
     2) J1: Sposta il puntatore alla locazione del segnale 1
     3) J2: Sposta il puntatore alla locazione del segnale 2
     4) Current: Sposta il puntatore alla locazione corrente


     9) Salva formato
     ----------------

     Ogni  volta  che salverete un sample su disco questo verrà salvato nel
     formato da voi scelto. Le possibili scelte sono:


     1) IFF( Interchange File Format ): utilizzato da tutti i programmi che
     trattano sample.

     2)  RAW:  Il  sample  viene  salvato  in  modo  grezzo,  senza  alcuna
     informazione ad esso relativa.


     10) Cerca modulo
     ----------------

     Vedi icona Hunt Module nel paragrafo `Gadgets'


     11) Zoom Sample ( da tastiera = Z )
     -----------------------------------

     Normalmente, nel  `displayer', il sample viene visualizzato al massimo
     dell'ingrandimento per permettervi di poter cogliere  anche  i  minimi
     particolari;  tuttavia  in  molte  occasioni  risulta  utile avere una
     visione globale del sample.  Tramite questa funzione il  sample  verrà
     interamente  visualizzato nel  `displayer'  e potrete sfruttare alcune
     comode funzioni da tastiera:

     - Tasto P:  il cursore indicherà IN TEMPO REALE quale parte del sample
     state ascoltando.

     - Freccia destra:  farete avanzare il cursore. Quando avrete raggiunto
     il punto desiderato premete il  pulsante  sinistro  del  mouse,  e  vi
     ritoverete esattamente alla locazione di memoria da voi indicata.

     -  Freccia  sinistra:  farete  retrocedere  il cursore.  Quando avrete
     raggiunto il punto desiderato premete il pulsante sinistro del  mouse,
     e  vi  ritroverete  esattamente  alla  locazione  di  memoria  da  voi
     indicata.

     Per  poter  usufruire del Zoom Sample ovviamente dovete prima definire
     il sample ( ...ed il sample deve essere più lungo di 257 bytes! )


     12) Zoom Raw ( da tastiera = R )
     --------------------------------

     Ha la stessa funzione di Zoom Sample,  solo che  in  questo  caso  non
     verrà  zummato  il sample da voi definito,  ma bensì l'area di memoria
     che va dalla locazione corrente  alla  locazione  corrente  più  tanti
     bytes quanti indicati in Length.  Molto, ma molto utile quando dovrete
     cercare l'inizio o la fine di un sample,  poiché ora  i  vostri  occhi
     verranno  in  aiuto alle vostre orecchie,  che grazie alla funzione di
     play in tempo reale ( vedi sopra ) vedranno quello che sentono(!!) con
     conseguente ottimizzazione del tempo e del risultato ottenuto.


     13) Cerca Zero ( da tastiera = 0 )
     ----------------------------------

     Tramite  questa  funzione Sgrab andrà alla ricerca del punto morto ( a
     volume zero ) più vicino  al  cursore.  In  questo  punto  il  grafico
     risulta  piatto. La  maggioranza dei samples comincia e finisce con un
     punto morto,  quindi con questa comoda  funzione  potrete  velocemente
     trovarne l'inizio o la fine.


     14) Recupera Chip
     -----------------

     Come  accennato all'inizio del Doc,  Sgrab promette il consumo ZERO di
     memoria CHIP,  ma é proprio vero?  NO!,  non  é  vero  che  Sgrab  non
     utilizza memoria Chip ( altrimenti lo schermo come lo aprirebbe? ), ma
     però vi offre una grandiosa funzione ( del tutto automatica ):

     Prima di allocare la memoria Chip che gli serve,  copia  il  contenuto
     delle  aree interessate ( cioè dove Sgrab vuole allocare i suoi dati )
     in Fast e successivamente le impegna per i suoi bisogni.

     Tramite la funzione Recupera Chip i dati  precedentemente  copiati  in
     Fast  verranno riportati in Chip,  e potrete così analizzare se fra di
     essi vi erano dei samples. Ecco dimostrato il consumo zero di  memoria
     Chip  !  Appena  invocata la funzione noterete che il parametro Length
     viene  automaticamente  impostato  a  40960  (  Totale  memoria   Chip
     utilizzata  da Sgrab ),  a questo punto basterà premere l'icona Po con
     il pulsante destro e sentirete cosa avete recuperato. ATTENZIONE: come
     avrete  intuito tale funzione é disponibile solo se dispone di memoria
     FAST.  Altro importantissimo  aspetto  é  che  funziona  correttamente
     solamente  se  Sgrab  viene lanciato dopo un reset come primo ED UNICO
     programma ( soluzione caldamente raccomandata per ottenere  i  miglior
     risultati  ).  Ultimo consiglio:  utilizzate la funzione Recupera Chip
     solamente dopo aver salvato tutti i samples che vi interessano, poiché
     i  dati  presenti  in  Fast  NON  verrano  ubicati alla loro posizione
     originale,  ma bensì in un punto qualsiasi della vostra  memoria  CHIP
     con il conseguente rischio di rovinare qualche sample.


     15) Cancella Banco-D
     --------------------

     Elimina dalla memoria Fast il banco contenente il backup della memoria
     Chip che ha utilizzato Sgrab.


                                  Menu Memory
                                  ~~~~~~~~~~~


     Per  non dover inventare differenti versioni dello stesso programma in
     base alla memoria Chip disponibile,  in questo menu dovrete dichiarare
     la memoria Chip di cui disponete. Valori disponibili: 512KB, un Mega e
     due  Mega.   Dichiarare  di  avere  più  memoria  rispetto  a   quella
     disponibile  è  perfettamente  inutile.  Appena avviato,  il programma
     tenterà di autoconfigurarsi,  e visualizzerà nella finestra in basso a
     destra la configurazione assunta.


                                  Menu Music
                                  ~~~~~~~~~~


     Questo  menu  contiene  tutte  le  funzioni per la gestione dei moduli
     musicali. Più precisamente troviamo:

     -  Carica:   carica  in  memoria  un  qualsiasi  modulo   in   formato
        Pro/Noise/Soundtracker

     - Ferma: Ferma l'esecuzione del modulo che state ascoltando

     - Suona: Riprende l'esecuzione del modulo dopo un'interruzione

     - Cancella: Cancella dalla memoria il modulo che avete caricato

     - Salva ST:  Memorizzerà nel buffer tutti gli strumenti utilizzati dal
       modulo che avete caricato. Quando li richiamerete dal buffer vi sarà
       segnalato anche il loro nome


                                  Menu Prefs
                                  ~~~~~~~~~~


     Contiene i diversi settaggi che potete modificare:


     1) Audio
     --------
     Per quanto riguarda l'audio potete scegliere tra:

     - Speaker sinistro: I samples verranno suonati attraverso lo  speaker
     sinistro della vostra Televisione o monitor.

     -  Speaker  Destro: I samples  verranno suonati attraverso lo speaker
     destro della vostra Televisione o monitor.

     - Generale: Utilizza tutti i canali audio.

     - Scegli:  Vi permette di scegliere  quale  canale  audio  utilizzare.
     Possibili  valori  vanno  da  1  a 4.  Tali settaggi non avranno alcun
     effetto sui moduli musicali!


     2) Icona
     --------

     Se viene selezionata questa funzione, assieme ai samples verrà salvata
     anche un'icona molto carina.


     3) Info 8SVX
     ------------

     Se  viene  attivata  tale  funzione,  ogni  qualvolta Sgrab troverà in
     memoria un sample in formato 8SVX controllerà se in esso vi é il chunk
     ANNO  (  utilizzato  dal'  ideatore  del  sample  per  memorizzare  un
     qualsiasi  messaggio  ),   in  caso  affermativo  ne  visualizzerà  il
     contenuto.


     4) Ctrl Modulo
     --------------

     Se  viene  attivata  tale funzione,  Sgrab controllerà che il file che
     state caricando sia effettivamente un modulo Pro/Noise/Soundtracker
     e non qualcos'altro che potrebbe mandare in crash il sistema.


     5) Ctrl Buffer
     --------------

     Attivando tale funzione, quando selezionerete la voce Salva Buffer dal
     `Menu Special' vi sarà chiesto per ogni sample  se  volete  salvarlo o
     meno.  Se  non  attivate  questa funzione,  quando salverete il Buffer
     TUTTI i samples verranno salvati.


     6) Errori
     ---------

     Tramite questo  menu  potrete  scegliere  in  quale  modo  vi  saranno
     segnalati gli errori. Potete scegliere tra:

     1) Default:  il classico Bell.

     2) P.  Sample:  vale a dire Preference Sample; tramite questa funzione
     potrete  selezionare  un  sample  a  vostro  piacimento,   che   verrà
     riprodotto qualora si verifichi un errore.

     3) Flash:  il classico flash dello schermo.


     7) Manuale/Auto
     ---------------

     Se attivate tale funzione,  quando salverete un sample vi sarà chiesto
     di indicarne il nome.  In caso contrario i  samples verranno  chiamati
     automaticamente Sample 0, Sample 1, Sample 2 ecc.


     8) Workbench
     ------------

     Tramite questa funzione potrete  chiudere  o  aprire  lo  schermo  del
     Workbench.  Utile se vorrete disporre di più memoria Chip. ( Chiudendo
     il Workbench guadagnerete 40K )


                             Funzioni da tastiera
                             ~~~~~~~~~~~~~~~~~~~~


     Esistono  alcune  funzioni  che  possono  essere attivate solamente da
     tastiera. Esse sono:

     1) Tasto Del: Attiva e disattiva il Led ( filtro audio ) di Amiga.

     2) Tasto  L:  Attiva  la  funzione  Loop-Sample  che  vi  permette  di
        ascoltare il  sample corrente in continuazione. Per interrompere il
        Loop sarà sufficiente premere il pulsante sinistro del mouse.

     3) Tasto C: trasferisce un sample da Fast a Chip.

     4) Barra: Ferma l'esecuzione del modulo che state ascoltando.

     5) Tasto G: sposta la locazione corrente da Chip a Fast e viceversa.

     6) Tasto D: cancella il file da voi indicato.

     7) Tasto T: visualizza il titolo del modulo corrente.

     8) Tasto S: visualizza la lunghezza del sample corrente.


                                   Displayer
                                   ~~~~~~~~~


     Rappresenta  il  punto  di  forza  del  programma  poiché  permette di
     visualizzare il contenuto della memoria sotto forma  di  onda  sonora,
     permettendovi di individuare con estrema precisione l'inizio o la fine
     del  sample  che  volete  salvare.   La  visualizzazione  parte  dalla
     locazione corrente ( estremità sinistra del grafico ) in avanti di 590
     bytes.  Con le frecce sulla tastiera potrete  muovervi  attraverso  la
     memoria alla ricerca del sample che vi interessa. Più precisamente:

     - Freccia destra:

     Farete avanzare il cursore che vi permette di posizionarvi esattamente
     nel punto desiderato.

     - Freccia sinistra:

     Farete  retrocedere  il  cursore  che  vi  permette  di   posizionarvi
     esattamente nel punto desiderato.

     - Freccia in alto:

     Avanzerete di 590 bytes rispetto alla locazione in cui vi trovate.
     Così facendo visualizzerete il seguito di ciò che era  precedentemente
     visualizzato.

     - Freccia in basso:

     Retrocederete  di 590 bytes rispetto alla locazione in cui vi trovate.
     Così facendo  visualizzerete  la  parte  precedente  di  ciò  che  era
     precedentemente visualizzato.

     Quando  avrete  individuato  il punto che vi interessa basterà premere
     l'icona Start o End a secondo che dobbiate memorizzare l'inizio  o  la
     fine  del  sample.  Per  velocizzare  gli spostamenti premete il tasto
     Shift. Quando avrete definito  un  sample  il  displayer  visualizzerà
     l'area interessata in BLU.


                                   Finestre
                                   ~~~~~~~~


     1) Location
     -----------

     Indica la locazione corrente.


     2) Length
     ---------

     Indica quanti bytes verranno suonati alla pressione dell'icona Po  con
     il pulsante destro del mouse. Cliccando al suo interno con il pulsante
     destro, il valore di Length sarà eguagliato alla lunghezza del sample
     corrente.


     3) Frequency
     ------------

     Indica la frequenza con cui verrà suonato il sample.


     4) Step
     -------

     Quando cliccherete su una delle icone poste al fianco di una finestra,
     per variare il valore in  esse  contenute,  tale  valore  aumenterà  o
     diminuirà di quanto indicato in Step.


     5) Start Track
     --------------

     Indica la traccia da cui inizierà la lettura del disco.


     6) End Track
     ------------

     Indica la traccia in cui terminerà la lettura del disco.


     7) Selected Sample
     ------------------

     Indica il numero del sample che avete selezionato dal buffer.


                                     Aiuti
                                     ~~~~~


                   Come trovare un sample non in formato IFF
                   -----------------------------------------

     1)  Premere  l'icona Pl ed ascoltare il contenuto della memoria finché
     non sentirete qualcosa di  interessante,  a  questo  punto  ricliccate
     tempestivamente  sull'icona Pl e vi troverete grosso modo nel punto in
     cui avete udito il sample.

     2) Cliccate con il pulsante destro l'icona Po, così sentirete in quale
     punto  del sample vi trovate.  Servendovi del displayer e delle frecce
     sulla tastiera andate alla ricerca dell'inizio ( o fine a secondo  del
     caso ) del  sample. ( Ogni tanto  cliccate l'icona Po  con il pulsante
     destro per rendervi conto in che punto del sample vi trovate )

     3) Una volta individuato l'inizio del sample cliccate  sull'icona  St,
     così facendo memorizzerete l'inizio del sample. A questo punto ( SENZA
     MUOVERVI dalla locazione iniziale del  sample  )  regolate  il  valore
     riportato  nella  finestra  "Length"  finché  sarà approssimativamente
     uguale alla lunghezza del sample che volete grabbare. Per sapere se il
     valore  di  length corrisponde alla lunghezza del sample basta premere
     l'icona Po ( con il pulsante destro ), e se sentirete TUTTO il sample,
     vorrà dire che avete pressappoco individuato la sua lunghezza.

     4) Dopo aver approssimativamente trovato la lunghezza del sample
     premere l'icona Pl CON IL PULSANTE DESTRO e vi sposterete rispetto
     alla locazione iniziale del sample di tanti bytes quanti da voi
     indicati in Length, quindi vi troverete più o meno alla fine del
     vostro sample. Ora seguendo la stessa procedura del punto 2 dovete
     trovare la locazione finale del sample.

     5) Trovata la locazione finale basterà premere l'icona En,  e a questo
     punto  il  sample è VOSTRO !!!.  Cliccate l'icona Po ( stavolta con il
     sinistro ) e sentirete ciò che avete catturato ( cioè i dati  compresi
     tra Start e End )


                      Come trovare un sample in formato IFF
                     -------------------------------------

     Niente di più facile, basterà servirsi delle funzioni messe a
     disposizione da Sgrab nel menu Special. Al resto pensa il computer.


                Come effettuare grandi spostamenti nella memoria
                ------------------------------------------------

     Per effettuare grandi spostamenti nella memoria non conviene
     utilizzare le  due  icone  a  fianco  della  finestra  "Location",  ma
     conviene  cliccare direttamente nella finestra e digitare la locazione
     che si vuole raggiungere.


                Come conservare il contenuto della memoria Chip
                -----------------------------------------------

     Per conservare al meglio il contenuto della vostra memoria Chip, e
     quindi i vostri samples, sarebbe un'ottima cosa se dopo aver resettato
     il computer disabilitiate TUTTI gli eventuali drives esterni. Così
     facendo risparmierete 30K per ogni drive. Per chi possiede il sistema
     2.0 o superiore l'operazione risulta molto facile, non dovrete far
     altro che tener premuti entrambi i pulsanti del mouse all'avviamento
     del computer, e sfruttare le funzioni del Boot Menu. Questa operazione
     oltre a farvi risparmiare preziosa memoria Chip, ne impedirà anche il
     refresh lasciandone inalterato il contenuto. Chi ancora possiede il
     sistema 1.3, dovrà procurarsi un'utility tipo SDbootinstall
     ( distribuita assieme al SuperDuper ) che installa nel Boot del disco
     un programma che automaticamente disabilità tutti i drives
     ad eccezzione di quello interno ( altrimenti dovrete disattivarli
     manualmente!! ).


                           Come variare i vari settaggi
                           ----------------------------

     Per modificare il valore contenuto in  una  qualsiasi  finestra  basta
     cliccare  al  suo interno e digitare il nuovo valore,  oppure servirsi
     delle icone poste al suo fianco.


                                      Bug
                                      ~~~


     Che io sappia non ce ne sono, unica cosa a cui dovrete fare attenzione
     è il File-Requester che dovrà essere usato con cautela.
     La routine per l'ascolto dei moduli, non supporta tutti gli effetti
     messi a disposizione dal protracker, ma io non posso far nulla...
     Il programma è stato testato con i sistemi 1.3  e  2.0  ed  ha  sempre
     funzionato egregiamente.


                                    History
                                    ~~~~~~~


     03-12-92  Sgrab 1.0
     -------------------
     Presenti alcuni Bug. Mai rilasciato nel Pubblico dominio


     19-02-93  Sgrab 1.2
     -------------------
     Corretti numerosi bug.
     Piena compatibilità con il sistema 2.04
     Possibilità di gestire file compressi con il PowerPacker.


     23-05-93  Sgrab 2.0
     -------------------
     Corretto bug nella ricerca dei IFF-samples.
     Aggiunto il Sample-Buffer e la relativa gestione.
     Possibilità di leggere i dischi.
     Incrementata del 10% la velocità del programma.
     Gestione moduli in formato Pro-Star-Noisetracker.
     Possibilità di salvare i samples in differenti formati.
     Prima versione immessa nel Pubblico Dominio !!


     08-06-93  Sgrab2.1
     ------------------
     Aggiunta routine per rippare moduli Star-Pro-Noisetracker.
     Aggiunta del menu Music
     Aggiornato-Velocizzato il Sample-Buffer con gestione  degli  strumenti
     musicali.
     Aggiunte funzioni di Play Buffer, e Salva Buffer ( Singolo-Libreria )


     02-07-93  Sgrab2.2
     ------------------
     Corretti  bug  nella  routine rippa moduli con aggiunta della funzione
     cancella modulo
     Aggiunta di 7 nuove funzioni:

     - Cut Sample
     - Paste Sample
     - Store Sample
     - Reverse Sample
     - Hunt Module ( icona )
     - Read Disk ( Automatico )
     - 8X ( icona )

     Aggiunta funzioni per il ricupero della memoria Chip utilizzata
     Velocizzato l'output del Displayer del 5%


     03-08-93  Sgrab2.3
     ------------------
     Sostituito  il  vecchio  Displayer con uno più grande,  che visualizza
     l'onda sonora in formato standard e  non  più  a  istogrammi  come  il
     precedente
     Sostituito lo slider orizzontale per lo spostamento in memoria con  un
     cursore più preciso ed intuitivo
     Aggiunto il menu Prefs
     Aggiunta funzione di Zoom
     Aggiunta funzione Cerca Zero
     Tutte  le  funzioni  di  Input/Output  su  disco sono ora svolte dalle
     librerie interne  Amiga  con  conseguente  incremento  di  velocità  e
     flessibilità
     Aggiunta del Double-Buffering per l'ascolto della memoria Fast


     26-09-93  Sgrab2.4
     ------------------
     Corretti alcuni Bug
     Ora Sgrab è in grado di dearchiviare file LHA o LZH
     Aggiunta della Sgrab Hunt Window!!
     Agginuta funzione delete file
     Aggiunta funzione per spostarsi velocemente da Chip a Fast e viceversa
     Aggiunta funzione per sapere la lunghezza del sample corrente
     Corretto bug nel Displayer ( presente solo nella versione 2.3 )
     ORA SGRAB E' COMPLETAMENTE DI PUBBLICO DOMINIO


                                 Per il futuro
                                 ~~~~~~~~~~~~~


     Ecco quali sono i progetti per il futuro di Sgrab:

     - Velocizzare il programma.

     - Aggiunta di nuove funzioni.

     - Aggiunta porta Arexx.

     - ...aspetto vostri suggerimenti!



                                 Suggerimenti
                                 ~~~~~~~~~~~~


     Ogni vostro suggerimento sarà il ben venuto, quindi non esitate a
     contattarmi per nessun motivo !! ( .... anche le critiche sono ben
     accette ). Il mio indirizzo è:



                                Ghizzoni Pietro
                                Via Termine 70/B
                     29017 Fiorenzuola D'Arda  - Piacenza -
                                     Italy



     Se avete un Modem potete contattarmi a uno dei  seguenti indirizzi:


     Fidonet:

     - 2:331/106.0

     - 2:331/117.0

     - 2:331/121.0


     Internet:

     Pietro_Ghizzoni@skylink.sublink.org


     Se non avete accesso a queste aree, lasciatemi un messaggio su una di
     queste BBS:

     IXTLAN    Tel. 02/27401029
     SKYLINK   Tel. 0332/706469
     ULTIMO IMERO  Tel. 02/55303002

     ... oppure nelle aree Echomail.


                                Ringraziamenti
                                ~~~~~~~~~~~~~~


     Speciali ringraziamenti vanno:

     - a Domenico Pavone e alla sua IXTLAN BBS

     - a mio fratello

     - a François Lionet e alla sua genialità ( AMOS is the best! )

     - a Manuel Andre e alla sua estensione Lturbo

     - a Stephan Sürken e al suo programma Text2Guide

     - alla redazione di TGM

     - a mia madre e al suo portafoglio!!


                         Divertitevi con Sgrab !!!!!!!!

