externals/grill/flext build.txt,NONE,1.1 AUTHORS,1.1,1.2 INSTALL,1.1,1.2 NEWS,1.1,1.2 build.bat,1.3,1.4 build.sh,1.2,1.3 changes.txt,1.66,1.67 configure.ac,1.2,1.3 flext.doxy,1.11,1.12 license.txt,1.2,1.3 package.txt,1.3,1.4 readme.txt,1.47,1.48 - Pd-cvs

5 Jan 2005


      Update of /cvsroot/pure-data/externals/grill/flext
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv12682
Modified Files:
    AUTHORS INSTALL NEWS build.bat build.sh changes.txt 
    configure.ac flext.doxy license.txt package.txt readme.txt 
Added Files:
    build.txt 
Log Message:
made default configurations generic
two more flext tutorials
fixes for Max headers
cleanups
updated build system
updated tutorials
revised the documentation
updated for OSX
upgraded version number
Index: changes.txt
===================================================================
RCS file: /cvsroot/pure-data/externals/grill/flext/changes.txt,v
retrieving revision 1.66
retrieving revision 1.67
diff -C2 -d -r1.66 -r1.67
*** changes.txt	3 Jan 2005 05:00:25 -0000	1.66
--- changes.txt	5 Jan 2005 05:04:07 -0000	1.67
***************
*** 14,18 ****
  Version history:
! 0.4.8:
  - fixes for 64 bit builds (size_t is integer type of pointer size)
  - finally added a autoconf system (many many thanks to Tim Blechmann)
--- 14,18 ----
  Version history:
! 0.5.0:
  - fixes for 64 bit builds (size_t is integer type of pointer size)
  - finally added a autoconf system (many many thanks to Tim Blechmann)
***************
*** 322,335 ****
  TODO list:
- for 0.4.8:
- - SIMD for gcc
- - Max/MSP MachO support
- 
- for 0.5.0:
  - optimizations for object initialization and messaging
bugs:
- - recreation of object with different argument line forgets about eventually present attributes
- 
  - can't use MFC libraries because of global new and delete overloadings
--- 322,329 ----
  TODO list:
- optimizations for object initialization and messaging
+ - SIMD for gcc
bugs:
  - can't use MFC libraries because of global new and delete overloadings
Index: build.bat
===================================================================
RCS file: /cvsroot/pure-data/externals/grill/flext/build.bat,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** build.bat	4 Jan 2005 04:58:46 -0000	1.3
--- build.bat	5 Jan 2005 05:04:07 -0000	1.4
***************
*** 1,40 ****
! @set flext=%~dp0
! @rem Arguments:
! @rem %1 - platform (win/lnx/mac)
! @rem %2 - system (pd/max)
! @rem %3 - compiler (msvc/gcc/mingw/cygwin/bcc/icc)
! @rem %4 - target (build/clean/install)
! @set platform=%1
! @set rtsys=%2
! @set compiler=%3
! @set target=%4
! @rem --- The subbatch knowns which make utility to use ---
! @set subbatch=%flext%buildsys\build-%compiler%.bat
! @if "%platform%"=="" goto syntax
! @if "%rtsys%"=="" goto syntax
! @if "%compiler%"=="" goto syntax
! @if not exist %subbatch% goto syntax
! @call %subpatch% %subbatch% %platform% %rtsys% %target% %5 %6 %7 %8 %9
! @goto end
! @rem -----------------------------------------
  :syntax
