Forum: VirtualDJ Plugins

//////////////////////////////////////////////////////////////////////////
//
// VirtualDJ / Cue
// Plugin SDK for Windows / MAC OS
// (c)Atomix Productions 2006-2011
// File Version: 2.0
//
//////////////////////////////////////////////////////////////////////////
//
// This file defines the basic functions that are used in all plugins.
// It defines the functions and variables needed to:
// - load and unload a plugin
// - give the infos about the plugin (name, picture, etc)
// - get the parameters automatically saved and restored between loads
// - interact with VirtualDJ (ask queries or send commands)
// - implement a custom interface
//
// Other functions specific to particular types of plugin can be found
// in their respective header file
//
//////////////////////////////////////////////////////////////////////////


#ifndef VdjPlugin_H
#define VdjPlugin_H

//////////////////////////////////////////////////////////////////////////
// Platform specific defines for compatibility Mac/Windows

#if (defined(WIN32) || defined(_WIN32) || defined(__WIN32_))
                #define VDJ_WIN
	#ifndef WIN32_LEAN_AND_MEAN        /* For old plugins compatibility */
		#define WIN32_LEAN_AND_MEAN
		#include <windows.h>
	#endif
	#define VDJ_EXPORT		__declspec( dllexport )
    #define VDJ_API         __stdcall
	#define VDJ_BITMAP		HBITMAP
	#define VDJ_HINSTANCE	HINSTANCE
    #define VDJ_WINDOW      HWND
#elif (defined(__APPLE__) || defined(MACOSX) || defined(__MACOSX__))
                 #define VDJ_MAC
	#define VDJ_EXPORT		__attribute__ ((visibility ("default")))
    #define VDJ_API
	#define VDJ_BITMAP		char *
	#define VDJ_HINSTANCE	CFBundleRef
    #define VDJ_WINDOW      WindowRef
	#define S_OK               ((HRESULT)0x00000000L)
	#define S_FALSE            ((HRESULT)0x00000001L)
	#define E_NOTIMPL          ((HRESULT)0x80004001L)
	#define MAKEINTRESOURCE(i) (LPSTR)((ULONG_PTR)((WORD)(i)))
	#define CLASS_E_CLASSNOTAVAILABLE -1
	#define NO_ERROR 0
	#define wsprintf sprintf
    #define VDJ_API          /* For old plugins compatibility */
	typedef long HRESULT;
	typedef struct _GUID {
		unsigned long  Data1;
		unsigned short Data2;
		unsigned short Data3;
		unsigned char  Data4[ 8 ];
	} GUID;
	typedef unsigned long ULONG;
	typedef unsigned long DWORD;
#endif


//////////////////////////////////////////////////////////////////////////
// Standard structures and defines

// structure used in plugin identification
struct TVdjPluginInfo
{
	char *PluginName;
	char *Author;
	char *Description;
	VDJ_BITMAP Bitmap;
	DWORD Flag;
};

// structure used to send queries to virtualdj
struct TVdjQueryResult
{
	// type of the result. Can be one of:
	// 0: no result
	// 'bool': boolean value (stored in vint)
	// 'val': float value (stored in vfloat, usually between 0.0f and 1.0f)
	// 'int': integer value (stored in vint)
	// 'txt': utf-8 text (stored in string)
	DWORD type;
	// value of the parameter (depends on the type, see above).
	union
	{
		int vint;
		float vfloat;
		char *string;
		DWORD flag;
	};
};

// flags used for plugin's parameters
#define VDJPARAM_BUTTON	0
#define VDJPARAM_SLIDER	1
#define VDJPARAM_SWITCH	2
#define VDJPARAM_STRING	3
#define VDJPARAM_CUSTOM	4
#define VDJPARAM_RADIO	5

//////////////////////////////////////////////////////////////////////////
// Base class

class IVdjPlugin
{
public:
	// Initialization
	virtual HRESULT VDJ_API OnLoad() {return 0;}
	virtual HRESULT VDJ_API OnGetPluginInfo(TVdjPluginInfo *infos) {return E_NOTIMPL;}
	virtual ULONG VDJ_API Release() {delete this;return 0;}
	virtual ~IVdjPlugin() {}

	// callback functions to communicate with VirtualDJ
	HRESULT (VDJ_API *SendCommand)(char *command,int sync); // send a command to VirtualDJ. if sync is set to 1, the command is sent from the plugin thread (don't use this with Windows-related commands).
	HRESULT (VDJ_API *GetInfo)(char *command,void *result); // get infos from VirtualDJ. result must point to a caller-allocated TVdjQueryResult structure.

	// parameters stuff
	// call DeclareParameter() for all your variables during OnLoad()
	// if type=VDJPARAM_CUSTOM or VDJPARAM_STRING, defaultvalue must be set to sizeof(*parameter)
	HRESULT (VDJ_API *DeclareParameter)(void *parameter,int type,int id,char *name,int defaultvalue);
	// OnParameter will be called each time a parameter is changed from within VirtualDJ
	virtual HRESULT VDJ_API OnParameter(int id) {return 0;}

	// Custom user-interface
	// Create a Window using CreateWindow() or CreateDialog(), and send back the VDJ_WINDOW.
	// If you return E_NOTIMPL, the default interface will be used.
	virtual HRESULT VDJ_API OnGetUserInterface(VDJ_WINDOW *hWnd) {return E_NOTIMPL;}
	VDJ_HINSTANCE hInstance;
	int Width,Height;
};

//////////////////////////////////////////////////////////////////////////
// GUID definitions

#ifndef VDJCLASSGUID_DEFINED
#define VDJCLASSGUID_DEFINED
static const GUID CLSID_VdjPlugin6 = { 0x37db664a, 0x6cf1, 0x4768, { 0xbc, 0x69, 0x32, 0x68, 0x13, 0xbf, 0xb, 0xf4 } };
static const GUID CLSID_VdjPlugin5 = { 0x2e1480fe, 0x4ff4, 0x4539, { 0x90, 0xb3, 0x64, 0x5f, 0x5d, 0x86, 0xf9, 0x3b } };
static const GUID IID_IVdjPluginBasic = { 0x865a6bbe, 0xed4b, 0x4bd5, { 0x93, 0xfe, 0x25, 0xa6, 0x26, 0xe2, 0x56, 0x1f } };
#else
extern static const GUID CLSID_VdjPlugin6;
extern static const GUID CLSID_VdjPlugin5;
extern static const GUID IID_IVdjPluginBasic;
#endif

//////////////////////////////////////////////////////////////////////////
// DLL export function

#ifndef NODLLEXPORT
#ifdef __cplusplus
extern "C" {
#endif
	VDJ_EXPORT HRESULT VDJ_API DllGetClassObject(const GUID &rclsid,const GUID &riid,void** ppObject);
#ifdef __cplusplus
}
#endif
#endif

//////////////////////////////////////////////////////////////////////////

#endif /* VdjPlugin_H */

wchar_t filenameUTF16[512]=TEXT("");
char filename[512];
DeclareParameter(filename,VDJPARAM_STRING, ID_STRING ,"Filename",sizeof(filename));
[...]
int len = (int) lstrlenA(filename) + 1;
MultiByteToWideChar( CP_UTF8, 0, filename, len, filenameUTF16, 512 );

int len = (int) lstrlenW( filenameUTF16) + 1;
WideCharToMultiByte( CP_UTF8, 0,  filenameUTF16, len, filename, 512, NULL, NULL);

#define SAMPLING_RATE 44100

infos->Flag=VDJPLUGINFLAG_PROCESSSCRATCH;