WarpMedia Technology Preview README


1. Introduction

  While not a completed product, this preview demonstrates a number of
  the exciting technologies SDG has been working on:

  - MPEG-1 video/audio playback.
  - DivX video/audio playback.
  - Fullscreen video and TV output with SciTech Display Doctor.
  - DIVE video output.
  - Customizable user interface, including the ability to use Winamp
    skins directly.


2. Installation notes

  1) Unzip the zip file to a directory of your choice.
  2) That's it! Run WarpMedia from that directory!

  Note #1: DivX playback requires divxc32.dll from the Windows DivX codec
           package. For legal reasons, SDG cannot distribute it together
           with WarpMedia.

           You can download the DivX codec at:
           http://ftp.pcworld.com/pub/video/video_tools/divx_311alpha.zip

           Extract the divxc32.dll file and put it in the WarpMedia
           directory.

  Note #2: In order to get the best possible DIVE performance you can either
           install SciTech Display Doctor's GRADD driver, or make sure you 
           have write-combining to the VRAM enabled. A utility to enable
           write-combining can be found at
           "http://hobbes.nmsu.edu/cgi-bin/h-search?key=p6k7mtrr".
           SDD can be found at "http://www.scitechsoft.com/".


3. Installation of the XCenter Widget plugin

   Put WMXCW.DLL in your XWorkplace\plugins\xcenter directory and
   restart XCenter. The widget requires WarpMedia.exe to be running for
   it to actually do something useful.

   For more information about XWorkplace and XCenter, go to 
   http://www.xworkplace.org/


4. Skins

  WarpMedia skins are more advanced than Winamp skins. For example,
  skins can be transparent or non-rectangular. However, WarpMedia is
  also capable of using Winamp skins.

  To see some examples on how to create skins for WarpMedia, get this:

  ftp://ftp.sdg.os2.nu/pub/warpmedia/wmsdk.zip
  
  Skins can be found at:

  ftp://ftp.sdg.os2.nu/pub/warpmedia/skins/


5. Keys

  The following keys are valid in the video window and in fullscreen mode:

    Alt+Home    Switch between fullscreen and windowed mode
    Enter       Switch from fullscreen to windowed mode
    Escape      Switch from fullscreen to windowed mode
    Ctrl+Up     Increase volume
    Ctrl+Down   Decrease volume
    Ctrl+Left   Previous 
    Ctrl+Right  Next 
    Space       Start/Pause playback
    a           AVI audio/video synchronization control.
                Hold down shift while adjusting to fine tune the value.
    r           Reset display adjustment
    p           Seek position. Select position with Left/Right and 
                press 'p' again to seek to the selected position.
    v           Volume control
    .           Stop playback

  The following keys select the display adjustment mode:
    g      Gamma correction
    b      Brightness
    c      Contrast
    C      Colour saturation
    R      Red saturation
    G      Green saturation
    B      Blue saturation
    s      Smooth filter
    m      Motion blur filter
    Up     Next mode
    Down   Previous mode

  After selecting an adjustment mode, use + or - to adjust the display.


6. The INI file.

  The WarpMedia.ini file currently has one section, [MGL_Resolutions].
  This section contains the resolutions that WarpMedia will display as
  possible MGL fullscreen modes. If you want to use more or fewer
  resolutions, then you can add/remove them in this section
  (one resolution per line). Note that if you want to use a non-standard
  mode, you may first have to add it with "gamode.exe" that is located in
  your SDD directory.


7. Restrictions

  - SDD beta 39 (a higher version might not work) for fullscreen/TV
    output.
  - The display adjustment controls do not work with DivX video.


8. Known bugs

  Too many to list...


9. Contact/Support

  http://groups.yahoo.com/group/WarpMedia


10. About SDG

  SDG is a non-profit collaborative team of OS/2 programmers that aims
  to promote OS/2 by developing freeware and shareware applications.
  SDG is primarily known for WarpAMP, its award-winning MP3 player.

  SDG's web site is located at http://www.sdg.os2.nu


11. Legal Stuff

     Copyright: WarpMedia and all associated information, such as files
                and documentation, are copyright Software Developers
                Guild (SDG for short).

  Distributing: WarpMedia is a so-called freeware, which means it is free
                for anyone to use.

                You may distribute WarpMedia if you:

                1) Distribute it using the distribution package (ie. the
                   zip file that SDG released). Distributing it in any
                   other form (for example, unzipped or repackaged using
                   another archiver) is not permitted.

                2) Do not alter the distribution package or any files it
                   contains.

                3) Do not sell WarpMedia.

                4) Do not charge a "distribution fee" or "copying fee".
                   This includes shareware CD-Roms and similar, if you
                   wish to include WarpMedia on such a CD-ROM then you
                   will have to get a written permission from SDG.

                All other forms of distribution of WarpMedia without the
                Software Developers Guild's written permission is
                prohibited.


    Disclaimer: WarpMedia is provided "AS IS" without warranty of any
                kind, either expressed or implied, including but not
                limited to the implied warranties of merchantability and
                fitness for a particular purpose. In no event shall SDG,
                or any member of SDG, be liable for any damages
                whatsoever including direct, indirect, incidental,
                consequential, loss of business profits or special
                damages, even if SDG has been advised of the possibility
                of such damages.
