home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 519b.lha / ZSound_v1.20 / ZSound1.20.TXT.pp / ZSound1.20.TXT
Encoding:
Text File  |  1991-06-09  |  33.3 KB  |  747 lines
  1.  
  2.                                   "Z Sound"
  3.                               User Documentation
  4.  
  5.                                  ###########
  6.                                  #/       /#
  7.                                  ####/   /##
  8.                                  ###/   /###
  9.                                  ##/   /####
  10.                                  #/       /#
  11.                                  ########### tm
  12.  
  13.                             Applies to ZSound 1.20
  14.  
  15.                       Conceived, designed, written and
  16.                      Copyright © 1991 by Gregg M. Giles
  17.  
  18.  
  19.                                  05.21.1991
  20.  
  21.  
  22.  
  23.  
  24. ***************************************************************************
  25. *** Purpose                                                             ***
  26. ***************************************************************************
  27.  
  28. ZSound enables you to play any SoundTracker (15 and 31 instruments) and
  29. NoiseTracker music modules. It can be used as a stand-alone module player,
  30. or it can be used as part of a larger multimedia presentation. It was
  31. designed to be flexible and polite. It will not hog your memory, and can
  32. be customized in many different ways to conform to your needs and hardware.
  33.  
  34. For a complete list of improvements since the last version of this program,
  35. see the section "Revisions & Planned Enhancements".
  36.  
  37.  
  38.  
  39. ***************************************************************************
  40. *** Features                                                            ***
  41. ***************************************************************************
  42.  
  43. ZSound has been designed with two major intents:
  44.  
  45.       (1) To be a stand-alone music player
  46.       (2) To be usable as part of an larger multimedia presentation
  47.  
  48.  
  49. In either of these endeavors, ZSound can provide the following options:
  50.  
  51.    * Plays SoundTracker (15 and 31 instrument) and NoiseTracker music
  52.      modules.
  53.  
  54.    * Works in a multitasking environment.
  55.  
  56.    * Works on systems with limited memory. (This program has successfully
  57.      played a 410k SoundTracker module on an Amiga with only 512k of Chip
  58.      memory and no Fast memory. Not even Module Master 1.7 can do that!)
  59.  
  60.    * Works with the original Amiga custom chip set.
  61.  
  62.    * Written to conform to Commodore's programming guidelines, so it
  63.      will work on all Amigas all the time.
  64.  
  65.  
  66. As a stand-alone music player, this program has the following specialized
  67. features and capabilities (using the window environment):
  68.  
  69.    * An optional user-selectable full featured window display, complete
  70.      with control panel gadgets which give you control of the module being
  71.      played. Gadgets include: Play, Pause, Stop, Loop, Speed, and Filter.
  72.  
  73.    * An LED-like display panel that show what the status of the player is,
  74.      as well as what settings are currently being used. Display information
  75.      includes player status, filter status, playback speed, and song
  76.      looping status.
  77.  
  78.    * Switch between NTSC (North American) and PAL (European) playback
  79.      speeds on the fly.
  80.  
  81.    * Toggle the audio high frequency filter on and off on the fly.
  82.  
  83.    * Standard Amiga window gadgets allow depth selection and window closing.
  84.  
  85.  
  86. The Amiga is a presentation and multimedia computer, and this program can
  87. help you with such presentations. The things which make this program ideal
  88. for such a purpose are (using the CLI/Shell options):
  89.  
  90.    * Usable with AmigaVision.
  91.  
  92.    * Run as a background task to provide slideshow and presentation music.
  93.  
  94.    * Will not bog down the CPU when used to provide background music. This
  95.      frees up your system for the actual presentation.
  96.  
  97.    * Option to shut off any window or text screen output.
  98.  
  99.    * Option to toggle the high frequency audio filter on and off.
  100.  
  101.    * Option to specify whether or not the song should be played
  102.      continuously (looping).
  103.  
  104.    * Option to specify playback speed: NTSC or PAL.
  105.  
  106.    * Can be run from an AmigaDOS script. Error codes are returned by the
  107.      program, enabling you to plan ahead for any unpleasant suprises when
  108.      you need them the least.
  109.  
  110.  
  111.  
  112. ***************************************************************************
  113. *** Requirements                                                        ***
  114. ***************************************************************************
  115.  
  116. In order to use ZSound, you must have the following:
  117.  
  118.    * An Amiga computer
  119.    * Workbench 1.3
  120.    * The ZSound executable file (supplied)
  121.    * Module.library file (supplied)
  122.    * At least one SoundTracker or NoiseTracker music module (not supplied)
  123.  
  124.  
  125.  
  126. ***************************************************************************
  127. *** Installation                                                        ***
  128. ***************************************************************************
  129.  
  130. Before this program can be used at all, it is imperative that you place the
  131. included file "Module.Library" into your "libs" directory on your Workbench
  132. disk. To do this on any Amiga system, issue the following command:
  133.  
  134.    1> copy module.library libs:
  135.  
  136. And press return. Users with one disk drive may be prompted to insert their
  137. Workbench disk and switch the write protect tab on the disk. Please do so,
  138. or the "module.library" cannot be installed. Hard disk users should have no
  139. trouble with the above setup.
  140.  
  141. If you would like to add this program and its documentation to your
  142. Workbench disk, issue the next command and press return:
  143.  
  144.    1> copy ZSound#? c:
  145.  
  146. Again, single drive users may be prompted to insert their Workbench disk
  147. and switch its write protect tab. The program is now properly installed.
  148.  
  149.  
  150.  
  151. ***************************************************************************
  152. *** Usage                                                               ***
  153. ***************************************************************************
  154.  
  155. ZSound is not currently executable from the Workbench, so it must be used
  156. from the Amiga Command Line Interface (CLI) or a Shell window. The usage
  157. for this program is:
  158.  
  159.        ZSound [<Module Name>] [NTSC|PAL] [Loop|NoLoop] [FilterToggle]
  160.               [NoText] [NoWindow] [Debug]
  161.  
  162. You can have this same information displayed at any time simply by running
  163. the program with no arguments.
  164.  
  165. The argument [<Module Name>] can be the name of any valid SoundTracker or
  166. NoiseTracker music module. (Full drive/paths may be used as part of a
  167. module name. For more information, see the "Usage Examples" section.)
  168.  
  169. SoundTracker and NoiseTracker modules are generally identifiable by the
  170. prefix "MOD." or suffix ".MOD". If you are unsure whether a file is a
  171. module or not, try and play it with this program anyway. If it is not a
  172. module, you will be told so, and if it is a module, it will be loaded into
  173. memory.
  174.  
  175.  
  176.  
  177. ***************************************************************************
  178. *** Command Line Flags                                                  ***
  179. ***************************************************************************
  180.  
  181. The program makes use of command line "flags", also known as command line
  182. "arguments", which will greatly enhance the program's utility and power.
  183. The way which a SoundTracker module is played may be modified to suite
  184. your tastes or needs. Flags are not case sensitive, but must be spelled
  185. correctly to be understood by the program.
  186.  
  187. The current flags available are:
  188.  
  189. Flag Name  : NTSC
  190. Description: Enables playback of the module using the NTSC (National
  191.              Television Standards Committee) refresh speed of 60 Hz. This
  192.              option should be used by those in North America. The default
  193.              speed is NTSC. (To those using a PAL Amiga, using the NTSC
  194.              flag will have the effect of speeding up the playback speed
  195.              of a module.)
  196.  
  197. Flag Name  : PAL
  198. Description: Enables playback of the module using the PAL (Phase
  199.              Alternation Line) refresh speed of 50 Hz. This option should
  200.              be used by those in Europe and outside of North America. (To
  201.              those using an NTSC Amiga, using the PAL flag will have the
  202.              effect of slowing down the playback speed of a module.)
  203.  
  204. Flag Name  : LOOP
  205. Description: Enables the program to play the module continuosly and without
  206.              any interruption (that is, once the end of the song is reached,
  207.              playing will resume at the beginning of the song). When this
  208.              flag is used from the CLI in conjunction with the NOWINDOW
  209.              flag, the module will play forever and cannot be stopped (this
  210.              is intentional, as it permits modules to be looped continuously
  211.              as background music during a presentation).
  212.  
  213. Flag Name  : NOLOOP
  214. Description: Restricts the program to playing the module one time only. Once
  215.              the end of the song is reached, it will not be played again.
  216.  
  217. Flag Name  : FILTERTOGGLE
  218. Description: Will check the current state of the Amiga high frequency
  219.              audio filter and will change its state. This filter will
  220.              enable higher-frequency sounds to be played audibly by the
  221.              Amiga when turned off. When turned on, the filter will tone
  222.              down high-frequency sounds (ie: high pitch notes), and all
  223.              music sounds somewhat quieter. The high-frequency audio filter
  224.              is said to be "off" when the Amiga Power LED is either dimmed
  225.              or not lit at all. The filter is said be "on" when this LED
  226.              is at its brightest state.
  227.  
  228. Flag Name  : NOTEXT
  229. Description: Suppresses all normal output to the CLI. Error messages are
  230.              not suppressed, and will appear as normal if they occur.
  231.              (This flag is ideal for use in slideshows where text or
  232.              window output from any programs other than the presentation
  233.              program will just get in the way.) [This flag was previously
  234.              known as QUIET in versions 1.00 through 1.10 of this program.]
  235.  
  236. Flag Name  : NOWINDOW
  237. Description: Forbids the opening of the program's output window, and also
  238.              supresses all text output which would normally appear in the
  239.              window. (This flag is ideal for use in slideshows where
  240.              text or window output from any programs other than the
  241.              presentation program will just get in the way.)
  242.  
  243. Flag Name  : DEBUG
  244. Description: Used for debugging purposes only. The program will generate
  245.              information helpful for tracking down errors and ensuring
  246.              that the program works properly during debugging. This flag
  247.              has no use for the end-user and is intended for the author's
  248.              convenience only.
  249.  
  250.  
  251.  
  252. ***************************************************************************
  253. *** Default Settings                                                    ***
  254. ***************************************************************************
  255.  
  256. This program maintains a built-in list of default flag settings. What this
  257. means is that the program will use these settings when the program is run,
  258. unless the user tells the program to do otherwise. A user may modify one or
  259. more of these settings (without disturbing any other settings) by using
  260. command line flags.
  261.  
  262. The built-in default settings are:
  263.  
  264.             Feature                 Default     Change setting by
  265.             description:            setting:    using this flag:
  266.             -----------------------------------------------------
  267.             Playback speed          NTSC        NTSC or PAL
  268.             Audio filter toggle     OFF         FilterToggle
  269.             CLI/Shell text output   ON          NoText
  270.             Window output           ON          NoWindow
  271.             Module looping          OFF         Loop or NoLoop
  272.             Debugging information   OFF         Debug
  273.  
  274.  
  275.  
  276. ***************************************************************************
  277. *** Debugging                                                           ***
  278. ***************************************************************************
  279.  
  280. As mentioned earlier, the Debug flag is intended primarily for the use of
  281. the programmer, and it does nothing more than display internal settings,
  282. flags, and status messages. The typical user will have no use for Debug.
  283.  
  284. The arguments displayed are shown in formatted columns, as are the internal
  285. program flags. Note that any redirection command line argument will not
  286. appear as an argument when using the Debug flag; this occurs because the
  287. redirection argument is intercepted by AmigaDOS before the program ever
  288. receives it. As such, the following example may actually have five
  289. arguments when issued in the command line, but when the program receives
  290. it (after intercepted by AmigaDOS), it actually only has four:
  291.  
  292.    Issued in the command line:
  293.    1> ZSound >RAM:TEXT Mod.Twin_Peaks FilterToggle Debug
  294.  
  295.    Program receives the arguments as:
  296.    1> ZSound Mod.Twin_Peaks FilterToggle Debug
  297.  
  298.  
  299.  
  300. ***************************************************************************
  301. *** Usage Examples                                                      ***
  302. ***************************************************************************
  303.  
  304. The following examples are provided to help you make better understand the
  305. features of this program. All examples assume that you possess a
  306. SoundTracker music module called "Mod.Twin_Peaks". (This module is not
  307. provided with the distibution archive of this program, and is used as an
  308. example only. However, you may substitute the name of any module in its
  309. place to yield identical results.)
  310.  
  311. Example: Load a module.
  312. Command: ZSound Mod.Twin_Peaks
  313. Notes  : This example assumes that the module is in your current directory.
  314.          Since no command line arguments are supplied, the program will
  315.          automatically revert to using its built-in default settings.)
  316.  
  317. Example: Load a module located in a different directory.
  318. Command: ZSound Music/Mod.Twin_Peaks
  319. Notes  : This example assumes that the module is in a subdirectory called
  320.          "Music". It is not necessary to change you current directory in
  321.          order to load a module located in a different directory. In fact,
  322.          the module need not even be on the same disk.
  323.  
  324. Example: Load a module located on a different disk.
  325. Command: ZSound DF1:Music/Mod.Twin_Peaks
  326. Notes  : This example assumes that the module is on a disk in drive DF1:,
  327.          and that it is also located within a directory called "Music" on
  328.          that same disk.
  329.  
  330. Example: Load a module located on a hard disk.
  331. Command: ZSound DH0:Music/Modules/Mod.Twin_Peaks
  332. Notes  : This example assumes you have a hard disk called "DH0:", and that
  333.          the module is located down inside of two directories (the first
  334.          being "Music", and the next down being "Modules".)
  335.  
  336. Example: Load a module using logical path names.
  337. Command: ZSound Music:Mod.Twin_Peaks
  338. Notes  : This example assumes that you have created a logical device called
  339.          "Music:", and that the module is located within that logical
  340.          device. (For more information on logical devices, refer to the
  341.          AmigaDOS manual section dealing with the command "Assign".)
  342.  
  343. Example: Load a module, use the PAL playback speed.
  344. Command: ZSound Mod.Twin_Peaks PAL
  345. Notes  : This example loads a module in the current directory, and changes
  346.          the program's playback speed to PAL. (Refer to the section "Command
  347.          Line Flags" under the flag "PAL".)
  348.  
  349. Example: Load a module, toggle the high frequency audio filter.
  350. Command: ZSound Mod.Twin_Peaks FilterToggle
  351. Notes  : This example loads a module in the current directory, and toggles
  352.          the high frequency audio filter. (Refer to the flag "FilterToggle"
  353.          in the section "Command Line Flags".)
  354.  
  355. Example: Load a module, but do not display an output window.
  356. Command: ZSound Mod.Twin_Peaks NoWindow
  357. Notes  : This example loads a module in the current directory and will not
  358.          open any output window. (Refer to the flag "NoWindow" in the
  359.          section "Command Line Flags".)
  360.  
  361. Example: Load a module, but do not display any text in the CLI or Shell.
  362. Command: ZSound Mod.Twin_Peaks NoText
  363. Notes  : This example loads a module in the current directory and will not
  364.          display any kind of text output in the CLI or Shell from which it
  365.          was run. (Refer to the flag "NoText" in the section "Command Line
  366.          Flags".)
  367.  
  368. Example: Load a song in a logical device, use PAL playback speed, toggle
  369.          the high frequency audio filter, and suppress both window and
  370.          text output.
  371. Command: ZSound Music:Mod.Twin_Peaks PAL FilterToggle NoText NoWindow
  372. Notes  : This example loads a module on the logical device "Music:",
  373.          changes the playback speed to PAL, toggles the audio filter, and
  374.          supresses all CLI and window output. (Refer to the flags "PAL",
  375.          "FilterToggle", "NoText" and "NoWindow" in the section "Command
  376.          Line Flags".)
  377.  
  378.  
  379.  
  380. ***************************************************************************
  381. *** Using The Control Window                                            ***
  382. ***************************************************************************
  383.  
  384. This program gives you the option of using a window to control a music
  385. module. This window will be opened by default. (To prevent the window
  386. from opening, refer to the "NoWindow" flag in the "Command Line Flags"
  387. section.)
  388.  
  389. Once opened, you are presented with a window in the middle of the screen.
  390. You will see a small horizontal bar containing some information - this is
  391. the "information display". In this small display are show the current
  392. program settings and the status of the module. When run with no flags, the
  393. information display should read:
  394.  
  395.                  +-------------------------------------+
  396.                  | Stopped  Loop Off  Toggle Off  NTSC |
  397.                  +-------------------------------------+
  398.                       ^        ^           ^       ^
  399.                       |        |           |       |
  400.     Module status ----+        |           |       +---- Playback speed
  401.                                |           |
  402.                Loop status ----+           +---- Filter toggle status
  403.  
  404. The "Module status" may say any of the following possible things:
  405.  
  406.    Status:     Meaning:
  407.    -----------------------------------------------------------------
  408.    Loading     The song specified is being loaded into memory
  409.    Playing     The song which was loaded is currently being played
  410.    Paused      The song which was played has been temporarily paused
  411.    Stopped     The song in memory is not currently playing or paused
  412.  
  413. The "Loop status" can be either "On" or "Off". When "On", the song will
  414. loop continuously until paused, stopped, or until the program is stopped
  415. by clicking on the close window gadget.
  416.  
  417. The "Filter toggle status" can be either "On" or "Off". When "On", the
  418. high frequency audio filter has been toggled. When "Off", it has not been
  419. toggled.
  420.  
  421. The "Playback speed" can be either "NTSC" or "PAL". When "NTSC", then the
  422. song is being played at a speed of 60 Hz (NTSC). When "PAL", then the song
  423. is being played at a speed of 50 Hz. (See the flags "NTSC" and "PAL" in
  424. the section "Command Line Flags" for more information on playback speeds.)
  425.  
  426. The grouping of gadgets below the information display is known as the
  427. "control panel". It is with this control panel that you are able to make
  428. the song pause, play, stop, and change any of the previously mentioned
  429. information shown in the "information display". The gadgets are (from left
  430. to right):
  431.  
  432. Gadget     : Pause
  433. Description: Two side-by-side vertical rectangles
  434. Purpose    : Pauses the module being played
  435.  
  436. Gadget     : Play
  437. Description: Triangle with its right-angle point facing right
  438. Purpose    : Plays the module in memory
  439.  
  440. Gadget     : Stop
  441. Description: Square
  442. Purpose    : Stops playing the module being played or paused
  443.  
  444. Gadget     : Loop
  445. Description: Arrow pointing to its own tail
  446. Purpose    : Plays the song in memory continuously until stopped or paused
  447.  
  448. Gadget     : Speed
  449. Description: Speedometer
  450. Purpose    : Toggles playback speed between NTSC and PAL
  451.  
  452. Gadget     : Filter
  453. Description: Lightbulb
  454. Purpose    : Toggles the high frequency audio filter on and off
  455.  
  456. The window also has the standard Amiga close-window gadget which will, when
  457. clicked, stop playing the song in memory immediately and stop the program.
  458. The standard Amiga window-depth gadgets are also present, which permit the
  459. window to be pushed to the back of the Workbench screen or brought to the
  460. front of it.
  461.  
  462.  
  463.  
  464. ***************************************************************************
  465. *** Multitasking                                                        ***
  466. ***************************************************************************
  467.  
  468. To make this program multitask, it is necessary to use the AmigaDOS "Run"
  469. command (not supplied with this program). As an example, if you desire to
  470. run some music in the background:
  471.  
  472.    1> run ZSound Mod.Twin_Peaks
  473.  
  474. While this song is playing, you will retain full control of your Amiga.
  475.  
  476.  
  477.  
  478. ***************************************************************************
  479. *** Output Redirection                                                  ***
  480. ***************************************************************************
  481.  
  482. The text output generated by this program can be redirected into a text
  483. file or to a printer. This does not include any text which appears within
  484. the program's window, only text which is displayed within the CLI window
  485. which the program was run from. This may be of limited use, but it is
  486. possible.
  487.  
  488. To redirect the text output of the program to a text file, use the
  489. following format (any combination of flags may be used):
  490.  
  491.    1> ZSound >TextFile.txt Mod.Twin_Peaks
  492.  
  493. Or even:
  494.  
  495.    1> run ZSound >TextFile.txt Mod.Twin_Peaks
  496.  
  497. Redirecting text output to a printer is just as simple (example makes
  498. use of the debugging flag):
  499.  
  500.    1> ZSound >PRT: Mod.Twin_Peaks Debug
  501.  
  502.  
  503.  
  504. ***************************************************************************
  505. *** Script File Usage                                                   ***
  506. ***************************************************************************
  507.  
  508. This program can also be used within an AmigaDOS script file. Return codes
  509. have been provided to accomodate the AmigaDOS "FailAt" and "Quit" commands.
  510. The following are all possible return codes which can be issued:
  511.  
  512.     0: No errors occured.
  513.     5: A non-fatal error occured (warning only); built-in defaults and
  514.        error checking automatically resolved the problem. An error
  515.        message will appear telling you exactly what happened and how the
  516.        problem was resolved. Be sure to contact the author in the event
  517.        of such an error.
  518.    20: Fatal error. Something occured which prevented the program from
  519.        working properly; the program will display a more explanatory
  520.        error message to tell you exactly what went wrong.
  521.  
  522. An example script file using this program is as follows:
  523.  
  524.    failat 20
  525.    run ZSound Music:Mod.TwinPeaks FilterToggle NoWindow NoText
  526.    type Texts:Credits.TXT
  527.  
  528. The script file will cease execution immediately whenever any command or
  529. program returns a returncode value of 20 or more. The music is run as a
  530. background task, and a text file is immediately typed to the screen with
  531. the AmigaDOS "Type" command.
  532.  
  533. For more information on AmigaDOS script files, refer to your Amiga manual.
  534.  
  535.  
  536.  
  537. ***************************************************************************
  538. *** Troubleshooting                                                     ***
  539. ***************************************************************************
  540.  
  541. It is possible that you will encounter an error in some form or another
  542. during your use of this program. All error messages generated by the
  543. program are listed and explained below.
  544.  
  545. Message    : "Error: can't open Intuition.library."
  546. Explanation: The program was unable to access and use a part of the Amiga
  547.              Kickstart ROM chip. This function, the Intuition.library,
  548.              enables the use of a windowing environment on the Amiga.
  549. What to do : This is a hardware problem. Reset your machine after you have
  550.              stopped all other processes and try to run the program again.
  551.              If this does not work, contact your Amiga dealer or an
  552.              authorized repair center for help.
  553.  
  554. Message    : "Error: can't open Module.library."
  555. Explanation: The program cannot open the file "Module.library", which it
  556.              needs in order to play any SoundTracker or NoiseTracker music
  557.              modules.
  558. What to do : Copy the file "module.library" into your LIBS: directory. If
  559.              you do not have this file, check the original distribution
  560.              archive which contained this program. If it is not there,
  561.              contact the author in order to obtain a copy of this library.
  562.  
  563. Message    : "Error: can't open main window."
  564. Explanation: The program was unable to open a window which it uses for
  565.              data output.
  566. What to do : Ensure that you are using a screen resolution of 640 wide or
  567.              greater (any screen height is acceptable). The program assumes
  568.              that you are using a screen resolution of 640x200 (the number
  569.              of colors is inconsequential). It is also possible that your
  570.              Amiga may not have enough available memory in order to open
  571.              the program's window - in this case, stop other processes
  572.              which are running and run this program again.
  573.  
  574. Message    : "Error: can't put device lock on <ModuleName>."
  575. Explanation: The program could not properly access the SoundTracker/
  576.              NoiseTracker module your specified. The program attempts to
  577.              put a "file lock" on the module before it attempts to load it
  578.              into memory or play it. (This is done to accomodate
  579.              multitasking situations where another application tries to
  580.              access the same module you are trying to load.)
  581. What to do : Check to make sure that you spelled the name of the module
  582.              correctly. If you did, you are experiencing some kind of
  583.              multitasking conflict that the Amiga operating system cannot
  584.              handle (which is rare).
  585.  
  586. Message    : "Error: can't load <ModuleName>."
  587. Explanation: The program cannot find or load the module specified in the
  588.              location it looked for it at.
  589. What to do : Ensure the module exists. It may be necessary to provide a
  590.              full path/name for the module. (See the Usage Examples
  591.              section of this documentation).
  592.  
  593. Message    : "Error: out of memory."
  594. Explanation: Your Amiga has run out of memory, and cannot sucessfully
  595.              run the program or module.
  596. What to do : Add more memory to your Amiga.
  597.  
  598. Message    : "Error: <ModuleName> isn't a SoundTracker or NoiseTracker
  599.               module."
  600. Explanation: The program tried to load the file it was told to load, but
  601.              it was not a SoundTracker or NoiseTracker module file.
  602. What to do : As there are variations of the SoundTracker and NoiseTracker
  603.              module formats, it is possible that you have tried to load a
  604.              module which this program does not yet support. If this is
  605.              the case, contact the author immediately (include a copy of
  606.              the module which would not play so it can be examined) so
  607.              that the program may be upgraded to play the module type.
  608.  
  609. Message    : "Error: can't determine playback speed; using NTSC."
  610. Explanation: The program experienced difficulty in determining what
  611.              playback speed to use - NTSC or PAL. The program will
  612.              automatically default to using NTSC.
  613. What to do : Nothing. This problem will take care of itself. If this error
  614.              reoccurs oftens, contact the author immediately (include a
  615.              note explaining the problem) so that the program may be
  616.              upgraded to solve the problem.
  617.  
  618. Message    : "Error: can't determine filter toggle; won't toggle."
  619. Explanation: The program experience difficulty in determining whether or
  620.              not to toggle the state of the high frequency audio filter
  621.              (ie: dim or brighten the Amiga "Power" LED). The program will
  622.              automatically default to no toggle.
  623. What to do : Nothing. This problem will take care of itself. If this error
  624.              reoccurs oftens, contact the author immediately (include a
  625.              note explaining the problem) so that the program may be
  626.              upgraded to solve the problem.
  627.  
  628.  
  629.  
  630. ***************************************************************************
  631. *** Program Integrity & Bugs                                            ***
  632. ***************************************************************************
  633.  
  634. It is the author's goal to keep this program as stable, correct, and as
  635. bug-free as possible. For this reason it employs careful error checking
  636. techniques, particularly when dealing with locks and memory. Everything
  637. which is opened is closed, even when errors occur. As an Amiga user
  638. himself, the author loves cleanly written programs, particularly those
  639. that don't suck up system resources when they screw up.
  640.  
  641. This program has its own built-in error messages, and all are largely
  642. self-explanitory. These error messages generally only appear when the
  643. user has done something incorrectly.
  644.  
  645. However, should you discover any bugs in this program, please record them
  646. and contact me immediately so that they may be corrected and the fixed
  647. version of the program released.
  648.  
  649.  
  650.  
  651. ***************************************************************************
  652. *** Program Background                                                  ***
  653. ***************************************************************************
  654.  
  655. Having spent alot of time dealing with Amiga music (mainly listening to it)
  656. and creating an occassional slideshow, it's always been my desire to use
  657. quality music. To date, SoundTracker modules provide the best quality music
  658. I've heard on the Amiga. However, I've always had to work with players
  659. written by others which never seemed to do exactly what I needed them to
  660. do.
  661.  
  662. ZSound is an effort in this direction, and will become a central part to
  663. bringing quality music to my future slideshows.
  664.  
  665.  
  666.  
  667. ***************************************************************************
  668. *** Revisions & Planned Enhancements                                    ***
  669. ***************************************************************************
  670.  
  671. The following changes have been made to this program since the previous
  672. version:
  673.  
  674. * Output window: gadgets added to make the program truly interactive
  675.   (Pause, Play, Stop, Loop, Speed, and Filter). Aesthetic changes also
  676.   made.
  677. * Command line arguments: no longer case sensitive. "Quiet" flag has been
  678.   renamed "NoText" (makes flag names easier to remember - the function
  679.   remains the same). New "Loop" and "NoLoop" flags added.
  680. * Text output: Debugging information now formatted and cleaner looking.
  681.   More likely to fit on a single screen than before.
  682. * Code enhancements: Main window opening code and some loop counting code
  683.   rewritten. Improved argument interpretation routine - it's shorter,
  684.   smarter, and faster than before. Alot of new error checking added,
  685.   particularly when dealing with Intuition.
  686.  
  687. Known bugs in this version:
  688. * Contrary to the author's quaint article on how he likes programs that
  689.   don't suck up system resources when they screw up, it's been discovered
  690.   that this program does just that: after execution, the program will chew
  691.   up approximately 100 bytes to 1 kilobyte of FAST RAM. (Interestingly, this
  692.   bug does not effect CHIP RAM at all.) This also prevents the program
  693.   from being able to be completely detached from the launching CLI/Shell.
  694.   The problem is being tracked down. (It's only fair that users of this
  695.   program know of its flaws as well as its benfits.)
  696.  
  697. Planned Enhancements:
  698. * Wildcards, including the AmigaDOS wildcard combination (#?) and the
  699.   well-liked asterisk (*) familiar to UNIX, MS-DOS, and Amiga ARP users.
  700. * User flag to allow play-time length.
  701. * ARexx support.
  702.  
  703.  
  704.  
  705. ***************************************************************************
  706. *** Legalese                                                            ***
  707. ***************************************************************************
  708.  
  709.    This program is public domain and may be copied and distributed freely
  710.    without the consent of the author for non-commerical purposes where no
  711.    charge is made for the copying or distribution of this program.
  712.  
  713.    Commerical sale, duplication, and distribution of this program is
  714.    forbidden without the consent of the author.
  715.  
  716.    Fred Fish and Amiga Atlanta, Inc. are entitled to include this program
  717.    in their public domain collections as a thank-you for all of the work
  718.    they have done to promote the Amiga and provide scum like us with
  719.    decent public domain software. Screw (PKWare).
  720.  
  721.    Module.library (Release 1.0, March 18th, 1991) was written by Peter S.
  722.    Martson, and is freely distributable.
  723.  
  724.  
  725.  
  726. ***************************************************************************
  727. *** Contacting The Author                                               ***
  728. ***************************************************************************
  729.  
  730. To contact the author of this program, use any of the following addresses:
  731.  
  732. US Mail Address  : Gregg Giles
  733.                    2275 Gray Highway N-10
  734.                    Macon, Georgia 31211-1029, USA
  735. Voice Mail Box   : 912-742-0019
  736. FidoNet NetMail  : 1:3611/11 as "Gregg Giles" (Amigalectric BBS)
  737. Amigalectric BBS : 912-922-5655, 14.4 kbps as "Gregg Giles"
  738. Mercer University: BearNet.CompSc (VAX) as "giles_g"
  739.                    tess.uucp as "giles"
  740.                    Prime System A as "cscmajch"
  741.                    University Campus Mail at Box 662
  742.  
  743. Donations and contributions will be accepted, but are not demanded. Source
  744. code is not provided in this archive as a matter of policy. Please contact
  745. me if you would like to obtain a complete copy of it.
  746.  
  747. *EOF*