Beginner's Basic Plugin Guide - Revision history

DrO: clarification

2013-03-04T21:53:52Z

clarification

Skurvy Pirate: Added quotes around the source path in the post build event section. If the path contains a space then it won't work without them.

2011-07-02T06:09:34Z

Added quotes around the source path in the post build event section. If the path contains a space then it won't work without them.

Culix: add notes on auto-copying .dll as post-build step

2011-01-15T04:06:50Z

add notes on auto-copying .dll as post-build step

Culix: /* Basic plugin code */ add #endif comment

2011-01-15T03:50:24Z

‎Basic plugin code: add #endif comment

CH: added info for linker problem in MS Visual 2010

2010-11-24T20:20:12Z

added info for linker problem in MS Visual 2010

SMonty: /* What's next? */

2009-07-13T18:18:24Z

‎What's next?

SMonty: /* Troubleshooting */

2009-07-13T18:13:57Z

‎Troubleshooting

SMonty: /* Troubleshooting */

2009-07-02T16:58:09Z

‎Troubleshooting

SMonty: /* Troubleshooting */

2009-07-01T21:33:09Z

‎Troubleshooting

SMonty: /* Edit dependencies */

2009-07-01T21:14:29Z

‎Edit dependencies

@@ Line 63: / Line 63: @@
 === Basic plugin code ===
-To create your plugin, just copy/paste the following code into gen_myplugin.h and gen_myplugin.cpp.
+To create your plugin, delete automatically generated code in both gen_myplugin.h and gen_myplugin.cpp then just copy/paste the following code into gen_myplugin.h and gen_myplugin.cpp.
 <nowiki><basic gen_myplugin.h></nowiki>

@@ Line 201: / Line 201: @@
 # Right-click on your project and select Properties
 # Open 'Configuration Properties' -> 'Build Events' -> 'Post Build Event'
-# In the Command Line type <pre>copy $(OutDir)\$(TargetFileName) "C:\Program Files\Winamp\Plugins"</pre>
+# In the Command Line type <pre>copy "$(OutDir)\$(TargetFileName)" "C:\Program Files\Winamp\Plugins"</pre>
 # Enter some Description, such as "copy dll to winamp plugins folder"
 # Click 'OK'

@@ Line 195: / Line 195: @@
 # Click on your plugin to hilight it and then select the 'Configure Selected Plugin' button.  This should cause the 'config' message to appear.
 # If you exit Winamp, you should now see the Quit message pop up as the program exits.
 == What's next? ==

@@ Line 93: / Line 93: @@
-#endif
+#endif //gen_myplugin_h
 </source>
 <nowiki><end basic gen_myplugin.h></nowiki>

@@ Line 227: / Line 227: @@
 # In the "Additional Dependancies" box, delete the text that says '$(NoInherit)'.
 # Save and recompile
 For more information see [http://stackoverflow.com/questions/739952/c-cli-linker-gives-unresolved-token-for-win32-function here] and [http://stackoverflow.com/questions/721387/i-get-lnk2028-when-trying-to-wrap-native-c-class-using-managed-c here].

@@ Line 198: / Line 198: @@
 == What's next? ==
-So what's next? We don't know. More guides still need to be written. Eventually there may be a guide for each type of plugin: [[Input_Plugin|Input]], [[Output_Plugin|Output]], [[Visualization_Plugin|Visualization]], [[DSP_Plugin|Audio Effect/DSP]], [[General_Purpose_Plugin|General Purpose]], [[Media_Library_Plugin|Media Library]] and [[Portable_Plugin|Portables]].
+So what's next? More guides still need to be written. Eventually there may be a guide for each type of plugin: [[Input_Plugin|Input]], [[Output_Plugin|Output]], [[Visualization_Plugin|Visualization]], [[DSP_Plugin|Audio Effect/DSP]], [[General_Purpose_Plugin|General Purpose]], [[Media_Library_Plugin|Media Library]] and [[Portable_Plugin|Portables]].
 If you're looking to write a plugin, you may want to start by reading through the [[SDK_Contents]] and trying to find a code example that's similar to what you want to do.
 ----

@@ Line 282: / Line 282: @@
 TODO: What's the right way of doing this for plugins?
 * '''My plugin isn't working / My plugin doesn't show up in the Preferences menu.'''
@@ Line 288: / Line 292: @@
 TODO: How about other names/plugins? What's the real answer?
 [[Category:Articles]]

← Older revision		Revision as of 16:58, 2 July 2009
Line 288:		Line 288:

	TODO: How about other names/plugins? What's the real answer?		TODO: How about other names/plugins? What's the real answer?
−
−	The answer to this is complicated, as so much with Winamp. The prefix is actually used by Winamp.exe to find plugins and identify what type they are. There is another way to create plugins that does not require the prefix. This second way is called Wasabi. Wasabi is a way to 'share' code among components of a software system (i.e., Winamp). Wasabi dlls do not need the prefix. We'll get to Wasabi if we keep writing these kinds of tutorials. Is there something specific about the prefixes that leads you to believe that there is a 'real' answer? Maybe I can investigate further.

	[[Category:Articles]]		[[Category:Articles]]

@@ Line 208: / Line 208: @@
 <pre>
->winamp_imms.obj : error LNK2028: unresolved token (0A00001D) "extern "C" int __stdcall
+>gen_myplugin.obj : error LNK2028: unresolved token (0A00001D) "extern "C" int __stdcall
 MessageBoxW(struct HWND__ *,wchar_t const *,wchar_t const *,unsigned int)" (?MessageBoxW@@$$J216YGHPAUHWND__@@PB_W1I@Z)
   referenced in function "extern "C" int __cdecl MessageBox(struct HWND__ *,wchar_t const *,wchar_t const *,unsigned int)"
   (?MessageBox@@$$J0YAHPAUHWND__@@PB_W1I@Z)
->winamp_imms.obj : error LNK2019: unresolved external symbol "extern "C" int __stdcall
+>gen_myplugin.obj : error LNK2019: unresolved external symbol "extern "C" int __stdcall
   MessageBoxW(struct HWND__ *,wchar_t const *,wchar_t const *,unsigned int)" (?MessageBoxW@@$$J216YGHPAUHWND__@@PB_W1I@Z)
   referenced in function "extern "C" int __cdecl MessageBox(struct HWND__ *,wchar_t const *,wchar_t const *,unsigned int)"
@@ Line 230: / Line 230: @@
 * '''* I get an error like'''
 <pre>
-"1>.\winamp_imms.cpp(29) : error C2146: syntax error : missing ';' before identifier 'plugin'"
+"1>.\gen_myplugin.cpp(25) : error C2146: syntax error : missing ';' before identifier 'plugin'"
 </pre>
@@ Line 273: / Line 273: @@
 <pre>
->.\winamp_imms.cpp(41) : error C2664: 'MessageBox' : cannot convert parameter 2 from 'const char [5]' to 'LPCTSTR'
+>.\gen_myplugin.cpp(42) : error C2664: 'MessageBox' : cannot convert parameter 2 from 'const char [5]' to 'LPCTSTR'
 >        Types pointed to are unrelated; conversion requires reinterpret_cast, C-style cast or function-style cast
 </pre>
@@ Line 288: / Line 288: @@
 TODO: How about other names/plugins? What's the real answer?
 [[Category:Articles]]

@@ Line 167: / Line 167: @@
 <nowiki><end basic gen_myplugin.cpp></nowiki>
 === Edit dependencies ===
@@ Line 174: / Line 176: @@
 # Expand the options to select Configuration Properties -> Linker -> Input
 # In the "Additional Dependancies" box, delete the text that says '$(NoInherit)', so the box is blank.
 # Click 'Apply', then 'OK', and then save your project.
 === Compiling the code ===