flext – C++ development layer for Pure Data and Max
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
build updates for newer STK and SndObj versions Mar 7, 2009
buildsys
examples
flext.xcodeproj Update xcode project to work with Xcode 10 Dec 7, 2018
source
tutorial
.gitignore Add opp files to gitignore May 16, 2017
Doxyfile
Makefile.am Modifications to autoconf files Jul 15, 2015
bootstrap.sh fixed bootstrapping Apr 4, 2008
build.bat new idle callback/method functionality Jun 14, 2007
build.sh
build.txt canonical spelling is Pd (not PD) Jul 15, 2015
changes.txt canonical spelling is Pd (not PD) Jul 15, 2015
configure.ac Fixed typo Nov 2, 2016
flext.mcp
flext.sln removed executable flags from data files Jul 15, 2015
flext.vcproj
flext.vcxproj
flext.vcxproj.filters
flext_settings_VS.props
gpl.txt
license.txt
max-flext.pc.in
notes.txt canonical spelling is Pd (not PD) Jul 15, 2015
package.txt
pd-flext.pc.in
readme.txt

readme.txt

flext - C++ layer for Max/MSP and Pd (Pure Data) externals

Copyright (c) 2001-2015 Thomas Grill (gr@grrrr.org)
For information on usage and redistribution, and for a DISCLAIMER OF ALL
WARRANTIES, see the file, "license.txt," in this distribution.

This package seeks to encourage the development of open source software
for the pd and Max/MSP platforms.

Donations for further development of the package are highly appreciated.
https://www.paypal.com/xclick/business=gr%40grrrr.org&item_name=flext&no_note=1&tax=0&currency_code=EUR

----------------------------------------------------------------------------

Abstract:

flext seeks to represent a uniform programming interface for extending the most common
modular real-time audio systems Max/MSP and Pure Data (Pd) with external modules, or
short externals. These modules provide a way to tailor such a system for oneís
special needs and supply additional functionality.

Source code based on flext is able to exploit most common features of the
respective real-time framework while staying completely independent of the
actual host system and platform (hardware and operating system).

flext currently supports development for Pd under Linux, Windows and OSX as well as
Max/MSP under OS9, OSX and Windows with various programming environments.

----------------------------------------------------------------------------

Goals/features of the package:

pros:
- better readability of code compared to straight C externals
- faster development, more robust coding
- sharing of common methods and data by using base classes
- any input to any inlet (with the exception of signal streams)
- transparent use of threads for methods
- libraries of externals in Max/MSP
- more than 3 typed creation arguments possible for Max/MSP

cons:
- introduces a small overhead to speed of message and signal handling
- larger memory footprint

----------------------------------------------------------------------------

Prerequisites:

--- Pd ---
    You need the pd source code which is most likely part of the distribution.
    Otherwise download from: http://msp.ucsd.edu/software.html

--- Max/MSP ---
    You will need the latest Max/MSP SDK: https://cycling74.com/downloads/sdk

--- SndObj ---
    If you choose to compile with SndObj support you will need the respective library
    download from: http://www.may.ie/academic/music/musictec/SndObj/main.html

--- STK ---
    If you choose to compile with STK support you will need the respective package
    and build a library.
    download from: https://ccrma.stanford.edu/software/stk/
    For linking it may preferable to use a library of all the STK objects.

    Under linux you can create one from the STK directory with something like
    > g++ -c -pipe -I include -D __LINUX_OSS__ src/*.cpp && ar r libstk.a *.o && rm -f *.o

    Under Windows you can build a static STK library with the following commands:
    > cl src/*.c* /MT /D__OS_WINDOWS__ /EHsc /Ox /Iinclude /I../pthreads/include /c
    > lib *.obj /out:stk.lib
    Please note, that you have to have pthreads installed (../pthreads points to it in the command)
    Also, the resulting stk.lib will be a multithreaded build, linked to a static C library.
    Consequently you should also use multithreaded flext for your flext-based external.

----------------------------------------------------------------------------

Building and installing of flext and flext-based externals:

    See the build.txt document

----------------------------------------------------------------------------

Various notes / limitations / bug list:

    Read the notes.txt document

----------------------------------------------------------------------------

History of changes:

    Read the changes.txt document