home *** CD-ROM | disk | FTP | other *** search
/ Esprit de Apple Corps / EDAC-2.iso / Sound / MOD.Utilities / Instant.Access / Instant.Manual < prev    next >
Text File  |  1993-06-30  |  18KB  |  360 lines
  1. Instant Access(tm)
  2. v2.30 - June 30th 1993
  3.  
  4.  
  5. Copyright ⌐ 1993 Ian Brumby.  All rights reserved.
  6.  
  7.     This program is SHAREWARE.  Please appreciate the time and effort that has gone into this program, and our other programs.  All we ask for is $10!  Paying it will help us to create more great GS software, instead of just being the next guys to leave the GS.
  8.     Now put more formally: You may evaluate this program for a period of 30 days, after which you must either pay us $10, or immediately delete this program.  Australian users should pay AUS$10 in cash, or a check made out to Ian Brumby.  American users and other overseas people should send me one US$10 note.
  9. +---------------------------------------------------------------+
  10. |  I'm going to trial credit card payments for a while.  I'd prefer it if    |
  11. |  users paid cash, but if you really can't, then e-mail or post me your    |
  12. |  VISA or MASTERCARD details (number/expiry date/etc.)        |
  13. |  You will be billed AUS$15 (or AUS$20, see below).            |
  14. +---------------------------------------------------------------+
  15.     What happens to your money?  Well, apart from bringing a smile to my face, it helps to pay some of my programming costs.  Yes, the simple art of programming costs THOUSANDS of dollars.  I'm but a poor Uni student, and I find it hard to pay for such things.
  16.     This program is not crippled in any way!  My new policy is that if you send in $5 (on top of the fee) then you will be entitled to TWO seperate updates.  I hate CrippleWare as much as the next person, but I hope no-one will abuse the new policy.  Alternatively, if you don't want to spend the extra $5, and if you have an Internet e-mail address, I'll post out notices of new releases, and tell you where you can FTP them from.
  17.     I try to reply to all postal letters that need a reply, but as it costs $1.20 per letter I can't guarantee to do so.  Don't think your letters aren't appreciated!!!  If you provide me with an e-mail address though, then I'll be able to reply for free, so providing nothing goes wrong you'll get a reply!
  18.  
  19.     Send all cash and comments to:
  20.     Ian Brumby
  21.     57 Macleay St
  22.     Turner ACT 2601
  23.     Australia
  24.  
  25.  
  26. What does this program do?
  27.  
  28. This program is a Program Launcher.  It is meant to replace the Finder as the program you use to do all your launching and file maintenance.  It should be able to do everything the Finder can and more, but use only a fraction of the disk space that the Finder takes, and it should also load a lot faster than the Finder.
  29.  
  30. Why should I choose it over my current Program Launcher?
  31.  
  32. Well, the following tables demonstrate why we think this is the best program for that job.
  33.  
  34. Note: The number on the left of a "/" is the time taken with an TransWarp 7 MHz/8k cache accelerator, and the number on the right is the time taken on an unaccelerated machine.  FExt = Finder Extension, Ext = External, Int = Internal, CBF = can't boot from floppy.  Sorry I can't give times for hard drives, as I currently don't have one.
  35.  
  36. The category "Finder 6.01" is the standard Finder as you get it on System 6.01, and the category "Finder 6.01 *" is the same program but with the following Shareware Finder Extensions:
  37.  
  38. FinderView v3.0        $10    70k
  39. More Info v1.0        $10    36k
  40. InitMaster v2.0        $10    28k
  41. DeskTracker v1.0        $10    17k
  42. TeachReader v1.0        $10    16k
  43. QuickLaunch v1.0        Free    20k
  44.             ----    ----
  45.             $50    187k
  46.  
  47.             Instant    Finder    Finder    Sys 6    Wings    Mini-
  48.             Access    6.01    6.01 *    Launch        Wings
  49.  
  50. Loading Time        29 / 36    48 / 62    CBF    36 / 47    53 / 64    42 / 52
  51. (cold boot from floppy, in secs)
  52. Reloading Time        1 / 1    7 / 10    CBF    2 / 3    7 / 10    4 / 5
  53. (immediate quit from floppy, in secs)
  54. Program's size        146k    183k    372k    1.5k    283k +    13k +
  55. (minimum size, incl. config files)
  56. FST aware        Yes    Yes    Yes    Yes    No    Yes
  57. (e.g. can it read Mac disks)
  58. Uses System 6.0        Yes    Yes    Yes    No    No    No
  59. (e.g. handles rVersions, rSounds)
  60. Graphical interface    Yes    Yes    Yes    Yes    Yes    Yes
  61. Launches S16/SYS files    Yes    Yes    Yes    Yes    Yes    Yes
  62. Launches BAS files    Yes    Yes    Yes    No    Yes    No
  63. Install CDAs/NDAs    Yes    No    No    No    No    No
  64. Deletes files        Yes    Yes    Yes    No    Yes    No
  65. Renames files        Yes    Yes    Yes    No    Yes    No
  66. Copies files        Yes    Yes    Yes    No    Yes    No
  67. Displays Graphics        Yes    No    Yes    No    Yes    No
  68. Displays 3200 Graphics    Yes    No    Yes    No    No    No
  69. Displays DPF Graphics    Yes    No    No    No    No    No
  70. Displays Print Shop Pics    Yes    No    Yes    No    No    No
  71. Displays PW Animations    Yes    No    Yes    No    No    No
  72. Displays GIF Graphics    Yes    No    No    No    No    No
  73. Plays digitized sounds    Yes    No    No    No    Yes    No
  74. Plays rSounds        Yes    No    No    No    No    No
  75. Plays SoundSmith        Yes    No    Yes    No    No    No
  76. Plays Amiga MODs        Yes(Ext)    No    No    No    No    No
  77. Plays in background    Yes    No    Yes    No    No    No
  78. Reads text files        Yes(Ext)    Yes(Ext)    Yes(Int)    No    Yes(Int)    No
  79. Reads Teach files        Yes(Ext)    Yes(Ext)    Yes(Int)    No    No    No
  80. Get and set file info    Yes    No    Yes    No    Yes    No
  81. Activate DAs/Inits/etc    No    No    Yes    No    Yes    No
  82. Undelete files        No    No    No    No    Yes    No
  83. Format/Erase disks    Yes    Yes    Yes    No    Yes    No
  84. Shutdown system        Yes    Yes    Yes    Yes    Yes    Yes
  85. Warm Slot reboots    Yes    No    No    No    Yes    No
  86. Cold Slot reboots        Yes    No    No    No    Yes    No
  87. Built-in Screen Blanker    Yes    No    No    No    Yes    No
  88. QuickLaunch        No    No    Yes    No    Yes    Yes
  89. Other misc. utilities    No    No    No    No    Yes    No
  90. Price            $10    Free    $50    Free    $60    $60
  91.  
  92.             Instant    Micro-    Squirt    ProSEL    Utility    ZLaunch
  93.             Access    Wings    16    16    Launch    0.3
  94.  
  95. Loading Time        29 / 36    39 / 47    28 / 36    34 / 42    52 / 58    35 / 43
  96. (cold boot from floppy, in secs)
  97. Reloading Time        1 / 1    2 / 3    2 / 3    2 / 3    8 / 12    3 / 4
  98. (immediate quit from floppy, in secs)
  99. Program's size        146k    1.5k    20.5k    190k    178k +    18k
  100. (minimum size, incl. config files)
  101. FST aware        Yes    No    No    No    No    No
  102. (e.g. can it read Mac disks)
  103. Uses System 6.0        Yes    No    No    No    No    No
  104. (e.g. handles rVersions, rSounds)
  105. Graphical interface    Yes    Yes    No    Almost    Yes    Yes
  106. Launches S16/SYS files    Yes    Yes    Yes    Yes    Yes    Yes
  107. Launches BAS files    Yes    No    Yes    Yes    Yes    No
  108. Install CDAs/NDAs    Yes    No    No    No    No    No
  109. Deletes files        Yes    No    No    Yes    No    No
  110. Renames files        Yes    No    No    Yes    No    No
  111. Copies files        Yes    No    No    Yes    No    No
  112. Displays Graphics        Yes    No    No    Yes    No    No
  113. Displays 3200 Graphics    Yes    No    No    No    No    No
  114. Displays DPF Graphics    Yes    No    No    No    No    No
  115. Displays Print Shop Pics    Yes    No    No    No    No    No
  116. Displays PW Animations    Yes    No    No    No    No    No
  117. Displays GIF Graphics    Yes    No    No    No    No    No
  118. Plays digitized sounds    Yes    No    No    No    No    No
  119. Plays rSounds        Yes    No    No    No    No    No
  120. Plays SoundSmith        Yes    No    No    No    No    No
  121. Plays Amiga MODs        Yes(Ext)    No    No    No    No    No
  122. Plays in background    Yes    No    No    No    No    No
  123. Reads text files        Yes(Ext)    No    No    Yes(Int)    No    No
  124. Reads Teach files        Yes(Ext)    No    No    No    No    No
  125. Get and set file info    Yes    No    No    Yes    No    No
  126. Activate DAs/Inits/etc    No    No    No    No    No    No
  127. Undelete files        No    No    No    Yes    No    No
  128. Format/Erase disks    Yes    No    No    Yes    No    No
  129. Shutdown system        Yes    No    No    Yes    Yes    No
  130. Warm Slot reboots    Yes    No    No    No    Yes    No
  131. Cold Slot reboots        Yes    No    No    No    No    No
  132. Built-in Screen Blanker    Yes    No    No    No    Yes    Yes
  133. QuickLaunch        No    No    Yes    Yes    Yes    No
  134. Other misc. utilities    No    No    No    Yes    No    No
  135. Price            $10    $60    $20    $90    $10    $20
  136.  
  137. The Crystal Ball
  138.  
  139. If this wonderous TurboRez card does actually come out in a few months, then I'll want to buy one, and make a TurboRez version of this program!  Lets hope there will be lots more support for what looks like another great piece of Apple II hardware.  And from what I've heard, other developers are right behind it as well.
  140.  
  141. Other goodies that might appear:
  142.     + Internal text file viewing
  143.     + Activate/Deactive DAs/Inits/etc.
  144.     + Archive viewing/manipulation
  145.     + QuickLaunch buttons/keys (top priority?)
  146.     + Shell (FAST! of course)
  147.     + and more... (only limited our imaginations!)
  148.  
  149. Feature summary
  150.  
  151. This program can:
  152. * Launch S16, SYS and BAS files
  153. * Install CDA and NDA files
  154. * View TXT, AWP (AppleWorks Classic), SRC and Teach files
  155. * Display most graphics files (Uncompressed, compressed and/or 3200 colour)
  156. * Display GIF files
  157. * Display animation files
  158. * Browse through icon files
  159. * Play most digitized sound files (Uncompressed and compressed)
  160. * Play SoundSmith songs
  161. * Play Amiga MODs
  162.  
  163. These features are activated by either double clicking on the desired file in the file list, or by selecting "Launch" from the menu bar, or by clicking on the "Open" box.
  164.  
  165. This program can also:
  166. * Display file info and change it
  167. * Delete files
  168. * Rename files
  169. * Copy files
  170. * Move files
  171. * Create folders
  172. * Rename disks
  173. * Format disks
  174. * Erase disks
  175. * Shutdown the system
  176. * Perform a warm or cold slot reboot
  177. * Save your preferences
  178. * Protect your monitor with a screen blanker
  179.  
  180. Other great features:
  181. * Written in 100% assembly, making it fast, and small in size.
  182. * Really cool custom interface, but remains easy to use.
  183. * "Free Tools", making it load faster than any other GS/OS launcher around.
  184. * Always remains memory resident so reloading is Instant!
  185. * Support and future versions! [And this version is further proof!]
  186. * CHEAP, CHEAP, CHEAP!
  187.  
  188. File formats currently supported
  189.  
  190. Filename        Type    Aux    Result
  191. All        PIC    $0000    Displays Uncompressed SHR Graphic
  192. All        PIC    $0002    Displays Uncompressed 3200 Graphic
  193. All        PNT    $0000    Displays PaintWorks Graphic
  194. All        PNT    $8000    Displays PaintWorks Gold 640 Graphic
  195. All        PNT    $0001    Displays PackBytes Graphic
  196. All        PNT    $0002    Displays Apple Preferred Graphic
  197. All        PNT    $8005    Displays DPF (DreamGrafix) Graphic
  198. All        $F1    $0004    Displays Packbytes 3200 Graphic
  199. All        $F8    $C323    Displays PrintShop GS Graphic
  200. All        BIN    $5800    Displays PrintShop Graphic
  201. *.3200        BIN    $0000    Displays Uncompressed 3200 Graphic
  202. *.3201        BIN    $0000    Displays French APP 3200 Graphic
  203. All        ANI    All    Displays PaintWorks Animation
  204. All        BIN    1-999    Plays uncompressed sound file
  205. All        BIN    $2000    Displays HiRes graphic
  206. All        BIN    $4000    Displays HiRes graphic
  207. All        ICN    All    Browses through Finder Icon file
  208. All        ACE    All    Plays ACE compressed sound file
  209. All        SND    $0002    Plays ASIF sound file
  210. All        SND    $0220    Plays NoiseTracker ASIF sound file
  211. All        SND    $0003    Plays System 6.0 rSound sound file
  212. All        SND    $8001    Plays HyperStudio sound file
  213. All        MUS    $0007    Plays SoundSmith song
  214. MOD.*    mod.*    All    All    Plays Amiga MOD song
  215. *.GIF    *.gif    All    All    Displays GIF 87a/89a file
  216. All        TXT    All    Views text file
  217. All        GWP    $5445    Views Teach file
  218. All        AWP    All    Views AppleWorks Classic WP file
  219. All        NDA    All    Installs NDA
  220. All        CDA    All    Installs CDA
  221. All        SRC    All    Views source code file
  222. All        S16    All    Executes GS/OS program
  223. All        SYS    All    Executes ProDOS 8 program
  224. All        BAS    All    Executes AppleSoft BASIC program
  225.  
  226. SoundSmith instruments can come in *.W, *.D, *.DOC and DOC.DATA formats, as well as individual ASIF instrument files.
  227.  
  228. How to install this program
  229.  
  230. There is only one file - "Instant.Access".  If you want it to replace the Finder then rename it "Start" and copy it over the file "Start" located in "*:System:", where * is the name of your boot disk.
  231.  
  232. Optional files (but highly recommended)
  233. 1.    Note that Tool029 is required if you want to play ACE files, however it isn't compulsory, and is only loaded when it is required.
  234. 2.    If you want to play MOD files then the file "SP" (ShellPlay) must be located in the same folder as Instant Access.  Only SP v0.6b3 and higher work.
  235. 3.    Also, if you want to view text files and Teach files then the program "WriteAway" must be located in the same folder as Instant Access.
  236. 4.    Finally, if you want to launch AppleSoft BASIC programs then "Basic.System" must be located in the root directory of your boot disk.
  237.  
  238. * Note, this program will run off System 5, but you might have a few problems!
  239.    Use System 6!
  240. * Also you might have a few problems if you are trying to run this off only one
  241.    800k floppy drive!
  242. * Instant Access also needs at least 1024k total memory to operate properly.
  243.  
  244. Programming Info
  245.  
  246. This program was written using ORCA/M 2.0 (by The Byte Works) and SHRUtils 1.0 (by the author of this program).  The whole thing was written without a hard drive, as that was not-so-recently fried by lightning.  Yup, here's version 2.3, and AE still haven't repaired/replaced the HD.  To make matters worse, my floppy drive just died on me (it's been a bad year!) which makes programming almost impossible!  (Reminder: send in those $$$ - it'll help a lot! :)
  247. It consists almost entirely of "No Tools" coding, which is why it is fast to load and fast when running.  The author isn't a die-hard NoTooler, but thought it would be a good idea for a program like this.  And yes, it allocates memory properly.
  248.  
  249. Version 2.3    39,959 lines of assembly    (656.5k)
  250.  
  251. Revision History
  252.  
  253. Version 1.0    * First Release
  254. Version 2.0    * Added support for Hi-Res, PrintShop & PrintShop GS graphics
  255.         * Improved APF support for things like 256 colour support
  256.         * Minor bug fixes (i.e. Launching text and double clicking)
  257.         * Improved scrollbar that can now be dragged
  258.         * Shift-click and OA-click now active
  259.         * Added Warm/Cold slot rebooting
  260.         * Added Copy Files/Move Files (hooray!) [NB: You can't do a
  261.            one drive copy though.  Tell me if you need this badly!]
  262.         * Added Activate Desktop due to popular demand :)
  263.         * SoundSmith playing is now internal (adieus Tool 219)
  264.         * Added "Stop music" option
  265.         * Added support for PaintWorks animations
  266.         * Added support for DPF (DreamGrafix) graphics
  267.         * Added "Create new folder"
  268.         * Preferences now stored in a CFG $8062 file
  269.         * Now installs NDAs or CDAs when you try to launch them
  270.         * Drives are now polled for disk inserts and ejects
  271. Version 2.1    * Added Sort Files option (in Preferences)
  272.         * Added Screen Blanker time option (in Preferences)
  273.         * Added Background editor/Colour editor (in Preferences)
  274.         * Minor bug fixes (e.g. Create new folder bug, Polling routine)
  275.         * Added the following keyboard shortcuts:
  276.            o Arrow keys select files
  277.            o Return opens files
  278.            o Escape closes folder
  279.         * Added support for Amiga MOD music files
  280.         * Added support for GIF graphics.  If there are 16 or less
  281.            colours then it displays it in colour, otherwise it uses
  282.            32-greyscale.  Both methods are pretty fast. :-)
  283.         * Added support for ASIF and HyperStudio sound files
  284.         * Optimized some code
  285.         * Now handles out of memory situations better
  286. Version 2.2    * New improved Window Manager & Control Manager
  287.         * SoundSmith/MegaTracker songs are now handled by the
  288.            radical MegaTracker player.  This means they take less
  289.            CPU time while playing, and also means you can load songs
  290.            that come with ASIF instrument files
  291.         * Added another keyboard shortcut.  Pressing a letter selects
  292.            the first file in the list that starts with that letter.  This
  293.            is only active if you have Sorted Files turned on
  294.         * Clicking on the pathname box in the file list closes the
  295.            current directory
  296.         * System 6.01 tuning
  297. Version 2.3    * Ooops.  My modifications to the MOD identification code in
  298.            v2.2 actually made things worse.  It's been fixed though :-|
  299.         * Added support for viewing Finder Icon files
  300.         * Now plays NoiseTracker ASIFs
  301.         * Changed polling routine (again)
  302.         * Now comes with a rVersion resource
  303.         * Extended the proportional font
  304.  
  305. Thanks
  306.  
  307.     Thanks go to Alex, who wrote that one piece of e-mail that resulted in a new GS development group being formed.  We've created a monster!  This program was his idea.  I thought there were too many program launchers on the market already, but he managed to persuade me otherwise.  He's got half a dozen other "ideas" that he wants implemented... look out for these!
  308.     Thanks go to Bertrand, who was the first person to pay me a Shareware fee (for TM-QWK, my offline mailer, and now for this as well!).  Thanks also for all the stuff you've grabbed off the Internet for me!
  309.     Thanks go to Spectre, SysOp of The Lower Planes BBS, for keeping one of the last public GS BBSes in Australia alive, and it's getting bigger and better!  Ring it sometime. :-)
  310.     Thanks go to the few people that wrote in and said what they wanted in future versions.  Especially Margot Taylor, for suggesting some good ideas.  Maybe you'll send in the other $5 now, and then I'll reply to you. :-)  Hi to James Brookes too! :-)  Hopefully, most of the suggestions that people made will be in this version - if not, there's always the next version!
  311.     Thanks to the ANU Students Union for providing real Internet accounts, unlike the fascist Department of Computer Science. :-)
  312.     Thanks to Thomas Dorris for his nice fast GIF code, which was improved upon to give you the GIF routines you see here.  Such things such as interlaced pic support and real 16 colour rendering were added.
  313.     Thanks to Brian Bening for his fabulous and amazing Shellplay!  It's really cool, and thanks to it, IA can now play MODs!
  314.     Finally, thanks to Ian Schmidt for the MegaTracker player source.  This is the third lot of SoundSmith code I've used for this program :-) and the best so far!
  315.  
  316. Hall of Fame (People who have registered this program)
  317.  
  318. Bertrand Lee (Australia)
  319. Tony Rasser (USA)
  320. John Swanland (Australia)
  321. Ian Jones (Australia)
  322. Daniel Pfarrer (USA)
  323.  
  324. Total money made = AUS$30 + US$25.
  325.  
  326. Who make up S.L.R.?
  327.  
  328. Programmer    Ian Brumby
  329.     Address    57 Macleay St    [Preferred]
  330.         Turner ACT 2601
  331.         Australia
  332.     E-Mail    user0213@student.anu.edu.au    [Preferred]
  333.         [Note:    The Internet address given in v1.0 doesn't work
  334.           now and never has (for international e-mail).  If you sent
  335.           mail there, it got gobbled up by a green hairy monster
  336.           before I ever got to see it.
  337.           Sorry about that!  But this one DOES WORK!]
  338.         FidoNET 3:620/250 (Ian Brumby)    [Preferred]
  339.         RiftNET 61:3011/0 (Prince Slime)
  340.     IRC    IRCNick: Slime
  341.         See you on #AppleIIgs! ;)
  342.     Oz BBS    The Lower Planes [(03) 543-2585] 14.4k v32bis max [Preferred]
  343.         User - Prince Slime
  344.         (Americans ring 011 61 3 5432585, if you're rich or .........)
  345.  
  346. Artist        Alex Lee
  347.     Address    39 off Beasley Cres    [Preferred]
  348.         Rankin Park NSW 2287
  349.         Australia
  350.     E-Mail    FidoNET 3:622/400 (Alex Lee)
  351.         RiftNET 61:3011/0 (Helix Energy)
  352.     Oz BBS    The Lower Planes [(03) 543-2585] 14.4k v32bis max [Preferred]
  353.         User - Helix Energy
  354.  
  355. Musicians    Christian Bell
  356.         Evan Rose
  357.  
  358. We are always looking for new members.  If you are a Programmer, Artist or Musician then write in and offer your services!  If you are a user, write in and offer ideas!
  359.  
  360. Instant Access is a trademark of Ian Brumby.  Finder and GS/OS are registered trademarks of Apple Computer, Inc.  ORCA/M is a trademark of The Byte Works, Inc.  Salvation: Wings, MiniWings and MicroWings are registered trademarks of Vitesse, Inc.