home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 3 / AUCD3.iso / airport / utils / 64coder / !64coder / !Help < prev    next >
Text File  |  1996-07-14  |  6KB  |  152 lines
  1. 64coder 1.00
  2. ============
  3.  
  4.  
  5. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  6. + © John Allen 1996.  This application is Freeware and is           +
  7. + supplied on the understanding that:                               + 
  8. +                                                                   + 
  9. + 1. The source code is not altered in any way                      +
  10. + 2. Any copies made contain all of the files in the directory      +
  11. + 3. It is not sold for a profit                                    +
  12. + 4. It is not included on any disc costing more than £2 or any     +
  13. +    CD Rom costing more than £20 without my prior permission       +           +                                                                   +
  14. +                                                                   +
  15. + Please contact me before adding it to a PD library so that I can  + 
  16. + supply an up to date version.                                     + 
  17. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  18.  
  19. This is the sister application to UUcoder by the same author.
  20.  
  21. It codes and decodes MIME base64 such as might be sent and received via 
  22. Usenet newsgroups on the Internet.  It works totally on the RISC OS 
  23. desktop and is designed to work only under RISC OS 3.10 and later 
  24. versions.
  25.  
  26. 64coder saves and loads files to and from the Scrap directory so will 
  27. run much better on a machine with a hard disc, but then Internet (or at 
  28. least Demon) would be a pain on a machine which only had floppy drives.
  29.  
  30. The following files should be included in the 64coder directory:
  31.  
  32. !Boot
  33. !Help
  34. !Run
  35. !RunImage
  36. !Sprites
  37. !Sprites22
  38. Resources directory containing: Mapping, Messages, Sprites, Sprites22, 
  39.                                 Templates
  40.  
  41. Use 
  42. ===
  43.  
  44. Double click on the 64coder icon in the Filer window.  This installs 
  45. 64coder on the iconbar and opens the main coding and decoding window.
  46.  
  47. Clicking on the 64coder icon on the iconbar will re-open the main 
  48. coding and decoding window if it has been closed.  If the window is 
  49. already open it will bring it to the top of any other windows that are 
  50. open.
  51.  
  52. 64coder is designed to be simple to use.  To decode: drop a file on the 
  53. decode icon and to code drop it on the code icon.  The resulting file 
  54. can then be dragged where ever it is required.  The instructions below 
  55. are more detailed an explain the more advanced features:
  56.  
  57.  
  58. To decode a file or series of files:
  59.  
  60. 1. Drag a file containing uuencoded data to the decode icon at the 
  61. bottom right of the main window.  There's no need to edit the header 
  62. off the file, just use the whole file.
  63.  
  64. 2. UUcoder decodes the complete uuencoded file.
  65.  
  66. 3. Edit the supplied name as appropriate, then drag the file icon to a 
  67. Filer directory display or to another application.  Alternatively enter 
  68. the full pathname of the file and click select on the 'OK' icon.  
  69. Additionally you can double-click select over the file icon to load it 
  70. into an appropriate application (if known to RISC OS at the time of 
  71. clicking). 
  72.  
  73.  
  74. To encode a file:
  75.  
  76. 1. Drag the file you wish to encode to the code icon at the top right 
  77. of the main window.  If the file is being sent to someone with a PC 
  78. rather than an Arc it should be named with the appropriate file PC file 
  79. extension, using a "/" instead of a ".".  This ensures that the PC user 
  80. gets a correctly typed file when it is decoded.  For example a gif file 
  81. "mum" should be called "mum/gif" before dragging it to 64coder.  It 
  82. will be encoded with the PC file name of "mum.gif".  64coder will save 
  83. the RISC OS filetype with the file so that its RISC OS filetype can be 
  84. restored if it is decoded by 64coder or Marcel.
  85.  
  86. 2. 64coder will encode the file.
  87.  
  88. 3. Edit the file name supplied by 64coder to the name you wish to save 
  89. the file under, and drag the file icon to a Filer directory display or 
  90. to another application.  Alternatively enter the full pathname and 
  91. click select on the 'OK' icon.
  92.  
  93.  
  94. Features 
  95. ========
  96.  
  97. * 64coder will accept coded files direct from other applications so, 
  98. for example, you can use the 'Save File' option of TTFN to decode files 
  99. by dragging them to the 64coder decode icon rather than saving them on 
  100. disc first.
  101.  
  102. * 64coder will save coded files to other applications so, for example, 
  103. you can insert an encoded file (or section of file) into a message 
  104. being composed by TTFN.
  105.  
  106. * 64coder will also transfer decoded files directly to and from other 
  107. applications which accept direct transfer.  Note that there is a bug in 
  108. Translatr which means it will not accept .jpg files unless you edit one 
  109. line in Translatr's !Run file.  The line that reads: 
  110.  
  111.           Set Translator$Scrap <Wimp$Scrap>
  112.  
  113. should be changed to point to a different file such as: 
  114.  
  115.           Set Translator$Scrap <Wimp$Scrap>2
  116.  
  117. * Double clicking a decoded file will attempt to load it into an 
  118. application that accepts that filetype.  Note that some applications 
  119. (e.g. Spark) do not take possession of files loaded this way so it is 
  120. vital that the file is processed and saved elsewhere before 64coder is 
  121. closed down - as all 64coder working files in the Scrap directory are 
  122. deleted on closedown.
  123.  
  124. * Closing the main window part way through any operation will destroy 
  125. the unsaved data (as per Acorn's guidelines).  To keep the data while 
  126. closing the 64coder main window, hold the shift key down when closing 
  127. it.  This will iconise the window on the pinboard allowing it to be 
  128. reopened by double clicking select on the window icon.
  129.  
  130. * 64coder uses solid sprite dragging if you have it enabled on your 
  131. machine.
  132.  
  133. * 64coder will translate PC-type file extensions to RISC OS filetypes 
  134. according to the host machines DOSMap settings and (if no DosMap 
  135. setting exists) with supplied translations in the file 
  136. Resources.Mapping.  This means that output files can be double clicked 
  137. to load them into image translators such as ChangeFSI, Translatr or 
  138. FYEO2 (.jpg, .gif and tif), an MPEG viewer (.mpg) or a de-archiver such 
  139. as Spark (.arc .tar and .zip).
  140.  
  141. * Interactive Help is supported for the main window, dialogue boxes and 
  142. menus.
  143.  
  144.  
  145. Any comments, queries, donations or bug reports to:
  146.  
  147. John Allen.
  148.  
  149. E-mail: john@bramber.demon.co.uk 
  150. Arcade: #917 
  151. Silicon Village: 819991215
  152.