Click here to Skip to main content
Click here to Skip to main content

Hosting a Winamp Output Plugin

, 5 Dec 2006
Rate this:
Please Sign up or sign in to vote.
How to host a Winamp output plug-in.

Screen capture of the Direct Sound plugin's config window launched by the plugin host.

Introduction

Ever wanted to host a Winamp plug-in? No? Hmm... Ever wanted an exercise in good code writing practices? Not even sometimes? OK... How about this... Have you ever wanted to write a coin-op juke box app, based on Winamp, that could provide the control over its plug-ins that only Winamp can? I did, and this article is the result.

This article will not tell you how to make a plug-in. There's enough information floating around in other places which would make this article redundant. Instead, this article will show you how to properly host a Winamp output plug-in. As far as the plug-in is concerned, your app is Winamp.

This article is part of a possible series on the Winamp plug-ins and system.

Background

Winamp, a freeware program developed by Nullsoft, is a program that was originally written to play music files. It originally had a unique user-interface, and became widely known when some tech-savvy users decided to toy around with the resources in the program. This led to an underground community of people who would write 'skins' for Winamp. Nullsoft embraced this community, and made skinning easier in future releases.

Nullsoft also developed a plug-in system that allowed third-party developers to add functionality to Winamp, such as adding file format support, visualizations, DSP support, as well as a multitude of other types of functionality.

Output plug-ins allow the audio to be routed to different locations. The output plug-ins included with Winamp allow the audio to be routed to your soundcard through the wave mapper, through DirectSound (to allow music when you're playing a game), or to a wave file.

Using the code

To use the code, add a reference to the Winamp Plugin Host. Create an instance of the plug-in like so:

Dim Plugin As New OutputPlugin("full path to plugin.dll")

I'm not going to get into the nuts and bolts of the Winamp SDK at this time, but suffice it to say, the only thing this plug-in host does for you automatically is pass the hDLLInstance to the plug-in. Everything else is up to you.

Initialization

To properly initialize the plug-in, you should call these methods:

Plugin.MainWindow = Me
Plugin.Init()

Opening the device

The best analogy to an output plug-in is a hardware device or a file. To do anything, you first open the device.

Dim LatencyMS As Integer = Plugin.Open(44100, 2, 16, 100, 0)

Writing data to the device

To get actual sound, you write to the device. The plug-in expects raw, uncompressed, sound data, and will play it with the parameters specified when you opened the device.

Dim data As Byte()
'todo: get the data from somewhere... maybe a file? or an input plugin?

Plugin.Write(data, data.GetLength(0))

Closing the device

When you are no longer expecting to write data to the device, close it. Some plug-ins have exclusive access to the device (e.g., the Wave mapper plug-in). If such a plug-in is open, no other application can have access to the device. This may result in sounds from other applications not being heard. Close the device to prevent this from happening:

Plugin.Close()

Finalization

Some plug-ins may have settings that may need to be saved, or file system transactions (it could happen...) that need to be finalized. Before you exit the program, call:

Plugin.Quit()

Points of interest

Plug-in systems, in general, and Winamp plug-ins, in particular, have always fascinated me. I've spent a lot of time trying to design new systems and implement older ones. While I have yet to actually write a Winamp plug-in, I do plan to at some point. The one thing I may run into is that while VB.NET can import functions from a DLL file (using LoadLibrary, no less), it can't yet export them that I know of.

One particular hoop I had to jump through to get this to work is that the winampGetOutModule function exported by the plug-ins returns a pointer to the OutModule structure. Attempting to attach a delegate to a function that returns a pointer was an interesting experience, to say the least. The exception that I was getting was non-specific, and actually had me thinking that this couldn't be done. If you're familiar with the exception "Method's type signature is not PInvoke compatible.", you'll understand why. Somebody on VBForums mentioned a way to dynamically bind an imported function at runtime that used DLLImportAttribute, and said that should help.

When I saw the article, it seemed overly complicated for what I was trying to do, so instead I rolled my own. The method used was to write a piece of template code and replace the DLL filename in it at runtime. The code would then be compiled and called. When I wrote that, it worked, that is, until it tried to call the DLL. It simply gave the same exception. This time, though, I had to write a few dozen lines of code to read an array of errors to find that out.

I solved the problem by having the imported function declared 'As Integer' instead of 'As OutModule'. Then, as can be seen in the code, I used Marshal.PtrToStructure to get the structure from the pointer. It was then that I realized that I no longer needed to compile a template and all that other stuff. In eight hours (on and off), I managed to write, then delete about 300 lines of code.

History

  • Sunday, Dec 3, 2006: Article submitted.

When I add more Winamp related articles, I will add links to them here.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

About the Author

Jack Schitt

United States United States
Jack Schitt is a hobbyist programmer who specializes in user interface design and usability as well as plug-in architectures. Owner-drawn controls and GDI+ are also common focuses.
 
Jack Schitt is not the real name of this developer; it is actually a pseudonym.

Comments and Discussions

 
QuestionText over video PinmemberMario_F13-Dec-06 12:22 
AnswerRe: Text over video PinmemberJack Schitt13-Dec-06 21:18 
AnswerRe: Text over video PinmemberMario_F14-Dec-06 2:38 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web01 | 2.8.140709.1 | Last Updated 5 Dec 2006
Article Copyright 2006 by Jack Schitt
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid