home *** CD-ROM | disk | FTP | other *** search
/ Chip 2003 January / Chip_2003-01_cd2.bin / players / WinAmp / plugin2x / filewrite114.exe / out_filewrite-readme.txt next >
Text File  |  2002-08-10  |  7KB  |  139 lines
  1.  
  2.     ================================    =========================
  3.     File Writer output plug-in v1.14    made by Jasper v/d Gronde
  4.     ================================    =========================
  5.  
  6. --------------------------------------------------------------------------------------------
  7.     General
  8. --------------------------------------------------------------------------------------------
  9. This plugin lets you write WinAMP's output to a file, it supports several different formats
  10. and has a couple of options that let you control the filename (it is very easy to add a time
  11. and date stamp to the file for example). It is also very nice to use in combination with my
  12. LineIn plugin, as it understands the same variables as my LineIn plugin for the title and
  13. has an option to expand the title it gets (lets you embed certain variables inside the title
  14. instead of just appending something).
  15. To setup this plugin:
  16.     - install it (you've probably already done that)
  17.     - put the files (or urls, for example for my LineIn plugin) you want to save in the
  18.       playlist
  19.     - select this plugin as the output plugin
  20.     - play the files and/or urls
  21.  
  22. IMPORTANT NOTE: Go to my site if you run into any problems (at the bottom of this text).
  23. Also any updates appear there first.
  24.  
  25. --------------------------------------------------------------------------------------------
  26.     Options
  27. --------------------------------------------------------------------------------------------
  28. This plugin has some options in the config dialog:
  29.  
  30. Directory: The directory where the files will be written to.
  31. Format: The fileformat the files will be in, you can select one of these:
  32.     Windows wav format (WAV)
  33.         Simply gets you a .wav file of the output, good for things
  34.         like recording to a cd.
  35.  
  36.     Raw waveformat (PCM)
  37.         Simply outputs the raw data, usefull if you have some use for
  38.         it, like when you are beginning to write an app that uses 
  39.         sound but you haven't written a good file reading function 
  40.         yet.
  41.  
  42.     Mpeg-1 Layer 3 (MP3)
  43.         This will get you an MP3 file, this format has a lot of options, but mostly
  44.         you will only fiddle with the bitrate settings.
  45.         NOTE: You need the lame dll for this format to be available,
  46.         see http://www.mp3dev.org/
  47.         NOTE2: You need a dll named lame_enc.dll, not out_lame.dll.
  48.         out_lame.dll is a WinAMP plugin that uses LAME, not the encoder itself.
  49.  
  50.     Ogg Vorbis (OGG)
  51.         This will get you a .ogg file, a relatively new (free) format.
  52.         Performs very similar to MP3.
  53.         NOTE: You need ogg.dll, vorbis.dll and vorbisenc.dll for this 
  54.         format to be available, see http://www.vorbis.com/
  55.  
  56.     Monkey's Audio Format (APE)
  57.         This will get you .ape file, this is a very popular (and very good)
  58.         lossless format.
  59.         You don't need anything special to use this format with my plugin, but
  60.         you might want to download Monkey's Audio, it comes with an input plugin.
  61.         See http://www.monkeysaudio.com/ for more information.
  62.  
  63. If you want more information, please visit my site:
  64. http://home.hccnet.nl/th.v.d.gronde/
  65. The main page has a tree like structure, there is some info on this plugin in its page, but
  66. the variable reference for the title options can be found in the Documentation of my LineIn
  67. plugin. Although the current version supports some special variables, that aren't supported
  68. by my LineIn plugin:
  69.     %ut    Will expand to the unexpanded title
  70.     %et    Will expand to the expanded title
  71.     %p#    Will expand to the playlist position, with zero padding, where # is the
  72.         number of digits to pad to (for example: %p3 will become 012 if the playlist
  73.         position is 12, 512 when the playlist position is 512 or 1742 when the
  74.         playlist position is 1742)
  75.     %ur    Will expand to the username of the current user
  76.     %cr    Will expand to the name of the computer the plugin runs on
  77.  
  78. Some example configurations:
  79.  Format: Ogg Vorbis
  80.  Expandable string: %p3 - %ut - %tm on %ds
  81.  
  82.  Format: Windows wav format
  83.  Expanded title (or unexpanded title)
  84.  My LineIn plugin as input plugin, with the following location: line://title=Old record\, recorded on %dl
  85.  
  86. NOTE: DO NOT forget to select the normal output plugin after you have finished!
  87.  
  88. --------------------------------------------------------------------------------------------
  89.     What to do in case of trouble with my plugin
  90. --------------------------------------------------------------------------------------------
  91. For now you should just mail me at th.v.d.gronde@hccnet.nl
  92.  
  93. --------------------------------------------------------------------------------------------
  94.     Version history
  95. --------------------------------------------------------------------------------------------
  96. v1.14 (August 10, 2002):
  97.     - added support for Monkey's Audio
  98.     - made the plugin faster while still letting WinAMP be responsive (it now changes the threadpriority instead of using Sleep(1))
  99.     - updated the LAME support (some new constants)
  100.     - made the error box look a little nicer
  101.     - added two variables for the filename (%ur and %cr)
  102.     - fixed some things in the config dialog (tab order and some fields didn't initialize correctly)
  103.     - changed some char*'s to string's
  104.  
  105. v1.13 (May 6, 2002):
  106.     - improved the support for filenaming (modified the add expandable string option to be: use expandable string, where one of the variables is the (un-)expanded title)
  107.     - added the variable %p# (where # is a number), which gives you the playlist position, padded with zeroes upto # digits
  108.     - made winamp much more responsive during writing (by using Sleep(1))
  109.     - nicer error message if the plugin hasn't been configured yet
  110.  
  111. v1.12 (April 13, 2002):
  112.     - fixed a bug in the wav writer that made a wav file look 44 bytes too large
  113.     - fixed a minor bug in the config dialog (the config button for formats wasn't grayed when you entered the dialog with wav or raw as the default format)
  114.  
  115. v1.11 (February 18, 2002):
  116.     - added support for Ogg Vorbis (see http://www.vorbis.com/)
  117.     - made lame optional (it will simply not show the mp3 possibility if lame is not installed), the same goes for Ogg Vorbis
  118.     - made the config button gray when format has no config
  119.     - moved the browse button a little bit
  120.     - made the combobox handle absent formats in a nice way
  121.     - fixed a minor bug in the lame (and ogg) config dialog (it wouldn't do enablewindow on wm_destroy)
  122.  
  123. v1.10 (January 10, 2002):
  124.     - added support for MP3 (through LAME, see http://www.mp3dev.org/)
  125.     - added a browse button for directory selection
  126.     - changed the style of the comboboxes (they are now drop lists)
  127.  
  128. v1.00 (January 3, 2002):
  129.     - it plays
  130.     - raw and wave support
  131.     - just title, expanded title and just title + expanded string filename support
  132.     - creates valid filenames
  133.     - lets you specify an output directory
  134.  
  135.  
  136. Jasper van de Gronde
  137. th.v.d.gronde@hccnet.nl
  138. http://home.hccnet.nl/th.v.d.gronde/ (watch the site for updates and so on)
  139.