! @echo .
! @echo SYNTAX: build [platform] [system] [compiler] {target}
! @echo platform ... win / lnx / mac
! @echo system   ... pd / max
! @echo compiler ... msvc / gcc / mingw / cygwin / bcc / icc
! @echo target   ... all (default) / clean / install
! @echo .
! @echo Please make sure that your make program and compiler can be accessed with the
! @echo system path and that all relevant environment variables are properly set.
:end
--- 1,58 ----
! @echo off
! rem
! rem flext - C++ layer for Max/MSP and pd (pure data) externals
! rem
! rem Copyright (c) 2001-2005 Thomas Grill (gr@grrrr.org)
! rem For information on usage and redistribution, and for a DISCLAIMER OF ALL
! rem WARRANTIES, see the file, "license.txt," in this distribution.  
! rem
! rem more information on http://grrrr.org/ext
! rem ------------------------------------------------------------------------
! rem
! rem To build flext or flext-based externals simply run this script.
! rem Running it without arguments will print some help to the console.
! rem
! rem ------------------------------------------------------------------------
! set flext=%~dp0
! rem Arguments:
! rem %1 - platform (win/lnx/mac)
! rem %2 - system (pd/max)
! rem %3 - compiler (msvc/gcc/mingw/cygwin/bcc/icc)
! rem %4 - target (build/clean/install)
! set platform=%1
! set rtsys=%2
! set compiler=%3
! set target=%4
! rem --- The subbatch knowns which make utility to use ---
! set subbatch=%flext%buildsys\build-%compiler%.bat
! if "%platform%"=="" goto syntax
! if "%rtsys%"=="" goto syntax
! if "%compiler%"=="" goto syntax
! if not exist %subbatch% goto syntax
! call %subpatch% %subbatch% %platform% %rtsys% %target% %5 %6 %7 %8 %9
! 
! goto end
! 
! rem -----------------------------------------
  :syntax
! echo .
! echo SYNTAX: build [platform] [system] [compiler] {target}
! echo platform ... win / lnx / mac
! echo system   ... pd / max
! echo compiler ... msvc / gcc / mingw / cygwin / bcc / icc
! echo target   ... all (default) / clean / install
! echo .
! echo Please make sure that your make program and compiler can be accessed with the
! echo system path and that all relevant environment variables are properly set.
! echo .
:end
--- NEW FILE: build.txt ---
flext - C++ layer for Max/MSP and pd (pure data) externals
Copyright (c) 2001-2005 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 document consists of the following parts:
1) Using the flext build system
1.1) Building flext
1.2) Building externals
2) Using autoconf
3) Other ways to compile flext and flext-based externals
----------------------------------------------------------------------------
1) Using the flext build system
===============================
flext provides a universal build system which supports
- various operating systems
    Windows (win)
    Linux (lnx)
    MacOSX (mac)
- various real-time systems
    Pure Data (pd)
    Max/MSP (max)
- various make programs
    GNU make (gnumake)
    Microsoft nmake (nmake)
    Borland make (bmake)
- various compilers
    Microsoft Visual C/C++ 6.0 or .NET 2002/2003 (msvc)
    GNU gcc 2.95 and above (gcc,cygwin,mingw)
    Borland bcc32 (bcc)
Useful combinations of the above are
win pd msvc, using nmake
win pd cygwin, using gnumake
win pd mingw, using gnumake
win max msvc, using nmake
win pd bcc, using bmake
mac pd gcc, using gnumake
mac max gcc, using gnumake - Mach-O externals only (Max 4.5 upwards)
There are two central scripts in the flext folder which invoke the building process:
- build.sh for bash shells (Linux, MacOSX, cygwin)
- build.bat for the Windows command prompt
A project needs to provide some information in order to be built properly.
By default, this resides in a file called package.txt
Please note, that the build system is shell-oriented, which means, that you'll have
to launch a command prompt (cmd.exe under Windows) and probably also set some
environment variables for your development system (e.g. run vcvars32.bat for Microsoft Visual Studio)
By invoking one of the build scripts (e.g. with "bash build.sh" under unix, 
or just "build" unter Windows) you'll get some lines of help.
Operating System, real-time system and compiler need to be provided as arguments.
See buildsys/readme.txt for developer-centered information.
1.1) Building flext
===================
Flext can build itself using the build system.
...
From the flext main directory, run the build script
e.g. under Windows
    build win pd msvc
or under unix with
    bash build.sh lnx pd gcc
When you run it for the first time, one or more configuration files will be created 
from templates - you will get a message on the console. 
You should edit the files to adapt it to your system.
Then install flext with (under Windows)
    build win pd msvc install
or (under unix)
    bash build.sh lnx pd gcc install
1.2) Building externals
=======================
The flext build system can be used to compile flext-based externals or also
native PD and Max/MSP externals, provided there is a package.txt file in the project folder.
In the shell, change to the project folder.
Then, simply run the flext build script,
e.g. under Windows
    ..\flext\build win pd msvc
Then install your newly built external with
    ..\flext\build win pd msvc install
or under unix with
    bash ../flext/build.sh lnx pd gcc
Then install your external with
    bash ../flext/build.sh lnx pd gcc install
----------------------------------------------------------------------------
2) Using autoconf
=================
Thanks to Tim Blechmann, flext can also be built using autoconf.
This only works under unix shells.
When starting from a fresh cvs-based copy of flext first run
./bootstrap.sh
then you can run
./configure --help 
to get a page of options.
You need to pass the path to the PD source files to the ./configure script, e.g. with
./configure --with-sysdir=/usr/local/src/pd/src
Then build flext with
make
and install it with
su -c "make install"
----------------------------------------------------------------------------
3) Other ways to compile flext and flext-based externals
========================================================
- Windows - Microsoft Visual Studio projects (.vcproj files)
Please have a look at the projects delivered with flext and flext-based externals.
- MacOSX - Apple Xcode projects (.xcode bundles)
Please have a look at the projects delivered with flext and flext-based externals.
- MacOSX - Metrowerks Codewarrior (.mcp files)
You should have the following "Source Trees" (CW preferences, not project specific!) defined:
"OS X Volume" - Pointing to your OSX boot drive
"flext" - Pointing to the flext main directory
"Cycling74 OSX" - Pointing to the SDK for Max/MSP - the path should end with /c74support
With your project using flext use the prefix file "flcwmax-x.h" or, 
alternatively "flcwmax-x-thr.h" for threading support.
- MacOS9 - Metrowerks Codewarrior (.mcp files)
You should have the following "Source Trees" (CW preferences, not project specific!) defined:
"flext" - Pointing to the flext main directory
"Cycling74" - Pointing to the Cycling 74 SDK
"MP SDK" - Pointing to the Multiprocessing SDK (for threading support)
With your project using flext use the prefix file "flcwmax.h" or, 
alternatively "flcwmax-thr.h" for threading support.
Index: AUTHORS
===================================================================
RCS file: /cvsroot/pure-data/externals/grill/flext/AUTHORS,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** AUTHORS	28 Oct 2004 04:01:37 -0000	1.1
--- AUTHORS	5 Jan 2005 05:04:07 -0000	1.2
***************
*** 1 ****
! Thomas Grill
\ No newline at end of file
--- 1 ----
! Thomas Grill (gr@grrrr.org)
Index: flext.doxy
===================================================================
RCS file: /cvsroot/pure-data/externals/grill/flext/flext.doxy,v
retrieving revision 1.11
retrieving revision 1.12
diff -C2 -d -r1.11 -r1.12
*** flext.doxy	26 Sep 2004 22:55:14 -0000	1.11
--- flext.doxy	5 Jan 2005 05:04:07 -0000	1.12
***************
*** 5,10 ****
  #---------------------------------------------------------------------------
  PROJECT_NAME           = flext
! PROJECT_NUMBER         = "version 0.4.7"
! OUTPUT_DIRECTORY       = c:/data/prog/max/flext/doc/
  OUTPUT_LANGUAGE        = English
  USE_WINDOWS_ENCODING   = YES
--- 5,10 ----
  #---------------------------------------------------------------------------
  PROJECT_NAME           = flext
! PROJECT_NUMBER         = "version 0.5.0"
! OUTPUT_DIRECTORY       = c:/data/pdmax/flext/doc/
  OUTPUT_LANGUAGE        = English
  USE_WINDOWS_ENCODING   = YES
***************
*** 63,67 ****
  # configuration options related to the input files
  #---------------------------------------------------------------------------
! INPUT                  = F:/prog/max/flext/source/
  FILE_PATTERNS          = 
  RECURSIVE              = NO
--- 63,67 ----
  # configuration options related to the input files
  #---------------------------------------------------------------------------
! INPUT                  = c:/data/pdmax/flext/source/
  FILE_PATTERNS          = 
  RECURSIVE              = NO
Index: configure.ac
===================================================================
RCS file: /cvsroot/pure-data/externals/grill/flext/configure.ac,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** configure.ac	28 Oct 2004 04:01:37 -0000	1.2
--- configure.ac	5 Jan 2005 05:04:07 -0000	1.3
***************
*** 7,11 ****
  API_VERSION=0:0:0
! AC_INIT([flext],[0.4.7],[gr@grrrr.org],[flext])
  AM_INIT_AUTOMAKE(1.8)
--- 7,11 ----
  API_VERSION=0:0:0
! AC_INIT([flext],[0.5.0],[gr@grrrr.org],[flext])
  AM_INIT_AUTOMAKE(1.8)
Index: INSTALL
===================================================================
RCS file: /cvsroot/pure-data/externals/grill/flext/INSTALL,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** INSTALL	28 Oct 2004 04:01:37 -0000	1.1
--- INSTALL	5 Jan 2005 05:04:07 -0000	1.2
***************
*** 1,2 ****
--- 1,7 ----
+ These are instructions for the autoconf building system.
+ For the native flext build system, please see the build.txt document.
+ 
+ -----------------------------------------------------------------------
+ 
  Basic Installation
  ==================
Index: package.txt
===================================================================
RCS file: /cvsroot/pure-data/externals/grill/flext/package.txt,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** package.txt	4 Jan 2005 04:58:51 -0000	1.3
--- package.txt	5 Jan 2005 05:04:07 -0000	1.4
***************
*** 1,29 ****
! NAME=flext
! 
! BUILDCLASS=flext
! BUILDMODE=all
! BUILDTYPE=all
SRCDIR=source
! PRECOMPILE=flext.h
! 
! SRCS= \
! 	flbase.cpp flext.cpp flbuf.cpp fldsp.cpp fllib.cpp \
! 	flxlet.cpp flattr.cpp flattr_ed.cpp flsupport.cpp \
! 	flutil.cpp flatom.cpp flatom_pr.cpp flthr.cpp fltimer.cpp flsimd.cpp flout.cpp \
! 	flatom_app.cpp flatom_part.cpp flitem.cpp flmeth.cpp flmsg.cpp \
! 	flproxy.cpp flqueue.cpp flbind.cpp
! HDRS= \
! 	flprefix.h flstdc.h flbase.h flclass.h flext.h flsupport.h flmap.h fldsp.h flinternal.h \
! 	fldefs.h fldefs_hdr.h fldefs_setup.h \
! 	fldefs_methcb.h fldefs_meththr.h fldefs_methadd.h fldefs_methbind.h fldefs_methcall.h \
! 	fldefs_attrcb.h fldefs_attrvar.h fldefs_attradd.h
! 
! 
! SRCS_SNDOBJ=flsndobj.cpp
! HDRS_SNDOBJ=flsndobj.h
! 
! SRCS_STK=flstk.cpp
! 
! HDRS_STK=flstk.h
--- 1,45 ----
! #
! # flext - C++ layer for Max/MSP and pd (pure data) externals
! #
! # Copyright (c) 2001-2005 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.  
! #
! # more information on http://grrrr.org/ext
! # ------------------------------------------------------------------------
! #
! # This file contains information for the building process
! #
! # DO NOT EDIT!!
! #
! # ------------------------------------------------------------------------
! 
! NAME=flext
! 
! BUILDCLASS=flext
! BUILDMODE=all
! BUILDTYPE=all
SRCDIR=source
! PRECOMPILE=flext.h
! 
! SRCS= \
! 	flbase.cpp flext.cpp flbuf.cpp fldsp.cpp fllib.cpp \
! 	flxlet.cpp flattr.cpp flattr_ed.cpp flsupport.cpp \
! 	flutil.cpp flatom.cpp flatom_pr.cpp flthr.cpp fltimer.cpp flsimd.cpp flout.cpp \
! 	flatom_app.cpp flatom_part.cpp flitem.cpp flmeth.cpp flmsg.cpp \
! 	flproxy.cpp flqueue.cpp flbind.cpp
! HDRS= \
! 	flprefix.h flstdc.h flbase.h flclass.h flext.h flsupport.h flmap.h fldsp.h flinternal.h \
! 	fldefs.h fldefs_hdr.h fldefs_setup.h \
! 	fldefs_methcb.h fldefs_meththr.h fldefs_methadd.h fldefs_methbind.h fldefs_methcall.h \
! 	fldefs_attrcb.h fldefs_attrvar.h fldefs_attradd.h
! 
! 
! SRCS_SNDOBJ=flsndobj.cpp
! HDRS_SNDOBJ=flsndobj.h
! 
! SRCS_STK=flstk.cpp
! 
! HDRS_STK=flstk.h
Index: NEWS
===================================================================
RCS file: /cvsroot/pure-data/externals/grill/flext/NEWS,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** NEWS	28 Oct 2004 04:01:37 -0000	1.1
--- NEWS	5 Jan 2005 05:04:07 -0000	1.2
***************
*** 0 ****
--- 1 ----
+ see changes.txt
Index: build.sh
===================================================================
RCS file: /cvsroot/pure-data/externals/grill/flext/build.sh,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** build.sh	3 Jan 2005 05:00:25 -0000	1.2
--- build.sh	5 Jan 2005 05:04:07 -0000	1.3
***************
*** 1,2 ****
--- 1,18 ----
+ #! /bin/bash
+ 
+ # flext - C++ layer for Max/MSP and pd (pure data) externals
+ #
+ # Copyright (c) 2001-2005 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.  
+ #
+ # more information on http://grrrr.org/ext
+ # ------------------------------------------------------------------------
+ #
+ # To build flext or flext-based externals simply run this script.
+ # Running it without arguments will print some help to the console.
+ #
+ # ------------------------------------------------------------------------
+ 
  flext=${0%/*}/
  if [ "$flext" = "$0"/ ]; then flext=./ ; fi
***************
*** 19,23 ****
    [ -n "$platform" -a -n "$rtsys" -a -n "$compiler" -a -f $subbatch ]
  then 
! 	sh $subbatch $platform $rtsys $target $5 $6 $7 $8 $9
  else
    echo 
--- 35,39 ----
    [ -n "$platform" -a -n "$rtsys" -a -n "$compiler" -a -f $subbatch ]
  then 
! 	bash $subbatch $platform $rtsys $target $5 $6 $7 $8 $9
  else
    echo 
***************
*** 30,33 ****
--- 46,50 ----
    echo Please make sure that your make program and compiler can be accessed with the
    echo system path and that all relevant environment variables are properly set.
+ 	echo
  fi
Index: license.txt
===================================================================
RCS file: /cvsroot/pure-data/externals/grill/flext/license.txt,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** license.txt	1 Jan 2003 04:32:04 -0000	1.2
--- license.txt	5 Jan 2005 05:04:07 -0000	1.3
***************
*** 1,4 ****
  flext - C++ layer for Max/MSP and pd (pure data) externals
! Copyright (C) 2001-2003 Thomas Grill
This program is free software; you can redistribute it and/or
--- 1,4 ----
  flext - C++ layer for Max/MSP and pd (pure data) externals
! Copyright (C) 2001-2005 Thomas Grill
This program is free software; you can redistribute it and/or
***************
*** 17,49 ****
In the official flext distribution, the GNU General Public License is
! in the file gpl.txt
! 
! ---------------------------------------------------------
! 
!              OTHER COPYRIGHT NOTICES
! 
! ---------------------------------------------------------
! This package uses a lot of code from GEM by Mark Danks 
! See the license text below:
! 
! --- GEM --------------------------------------
! GEM - Graphics Environment for Multimedia
! Copyright (C) 1997-2000 Mark Danks
! 
! This program is free software; you can redistribute it and/or
! modify it under the terms of the GNU General Public License
! as published by the Free Software Foundation; either version 2
! of the License, or (at your option) any later version.
! 
! This program is distributed in the hope that it will be useful,
! but WITHOUT ANY WARRANTY; without even the implied warranty of
! MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
! GNU General Public License for more details.
! 
! You should have received a copy of the GNU General Public License
! along with this program; if not, write to the Free Software
! Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
! 
! In the official GEM distribution, the GNU General Public License is
! in the file GnuGPL.LICENSE
! 
--- 17,19 ----
In the official flext distribution, the GNU General Public License is
! in the file gpl.txt
\ No newline at end of file
Index: readme.txt
===================================================================
RCS file: /cvsroot/pure-data/externals/grill/flext/readme.txt,v
retrieving revision 1.47
retrieving revision 1.48
diff -C2 -d -r1.47 -r1.48
*** readme.txt	24 Aug 2004 02:34:30 -0000	1.47
--- readme.txt	5 Jan 2005 05:04:07 -0000	1.48
***************
*** 1,5 ****
  flext - C++ layer for Max/MSP and pd (pure data) externals
! Copyright (c) 2001-2004 Thomas Grill (xovo@gmx.net)
  For information on usage and redistribution, and for a DISCLAIMER OF ALL
  WARRANTIES, see the file, "license.txt," in this distribution.  
--- 1,5 ----
  flext - C++ layer for Max/MSP and pd (pure data) externals
! Copyright (c) 2001-2005 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.  
***************
*** 9,150 ****
Donations for further development of the package are highly appreciated.
! Visit https://www.paypal.com/xclick/business=t.grill%40gmx.net&item_name=flext...
----------------------------------------------------------------------------
! o for PD you need the pd source code (which is most likely part of the distribution)
!   download from: http://www-crca.ucsd.edu/~msp/software.html
! o for Max/MSP you will also need the Max/MSP SDK for OS9 (http://www.cycling74.com/products/dlmaxmsp.html) 
!   or OSX (http://www.cycling74.com/products/dlxmax.html)
!   and for threading the Multiprocessing library (download at http://developer.apple.com/sdk/)
! o 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
! o if you choose to compile with STK support you will need the respective package and build a library
!   download from: http://ccrma-www.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"
----------------------------------------------------------------------------
! BUILDING & INSTALLING:
! ======================
! 
! 
! pd - Windows:
! -------------
! o Microsoft Visual C++ 6 or 7: 
! 	edit "config-pd-msvc.txt"
! 	start a dos-shell (cmd.exe) and set the compiler environment (vcvars32.bat)
! 	run "build-pd-msvc.bat" 
! 
! o Borland C++ 5.5 (free): 
! 	edit "config-pd-bcc.txt" and run "build-pd-bcc.bat" 
! 	BCC++ currently supports non-threaded static flext libraries only
! 
! o Cygwin: edit "config-pd-cygwin.txt" & run "sh build-pd-cygwin.sh" 
! 	additional settings (e.g. target processor, compiler flags) can be made in makefile.pd-cygwin
! 
! o MinGW: edit "config-pd-mingw.txt" & run "build-pd-mingw.bat" 
! 	the MinGW binaries have to be in the PATH
! 	additional settings (e.g. target processor, compiler flags) can be made in makefile.pd-mingw
! 	MinGW currently supports non-threaded static flext libraries only
! 	
! 
! With your project using flext, be sure to define "FLEXT_SYS=2".
! 
! 
! pd - linux:
! -----------
! o GCC,ICC: edit "config-pd-linux.txt" & run "sh build-pd-linux.sh" 
! 	additional settings (e.g. target processor, compiler flags) can be made in makefile.pd-linux
! 
! Several variations of the flext library will be built: release and debug version of single-threaded and multi-threaded static libraries and of a multi-threaded shared library, respectively.
! These will be installed into the flext directory given in config-pd-linux.txt. For the shared libraries to be found, be sure to specify the flext folder in the /etc/ld.so.conf.
! 
! 
! With your project using flext, be sure to define "FLEXT_SYS=2".
! 
! 
! pd - MacOSX:
! -----------
! o GCC: edit "config-pd-darwin.txt" & run "sh build-pd-darwin.sh" 
! 	additional settings (e.g. target processor, compiler flags) can be made in makefile.pd-darwin
! 
! 
! With your project using flext, be sure to define "FLEXT_SYS=2".
! 
! 
! Max/MSP - Windows:
! ------------------
! o Microsoft Visual C++ 6 or 7: edit "config-max-msvc.txt" & run "build-max-msvc.bat" 
! 
! 
! With your project using flext, be sure to define "FLEXT_SYS=1".
! 
! 
! Max/MSP - MacOS 9:
! ------------------
! o Metrowerks CodeWarrior: edit & use the "flext.cw" project file
! 
! You must have the following "Source Trees" (CW preferences, not project specific!) defined:
! "flext" - Pointing to the flext main directory
! "Cycling74" - Pointing to the Cycling 74 SDK
! "MP SDK" - Pointing to the Multiprocessing SDK (for threading support)
! 
! 
! With your project using flext, be sure to define "FLEXT_SYS=1" 
! - alternatively use the prefix file "flcwmax.h" or "flcwmax-thr.h" for threading support.
! 
! 
! Max/MSP - MacOSX:
! ------------------
! o Metrowerks CodeWarrior: edit & use the "flext.cw" project file
! Be sure to have the latest Max/MSK SDK downloadable from http://www.cycling74.com
! You should use "version 4.5 headers" rather than "version 4.3 headers".
! You must have the following "Source Trees" (CW preferences, not project specific!) defined:
! "OS X Volume" - Pointing to your OSX boot drive
! "flext" - Pointing to the flext main directory
! "Cycling74 OSX" - Pointing to the SDK for Max/MSP - the path should end with /c74support
! "MP SDK" - Pointing to the Multiprocessing SDK (for threading support)
! Note: Some parts of the Max/MSP SDK may not be compliant to the C standard. 
! If you get errors for lines like
! #endif _MOTO_
! You should changes all of these to
! #endif /* _MOTO_ */
! o GCC: edit "config-max-darwin.txt" & run "sh build-max-darwin.sh" 
! 	additional settings (e.g. target processor, compiler flags) can be made in makefile.max-darwin
! With your project using flext, be sure to define "FLEXT_SYS=1" 
! - alternatively use the prefix file "flcwmax-x.h" or "flcwmax-x-thr.h" for threading support.
----------------------------------------------------------------------------
! 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 MaxMSP
! - more than 3 typed creation arguments possible for MaxMSP
! cons:
! - introduces a small overhead to speed of message handling 
! - overhead in object size (due to possibly unneeded code)
! see flext.h, fldefs.h and flclass.h for the documented base definitions and classes
--- 9,85 ----
Donations for further development of the package are highly appreciated.
! https://www.paypal.com/xclick/business=t.grill%40gmx.net&item_name=flext...
----------------------------------------------------------------------------
! 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 ones 
! special needs and supply additional functionality.
! Source code based on flext is able to exploit nearly all 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 
! - overhead in object size (due to possibly unneeded code)
! ----------------------------------------------------------------------------
! Prerequisites:
+ o --- PD ---
+   You need the pd source code which is most likely part of the distribution.
+   Otherwise download from: http://www-crca.ucsd.edu/~msp/software.html
! o --- Max/MSP ---
!   You will need the latest Max/MSP SDK 
!   for Windows (http://synthesisters.com/pluggo3/downloadMaxWinSDK.php)
!   for OSX (http://www.synthesisters.com/sdk/max.php)
!   or for OS9 (ask Cycling'74 where to find that)
+   For OS9 threading support you'll also need the Multiprocessing library 
+   (download at http://developer.apple.com/sdk/)
! o --- 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
+ o --- STK ---
+   If you choose to compile with STK support you will need the respective package 
+   and build a library.
+   download from: http://ccrma-www.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"
----------------------------------------------------------------------------
! Building and installing of flext and flext-based externals:
!   Read the build.txt document
! ----------------------------------------------------------------------------
! History of changes:
+   Read the changes.txt document