



                       PowerMOD for OS/2 v0.39

                    MOD music player with effects

                 Copyright 1996,1997 Antony T Curtis



Optimised for reading using                             28 August 1998
 TEDIT in 80x25 video mode
    Just hit Page Down!




Page 1

 ABOUT THIS RELEASE:
 ===================

Audio:     Interpolated audio (linear and cubic) available.
           P200 recommended for cubic interpolation.

Cosmetic:  Individual fourier displays in wave view. Also L/R display.

Other:     Misc GPI bug fixes.




DISCLAIMER:
===========
        THIS SOFTWARE HAS ABSOLUTELY NO WARRANTY AS TO IT'S
        FITNESS FOR USE OR OTHERWISE. THIS PROGARM MAY BE A CPU HOG.
        I ACCEPT NO RESPONSIBILITY FOR ANY LOST DATA/PROFITS, BRAIN DAMAGE,
        WASTED TIME, BRUSES TO LOWER JAW AS IT HITS THE DECK, etc...
Page 2

 REQUIREMENTS:
 =============

        486dx4 100MHz
        6Mb RAM
        OS/2 Warp 3
        MMPM/2 with Audio Support
        VGA Display Adaptor
        Mouse
        Lotsa MOD files... (I only have about 250)

Recommended minimum setup:

        Pentium 90Mz
        8Mb RAM
        VLB 800x600 256 Color display
        16bit stereo soundcard
        OS/2 Warp3 (FP17+) or Warp4.

Page 3

 FEATURES:
 =========

        + Plays 4, 6 and 8 track MOD files
        + Better playlist support
        + 5 Channel modes ( Mute, Left, Middle, Right and Wide)
        + Phased Audio for headphones.
        + Real-time adjustable effects
           + Volume
           + Quality ( 100% down to about 5% )
           + Speed ( 50% up to 150% )
           + Tempo ( 50% up to 150% )
           + Echo ( up to 0.1s, variable gain )
        + Sample list (highlights active samples)
        + Spectrum Analyser (32 bands, with peek holds)
        + 8 Wave displays (4 types: Line, Solid, Wave and Dots)
           + Rainbow colour waves!
        + 6 predefined effects! ( Cave, Hall, Stadium, Tannoy, Telephone )

Page 4

 USAGE INFORMATION
 =================

There are some command line parameters which are of interest....

    -OK    Disable the startup dialog and assume previous values.
    -MIN   Start up PowerMOD in the minimised state.
    -Q     Auto quit PowerMOD when the playlist is exausted
    -DYN   Prototype dynamic priority... Milage may vary.

Usage Syntax:

    PowerMOD [-OK] [-MIN] [-Q] [-DYN] [@playlistfile] [modfile] ...

Non Obvious Keyboard Shortcuts:

"+" and "-" can be used to control the volume from the main window or playlist


Page 5

 WORDS FROM THE AUTHOR:
 ======================

This program was written over a year ago and I never got round to
releasing it - so I am doing so now. There may be bugs but as I'm
working on a completely new version, bugs found may not be fixed.
Remember - this was the first program I had ever written for OS/2
and it was first working within a month of getting a compiler for
OS/2.

The main "plusses" for this MOD player is that the effects are
adjustable in real time. It currently only uses MMPM/2 so it
should work in any multimedia OS/2 system v3 or better.
"Minuses" include that it can only handle the MOD format and
that there is currently no DART support. Also, with the latest
Creative Labs drivers the sound goes choppy - select the SBFix
option and restart PowerMOD to solve this.


Page 6


I have no fixed date for the next release - only that I'm working
on it when I have the time. I plan to support a wider range of
file formats and also extend the range of real time effects that
are available. Also, the user interface may be quite different.

Just for the curious out there, this program was written using
fPrint's Virtual Pascal compiler and consists of only 7300+ lines
of Pascal source code. The only bit not written in Pascal is the
Discrete Fourier Transform code which is written in assembler.
The next version should be using the Fast Fourier Transform %^)

