Mercurial > hg > vamp-plugin-sdk
diff README @ 162:8c8854a78dcd
* Update README, .la files etc for 1.3
author | cannam |
---|---|
date | Wed, 09 Jul 2008 09:36:39 +0000 |
parents | 1da43924fa14 |
children | d643927816aa |
line wrap: on
line diff
--- a/README Mon Jul 07 17:17:11 2008 +0000 +++ b/README Wed Jul 09 09:36:39 2008 +0000 @@ -49,7 +49,7 @@ About this SDK ============== -This is version 1.2 of the Vamp plugin Software Development Kit. +This is version 1.3 of the Vamp plugin Software Development Kit. Plugins and hosts built with this SDK are binary compatible with those built using version 1.0 of the SDK. @@ -76,16 +76,12 @@ to expose the correct C API for the plugin. Plugin authors should read vamp-sdk/PluginBase.h and Plugin.h for code documentation, and refer to the example plugin code in the examples directory. Plugins -should link with -lvampsdk. [*NOTE: this has changed from vamp-sdk in -previous versions, to avoid conflict with the use of hyphens for -library versioning schemes on some platforms.] +should link with -lvamp-sdk. Hosts may use the Vamp::PluginHostAdapter to convert the loaded plugin's C API back into a Vamp::Plugin object. Host authors should refer to the example host code in the host directory. Hosts should -link with -lvamphostsdk. [*NOTE: this has changed from vamp-hostsdk -in previous versions, to avoid conflict with the use of hyphens for -library versioning schemes on some platforms.] +link with -lvamp-hostsdk. * vamp-sdk/hostext @@ -180,18 +176,51 @@ provides support for plugin category lookup using this scheme. -Building and Installing the SDK and Examples -============================================ +Compiling the SDK and Examples +============================== -To build the SDK, the simple host, and the example plugins, edit the +This SDK is intended for use on Windows, OS/X, Linux, and other POSIX +platforms. + + * Windows + +A project file for Visual Studio is included (VampPluginSDK.vcproj). +This builds the SDK library, but does not build the example plugins or +command-line host. + +Alternatively, when using Visual Studio or another IDE to build a +plugin or host using the SDK, you can simply add the .cpp files in the +vamp-sdk and vamp-sdk/hostext directories to your existing project. + +If you are using a Cygwin or MinGW GNU toolchain, use the included +Makefile (see Linux and other POSIX platforms below). + + * OS/X + +Run "make -f Makefile.osx" to build the SDK, example plugins, and +command-line host. + +Note that the host requires that you have libsndfile +(http://www.mega-nerd.com/libsndfile/) installed. To build only the +SDK and examples, "make -f Makefile.osx sdk examples". + +If you are using an IDE, you may prefer to simply add the .cpp files +in the vamp-sdk and vamp-sdk/hostext directories to your existing +project. + + * Linux and other POSIX platforms + +To build the SDK, example plugins, and command-line host, edit the Makefile to suit your platform according to the comments in it, then run "make". -There is a ready-tweaked Makefile for use on OS/X; to use it, run -"make -f Makefile.osx". +Note that the host requires that you have libsndfile +(http://www.mega-nerd.com/libsndfile/) installed. To build only the +SDK and examples, edit the Makefile then run "make sdk examples". -To use an IDE to build a plugin or host using the Vamp SDK, simply add -the .cpp files in the vamp-sdk directory to your project. + +Installing the Example Plugins +============================== Installing the example plugins so that they can be found by other Vamp hosts depends on your platform: