home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 389.lha / View80_v1.1 / Istruzioni.ita < prev    next >
Text File  |  1990-07-02  |  14KB  |  312 lines
  1.  
  2.  
  3.  
  4.                                      View80
  5.                                    ----------
  6.  
  7.                                       v1.1
  8.  
  9.  
  10.                               by Federico Giannici
  11.  
  12.  
  13.  
  14.  
  15.  
  16. View80 e` un programma veloce e comodo per la lettura di files ASCII.
  17. Permette  la visualizzazione di  testi ad 80  colonne e contemporaneamente l'uso
  18. della scroll-bar.
  19.  
  20. View80  e`  interamente  scritto  in  linguaggio  C, ad eccezione di una piccola
  21. routine  per la scrittura su  video, che a partire  dalla versione 1.1, e` stata
  22. riscritta in assembler per aumentarne al massimo la velocita`. Cio` ha  permesso
  23. di  ottenere  3  differenti  velocita`  di scroll: SMOOTH-Scroll con apparizione
  24. graduale delle linee,  FAST-Scroll veloce ma  fluido, ed infine  il TURBO-Scroll
  25. che  permette  di  raggiungere  la  massima  velocita`  possibile,  ottenuta non
  26. aggiornando  la  scroll-bar  che  viene  riposizionata  solo  nel momento in cui
  27. vengono rilasciati i tasti.
  28.  
  29. View80  da il meglio di  se` se vi e`  della FAST-RAM a disposizione. Infatti si
  30. tratta  di  un  programma  multiprocessore  (su  Amiga  un po` tutti lo sono) in
  31. quanto,  mentre il Blitter esegue lo scroll del video, CONTEMPORANEAMENTE la CPU
  32. (680x0) provvede alla  scrittura della prossima  linea in un  buffer temporaneo.
  33. Quindi,  se View80 e` costretto a lavorare in CHIP-RAM, si avranno dei conflitti
  34. tra  la  CPU  ed  il  Blitter  per  l'accesso  alla  memoria.  Cio`  porta ad un
  35. rallentamento  del Fast e Turbo scroll, in corrispondenza di linee molto lunghe.
  36. Nessun problema per lo Smooth-Scroll.
  37.  
  38. Altra caratteristica fondamentale di View80, a partire dalla versione 1.1, e` la
  39. possibilita`  di  caricare  in  memoria  fino  a  tre  files contemporaneamente,
  40. passando da un file all'altro con la semplice pressione di un tasto.
  41.  
  42. Il  programma e` di  Pubblico Dominio, puo`  quindi essere copiato liberamente e
  43. non  si  e`  obbligati  a  pagarmi  alcunche`  per  il  suo  utilizzo (eventuali
  44. contributi  saranno comunque ben accetti). Non e` pero` ammessa alcuna modifica,
  45. vendita od inserimento in programmi commerciali, senza il mio permesso  scritto.
  46. Infine  non  mi  assumo  alcuna  responsabilita`  per eventuali danni provocati,
  47. direttamente o indirettamente, da View80.
  48.  
  49. Finite le formalita`, passiamo alla descrizione del programma.
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                                   CARICAMENTO
  56.                                  -------------
  57.  
  58.  
  59. Il programma puo` partire sia da CLI che da Workbench.
  60.  
  61. L'eventuale caricamento automatico di uno o piu` files avviene nel solito modo:
  62.  
  63. Da  CLI,  al  nome  del  programma  si  possono  far seguire i nomi dei files da
  64. caricare.  Da notare  che e`  possibile riutilizzare  immediatamente il  CLI per
  65. eseguire altri programmi, come se si fosse utilizzato il comando Run.
  66.  
  67. Da Workbench si puo` utilizzare la tecnica della selezione multipla con il tasto
  68. SHIFT, oppure si puo` inserire il nome del programma (View80) nel "Default Tool"
  69. del file  da caricare  (clickare sull'icona  del testo  da leggere e selezionare
  70. "Info" nel primo menu (se continua cosi` scrivo tutto il manuale dell'Amiga!)).
  71.  
  72. In  entrambi  i  casi  se  non  viene  fornito nessun file da caricare apparira`
  73. immediatamente  il  File-Requester  (File-Finder  by  FG,  naturalmente), di cui
  74. parlero` piu` diffusamente in seguito.
  75.  
  76. Al  momento del  caricamento il  programma si  accorgera` automaticamente  se si
  77. trova su di un  Amiga PAL o NTSC,  adeguando di conseguenza la  dimensione dello
  78. schermo.  In realta` non ho potuto provare il programma su una macchina NTSC, ma
  79. dai test che ho potuto effettuare, sembra che non vi siano problemi.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.                                    MOVIMENTO
  86.                                   -----------
  87.  
  88.  
  89. Il movimento su` e giu` per il file puo` avvenire sia con la tastiera che con il
  90. mouse.
  91.  
  92.  
  93. MOVIMENTO CON TASTIERA
  94. Con i  tasti freccia  in alto  ed in  basso ci  si muove  di una  linea in  modo
  95. Smooth-Scroll.  In unione allo SHIFT si ottiene  il Fast-Scroll ed infine con il
  96. tasto ALT si ottiene il Turbo-Scroll.
  97. Con le frecce a destra e a sinistra ci si muove di una pagina (meno un rigo, per
  98. non  perdere  il  filo  del  discorso).  Se  premute con lo SHIFT lo spostamento
  99. avverra`  con il Fast-Scroll. In unione al  tasto ALT ci si spostera` all'inizio
  100. ed alla fine del file.
  101. Con il tasto di SPAZIO si  attivera` e disattivera` lo scroll automatico.  Anche
  102. in questo caso si potranno usare lo SHIFT e l'ALT.
  103. Con i tasti F4 ed F5 si saltera` alle posizioni precentemente memorizzate con la
  104. pressione  dello SHIFT piu` F4 od F5. Appena caricato un file, F4 ed F5 verranno
  105. inizializzati rispettivamente alla  prima ed ultima  linea del file,  diventando
  106. un'utile scorciatoia ai tasti ALT-freccia a sinistra o a destra.
  107.  
  108.  
  109. MOVIMENTO CON MOUSE
  110. Tramite il mouse ci si puo` muovere utilizzando la scroll bar, i gadgets freccia
  111. ai  lati della  scroll bar  (con un  doppio click  si attiva il Fast-Scroll), ed
  112. infine, clickando direttamente sulla parte superiore od inferiore dello  schermo
  113. (vicino ai bordi si ottiene il Fast-Scroll).
  114. Il   Turbo-Scroll  non  e`  attivabile  tramite  mouse,  in  quanto  per  grandi
  115. spostamenti risulta piu conveniente utilizzare la scroll-bar.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.                                      I MENU
  122.                                     --------
  123.  
  124.  
  125. LOAD FILE
  126. (Attivabile anche tramite F9)
  127. Questa opzione permette di caricare in memoria un nuovo file (chi lo avrebbe mai
  128. detto!?!),  cancellando  il  precedente.  Per  caricare  un  nuovo  file   senza
  129. cancellare  quello attuale ci si  deve spostare ad un  nuovo File#, tramite menu
  130. (vedi piu`  avanti) o  piu` semplicemente  con i  tasti funzione  da F1 ad F3, e
  131. quindi scegliere LOAD FILE.
  132. Apparira`  la finestra del File-Finder (e` un file requester realizzato da me un
  133. po' di tempo fa) ed cominceranno  ad apparire i files della directory  corrente.
  134. Il  suo funzionamento  e` simile  a quello  di molti altri file-requester quindi
  135. parlero` solo di alcune sue particolarita`.
  136. Il gadget "Suffix"  permette di far  apparire solo i  files terminanti con  tale
  137. suffisso (evidentemente se nullo appariranno tutti i files).
  138. Se  si lascia completare la lettura della  directory, la volta successiva che si
  139. richiama il File-Finder la lista apparira` istantaneamente.
  140. Durante  la  lettura  della  directory,  poiche`  i  files  tendono  a  cambiare
  141. continuamente  posizione, e` difficile centrare con il mouse il file desiderato.
  142. Ho pensato, quindi, di  far terminare la lettura  della directory non appena  si
  143. clicka  su di un file, cosi` che  si possa procedere con piu` tranquillita` alla
  144. selezione del file desiderato.
  145.  
  146.  
  147. QUIT
  148. (Accessibile anche tramite F10)
  149. Abbandona il programma cancellando tutti i files attualmente in memoria.
  150. Apparira` un requester che vi  chiedera` di confermare le vostre  intenzioni. Si
  151. potra`  rispondere  positivamente  premendo  un  tasto qualunque (tranne i tasti
  152. funzione e le frecce).
  153.  
  154.  
  155. SEARCH STRING
  156. Questa opzione permette di ricercare una stringa nel file, senza far  differenze
  157. fra  maiuscole e minuscole.  La ricerca avviene  dalla seconda riga visualizzata
  158. sullo schermo in poi (piu` avanti vedremo perche`).
  159. Se la ricerca  ha esito positivo  viene mostrata in  reverse la linea  in cui e`
  160. stata trovata la stringa.
  161.  
  162.  
  163. SEARCH NEXT
  164. (Attivabile anche tramite F8)
  165. Come "SEARCH STRING" ma non richiede che venga reinserita la stringa.
  166. Poiche`,  generalmente, l'ultima linea trovata appare in cima allo schermo, e la
  167. ricerca parte dalla seconda  linea, cio` che si  ottiene e` il classico  "Search
  168. Next" (Come Volevasi Dimostrare).
  169.  
  170.  
  171. PRINT RANGE
  172. Permette la stampa di un range di linee.
  173. Vi  verra` chiesto da quale  linea a quale linea  stampare. Tali valori potranno
  174. essere  scelti  precedentemente  posizionandosi  sulla  prima ed ultima linea da
  175. stampare  e  premendo  rispettivamente  F6  ed  F7  (la  linea  lampeggera`  per
  176. conferma). Di default verranno stampate tutte le linee del file.
  177. Normalmente  la  stampa  viene  mandata  al  device  PRT:  (la  stampante) ma e`
  178. possibile,  tramite  il  gadget  "Send  to"  dirottare  la  stampa su di un file
  179. qualunque. Se il file e` gia` esistente la stampa verra` aggiunta alla fine  del
  180. file stesso. Risulta, quindi, possibile fare un collage di piu` parti di diversi
  181. files.  Si consiglia,  per motivi  di velocita`  di eseguire  tali operazioni in
  182. RAM:.
  183. La stampa puo` essere interrotta in qualsiasi momento con il gadget CANCEL.
  184. View80  riprodurra`  il  piu`  fedelmente  possibile  cio`  che appare sul video
  185. stampando  ad  80  colonne  (indipendentemente  dai  settaggi  di  Preferences),
  186. espandendo appropriatamente i Tab e  sostituendo i caratteri non stampabili  con
  187. delle "X".
  188.  
  189.  
  190. PRINT LINE
  191. Effettua la stampa della prima linea che appare sullo schermo e muove lo schermo
  192. in basso di una linea.
  193. Cio`  permette di stampare molto facilmente un piccolo numero di linee contigue,
  194. senza bisogno di andare a vedere  il numero della prima e dell'ultima  linea che
  195. si desidera stampare.
  196. Tutto  cio` si paga con una maggiore lentezza, in quanto, per ogni linea, View80
  197. deve aprire e  poi richiudere il  device "PRT:" (od  altro, vedi sopra),  e cio`
  198. richiede un po' di tempo.
  199.  
  200.  
  201. USE MY COLORS
  202. Appena caricato il programma utilizza i colori del Workbench.
  203. Se  tali colori risultassero poco leggibili,  o semplicemente non vi piacessero,
  204. con  questa  opzione  il  programma  utilizzera`  un  proprio set predefinito di
  205. colori, che penso siano abbastanza leggibili (sono simili a quelli di default di
  206. Preferences).
  207.  
  208.  
  209. JUMP TO
  210. Apparira`  un  requester  in  cui  dovrete  immettere  il  numero di linea a cui
  211. saltare. Se la linea non e` accessibile come prima linea dello schermo, la  vera
  212. linea  che avete scelto  apparira` in reverse  (provate a saltare  ad un paio di
  213. linee dalla fine del file).
  214.  
  215.  
  216. CLEAR FILE
  217. Cancella  dalla  memoria  il  file  corrispondente  al  File# attuale. Gli altri
  218. eventuali files in memoria non verranno toccati.
  219.  
  220.  
  221. ABOUT KEYS
  222. (Attivabile anche tramite il tasto HELP)
  223. Scegliendo questa opzione viene mostrato un requester con un riassunto dei tasti
  224. (e  relative funzioni) utilizzati dal programma. Viene inoltre mostrato in basso
  225. a sinistra l'ammontare di memoria libera.
  226. Premendo un tasto qualsiasi si elimina tale requester.
  227.  
  228.  
  229. FILE# (1, 2, 3)
  230. (Attivabili anche con i tasti F1, F2 ed F3)
  231. Tale comando permette di passare da un file all'altro in memoria.
  232. Da notare  che ogni  qualvolta si  torna ad  un File#  ci si ritrova ESATTAMENTE
  233. nelle  stessa situazione del  momento in cui  si era abbandonato  tale File#. In
  234. particolare  vengono  memorizzati:  la  posizione  attuale,  i mark (F4, F5), le
  235. posizioni di stampa (F6, F7), Word-Wrap e Tab.
  236.  
  237.  
  238. WORD-WRAP (OFF, ON)
  239. Se  attivato, View80 non spezzera`  le parole a fine  riga, riportando la parola
  240. nella riga successiva.
  241.  
  242.  
  243. TAB (OFF, 1, 2, 4, 8)
  244. Con questa opzione si seleziona il modo in cui verranno visualizzati i TAB.
  245. Scegliendo "OFF",  i TAB  vengono trattati  come tutti  gli altri  caratteri non
  246. visualizzabili  (cioe`  apparira`  un  unico  carattere  con  due  cifre "09" in
  247. verticale) (vedi MISCELLANEA).
  248. Scegliendo  1,  2,  4,  o  8,  verranno visualizzati degli spazi per incolonnare
  249. adeguatamente il file.
  250.  
  251. NOTA: Ogni volta che si sceglie quest'ultima opzione o la precedente (Word-Wrap)
  252. bisognera`  attendere  un  attimo  che  il  programma  riformatti tutto il file.
  253. Inoltre, i  valori associati  ai tasti  F4, F5,  F6 ed  F7 verranno riportati ai
  254. rispettivi valori di default (prima ed ultima linea del file).
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                                   MISCELLANEA
  261.                                  -------------
  262.  
  263.  
  264. Se  lo  scroll  viene  ottenuto  con  la  tastiera, il puntatore del mouse viene
  265. temporaneamente reso invisibile. Esso riapparira` al primo movimento del mouse.
  266.  
  267. Nella drag bar dello schermo viene mostrato: il nome del programma (View80),  il
  268. numero  di versione, il numero del File#, il nome del file attualmente mostrato,
  269. la dimensione ed il  numero di linee del  file, ed infine il  numero della linea
  270. attuale,  ovvero della  prima linea  visualizzata sul  video (tale  numero viene
  271. aggiornato solo rilasciando il tasto od il mouse).
  272.  
  273. Il programma utilizza un set di caratteri interno che mostra i caratteri da 00 a
  274. 1F  e  da  80  a  9F  (normalmente  non  visualizzabili)  con un unico carattere
  275. rappresentante,  con due  cifre verticali,  il valore  esadecimale del carattere
  276. stesso  (sembra  complicato  ma  non  lo  e`,  caricate  un  file non di testo e
  277. vedrete).
  278. In fase di stampa verra` utilizzata una "X".
  279.  
  280. Talvolta  potra` apparire,  in alto  a sinistra  dello schermo, un requester con
  281. qualche messaggio  di avvertimento,  a cui  si potra`  rispondere clickando  sul
  282. gadget "Continue" o premendo un tasto qualunque.
  283.  
  284. Se  il programma  incontra nel  file una  coppia di  caratteri CR e LF (Carriage
  285. Return e Line Feed), si comportera` come se vi fosse solo il LF.
  286.  
  287.  
  288.  
  289.  
  290.  
  291.                                  PER CONCLUDERE
  292.                                 ----------------
  293.  
  294.  
  295. Per qualsiasi consiglio, critica,  bug, contributo, e soprattutto  elogi, potete
  296. contattarmi  all'indirizzo che appare nel  menu del programma (e  che per i piu`
  297. pigri riporto alla fine di queste note) oppure sulla BBS MC-Link (06-4180440, il
  298. mio codice e` MC4080).
  299.  
  300. Io mi sono divertito molto a  scrivere questo programma, ed il risultato  finale
  301. e` stato anche superiore alle mie aspettative. Spero che piaccia anche a voi.
  302.  
  303.  
  304.  
  305.  
  306.                                                        Federico Giannici
  307.  
  308.                                                        Viale Francia 4
  309.                                                        90146 Palermo
  310.                                                        Italy
  311.  
  312.