cannam@21:

plugguard.h File Reference

cannam@21:

cannam@21: cannam@21:

cannam@21: Go to the source code of this file. cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21:

Defines
#define _VAMP_IN_PLUGINSDK 1
Normal usage should be:.
#define _VAMP_SDK_PLUGSPACE_BEGIN(h)
#define _VAMP_SDK_PLUGSPACE_END(h)
cannam@21:

Define Documentation

cannam@21: cannam@21:

cannam@21:

cannam@21: cannam@21: cannam@21: cannam@21: cannam@21:

#define _VAMP_IN_PLUGINSDK 1

cannam@21:

cannam@21: cannam@21:

cannam@21: Normal usage should be:. cannam@21:

cannam@21:

Plugins include vamp-sdk/Plugin.h or vamp-sdk/PluginBase.h. These files include this header, which specifies an appropriate namespace for the plugin classes to avoid any risk of conflict with non-plugin class implementations in the host on load.

cannam@21:

Hosts include vamp-hostsdk/Plugin.h, vamp-hostsdk/PluginBase.h, vamp-hostsdk/PluginHostAdapter, vamp-hostsdk/PluginLoader.h etc. These files include vamp-hostsdk/hostguard.h, which makes a note that we are in a host. A file such as vamp-hostsdk/Plugin.h then simply includes vamp-sdk/Plugin.h, and this guard header takes notice of the fact that it has been included from a host and leaves the plugin namespace unset.

cannam@21:

cannam@21: Problems will occur when a host includes files directly from the vamp-sdk directory. There are two reasons this might happen: mistake, perhaps owing to ignorance of the fact that this isn't allowed (particularly since it was the normal mechanism in v1 of the SDK); and a wish to incorporate plugin code directly into the host rather than having to load it.

cannam@21: What if the host does include a vamp-sdk header by mistake? We can catch it if it's included before something from vamp-hostsdk. If it's included after something from vamp-hostsdk, it will work OK anyway. The remaining problem case is where nothing from vamp-hostsdk is included in the same file. We can't catch that. cannam@21:

Definition at line 72 of file plugguard.h.

cannam@21: cannam@21:

cannam@21:

cannam@21: cannam@21:

cannam@21:

cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21:

#define _VAMP_SDK_PLUGSPACE_BEGIN ( h )

cannam@21:

cannam@21: cannam@21:

Definition at line 75 of file plugguard.h.

cannam@21: cannam@21:

cannam@21:

cannam@21: cannam@21:

cannam@21:

cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21: cannam@21:

#define _VAMP_SDK_PLUGSPACE_END ( h )

cannam@21:

cannam@21: cannam@21:

Definition at line 76 of file plugguard.h.

cannam@21: cannam@21:

cannam@21:


Defines
#define	_VAMP_IN_PLUGINSDK 1
	Normal usage should be:.
#define	_VAMP_SDK_PLUGSPACE_BEGIN(h)
#define	_VAMP_SDK_PLUGSPACE_END(h)