home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / t / typeinfo / Documents / HowToUse < prev    next >
Text File  |  1996-08-06  |  14KB  |  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 inf