Skip to content

Latest commit

 

History

History
102 lines (78 loc) · 2.77 KB

BUILD.md

File metadata and controls

102 lines (78 loc) · 2.77 KB
Raw

Building the Plugins from Source

To build custom UGens on the Bela you now have to tell cmake where your external dependencies are. These include, for example, the Bela headers and API, the Trill library, and also also any other things you may want to include from 3rd party sources.

The UGens need to be built on the Bela. Make sure you have the SuperCollider source on your Bela. SSH in...

> ssh [email protected]

Edit your CMakeLists.txt

CMakeLists.txt must have all the appropriate libraries included and that you've set the FILENAME var to the name of your UGen's .cpp file

Add these lines

set(FILENAME TrillCentroids.cpp)
set(CMAKE_BUILD_TYPE Release)


set(BELA_PATH /root/Bela/)

# Include all the search directories
include_directories(${SC_PATH}/include/plugin_interface)
include_directories(${SC_PATH}/include/common)
include_directories(${SC_PATH}/common)
include_directories(${BELA_PATH})
include_directories(${BELA_PATH}/include)
include_directories(${BELA_PATH}/lib)
# include_directories(${BELA_PATH}/libraries)
include_directories(${BELA_PATH}/libraries/Trill/)

# Build the shared library
add_library(${PROJECT} MODULE
  ${FILENAME}
  ${BELA_PATH}/libraries/Trill/Trill.cpp
)

Go into the project dir for your UGen and make a build directory

> cd Trill_SC/Bela_UGens/TrillCentroids && mkdir build && cd build

Configure CMAKE

DSC_PATH needs to point to your SuperCollider source (I dropped my source into ~, the source should match whatever version of SC is on the Bela).

DBELA_PATH needs to point to the main Bela directory (usually ~/Bela)

> cmake -DSC_PATH=~/supercollider3.10b/ -DBELA_PATH=~/Bela/ ..

Run the make command

> make

Copy the compiled shared object (.so) into the ext directory

> mv TrillCentroids.so ../../../ext/Trill/

remember to symlink this extensions directory to your SC Extensions

> ln -s ~/Trill_SC/ext/ /usr/local/share/SuperCollider/Extensions/TrillUGens

Debug... Repeat...

note You can save some time in your workflow by running the server and running the language separately/remotely.

You can also combine the whole make/mv/scsynth process with a single line.

> make && mv TrillCentroids.so ../../../ext/Trill/ && scsynth -u 57110 -z 16 -J 8 -K 8 -G 16 -i 2 -o 2

...then on your laptop you can remotely attach to the server...

( // connect to the already-running remote belaserver
Server.default = s = Server("belaServer", NetAddr("192.168.7.2", 57110));
s.options.maxLogins = 4; // should match the settings on the Bela
s.initTree;
s.startAliveThread;
);
s.plotTree;
s.freeAll;

// Make sure your UGen class file is visible to SC on your host machine..
// then you can test it out...
{
    var output;
    output = MyUGen.kr(1, 2, 3.0);
}.play(s);