History

About [pdsheefa]

Written for use with Pure Data, the pdsheefa library provides externals and patches to provide support for creating pd-based SPIN SPIN Framework clients for scene management (show control) and audio rendering. The library contains several objects related to distributed network control. Control signals can be managed, filtered and redirected using several utility objects and abstractions. There is support for simple HID devices (mouse, keyboard, joysticks) and the Ubisense tracking system. Some of the patches and extenals in this library, were taken from other (now frozen) repositories, such as "audioscape", spinwidgets, and pdsheefa-0.3.6. The library also consolidates the xjimmies library (from nSLAM).

License: GPL

Authors: Mike Wozniewski, Zack Settel.

Developed in partnership with:

Download & Install binary package

  1. Download older tarballs from: http://code.sat.qc.ca/downloads/pdsheefa.
    or Download the latest tarballs from: http://code.sat.qc.ca/redmine/projects/pdsheefa/files
  2. Unpack the tarball.
  3. Add that path to the list of searched paths in Pd (ie, using the "File > Path" menu in Linux, or "Pd > Preferences > Path" in OSX)

Typical paths are:

  • OSX: /Users/userName/Library/Pd/pdsheefa
  • Linux: /home/userName/pd-externals/pdsheefa

(see instructions in the README in the pdsheefa directory)

Requirements

The pdsheefa library requires pd-extended

Although any version of greater than 0.42.5 should work, note that pdsheefa has been successfully tested using the following configurations:

Ubuntu Precise 64-bit:

Not yet packaged, so download it here: Pd-0.43.1-extended-20120430.deb

Ubuntu Precise 32-bit:

Not yet packaged, so download it here: Pd-0.43.1-extended-ubuntu-precise-i386.deb

Ubuntu Lucid 32-bit:

sudo apt-get install tk tcllib libmp3lame0 libquicktime1 libimlib2
wget http://sourceforge.net/projects/pure-data/files/pd-extended/0.42.5/Pd-0.42.5-extended-ubuntu-lucid-i386.deb
sudo dpkg -i Pd-0.42.5-extended-ubuntu-lucid-i386.deb

Ubuntu Lucid 64-bit:

sudo apt-get install tk tcllib libmp3lame0 libquicktime1 libimlib2
wget http://sourceforge.net/projects/pure-data/files/pd-extended/0.42.5/Pd-0.42.5-extended-ubuntu-lucid-amd64.deb
sudo dpkg -i Pd-0.42.5-extended-ubuntu-lucid-amd64.deb

OSX 10.6:

http://sourceforge.net/projects/pure-data/files/pd-extended/0.42.5/Pd-0.42.5-extended-macosx104-i386.dmg
# then double-click the .dmg and drag the app to your Applications folder

Other dependencies

For the pdsheefa tarball on OSX, you do NOT need any other dependencies.

For Linux, or if you wish to compile from source on ANY OS:

Dependency: liblo

On OSX (using Macports):

sudo port install liblo

then

sudo port upgrade --enforce-variants liblo +universal

On Ubuntu:

sudo apt-get install liblo7

OR (Linus/OSX) you can build from sources:
You will need to compile/install liblo if you with to use the [OSCrxtx] object for OpenSoundControl.
note: For OSX, you will need to make a universal build.

Dependency: libcwiid (Linux only)

For the [cwiidmote] object, that allows use of Nintendo Wii controllers, you will need to install Cwiid

sudo apt-get install libcwiid-dev

Building from source

Do the following:

git clone https://code.sat.qc.ca/redmine/pdsheefa.git
cd pdsheefa
make all
sudo make install-all

If you want the lite version of pdsheefa (no externals for sensors), replace the last two lines with:

make
sudo make install

NOTE: If you've installed pdsheefa from source, the typical search path that you need to specify in Pd-Extended is:

/usr/local/lib/pd-externals/pdsheefa

Related Projects

SPIN Framework: www.spinframework.org

pdsheefa was created as part of the realtime protoyping environment for the SPIN Framework (formerly Audioscape). This networked client/server framework provides a distributed architecture for the management of shared virtual environments. A server maintains the state of 3D content, where client applications can connect and send messages to move content, or receive messages when the content has been modified. Clients typically include editors (immersive display systems, audio spatializers), editing programs/scripts, motion tracking systems, mapping applications, etc. (MORE)