home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 April / CMCD0404.ISO / Software / Freeware / Multimedia / xcd / dshow / release / readme.txt < prev    next >
Text File  |  2002-06-03  |  5KB  |  118 lines
  1.  
  2.  RIFF/CDXA Source filter
  3.  -----------------------
  4.  
  5. This is a DirectShow Source filter for parsing RIFF/CDXA file and playing it on the fly (from a Mode2 CD)
  6. (Original code from M$ DX8.1 SDK sample: samples\multimedia\dshow\filters\asynch)
  7.  
  8. Modified to RIFF/CDXA parsing by Avi Halachmi (avihpit@yahoo.com)
  9. DShow stuff by DeXT (de_xt@hotmail.com)
  10.  
  11. last modified: 03-JUN-2002
  12. version: test6b
  13.  
  14. functionality:
  15. - allow any direct show based media player to play mode 2 form 2 files right from the CD
  16.   (i.e. VCD, SVCD and files burned using mode2cdmaker tool [aka "DeXT's tool"])
  17.  
  18.  
  19. --------------- WARNING WARNING WARNING ---------------------
  20.  
  21. this is alpha software. this means that if you start storing files using mode2cdmaker now, 
  22. THE BURNED FILES MAY NOT BE COMPATIBLE WITH FUTURE VERSIONS OF THIS STORAGE FORMAT.
  23. THE FORMAT IS NOT FINALIZED YET. (and error correction hasn't been added yet) 
  24.  
  25. although it's possible to use these filters to read 800M files directly from the cd and play them,
  26. you should NOT by any means start archiving your files using this format.
  27. these filters are only here for testing of playback, co-existance with other filters,
  28. smoothness of playback etc. 
  29.  
  30. the reason you should not start archiving your clips using mode2cdmaker is that there's
  31. no error correction. this means that if your cd is scratched, and 
  32. important (=headers/indexes) parts of the file are lost, you will NOT be able to
  33. play your file. 
  34.  
  35. mode2cdmaker stores the files as standard m2f2 files on iso 9660 filesystem.
  36. this mode offers no error correction. what is lost is lost. 
  37.  
  38. the final target is to add some error correction facilities, and then use the tool 
  39. to make an image. the filter would also be modified to use these 
  40. error correction facilities when errors are detected. 
  41.  
  42. atm though, THERE IS NO ERROR CORRECTION AND YOUR FILE MIGHT NEVER PLAY AGAIN IF THE
  43. CD HAS SCRATCHES WHERE IT MATTERS.
  44.  
  45. be warned. 
  46.  
  47. -------------------------------------------------------------
  48.  
  49.  
  50. Usage:
  51.  
  52.   0. uninstall any previous version, if you had one installed 
  53.      (although it seems to working also without this stage).
  54.   1. click on the install.bat file to register the xcdsrc.ax filter (shown as 'RIFF/CDXA Source')
  55.   2  for VCD/SVCD playback only, skip to stage 5
  56.   3. create a RIFF/CDXA cd image using mode2cdmaker that contains at lease one media file.
  57.      The tool can be obtained from the following sites:
  58.       http://webs.ono.com/de_xt (official site)
  59.       http://www.wsu.edu/~benp/mcfcd.htm (under the name 'Dext's Mode2 CD Maker')
  60.       http://www.doom9.org (Download/Support utils/Show me more)
  61.   4. burn the image (or use daemon tools to mount it)
  62.   5. run your favorite player and open a file from the new CD. it should play.
  63.   6. to remove this filter, use uninstall.bat
  64.  
  65.   formats tested: AVI, OGG, MP3, MPEG-1/2 (VCD & SVCD too), MOV (QuickTime 3 only)
  66.  
  67.   formats known NOT to work: ASF, WMV, WMA, MOV (QuickTime 4/5), RM(*), MP4(*)
  68.  
  69.   SVCD playback may be a bit skippy since the bitrate is usually high, and we didn't add buffering yet.
  70.  
  71.   (*) these formats MIGHT work in future or with special software support
  72.  
  73.  
  74. Credits:
  75.  
  76.   Many thanks to all the people who have helped us and made our life easier.
  77.   Specially to Ingo, some parts of the filter code are inspired on his work on the MediaXW project.
  78.   Big thanks go to the MCF team who was the 1st to define a spec for 800M files on a cd (MCF-CD project)
  79.  
  80.  
  81. Changelog:
  82. ----------
  83.  
  84.   test6b:
  85.    - fixed install script to work on Win9x/Me
  86.  
  87.   test6:
  88.    - VCD and SVCD playback support added
  89.    - filter rewrite (for portability and future support for error protection)
  90.    - improved media detection
  91.    - file name changed from asyncflt.ax to xcdsrc.ax
  92.    - registry system modified to override ms VIDEO CD Source 
  93.      (which doesn't read s/vcd correctly, and may introduce conflicts.
  94.       the uninstall script put back the original registry values)
  95.  
  96.   test5:
  97.    - added automatic media detection
  98.    - internal cleanup
  99.  
  100.   test4:
  101.    - added custom builds for AVI/OGG content
  102.    - enhanced filter multithreading compliance
  103.  
  104.   test3:
  105.    - the filter no longer will load the entire file into memory
  106.  
  107.   test2b:
  108.    - fixed registry compatibility problem with VCD/SVCD
  109.  
  110.   test2:
  111.    - added RIFF/CDXA media type
  112.    - set custom GUID for filter
  113.  
  114.   test1:
  115.    - first release, based on M$ Async File Source sample filter
  116.    - added RIFF/CDXA parsing code
  117.  
  118.