================================ ========================= File Writer output plug-in v1.14 made by Jasper v/d Gronde ================================ ========================= -------------------------------------------------------------------------------------------- General -------------------------------------------------------------------------------------------- This plugin lets you write WinAMP's output to a file, it supports several different formats and has a couple of options that let you control the filename (it is very easy to add a time and date stamp to the file for example). It is also very nice to use in combination with my LineIn plugin, as it understands the same variables as my LineIn plugin for the title and has an option to expand the title it gets (lets you embed certain variables inside the title instead of just appending something). To setup this plugin: - install it (you've probably already done that) - put the files (or urls, for example for my LineIn plugin) you want to save in the playlist - select this plugin as the output plugin - play the files and/or urls IMPORTANT NOTE: Go to my site if you run into any problems (at the bottom of this text). Also any updates appear there first. -------------------------------------------------------------------------------------------- Options -------------------------------------------------------------------------------------------- This plugin has some options in the config dialog: Directory: The directory where the files will be written to. Format: The fileformat the files will be in, you can select one of these: Windows wav format (WAV) Simply gets you a .wav file of the output, good for things like recording to a cd. Raw waveformat (PCM) Simply outputs the raw data, usefull if you have some use for it, like when you are beginning to write an app that uses sound but you haven't written a good file reading function yet. Mpeg-1 Layer 3 (MP3) This will get you an MP3 file, this format has a lot of options, but mostly you will only fiddle with the bitrate settings. NOTE: You need the lame dll for this format to be available, see http://www.mp3dev.org/ NOTE2: You need a dll named lame_enc.dll, not out_lame.dll. out_lame.dll is a WinAMP plugin that uses LAME, not the encoder itself. Ogg Vorbis (OGG) This will get you a .ogg file, a relatively new (free) format. Performs very similar to MP3. NOTE: You need ogg.dll, vorbis.dll and vorbisenc.dll for this format to be available, see http://www.vorbis.com/ Monkey's Audio Format (APE) This will get you .ape file, this is a very popular (and very good) lossless format. You don't need anything special to use this format with my plugin, but you might want to download Monkey's Audio, it comes with an input plugin. See http://www.monkeysaudio.com/ for more information. If you want more information, please visit my site: http://home.hccnet.nl/th.v.d.gronde/ The main page has a tree like structure, there is some info on this plugin in its page, but the variable reference for the title options can be found in the Documentation of my LineIn plugin. Although the current version supports some special variables, that aren't supported by my LineIn plugin: %ut Will expand to the unexpanded title %et Will expand to the expanded title %p# Will expand to the playlist position, with zero padding, where # is the number of digits to pad to (for example: %p3 will become 012 if the playlist position is 12, 512 when the playlist position is 512 or 1742 when the playlist position is 1742) %ur Will expand to the username of the current user %cr Will expand to the name of the computer the plugin runs on Some example configurations: Format: Ogg Vorbis Expandable string: %p3 - %ut - %tm on %ds Format: Windows wav format Expanded title (or unexpanded title) My LineIn plugin as input plugin, with the following location: line://title=Old record\, recorded on %dl NOTE: DO NOT forget to select the normal output plugin after you have finished! -------------------------------------------------------------------------------------------- What to do in case of trouble with my plugin -------------------------------------------------------------------------------------------- For now you should just mail me at th.v.d.gronde@hccnet.nl -------------------------------------------------------------------------------------------- Version history -------------------------------------------------------------------------------------------- v1.14 (August 10, 2002): - added support for Monkey's Audio - made the plugin faster while still letting WinAMP be responsive (it now changes the threadpriority instead of using Sleep(1)) - updated the LAME support (some new constants) - made the error box look a little nicer - added two variables for the filename (%ur and %cr) - fixed some things in the config dialog (tab order and some fields didn't initialize correctly) - changed some char*'s to string's v1.13 (May 6, 2002): - 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) - added the variable %p# (where # is a number), which gives you the playlist position, padded with zeroes upto # digits - made winamp much more responsive during writing (by using Sleep(1)) - nicer error message if the plugin hasn't been configured yet v1.12 (April 13, 2002): - fixed a bug in the wav writer that made a wav file look 44 bytes too large - 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) v1.11 (February 18, 2002): - added support for Ogg Vorbis (see http://www.vorbis.com/) - made lame optional (it will simply not show the mp3 possibility if lame is not installed), the same goes for Ogg Vorbis - made the config button gray when format has no config - moved the browse button a little bit - made the combobox handle absent formats in a nice way - fixed a minor bug in the lame (and ogg) config dialog (it wouldn't do enablewindow on wm_destroy) v1.10 (January 10, 2002): - added support for MP3 (through LAME, see http://www.mp3dev.org/) - added a browse button for directory selection - changed the style of the comboboxes (they are now drop lists) v1.00 (January 3, 2002): - it plays - raw and wave support - just title, expanded title and just title + expanded string filename support - creates valid filenames - lets you specify an output directory Jasper van de Gronde th.v.d.gronde@hccnet.nl http://home.hccnet.nl/th.v.d.gronde/ (watch the site for updates and so on)