home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 6 / FreshFish_September1994.bin / new / mus / misc / pro-wizard / docs / pro-wiz-2_english.doc next >
Text File  |  1994-04-21  |  31KB  |  860 lines
  1.  
  2.         __________________________________________________________
  3.        /                                                          \
  4.       *------------------------------------------------------------*
  5.       *                  P R O  -  W I Z A R D   2                 *
  6.       *                *---------------------------*               *
  7.       *                        Documentation                       *
  8.       *------------------------------------------------------------*
  9.        \__________________________________________________________/
  10.  
  11.                              © Nicolas FRANCK
  12.  
  13.  
  14. *-------------------*
  15. *--->  Preface  <---*
  16. *-------------------*
  17.  
  18. Pro-Wizard 2 is Copyright 1993-94 by Nicolas FRANCK - All Rights Reserved
  19.  
  20. Pro-Wizard-2 is a SHAREWARE program ! The unregistered version is freely
  21. distributable on condition that all files mentioned in the DISTRIBUTION
  22. are copied with the main program.
  23. No modification must be done at all !! (Program and docs)
  24.  
  25. PD Collectors like Fred Fish are allowed to include the unregistered
  26. version of Pro-Wizard 2 in their library, under the same conditions.
  27.  
  28. If you use regularly Pro-Wizard 2, I invite you to register yourself.
  29. You only have to fill the "registration form" (that should be in the
  30. 'Docs/' directory) and to send your donation of at least :
  31.  
  32.                   50 Francs  /  15$ US  /  20 DM
  33.  
  34. to the address mentioned in the "About" requester in the program,
  35. or mentioned in the registration form itself...
  36.  
  37. Then, you'll become a registered user of Pro-Wizard, and you'll receive
  38. your OWN version, without these boring requesters.
  39. You'll also receive some "bonus" files as some special modules to be
  40. converted etc...
  41. And finally, the update versions will be available for free !
  42. You will only have to send me a disk with an envelope (with your address on
  43. and auto-stamped), so you'll receive each new update !
  44.  
  45.  
  46.  
  47. *----------------------*
  48. *---> Requirements <---*
  49. *----------------------*
  50.  
  51. The only thing Pro-Wizard 2 needs is the Kickstart 2.04 (V37) or above !
  52.  
  53. Except that, it works on every Amiga model, all configurations,
  54. hard-disk or not etc.... but it is recommanded to have a "minimum" of
  55. Free-Memory to be able to load the files to be scanned and a hard-disk
  56. is welcome too ! :-)
  57.  
  58.  
  59.  
  60. *------------------------*
  61. *--->  Introduction  <---*
  62. *------------------------*
  63.  
  64. Pro-Wizard is a multi-converter for music modules packed with
  65. tools like NoisePacker, Promizer, ProPacker, ProRunner and so on....
  66. (you'll find the list of all known formats below).
  67. Of course, it converts these formats into our good oldy PROTRACKER format!
  68.  
  69. Moreover, regarding to a tool like Delitracker, it's better to convert
  70. packed modules into Protracker format, so that Delitracker plays'em
  71. in the correct way.... Coz with each Deliplayer, sometimes, some functions
  72. are very bad written and some effects are not handled etc...
  73.  
  74.  
  75.  
  76. *-------------------------------------------*
  77. *--->  What's new in this version 2 ??  <---*
  78. *-------------------------------------------*
  79.  
  80. Pro-Wizard 2 runs in a totally different way than the versions 1.x.
  81. Now, it opens its own screen, screen that you can choose at the beginning.
  82.  
  83. There is a nice Graphic User Interface, which reacts on mouse-events,
  84. gadgets, menus select and some shortcuts ! User-friendly or what ?? :-)
  85.  
  86. If you're used to work with the versions 1.x of Pro-Wizard, you must
  87. remember that you could only load ONE file at a time !?
  88. Boring, no ?
  89. Moreover, Pro-Wizard was only able to recognize modules at the BEGINNING
  90. of each file...
  91.  
  92. Now, these two problems have disappeared !!
  93.  
  94. Pro-Wizard 2 offers now :
  95.  
  96. - MULTISELECT ! In the loading requester, you can now select more than one
  97.                 file, with the "ALL" gadget or by using the SHIFT key and
  98.                 picking all the files you want !
  99.  
  100.        Pro-Wizard will switch to "multi-files" mode, where all is automatic!
  101.        You'll only be asked for a Destination-Directory in which Pro-Wiz
  102.        will save all found and converted modules.
  103.        All operations will be done automatically, you'll have nothing to do
  104.        except follow the operations till all files are handled...
  105.        Then a big recapitulation window will open, with the converting
  106.        statistics, all formats and the number of converted modules for each.
  107.  
  108.        Of course, you can still choose only ONE file, so Pro-Wizard will
  109.        run as in the versions 1.x, with all the requesters (confirm,
  110.        enter the composer name, the saving name etc...)
  111.  
  112.  
  113. - FILE-RIPPER !! Yeah ! Now Pro-Wizard scans for modules in WHOLE FILES !!
  114.                  Not only at the beginning !
  115.  
  116.        Here are two examples of using :
  117.  
  118.        - You receive lots of little "one-file-demos", intros...
  119.          You only have to decrunch'em (with DLD 2.0) and then, you load
  120.          all these files in Pro-Wizard 2 which will scan all over your
  121.          files to find modules !   Remember to use "ALL" !!
  122.  
  123.        - You own an Action Replay or so ?? Fine ! When you freeze a demo,
  124.          no need to look for the packed module yourself : just save ALL
  125.          your CHIP-RAM in a file, and load it in Pro-Wizard 2 !!
  126.          Essential or what ??? ;-))
  127.  
  128. Thanks to these 2 options, rip'n'convert is very easy, fast, and coooool !
  129.  
  130.  
  131. As well as these 2 new functions, here follow other great new features :
  132.  
  133. - XPK support.
  134.  
  135. - Iconify function. A little window opens on the Workbench screen.
  136.           Close it to uniconify !
  137.  
  138. - New formats : 12 new ones ! See the complete list below...
  139.  
  140. - Original format name inserted in the DOS_Comment. No need to edit the
  141.           module to know which format it comes from.
  142.  
  143. - Modules which already have an own name will be saved back with this name,
  144.           not the filename (KRIS, UNIC, LAXITY, EUREKA....)
  145.  
  146. - In "multi-files" mode, when saving a module which name is identical to
  147.           an already saved module, an underscore is added at the end of
  148.           the filename to avoid deleting the first one... and so on...
  149.  
  150. - In "one-file" mode, when Pro-Wizard finds a module, as well as the two
  151.           buttons "Convert or Abort", there is a new button : VIEW
  152.           which allowes you to have a look at the beginning of the module
  153.           AND a "model" of a module from the same format, in order to
  154.           compare DIRECTLY the two headings !
  155.           It's very useful to be sure of what you gonna do...
  156.           Coz if you confirm conversion for a WRONG module, be sure that
  157.           a GURU will follow !    In this case, please, send me the file
  158.           for hot debugging :-)
  159.  
  160. - Finally, there is another great improvement :
  161.  
  162.           The Graphic User Interface !
  163.  
  164.           Using gadtools.library of course (besides, I thank a lot the
  165.           authors of Delitracker, for their help concerning some basic
  166.           gadtools routines ! Thanx Peter & Frank !).
  167.  
  168.           This GUI may be used with gadgets, menus, shortcuts...
  169.  
  170.           You can enable/disable each format you want, in order to speed up
  171.           scanning. (If you know what kind of format you gonna rip, 
  172.           disable all the others !) Of course, there is a way to enable or
  173.           disable ALL the formats together !
  174.           You can also change the palette of the screen, and the screen mode
  175.           depth, size, autoscroll...
  176.           Of course, you can save these PREFERENCES !
  177.           (saved in 'Pro-Wizard.prefs' in your 'S:' directory)
  178.  
  179.           While scanning a file, you can abort all the work or just skip
  180.           the actual file, to scan the next ones.
  181.  
  182. Besides, concerning the conversion routines, I only have to mention that
  183. the Noise/Star/Protracker modules are also recognized, and are just saved
  184. back (no conversion needed for these formats).
  185. All the check-routines have been improved and improved, to avoid wrong
  186. recognitions !
  187.  
  188. I thank specially   - Mexican Boy -   for his great Beta-Testing !!
  189.  
  190. Otherwise, the version-1 bugs have been fixed, like the P50A recognition
  191. bug when similar samples were used in a module...
  192.  
  193.  
  194.  
  195. *------------------------*
  196. *--->  Installation  <---*
  197. *------------------------*
  198.  
  199. Pro-Wizard 2 is very easy to install, here what you have to do :
  200.  
  201. - Copy all the files in 'Libs/' in Y