Please read this topic first:
http://www.virtualdj.com/wiki/Plugin_Guide
I advise you to use this file for better compatbility PC/MAC instead: vdjPlugin.h
> The actions used by the function SendCommand() are always the ones listed in the Mapper section of VirtualDJ (also see English.xml)
> For the function GetInfo(), see the post in this forum
> .ini files (Plugin settings) are saved in UTF-8
So to convert a string saved in UTF-8 to UTF-16, please use:
and to convert a string saved in UTF-16 to UTF-8, please use:
For DSP plugins:
> Frequency used in VirtualDJ:
> You can create "asynchronous" sound plugin (the sound plugin still works even if the button stop is pushed) by using the following flag:
In this case, the input audio buffer is called after the pitch instead of before. So such a plugin has directly access to the final buffer which has a constant size of "latency" samples (except during loop where the buffer size is 64 samples)
http://www.virtualdj.com/wiki/Plugin_Guide
I advise you to use this file for better compatbility PC/MAC instead: vdjPlugin.h
//////////////////////////////////////////////////////////////////////////
//
// 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 */
> The actions used by the function SendCommand() are always the ones listed in the Mapper section of VirtualDJ (also see English.xml)
> For the function GetInfo(), see the post in this forum
> .ini files (Plugin settings) are saved in UTF-8
So to convert a string saved in UTF-8 to UTF-16, please use:
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 );
and to convert a string saved in UTF-16 to UTF-8, please use:
int len = (int) lstrlenW( filenameUTF16) + 1;
WideCharToMultiByte( CP_UTF8, 0, filenameUTF16, len, filename, 512, NULL, NULL);
For DSP plugins:
> Frequency used in VirtualDJ:
#define SAMPLING_RATE 44100
> You can create "asynchronous" sound plugin (the sound plugin still works even if the button stop is pushed) by using the following flag:
infos->Flag=VDJPLUGINFLAG_PROCESSSCRATCH;
In this case, the input audio buffer is called after the pitch instead of before. So such a plugin has directly access to the final buffer which has a constant size of "latency" samples (except during loop where the buffer size is 64 samples)
发表时间 Sun 08 May 11 @ 4:24 am