home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Exec 5 / CD_Magazyn_EXEC_nr_5.iso / Programy / Muzyczne / MMV8_Disk_2.lha / READ.ME < prev    next >
Text File  |  1994-04-25  |  13KB  |  270 lines
  1.  
  2.  MusicMaker Manual Addendum
  3.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  4.  
  5.  Last Minute Changes:
  6.  
  7.  -) WAV and VOC file support added. Now MusicMaker can load and save these
  8.     formats common to the world of PCs. However, using these on the AMIGA
  9.     for storing is not recommended: Files namely do not feature LOOP
  10.     information, so s(h)aving a sample in either of these formats causes
  11.     loss of LOOP facility.
  12.     WAV 16-bit files are automatically converted to 8 bit.
  13.     VOC files created by MediaVision®'s "recfile" program made obvious that
  14.     VOC happens to be a quite "loose" standard. ["Pack byte" in stereo
  15.     samples set to 0x05 - according to official documents, the only way
  16.     to declare a sample as stereo is using the "extension block" (0x08).
  17.     However, 0x05 is accepted as a special case.]  - Using NEW values for
  18.     DECLARED positions in DECLARED headers does not seem to appear like
  19.     pulling away the rug from beneath the programmers' feet to anyone
  20.     there. Changes to this "file format" in the future could make
  21.     MM to cancel VOC loading in case it senses "illegal" values - so to
  22.     speak.
  23.     VOC files in SoundBlaster® hardware compression format cannot be loaded
  24.     Including this is not worth the work; sounds like via the telephone...
  25.  
  26.  -) "@" Speed Change Effect is now enabled in EXT mode as well, BUT -
  27.     with -two- limitations: First, it allows speed INCREASES only
  28.     (such as 5/6; decreases will be ignored!) and, secondly, to force
  29.     a speed change on a distinct location, it has to be set ONE slot LEFT
  30.     of this position. Read: The player "delays" (-unvoluntarily, of
  31.     course) the effect one macro slot. Sorry for that, but the mixer program
  32.     is mindboggling enough, though.
  33.  
  34.  -) MM from now features 10 pre-assignable AREXX-scripts. These are executed
  35.     from TrEd and MacEd by pressing CTRL+F1 thru CTRL-F10. If the key's
  36.     corresponding script is unassigned, the file-requester allows
  37.     choosing.
  38.     Further, the "#" command in CM has changed its abilities a little:
  39.     "#" called without any parameter shows the list of all currently defined
  40.         REXX-scripts in ascending order from F1 to F10.
  41.     "#" called with a numerous argument (ranged from 1 to 10) only, executes
  42.         the current REXX-script represented by this number.
  43.     "#", if given a number AND a text parameter (in quotes!!!), assigns
  44.         this REXX script to this number.
  45.     "#" featuring a text parameter only, simply executes this REXX-script,
  46.         without assigning it to anything. This is the function, "#" had
  47.         so far.
  48.  
  49.     The script names are saved into the prefs file. The standard prefs file
  50.     supplied on the disk has the "UPDATE"-script assigned to CTRL-F1,
  51.     "LOADMACRO" to CTRL-F6 and "SAVEMACRO" to CTRL-F7.
  52.  
  53.  -) Instrument-Editor's "OS <play> LP" gadget changed behavior when hit
  54.     with right mouse button: Left half now plays range (as before) but
  55.     right half makes the current DISPLAY audible - new.
  56.  
  57.  -) FadeSnd()-parameter in library+link-module function changed slightly:
  58.     "Speed" now weights half, so fading takes twice the time it took
  59.     before. This was done due to very small useable range of old parameter
  60.     value.
  61.  
  62.  -) SetupCacheControl() function in mplayer module. This has been
  63.     added for handling the CPU caches on 68030 and 68040. A call
  64.     to this is only required when playing 8 channel songs, but for
  65.     absolute identity to 4 channel players, the sysplayer module,
  66.     however, also features it as a stub.
  67.     This function, as mentioned, must be called when playing an EXT
  68.     song. As parameters, it exspects the OS version (37 for Kick 2.0;
  69.     can be obtained from Execbase->LibNode.lib_Version) and the
  70.     System's AttnFlags (in ExecBase, as well). According to that,
  71.     it sets up cache handling in the player; especially the 68040's
  72.     COPYBACK mode and the larger cache are the trouble makers in here.
  73.     For more details about using this function, see all the 8-channel
  74.     source code examples supplied.
  75.     By the way: NEVER corrupt execbase when using the 8-channel player
  76.     (no matter wether library or link module) !! It obtains some
  77.     data about your system from it, so clearing exec IS harmful to
  78.     the player!!!
  79.  
  80.  V2.40 (and later) post-release changes:
  81.  
  82.  -) New library functions "MuteChannels()" and "GetMutedChannels()"
  83.     The functions do exactly what the name says, they mute one or
  84.     more channels. In D0, the routine exspects bits 0-3/0-7 to
  85.     specify which channels to be muted. A bit set means the channel
  86.     is muted. The function should be called after initialising a
  87.     song to the routines (eg. via LoadAndInit(), NewSndInit()...).
  88.     GetMutedChannels() returns the current state in D0.
  89.  
  90.  -) MusicMaker goes international: It from now supports the locale.lib
  91.     and a German catalog is supplied. However, the manual still refers
  92.     to the english version. This will not change, anyway.
  93.  
  94.  -) Additional data saved into the .sdata file. Therefore, the format
  95.     of the files slightly changed. YOU MUST USE V2.4-PLAYERS FROM NOW!
  96.     (New 2.4-EaglePlayer-players supplied on Disk #1! The versions
  97.     coming with the program do no more work correctly with V2.4
  98.     files.) MM and the new players, of course, can load all formats.
  99.     [Sorry for that inconvenience; the V2.4 players will work with all
  100.     forthcoming versions.]
  101.     New data saved includes: Oneshot-Flag; Custom-Edit setting; Songdate;
  102.     Version (just a save count); BPM-Flag. BPM means "beats per minute" and
  103.     is the new speed-format in MusicMaker. Normally speed is being shown
  104.     in the old unit (300/600-2800); Clicking the Speed:-display in
  105.     TrEd turnes the display into the new bpm format. However, the "t"-
  106.     command still only accepts the old unit.
  107.  
  108.  -) The RAM Scan function in the Instr/LFO-Editor experienced some en-
  109.     hancement: The 'Save'-gadget is now actived during the operation, so
  110.     the user is enabled to save the whole scan area or just a range
  111.     directly out of the memory without leaving the RAM scan operator.
  112.  
  113.  -) The 'Info' in TrEd features some new data.
  114.  
  115.  -) The Record/Accompany gadgets now react on a double click in the way
  116.     that they call the recorder with the previous (valid) parameters
  117.     (such as recording channel and start/stop rows) again. This can be
  118.     repeated as often as desired.
  119.  
  120.  -) Tremolo and Vibrato effect in MacEd. These are, as I guess, mostly
  121.     self explaining; One more to say here: The volume parameter specifies
  122.     the depth of the effect.
  123.  
  124.  
  125.  -) Macro-Editor is enabled to be placed on an interlaced (NTSC where
  126.     available) screen for editing all 8 macros at a time
  127.  
  128.  -) NEW FILEFORMAT: New MM features a MODULE save format (for all three
  129.     save modes: data, packed and lib-disk). I think more explanation
  130.     concerning this is not required... except that the supplied EaglePlayer
  131.     player/modules do NOT feature loading MM/Modules (yet).
  132.     Also, the libraries/players feature some new functions. Please see
  133.     developer-files for more info about these.
  134.  
  135.  Supplied utility pack
  136.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  137.  
  138.  T2MM - NoiseTracker to MusicMaker CONVERTER
  139.  ¯¯¯¯
  140.  This program converts a NoiseTracker or "compatible" (?) module or
  141.  song file into MusicMaker format. Efx not or differently supported
  142.  in either program remain untouched. Instruments are automatically
  143.  converted, in case you have a module file, otherwise T2MM creates
  144.  a LIB-DISK instrument set. Since there are many different versions 
  145.  of this so-called "standard" file format available, T2MM may a
  146.  kind of "abort" himself in some cases.
  147.  Starting version 3, T2MM is able to convert "Startrekker" 8-channel
  148.  modules. It must be an audible relief to people using this program
  149.  in 8 channel mode, now to hear it through MusicMaker.
  150.  ProTrackers $e-commands are ignored.
  151.  
  152.  
  153.  S2MM - SMUS to MusicMaker CONVERTER
  154.  ¯¯¯¯
  155.  As the name makes it easy to guess, this converts a SMUS file into
  156.  MusicMaker format.
  157.  Restrictions: Song must have been written in 4/4 beat, 4 channels
  158.  ¯¯¯¯¯¯¯¯¯¯¯¯¯ maximum.
  159.  Some SID_events remain unconverted due to incompatibility, and some
  160.  may under some very special circumstances lead into "abortion"...
  161.  Instruments cannot be converted, so S2MM shows a list from A in
  162.  asc. order. They are to be replaced by MM Instruments, since MM can't
  163.  load Sonix' or DMCS' Instruments, unless they are IFF or SONIX's ".ss"-
  164.  format.
  165.  
  166.  
  167.  O2MM - Oktalyzer to MusicMaker CONVERTER
  168.  ¯¯¯¯
  169.  Oktalyzer files are being converted including instruments. Efx mostly
  170.  remain unconverted. O2MM can handle all channel configurations.
  171.  
  172.  
  173.  Converting a song from either of the mentioned ain't a perfect thing.
  174.  Some cases, which MUST be handled by editing the song in MM are:
  175.  T2MM: $d, pattern break: T2MM works channelwise, so it sets ":" in ONE
  176.        of the 4/8 channels only. The ":" must be copied to ALL channels.
  177.        A pattern in Noisetracker represents TWO macros in MusicMaker.
  178.        If a ":" is set to halfen the length of a Tracker-pattern, you
  179.        must delete the "-P-"'s following in the tracks.
  180.  O2MM: Unusual pattern length may require insertion of ":".
  181.  
  182.  
  183.  Wurlitzer
  184.  ¯¯¯¯¯¯¯¯¯
  185.  is a small replayer-demo. It can be executed from CLI as well as from
  186.  Workbench. It opens a window of its own, containing a real bunch of
  187.  gadgets of all kinds. Don't worry about this at first!
  188.  
  189.  You can name up to 20 (on NTSC machines: 15 due lower vertical screen
  190.  resolution) songs, which are together called a "DISC". Not just by
  191.  accident this will remind you of CD. To select a song's name, you
  192.  either activate the text-gadget or the corresponding "FReq"-gadget,
  193.  which will bring up the file requester. Do this for all the songs you
  194.  intend to collect together to a disc.
  195.  A disc can be saved or loaded using these two gadgets below the control-
  196.  panel. An arrow pointing left from the depicted floppy disk means
  197.  load, and vice versa. The "ICONS" tool type controls wether or not to
  198.  save a disc workbench icon.
  199.  
  200.  The control panel to the right works like a compact disc player's
  201.  equivalent.
  202.  Keys in from left to right order work as
  203.    -) PLAY. Starts at current track.
  204.    -) STOP. Guess what.
  205.    -) FAST FORWARD
  206.    -) RESTART CURRENT TRACK. This only works if player is running.
  207.    -) PREVIOUS TRACK
  208.    -) NEXT TRACK.
  209.  In order to start at track 7, click NEXT TRACK 7 times, followed by a
  210.  click on PLAY. This is faster than clicking PLAY first and NEXT
  211.  afterwards, because this will load all songs between 1 and 7 into memory.
  212.  
  213.  The volume slider does its intended job, and "EJ" ejects the current
  214.  disc clearing all the text areas. To quit the program, click the
  215.  closing gadget.
  216.  
  217.  Playmode controls wether to play all tracks for a single time (which is
  218.  the normal setting), repeat all tracks or play a single track continously.
  219.  The latter has the following to care about: Playmode must be turned to
  220.  "Repeat Single" BEFORE the concerned song starts. While playing, changing
  221.  to "Repeat Single" has no effect. To force this mode to be used at the
  222.  current track, just RESTART it, in case it has already been loaded. Other-
  223.  wise do PLAY instead.
  224.  
  225.  Wurlitzer plays all kinds of MusicMaker songs except the ones with
  226.  LIB-DISK instrument sets. Thus not many songs supplied can be played
  227.  using Wurlitzer. Sorry about that, but I suppose you don't want to be
  228.  charged 6 MM-disks just for this feature. The LIB-DISK file format
  229.  is intended to be an "under-development"-tag; The opus should be saved
  230.  normally when complete.
  231.  
  232.  
  233.  Radio
  234.  ¯¯¯¯¯
  235.  is an even smaller demo, and plays a 4-channel (STD) song using the
  236.  mmv8.library. Returns to CLI immediatly, so RUNning it is not required.
  237.  Plays songs with packed or data-file instruments, no LIB-DISK sets.
  238.  
  239.  
  240.  8Player
  241.  ¯¯¯¯¯¯¯
  242.  same as Radio, but plays 8-channel (EXT) songs (only).
  243.  
  244.  
  245.  URadio
  246.  ¯¯¯¯¯¯
  247.  same as Radio, too, but plays both 4 and 8 channel songs. (Universal).
  248.  Differs from Radio just in library name and CPU cache handling.
  249.  
  250.  
  251.  
  252.  
  253.  All the above described programs are public domain. Permission to
  254.  use the players in own programs is given under the condition, that 
  255.  a READABLE reference to the name "MusicMaker V8" appears in the
  256.  program.
  257.  The libraries are freely distributable, but programs using any of
  258.  them also have to carry a readable reference to "MusicMaker V8".
  259.                            ¯¯¯¯¯¯¯¯
  260.  Thomas Winischhofer/Dire Crax Amiga® Software, Austria.
  261.  MusicMaker is dedicated to Jeff Porcaro+, the greatest drummer ever.
  262.  
  263. ____________________________________________________________________________
  264.  
  265. "Oktalyzer" is a trademark of MEDIA GmbH.
  266.  
  267. ----------------------------------------------------------------------------
  268.  
  269. [eof]
  270.