home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / t / typeinfo / Documents / HowToUse < prev    next >
Encoding:
Text File  |  1996-08-06  |  14.0 KB  |  271 lines

  1. b1. Hexadecimal filetypes
  2. _________________________
  3.  
  4. Hexadecimal is merely another way of counting. In hexadecimal instead of
  5. counting to the tenth number before adding an extra digit, you go to the sixteenth. The name comes from the latin 'hex' meaning 6 and 'deca' meaning 10 (10+6=16!). As we only have 10 digits ie. 0,1,2,3,4,5,6,7,8,9 to go upto 16 in one digit, we use uppercase (capital) letters for the extra digits. Hexadecimal numbers are often marked by an ampersand (&) to show that they are not a letter but a number. 
  6.  
  7. We can count up but when we get to 10 instead of adding a 1 and going
  8. back to zero we keep going with letters:
  9.  
  10. 1  2  3  4  5  6  7  8  9  A  B  C  D  E  F  10  11  12  13  14  15  16  17
  11. 18  19  1A  1B  1C  1D  1E  1F  20 and so on.
  12.  
  13. Inside the computer, it uses hexadecimal rather than decimal for many
  14. activities. One of these activities is the storage of filetypes as a
  15. hexadecimal number. When I refer to filetypes in the rest of this manual, I
  16. will be referring to this number which denotes the type which the file is.
  17.  
  18. To make things easier on the user, Acorn included a labelling feature for
  19. these filetypes so that we can set them or read them as text. For example if
  20. you click the menu button over the 'manual' file, follow the entry
  21.  
  22.  File 'Manual' >  
  23.  
  24. across to the right, and go down to the 'Info' option, and again move to the 
  25. right, a window will open. In the 2nd line down it should read;
  26.  
  27.  Type: Text   (fff)
  28.  
  29. The word 'Text' is an example of such a label and the letters 'fff' are the
  30. hexadecimal number for 4095. 
  31.  
  32. Every filetype hexadecimal number has only 3 digits the largest being fff,
  33. this means that there are 4096 (remembering &000) possible filetypes.
  34.  
  35. In the computers memory, each of these numbers can be represented by a string of text a maximum of 8 characters long eg. &FFB = 'BASIC' and &AFF = 'DrawFile', in most parts of typeinfo, the types are referred to as hexadecimal numbers, but in a couple of places strings can be used. Read the rest of this manual to find out about these locations (especially b10).
  36.  
  37. To confuse matters even more, some files don't have a filetype and are merely intended to be loaded into an address in the computers memory. These files if loaded into typeinfo will cause a message box to open, nicely informing you that the file has no type at the moment. 
  38.  
  39. b2. Multiple uses
  40. _________________
  41.  
  42. In Filetypes by Mark Thompson on which this is loosely based, when a
  43. filetype was used by more than one program, there was still only 4 lines of
  44. information allowed. When analysing what improvements I could make, I
  45. decided to provide a facility for such filetypes. Now, in the information
  46. window there is an icon that says something like "Use 1:2" this means that
  47. the currently displayed information is for the 1st out of 2 known uses. To
  48. see the other uses simply click on the right or left arrows to go forwards or
  49. backwards, respectively. Note that their is currently a restriction of 10
  50. maximum usages so that memory is not overused by typeinfo. Also
  51. remember, there is only one filesprite per type and it doesn't change with
  52. the usage, perhaps in the future...
  53.  
  54.  
  55. b3. The Iconbar icon
  56. ____________________
  57.  
  58. If you click on this icon with the select mouse button, the information
  59. window will be brought up and it will contain the information about the
  60. last loaded filetype (the starting type is &FFF). If you click on this icon with the adjust mouse button, the editing window will be brought up and it will contain the last edited records data.
  61.  
  62. b4. The Information window
  63. __________________________
  64.  
  65. There are several icons to the information window and at first glance, they
  66. can make it appear cluttered. To start with the main purpose of the window
  67. is to display information about the selected filetype. This filetype can be
  68. selected in many different ways as outlined in the 'Loading Files' section
  69. of this document.
  70.  
  71. Icon Uses
  72. ~~~~~~~~~
  73. The icon at the very top-left of the window displays the filename of the
  74. loaded file. Or at least if the filename is too long to fit in the icon, the last 52 characters of the filename. If you do not load a file and merely 
  75. search for data about the file instead of a useless out of date filename,
  76. it displays the message 'Data search complete' to show that the search 
  77. has finished. If when you open the information window by clicking on the 
  78. icon bar before you have ever loaded a file or done a search the icon 
  79. will contain the message, 'Demonstration of operation', to show that no 
  80. search was done nor file loaded.
  81.  
  82. The next icon down displays a valuable bit of information. This icon
  83. displays the filetype hexadecimal number as well as the File$Type name.
  84. If the name is not available (has not been specified by any program) then
  85. the window simply displays the message 'Unknown to the 
  86. computer' and then a dash and the hex no.
  87.  
  88. The arrows on either side of this box pointing left and right allow you to
  89. easily display the filetype directly before or after the current one, by
  90. clicking on the left or right arrows respectively. Or you can simply hold
  91. down Ctrl and press either the left or right cursor arrows.
  92.  
  93. To the right of these two icon is a square icon. This will display the
  94. filesprite if it has been already loaded into memory or if it is in the records.
  95. If it is in memory but NOT in the records then it will still be displayed. If
  96. however no spritefile can be found then the box will simply be left blank.
  97.  
  98. The next icon down is used to display the type of program that should be
  99. using that filetype according to the Acorn allocation rules. This is useful
  100. for if you are trying to decide on a filetype for a new application, you can
  101. quickly and easily see whether your application's filetype is in the right
  102. section.
  103.  
  104. Below this there are four borderless icons within one large one. These 4
  105. icons hold the information that is loaded from the text record files. This
  106. data can be edited in the edit window if you feel you can add something to
  107. the comprehensive information already in place. This is probably the most
  108. valuable part of the entire window as it 
  109. tells you what the file is what application can load/save it and where you
  110. can get a copy of the application from.
  111.  
  112. Further down in the bottom left is an icon which will contain a message of
  113. the form 'Use x:x'. This is in place for files which are used used by 2 or
  114. more different applications. These uses of the same filetype I have dubbed
  115. usage. The number to the left of the colon is the number of the usage
  116. currently on display in the information icons. The number to the right of
  117. the colon is the number of usages for this filetype. To the left of this icon
  118. is two arrows pointing left and right, to see the next usage click on the
  119. right one, to see the last usage click on the left one. If the currently
  120. displayed usage is the first and you click to go back, there is no effect and
  121. vice versa. If you click the adjust mouse button over either of these arrows,
  122. then it does the action of the other arrow.
  123.  
  124. To the far bottom-right is the 'Edit' icon. When you click on this icon, the
  125. record for that filetype is loaded into the editor and the information
  126. window is closed while the edit window opens. You are now free to do
  127. any editing you want on that filetype, to the data stored in the records. Or
  128. alternatively you can simply press Ctrl-E.
  129.  
  130. Miscellaneous...
  131. ~~~~~~~~~~~~~~~~
  132. The info window can be opened in 6 different ways:
  133.  
  134.   • If the autoload option is turned on and you double-click
  135.     on a file without a run type the window will open.
  136.   • If you click with select on the iconbar icon, the window
  137.     will open displaying the information about the last loaded
  138.     filetype.
  139.   • If a file is dragged to the iconbar, the window will open
  140.     displaying any data that is available about that filetype.
  141.   • If you use the hotkey function where you hold down either
  142.     set of Ctrl and Alt keys and double-click on the file
  143.     the information window will open displaying data about that
  144.     filetype.
  145.   • Or you can edit the filetype into the 'Find Info'
  146.     window (found from the iconbar menu) and perform the search
  147.     the window will open containing available information
  148.     about the entered filetype.
  149.   • By pressing the hotkey F1. Read the Hotkeys section (e2) for
  150.     more information. 
  151.  
  152. b.5 Saving from Records
  153. _______________________
  154.  
  155. If you click the menu button over the information window, you will see the
  156. 'Save' options leading off to the right. This is so long as the currently
  157. displayed filetype has either some information of a filesprite stored in
  158. memory, if it doesn't then this option  will be greyed out. Move along to the right and another menu with two other options on it 'Save Sprite' and 'Save Data' are shown, so long as there is some of either resident in memory. Note: if there is no filesprite in the records but there is one in memory, then one may be displayed in the filesprite icon on the information window but it won't be available to save. You can use the 'GetWimpSpr' program from inside the Extras directory to save this sprite from memory. Follow the desired menu item across to the right and then drag the icon to a filer window as with any other
  159. application. Or to save the textfile you can press F3 or to save the sprite file press Shift-F3. 
  160.  
  161. b6. Loading files
  162. _________________
  163.  
  164. Like most other Risc OS applications simply double-click the !TypeInfo
  165. icon in the window to start. The icon of a white box with a red arrow
  166. pointing to a directory-like icon should appear on the icon bar. The default
  167. filetype is &FFF and when you click on the iconbar icon with select, the
  168. information window will come up.
  169.  
  170. By loading I mean that the information window will open and the
  171. filetype's sprite, name if available, block of allocation, and information
  172. will be displayed if available.
  173.  
  174. To load a file and get information about it, you can simply drag it to the
  175. iconbar icon.
  176.  
  177. If the autoloading feature has been selected from the options window, any
  178. file that you double-click without a runtype will be loaded.
  179.  
  180. The other way to load a file and get information about it is to hold down
  181. either set of Ctrl and Alt keys on the keyboard while you doubleclick on a 
  182. file, whether it has a runtype or not. The information window will then
  183. automatically open displaying information about that filetype.
  184.  
  185.  
  186. b7. Autoloading
  187. _______________
  188.  
  189. This is a very good feature of this program. What it does (when selected)
  190. is to check up on every double-clicked file. If that file has no runtype
  191. (when it would normally produce a 'No run action specified..' error) then
  192. instead typeinfo loads that file.
  193.  
  194. If however the file does have a runtype, typeinfo completely ignores it and
  195. you will notice no change.
  196.  
  197. It is this feature that allows background operation where you never see
  198. typeinfo until you doubleclick a no runtype file.
  199.  
  200.  
  201. b8. Utility and Absolute files
  202. ______________________________
  203.  
  204. During the development of the software, I noticed a bug in the way the
  205. software recognises non-descript filetypes. 'Utility' and 'Absolute' type
  206. filetypes have no run action set up by the computer and as a result, when a
  207. piece of software was run which runs one of these filetypes, the program
  208. failed to run and the information window was opened (if the autoloading
  209. feature was activated). This option from the option window to not load
  210. these filetypes should nearly always be turned on unless you want your
  211. computer to become unusable. 
  212.  
  213. b9. Skimming through the files
  214. ______________________________
  215.  
  216. This is a feature that I added at the last moment in order to allow the user
  217. to search through all the files on record quickly and without having to hold
  218. down the left or right arrow buttons. When you select this menu item, you
  219. will have to make sure that the menu is not obscuring the view of the main
  220. information window otherwise you will not be able to see the file
  221. information. The files will be skimmed through displayed one after the
  222. other as if you were holding down the next filetype 
  223. button. To stop the skimming, simply press the space button and hold it for
  224. a moment until the skimming stops. To make the skimming go as fast as
  225. possible simply hold down the 'F' button on the keyboard. To adjust the
  226. skimming rate you should read about the options window. The skimming
  227. will only display the filetype for the skimming time set in the options
  228. window if there is either information or a sprite otherwise it will skim past
  229. as if you were holding down 'F'.
  230.  
  231. b10. Searches
  232. _____________
  233.  
  234. There are two different search features encompassed into TypeInfo, both
  235. of which are executed from the iconbar icon's menu. They can be reached
  236. through the following menu structure (on the icon bar menu):
  237.  
  238.       _________________
  239.      |     TypeInfo    |
  240.      †—————————————————†
  241.      | Info          – |
  242.      | New Info   F2   |
  243.      |–––––––––––––––––|                 
  244.      | Find Info  F4 – |   - goes to info search
  245.      | Edit Type ⇧F4 – |   - goes to edit search
  246.      |–––––––––––––––––|
  247.      | Count      F8   |
  248.      | Options    F5   |
  249.      | Quit       ^Q   |
  250.      |_________________|
  251.  
  252. The 'Find Info' line brings up a window with an icon into which the
  253. filetype should be entered (either the filetype string or the number is acceptable here). Then you can either press RETURN or click on
  254. the 'Ok' icon. If there is some information available, it will be brought up
  255. just as if you had loaded that filetype. Or you can press F4 to open this window.
  256.  
  257. The same applies for the 'Edit Type' line, with both search windows
  258. looking the same (again, use either the filetype string or the hexadecimal number). But once you have entered the type to search for, instead
  259. of the information window opening, up comes the editing window with the
  260. data for that filetype (if it is available) present in the window ready for
  261. editing. Or you can press Shift-F4 to open this window.
  262.  
  263. b11. Animation
  264. ______________
  265.  
  266. Every 25 seconds or so (well actually its exactly every 25 second,
  267. measured in centi-seconds, you could set your watch by it) the typeinfo
  268. icon in the info window (accessible from the iconbar menu) rotates
  269. anti-clockwise. It can be quite entertaining to watch but other than that has
  270. no real purpose other than for me to show of my animating skills. If it
  271. annoys you, it can be turned off from the options window.