Thanks go to Chris Wormuth, who informs me that PowerMOD is a tad
slow on his 75MHz 486. So, anything higher should be fine.
PowerMOD 2 should correct some performance problems. It is in the
works, but I simply don't have very much time. My university finals
are very soon - that must take priority. Wish me luck.


Page 7

 CONTACT INFORMATION:
 ====================

        Antony T Curtis

email:  antony.curtis@olcs.net (preferred)

web:    http://nuts.ml.org/

If you have any suggestions or comments, don't hesitate to contact me.
Many thanks for all the suggestions and complements that I have received.

What would be nice is a show of appreciation... Please send a picture postcard
of where you live to me. Many thanks.

        Antony T Curtis, 34 Little Reeves Avenue,
        Amersham, Bucks. HP7 9JB. UNITED KINGDOM.


Page 8  {$DEFINE SMILE}  (*:  Donations would be accepted  %^)  {$UNDEF SMILE}

 KNOWN PROBLEMS:
 ===============

  Stalls under high CPU load.
    Cannot be fixed due to buffer size & the use of MMPM/2. DART should fix.
    I now have some ideas on how to tackle this problem under MMPM/2...

  mWave users experience a long quitting time.
    Don't yet know why - I suspect it's something to do with mWave's drivers.
    DART should fix. Maybe fix for stalling will fix this too.

  Mixer Window never works.
    It actually worked with early beta SB16 drivers and Merlin (Warp4 beta).
    IBM changed the API - and I haven't subscribed to DevCon.
    Perhaps I'll make it so that it can execute a 3rd party mixer program.

  Sucks a lot of CPU.
    Yes. It does, doesn't it? DART will reduce CPU usage.

Page 9

 HISTORY:
 ========

Version 0.39    28 Aug 98
        Added interpolated resampling, cubic (4 point) and linear (2 point).
        Fixed some GPI code. Fourier analysis now available in wave display.

Version 0.38    12 Jul 98
        Spectrum analyser window is resizable. Non-linear audio mixing.

Version 0.37    27 Mar 98
        New styles for spectrum analyser. Various small bug fixes.
        Adjustments to DFT code, etc etc.

Version 0.36    06 Jan 98
        Cosmetic adjustments to main window.
        Fixed loading of some MOD files.
        Volume Boost available.



Version 0.35    30 Nov 97
        DFT now using Ken Turkowski's Sqrt, replacing my Babbage Sqrt.
        Several Cosmetic Adjustments... Phased Audio support.
        Auto open windows. Playlist location fix. Bug fixes.

Version 0.34    20 Oct 97
        Now it has a proper playlist. Added Random selection.
        Added Right-Mouse-Button pop-up menus to some windows.
        Added flame effect for Analyser display.
        Other minor cosmetic adjustments.

Version 0.33    18 Sep 97
        Fix "not-loading" bug. New - Prototype dynamic priority.
        CLI added. "Remembers" more settings.
        Performance enhancements (core & display).
        Cosmetic enhancements - Wave Display.





Version 0.32    17 Sep 97
        Now able to load read-only files
         - Playing from CDROM should work.
        Cosmetic adjustments, incl button bitmaps for 1024x768+ users
        Moved SBFix option to a more sensible location.

Version 0.31    14 Sep 97
        Fixed "Invisible" window problem.

Version 0.30    12 Sep 97
        First Version released to the big wide world.
        Added SBFix setting to correct choppy sounds with Creative
        Drivers.

Version 0.24    12 Dec 96
        Added Channel Wave displays

Version 0.23    09 Dec 96
        Added Spectrum Analyser display
        Improved sample display list - to show active samples.

Version 0.21    02 Sep 96
        Added multiple file selection.
        Added sample display list.

Version 0.20    20 Jul 96
        User interface improvement.

Version 0.10    22 Apr 96
        Stereo 16bit sound version. 8channel.

Version 0.01    20 Apr 96
        Created PowerMOD/2. Quick and dirty port of my original DOS
        version. Stereo 8bit sound. 4channel.





END OF FILE

