home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / wame1x08.zip / readme.txt < prev    next >
Text File  |  2001-11-04  |  6KB  |  178 lines
  1. WarpMedia Technology Preview README
  2.  
  3.  
  4. 1. Introduction
  5.  
  6.   While not a completed product, this preview demonstrates a number of
  7.   the exciting technologies SDG has been working on:
  8.  
  9.   - MPEG-1 video/audio playback.
  10.   - DivX video/audio playback.
  11.   - Fullscreen video and TV output with SciTech Display Doctor.
  12.   - DIVE video output.
  13.   - Customizable user interface, including the ability to use Winamp
  14.     skins directly.
  15.  
  16.  
  17. 2. Installation notes
  18.  
  19.   1) Unzip the zip file to a directory of your choice.
  20.   2) That's it! Run WarpMedia from that directory!
  21.  
  22.   Note #1: DivX playback requires divxc32.dll from the Windows DivX codec
  23.            package. For legal reasons, SDG cannot distribute it together
  24.            with WarpMedia.
  25.  
  26.            You can download the DivX codec at:
  27.            http://ftp.pcworld.com/pub/video/video_tools/divx_311alpha.zip
  28.  
  29.            Extract the divxc32.dll file and put it in the WarpMedia
  30.            directory.
  31.  
  32.   Note #2: In order to get the best possible DIVE performance you can either
  33.            install SciTech Display Doctor's GRADD driver, or make sure you 
  34.            have write-combining to the VRAM enabled. A utility to enable
  35.            write-combining can be found at
  36.            "http://hobbes.nmsu.edu/cgi-bin/h-search?key=p6k7mtrr".
  37.            SDD can be found at "http://www.scitechsoft.com/".
  38.  
  39.  
  40. 3. Installation of the XCenter Widget plugin
  41.  
  42.    Put WMXCW.DLL in your XWorkplace\plugins\xcenter directory and
  43.    restart XCenter. The widget requires WarpMedia.exe to be running for
  44.    it to actually do something useful.
  45.  
  46.    For more information about XWorkplace and XCenter, go to 
  47.    http://www.xworkplace.org/
  48.  
  49.  
  50. 4. Skins
  51.  
  52.   WarpMedia skins are more advanced than Winamp skins. For example,
  53.   skins can be transparent or non-rectangular. However, WarpMedia is
  54.   also capable of using Winamp skins.
  55.  
  56.   To see some examples on how to create skins for WarpMedia, get this:
  57.  
  58.   ftp://ftp.sdg.os2.nu/pub/warpmedia/wmsdk.zip
  59.   
  60.   Skins can be found at:
  61.  
  62.   ftp://ftp.sdg.os2.nu/pub/warpmedia/skins/
  63.  
  64.  
  65. 5. Keys
  66.  
  67.   The following keys are valid in the video window and in fullscreen mode:
  68.  
  69.     Alt+Home    Switch between fullscreen and windowed mode
  70.     Enter       Switch from fullscreen to windowed mode
  71.     Escape      Switch from fullscreen to windowed mode
  72.     Ctrl+Up     Increase volume
  73.     Ctrl+Down   Decrease volume
  74.     Ctrl+Left   Previous 
  75.     Ctrl+Right  Next 
  76.     Space       Start/Pause playback
  77.     a           AVI audio/video synchronization control.
  78.                 Hold down shift while adjusting to fine tune the value.
  79.     r           Reset display adjustment
  80.     p           Seek position. Select position with Left/Right and 
  81.                 press 'p' again to seek to the selected position.
  82.     v           Volume control
  83.     .           Stop playback
  84.  
  85.   The following keys select the display adjustment mode:
  86.     g      Gamma correction
  87.     b      Brightness
  88.     c      Contrast
  89.     C      Colour saturation
  90.     R      Red saturation
  91.     G      Green saturation
  92.     B      Blue saturation
  93.     s      Smooth filter
  94.     m      Motion blur filter
  95.     Up     Next mode
  96.     Down   Previous mode
  97.  
  98.   After selecting an adjustment mode, use + or - to adjust the display.
  99.  
  100.  
  101. 6. The INI file.
  102.  
  103.   The WarpMedia.ini file currently has one section, [MGL_Resolutions].
  104.   This section contains the resolutions that WarpMedia will display as
  105.   possible MGL fullscreen modes. If you want to use more or fewer
  106.   resolutions, then you can add/remove them in this section
  107.   (one resolution per line). Note that if you want to use a non-standard
  108.   mode, you may first have to add it with "gamode.exe" that is located in
  109.   your SDD directory.
  110.  
  111.  
  112. 7. Restrictions
  113.  
  114.   - SDD beta 39 (a higher version might not work) for fullscreen/TV
  115.     output.
  116.   - The display adjustment controls do not work with DivX video.
  117.  
  118.  
  119. 8. Known bugs
  120.  
  121.   Too many to list...
  122.  
  123.  
  124. 9. Contact/Support
  125.  
  126.   http://groups.yahoo.com/group/WarpMedia
  127.  
  128.  
  129. 10. About SDG
  130.  
  131.   SDG is a non-profit collaborative team of OS/2 programmers that aims
  132.   to promote OS/2 by developing freeware and shareware applications.
  133.   SDG is primarily known for WarpAMP, its award-winning MP3 player.
  134.  
  135.   SDG's web site is located at http://www.sdg.os2.nu
  136.  
  137.  
  138. 11. Legal Stuff
  139.  
  140.      Copyright: WarpMedia and all associated information, such as files
  141.                 and documentation, are copyright Software Developers
  142.                 Guild (SDG for short).
  143.  
  144.   Distributing: WarpMedia is a so-called freeware, which means it is free
  145.                 for anyone to use.
  146.  
  147.                 You may distribute WarpMedia if you:
  148.  
  149.                 1) Distribute it using the distribution package (ie. the
  150.                    zip file that SDG released). Distributing it in any
  151.                    other form (for example, unzipped or repackaged using
  152.                    another archiver) is not permitted.
  153.  
  154.                 2) Do not alter the distribution package or any files it
  155.                    contains.
  156.  
  157.                 3) Do not sell WarpMedia.
  158.  
  159.                 4) Do not charge a "distribution fee" or "copying fee".
  160.                    This includes shareware CD-Roms and similar, if you
  161.                    wish to include WarpMedia on such a CD-ROM then you
  162.                    will have to get a written permission from SDG.
  163.  
  164.                 All other forms of distribution of WarpMedia without the
  165.                 Software Developers Guild's written permission is
  166.                 prohibited.
  167.  
  168.  
  169.     Disclaimer: WarpMedia is provided "AS IS" without warranty of any
  170.                 kind, either expressed or implied, including but not
  171.                 limited to the implied warranties of merchantability and
  172.                 fitness for a particular purpose. In no event shall SDG,
  173.                 or any member of SDG, be liable for any damages
  174.                 whatsoever including direct, indirect, incidental,
  175.                 consequential, loss of business profits or special
  176.                 damages, even if SDG has been advised of the possibility
  177.                 of such damages.
  178.