home *** CD-ROM | disk | FTP | other *** search
/ Merciful 3 / Merciful_Release_3.bin / software / d / data_division_docs / datadivisiondocs02.dms / datadivisiondocs02.adf / 13 < prev    next >
Text File  |  1996-11-23  |  10KB  |  223 lines
  1.  
  2.                               Chapter Twelve
  3.  
  4. Filetypes .......................................139
  5. Predefined Filetypes ............................139
  6. Filetype Manager ................................140
  7. Editing Filetypes ...............................141
  8.     Events ......................................141
  9.     Mouse Events ................................142
  10.     Command Events - User 1-4 ...................143
  11. Icon and Filetype Menus .........................143
  12.     Default Icon and Select Icon ................143
  13.     Edit Class ..................................144
  14.     Definition of a Filetype ....................144
  15.     Editing the Filetype Definition .............145
  16.     Edit Commands ...............................146
  17.     Testing Directives ..........................146
  18.     Movement Directives .........................149
  19.     Extra Examples ..............................151
  20. The Automatic Filetype Creator ..................152
  21.  
  22.                                 Filetypes
  23.  
  24.  A file is simply stored data.  Files can contain executable programs,
  25. text files, pictures or various types, icons for Workbench, or a multitude
  26. of other kinds of data.  Most, but not all files, have an identifiable
  27. structure.  Directory Opus 5's Filetypes system is designed to examine a
  28. file's internal structure and identify the type of data it contains.  You
  29. can configure Directory Opus 5 to understand an unlimited number of
  30. Filetypes.
  31.  
  32.  Filetypes are a powerful feature of Directory Opus 5.  By using
  33. Filetypes, you can configure Opus 5 to play animations when they are
  34. double-clicked, to load and use Multiview when you double-click on an
  35. AmigaGuide help file, or to uncompress an archived file when you drag and
  36. drop it to a new directory or even to feed the archive to an external
  37. handler such as ArcDir.
  38.  
  39.  This is the essence of the Filetypes; when you do something to a file,
  40. Opus 5 can figure out what kind of file it is, and take the appropriate
  41. action for that type of data.
  42.  
  43.                            Predefined Filetypes
  44.  
  45.  Opus 5 comes with some fully defined Filetypes.  These are stored in the
  46. DOpus5:Filetypes directory and have both the Filetype structure fully
  47. defined, plus have default commands attached to the various actions
  48. available.  The loading of Filetypes is dynamic.  Opus 5 will look to see
  49. what Filetypes you have defined in this directory and load them
  50. automatically.
  51.  
  52.                              Directory Opus 5                        139
  53.  
  54.  For convenience, we have also provided a set of default Filetypes
  55. definitions in the DOpus5:Storage/filetypes directory.  With these, we
  56. have done most of the hard work and have set out the details needed by
  57. Opus 5 to recognise files of the specific types.  To use one of these pre-
  58. defined Filetypes, you should use the Automatic Filetype Creator to
  59. identify and install the matching Filetypes or you can manually drag the
  60. required one into the DOpus5:Filetypes drawer and Opus 5 will recognise
  61. and load it automatically.  Then, edit the new Filetype and set out the
  62. specific actions you wish to attach to the new definition.  By doing this,
  63. you don't have to be an expert or know anything about the internal
  64. structure of the various files.  All you need to do is attach the actions
  65. which Opus 5 should take when it recognises a file of this type.
  66.  
  67.                              Filetype Manager
  68.  
  69.  The Filetypes requester is accessed from the Settings menu and displays
  70. the list of Filetypes that Directory Opus 5 recognises.  For starters, we
  71. have included several definitions.  These may include AmigaGuide, LHA
  72. archive, Workbench icons, and Script files.
  73.  Your currently defined and available Filetypes will be shown in the list
  74. in alphabetical order.  For example,
  75.  
  76.  *** See Fig 12-01 ***
  77.  
  78.  Add:  Allows you to create a new Filetype entry based on a predefined
  79.        File Class.  When you select this button, two requesters appear
  80.        where you may define the actions and definitions of the new
  81.        Filetype.
  82.  
  83.  Duplicate:  Allows you to quickly duplicate a current entry.  Highlight
  84.              the desired entry, select 'Duplicate' and a new entry will be
  85.              cloned from the current one and presented for editing.
  86.  
  87.     140                      Directory Opus 5
  88.  
  89.  Edit:  Displays the Filetype events and allows you to edit the Filetype
  90.         definition and command actions.
  91.  
  92.  Remove:  Removes a Filetype definition from the list and deletes the
  93.           entry from the DOpus5:Filetypes drawer.
  94.  
  95.  Store:  Removes a Filetype definition from the list and moves the entry
  96.          from the DOpus5:Filetypes drawer to the DOpus5:Storage/Filetypes
  97.          draw.
  98.  
  99.                             Editing Filetypes
  100.  
  101.  The Filetype Editor consists of a number of parts; one showing the actual
  102. Filetype definition or class, one showing the possible events or user
  103. actions, and one detailing the corresponding commands each action will
  104. perform.
  105.  
  106.  Double-clicking on a particular Filetype, or selecting the Edit button,
  107. displays the list of events or user actions which can be defined for each
  108. Filetype, a special set of menus which you may attach to the sticky menus
  109. for icons of this type, and the default icon image you wish to use for
  110. this type of file.
  111.  
  112.  *** See Fig 11-02 ***
  113.  
  114.                                   Events
  115.  
  116.  Each of the actions is associated with either a mouse event or a limited
  117. set of Opus 5 commands, namely User1 - User4.
  118.  
  119.  A tick on the left of an entry indicates that it already has an Function
  120. Command List defined for it.  Clicking on an entry in the list displays
  121. the Function Editor, allowing you to edit the commands associated with
  122. this event.
  123.  
  124.                              Directory Opus 5                        141
  125.                              
  126.  *** See Fig 11-03 ***
  127.  
  128.  To compare the definitions for multiple events, or edit multiple
  129. definitions simultaneously, double-click on multiple events in turn.
  130. While each of these event types can be defined to do something different,
  131. usually only a few are actually defined.  It is certainly not necessary to
  132. define all events for a particular Filetype.
  133.  
  134.  When one of these actions or events occurs, Opus 5 does the following:-
  135.  
  136.  *      It first searches the Filetypes list, starting with the Filetype
  137.         of highest priority, and checks whether it matches the entry's
  138.         Filetype definition.
  139.  
  140.  *      If it matches, it checks if the corresponding event has been
  141.         defined as a notifiable action.  If it is defined, it performs the
  142.         attached function.
  143.  
  144.  *      If there is no match for the Filetype definition, or if there is a
  145.         match but no associated function, it continues to search the
  146.         Filetypes list.  Note that it is possible for it to match a
  147.         subsequent entry that has a function defined.
  148.  
  149.                                Mouse Events
  150.  
  151.  Mouse events occur when you either double-click on a file or when you
  152. drag and drop it into a new directory.
  153.  
  154.  Double-click:  This occurs when you double click on a file.  A popular
  155.                 use of this action is to examine a file and, for example,
  156.                 to show it if it is a picture, or play it if it is a
  157.                 sound.  The actual double-click speed is defined by your
  158.                 Amiga OS preferences.
  159.  
  160.     142                      Directory Opus 5
  161.  
  162.  Drag and drop:  This event occurs when a file is clicked on, dragged to
  163.                  another window and released.  One popular use of this
  164.                  event is for extracting an archive.
  165.  
  166.                         Command Events - User 1-4
  167.  
  168.  Command events are called when a file is acted upon by a limited set of
  169. Directory Opus 5 commands.  Only the User event commands are available.
  170. The terms User 1, User 2, User 3, and User 4 may seem cryptic, but they
  171. are here to give you flexibility.  Each of the normal Opus 5 commands has
  172. an implied usage, but you may have an application which doesn't really
  173. mean any of these.  In that case, you can decide that one of these User
  174. events means "Perform this special operation".
  175.  
  176.                          Icon and Filetype Menus
  177.  
  178.  As from Opus 5.5, each icon, and Name mode Listers if activated, has a
  179. special set of Filetype pop-up menus, accessed by pressing the RMB over
  180. the icon, or an entry in a Name mode Lister.  Opus provides a limited set
  181. of common commands for these menus according to the type of icon or file.
  182. You can add your own favourite commands specific to icons and files of
  183. defined types.
  184.  
  185.  When an icon is displayed for a file for which you have previously
  186. defined a Filetype, the Filetype menus are added to the pop-up menus for
  187. icons of this type.  Select Add to define the Menu label and functions for
  188. your own custom menus.
  189.  
  190.                        Default Icon and Select Icon
  191.  
  192.  The Select Icon button allows you to provide an icon image which Opus 5
  193. will use when displaying this specific Filetype in either an Icon or Icon
  194. Action mode Lister, or when left-out on the Opus 5 Main Window.  To add
  195. your own special image, either select the icon image required through the
  196. file requester, or drag and drop a suitable icon into the display area
  197. above this button.  (We provide a special DOpus5:Icons directory to store
  198. such special icons.)
  199.  
  200.   +---------------------------------------------------------------------+
  201.   | If an icon image is supplied, Opus 5 will use this defined icon for |
  202.   | the internal AddIcon command instead of the system default.         |
  203.   +---------------------------------------------------------------------+
  204.                              Directory Opus 5                        143
  205.  
  206.                                 Edit Class
  207.  
  208.  Underneath the event list is a button which lets you modify the class or
  209. definition for this Filetype as discussed below.
  210.  
  211.                          Definition of a Filetype
  212.  
  213.  Selecting Edit Class from the Event Requester brings up the File Class
  214. editor.  Here, you specify the elements which Opus 5 will look for to
  215. recognise a specific Filetype.
  216.  
  217.  *** See Fig 11-04 ***
  218.  
  219.  Name:  This is for the name of the Filetype.
  220.  
  221.  ID:  The ID will appear beside the Filetype in the Filetype manager
  222.       screen.  It is a shorthand way for Opus 5 to display the name for
  223.       the Filetype