home *** CD-ROM | disk | FTP | other *** search
/ PSION CD 2 / PsionCDVol2.iso / Programs / 267 / QV5.TXT < prev    next >
Encoding:
Text File  |  1998-08-23  |  8.6 KB  |  215 lines
  1. QuickView 5 for Psion Series 5 and Geofox One.     Version 1.06
  2.  
  3. QV5 is a simple program which I wrote in order to explore various systems
  4. for my 3T file manager application. The general idea was to minimise messing
  5. about with windows, which can be a slow process in OPL32.
  6.  
  7. QV5 became quite a useful tool in its own right, especially after an OPL
  8. session which generally leaves me with loads of bits of trial code that are
  9. no longer required. With QV5 I can trawl through my project folders and
  10. view and delete files as required.
  11.  
  12. There are two windows. On the left is the file window, where you can move
  13. through the various folders in memory, the ROM, and CF disks. On the right
  14. is the viewer window, where the contents of files may be examined.
  15.  
  16. The file window uses the following keys:
  17.  
  18.     Up and Down Arrows move through the files in the current folder.
  19.     (Folders are shown with the trailing backslash "\", except when the name
  20.     is too long.)
  21.  
  22.     Page Up and Down also have the usual functions on the file list.
  23.  
  24.     Esc moves back to the previous folder. If you are in the root folder, you
  25.     will see the "Change Disk" dialog. Here you may press a letter key or Esc. 
  26.  
  27.     Enter has several functions. If a folder is highlighted, QV5 moves to that
  28.     folder. If <==Parent==> is highlighted, QV5 moves back to the previous
  29.     folder. If a file is highlighted, the file is displayed.
  30.  
  31.     Any letter or number key moves the highlight to the next file or folder
  32.     beginning with that letter or number. At present this operates only on the
  33.     current page.
  34.  
  35.     Del will delete the highlighted file or folder (and contents).
  36.  
  37. The viewer window uses just two keys:
  38.  
  39.     Right Arrow moves to the next page (or bitmap),
  40.     Left Arrow moves back a page (or bitmap).
  41.  
  42. In addition, there are several keys which operate whether or not a file is
  43. being viewed:
  44.  
  45.     Ctrl-E is the exit or quit key.
  46.     Ctrl-K allows setup of QV5 properties.
  47.     Ctrl-A selects the Ascii viewer.
  48.     Ctrl-B selects the binary (hexadecimal) viewer.
  49.     Ctrl-T selects the text viewer.
  50.     Ctrl-O selects the OPL32 viewer.
  51.     Ctrl-V displays the current bitmap (.MBM) file.
  52.     Ctrl-Q toggles the view mode.
  53.     Ctrl-I toggles 'Intelligent' mode.
  54.     Ctrl-Shift-A shows the "About" details.
  55.     Ctrl-Shift-H shows the help screen.
  56.  
  57. View modes.
  58.  
  59. There are two view modes. The default is "Autoview Off", where you have to
  60. press Enter (or Right Arrow) to view a file. This allows you to quickly move
  61. through the file list. The alternative, "Autoview On" views each file as it
  62. is highlighted, without having to press Enter.
  63.  
  64. The viewers.
  65.  
  66. Ascii view shows all the printing characters on the screen. Those which do
  67. not print have been replaced with a dot. You can move forwards and backwards
  68. through the file with the Right and Left Arrow keys. All files, including
  69. binary files, may be viewed this way.
  70.  
  71. Binary (Hex) view works like the latter view, except that the file offset,
  72. byte value (both hexadecimal), and the corresponding Ascii character are
  73. shown. You can move up and down the file as with Ascii view.
  74.  
  75. Text view offers a clipped view of text files. Here the layout is preserved,
  76. but the lines are clipped after about 60 characters. Also you cannot move
  77. backwards through a file, if you press Left Arrow you are moved back to the
  78. start of the file.
  79.  
  80. OPL view enables an OPL32 source file to be displayed, with the header and
  81. footer removed, and the end-of-lines insered, i.e. just as in the OPL 
  82. editor. You can move up and down the file with the Right and Left Arrow 
  83. keys, but the latter works only up to page 500 (If this causes problems,
  84. let me know, I can change this if required).
  85. This viewer will work only on valid OPL source and header files.
  86.  
  87. There is also an independant bitmap viewer. Just press Ctrl-V when an .MBM
  88. file is highlighted. Only files containing the correct UIDs will be displayed.
  89. Note that files will be displayed in 4 colour mode only. Left and right
  90. arrow keys move between the images in a multi-bitmap file. If you move to
  91. an invalid bitmap in an MBM file, the bitmap display is closed.
  92. This viewer will only work on valid EPOC32 bitmaps.
  93.  
  94. You may change viewers at any time. If a file is being viewed, it will be
  95. closed first. If autoview is on, the file will then open in the new viewer.
  96. With autoview off, the file will open when you press Enter.
  97. You can move between files and folders even if a file is being displayed.
  98.  
  99. Intelligent mode.
  100.  
  101. Pressing Ctrl-I toggles Intelligent mode. This mode will set display mode
  102. to OPL when viewing OPL32 files, bitmap for bitmap files, text mode
  103. for text files, and Ascii mode for other files.
  104.  
  105. Since text files have no UID, QV5 makes a guess here, and some other non-
  106. UID coded files will also display in text mode.
  107.  
  108. Properties.
  109.  
  110. Press Ctrl-K and a small dialog will appear. This allows you to change
  111. the viewer type, intelligent mode, and view mode. 
  112.  
  113. Menu.
  114.  
  115. QV5 now has a menu.
  116.  
  117. Installation.
  118.  
  119. This version of QV5 is supplied as a SIS file. If you are using a version
  120. prior to 1.05, please delete c:\system\apps\qv5\qv5.ini before proceeding.
  121.  
  122. Installation of a SIS file is very simple. If you are using PsiWin 2.1 or
  123. later, simply couple up your Series 5 to your PC, and double click QV5.SIS
  124. in Windows Explorer. If you do not have SystInfo.opx installed to your 
  125. Psion, you must add this in the same way. If you are not sure about this,
  126. it is quite safe to install both QV5.SIS and SystInfo.SIS.
  127.  
  128. If you have PsiWin 2.0, the install application can be installed to your 
  129. PC easily, I can supply the setup file if required. If you do not use
  130. PsiWin, e.g. you have a Mac, Amiga, etc., or a DOS PC, you can copy the 
  131. SIS files to your Series 5 (I recommend you create a c:\Install folder)
  132. and install them using the Add/Remove item in the Psion Control Panel.
  133. If you don't have this item, it can easily be added, a program to do 
  134. this is freely available. I can supply this if required.
  135.  
  136. PsiWin 2.1 is freely available from Psion's web site (about a 16 meg
  137. download), and can also be found on the 3lib and Palmtop magazine CD.
  138. The files to set up Psion Install and the Add/Remove Control Panel
  139. item are also freely available on the web. Try http://www.rmrsoft.com 
  140. or http://3lib.ukonlike.co.uk
  141.  
  142. Limitations.
  143.  
  144. QV5 can cope with folders containing up to 400 files only.
  145. The maximum file name length is 100 characters, not including the path
  146. name, which can be up to 255 characters. This should not cause problems
  147. if QV5 encounters a longer filename, however.
  148.  
  149. Starting from a command line.
  150.  
  151. QV5 may be launced from another application, and will accept a command
  152. line containing the name of the folder you wish to initially display.
  153. This folder name must be terminated with a backslash, e.g. C:\Documents\
  154.  
  155. Copyright.
  156.  
  157. QV5 is copyright Roger Muggleton 1997-1998, and is released as freeware.
  158. Sysram1.opx is Copyright Otfried Cheong/RMR Software.
  159.  
  160. Bug reports, etc.
  161.  
  162. QV5 is released as freeware. I disclaim all responsibility for any ill
  163. effects on your Psion Series 5 or Geofox. There are bound to be bugs in my 
  164. code, hopefully these are unlikely to have any serious effects on your files.
  165. Remember to back up your Psion frequently, as it is easy to delete a wanted
  166. file inadvertantly, even from the system screen.
  167.  
  168.  
  169. Changes since version 1.00
  170.  
  171. Multi-image bitmap support added.
  172. OPL file viewer.
  173. Current folder displayed.
  174. File size display on Ascii, binary, and OPL viewers.
  175. Deletes folders.
  176. Saves settings to an ini file.
  177.  
  178. Changes since version 1.01
  179.  
  180. Intelligent mode added.
  181. Bitmap viewer action changed.
  182. Settings saved only when changed.
  183.  
  184. Changes since version 1.02
  185.  
  186. Geofox One supported.
  187. Viewers modified for Geofox 640*320 screen.
  188. Sort now case-insensitive.
  189. Can be driven to a named folder by command line.
  190.  
  191. Changes since version 1.03
  192.  
  193. QV5 should no longer be upset if you send it to the background, and delete
  194. the folder QV5 was displaying! It should refresh to the next layer down.
  195. QV5 now uses Sysinfo1.opx for file/folder checking. My thanks to 
  196. Otfried Cheong for writing this useful OPX. 
  197. I have added a menu.
  198.  
  199. Changes since version 1.04
  200.  
  201. The menu has been reorganised, and some shortcuts changed to Psion standards.
  202. The menu can now be activated with the pen.
  203. QV5 now uses less memory when running in the background.
  204.  
  205. Changes since version 1.05
  206.  
  207. SystInfo.opx is now used instead of Sysinfo1.opx. You may delete the latter
  208. only if you are sure no other application uses it. If you are not sure, 
  209. you could rename sysinfo1.opx, then try all your applications. None of the
  210. built-in applications use this file.
  211.  
  212. Roger Muggleton, hzk@cix.co.uk
  213. 23rd August, 1998
  214.  
  215.