This commit was generated by cvs2svn to compensate for changes in r186,

which included commits to RCS files with non-trunk default branches.

svn path=/trunk/; revision=187

3 files changed, 224 insertions, 0 deletions

diff --git a/externals/grill/flext/tutorial/signal1/main.cpp b/externals/grill/flext/tutorial/signal1/main.cpp
new file mode 100644
index 00000000..14818e6f
--- /dev/null
+++ b/externals/grill/flext/tutorial/signal1/main.cpp
@@ -0,0 +1,129 @@
+// signal1~ - a flext tutorial external written by Frank Barknecht
+// 
+// This is a commented port of the pan~ example from the PD-Externals-Howto to
+// illustrate the usage of flext. You can get the original code at
+// http://iem.kug.ac.at/pd/externals-HOWTO/
+
+#include <flext.h>
+#include <math.h>
+ 
+#if !defined(FLEXT_VERSION) || (FLEXT_VERSION < 300)
+#error You need at least flext version 0.3.0
+#endif
+
+
+// A flext dsp external ("tilde object") inherits from the class flext_dsp 
+class signal1: 
+	public flext_dsp
+{
+	// Each external that is written in C++ needs to use #defines 
+	// from flbase.h
+	// 
+	// The define
+	// 
+	// FLEXT_HEADER(NEW_CLASS, PARENT_CLASS)
+	// 
+	// should be somewhere in your dsp file.
+	// A good place is here:
+	
+	FLEXT_HEADER(signal1, flext_dsp)
+
+	public:
+		signal1():
+			f_pan(0) // initialize f_pan
+		{
+			// The constructor of your class is responsible for
+			// setting up inlets and outlets and for registering
+			// inlet-methods:
+			
+			AddInSignal(2);         // 2 audio ins
+			AddInFloat();           // 1 float in
+			AddOutSignal();         // 1 audio out [ == AddOutSignal(1) ]
+			
+			SetupInOut();           // set up inlets and outlets. 
+			                        // Must be called once!
+
+			// Now we need to bind the handler function to our
+			// panning inlet, which is inlet 2 (counting all inlets
+			// from 0).  We want the function "setPan" to get
+			// called on incoming float messages:
+
+			FLEXT_ADDMETHOD(2,setPan);
+			
+			// We're done constructing:
+			post("-- pan~ with flext ---");
+			
+		} // end of constructor
+		
+	
+	protected:
+		// here we declare the virtual DSP function
+		virtual void m_signal(int n, float *const *in, float *const *out);
+	private:	
+		float f_pan;  // holds our panning factor
+		
+		// Before we can use "setPan" as a handler, we must register this
+		// function as a callback to PD or Max. This is done using the
+		// FLEXT_CALLBACK* macros. There are several of them.
+		//
+		// FLEXT_CALLBACK_F is a shortcut, that registers a function
+		// expecting one float arg (thus ending in "_F"). There are
+		// other shortcuts that register other types of functions. Look
+		// into flext.h. No semicolon at the end of line!!!
+		FLEXT_CALLBACK_F(setPan)
+
+		// Now setPan can get declared and defined here.
+		void setPan(float f) 
+		{ 
+			// set our private panning factor "f_pan" to the inlet
+			// value float "f" in the intervall [0,1]
+			f_pan = (f<0) ? 0.0f : (f>1) ? 1.0f : f ;	
+			
+			// if you want to debug if this worked, comment out the
+			// following line: 
+			//post("Set panning to %.2f, maybe clipped from %.2f", f_pan,f);
+		} // end setPan
+}; // end of class declaration for signal1
+
+
+// Before we can run our signal1-class in PD, the object has to be registered as a
+// PD object. Otherwise it would be a simple C++-class, and what good would
+// that be for?  Registering is made easy with the FLEXT_NEW_* macros defined
+// in flext.h. For tilde objects without arguments call:
+
+FLEXT_NEW_DSP("signal1~ signal1~", signal1)
+// T.Grill: there are two names for the object: signal1~ as main name and pan~ as its alias
+
+// Now we define our DSP function. It gets this arguments:
+// 
+// int n: length of signal vector. Loop over this for your signal processing.
+// float *const *in, float *const *out: 
+//          These are arrays of the signals in the objects signal inlets rsp.
+//          oulets. We come to that later inside the function.
+
+void signal1::m_signal(int n, float *const *in, float *const *out)
+{
+	
+	const float *ins1    =  in[0];
+	const float *ins2    =  in[1];
+	// As said above "in" holds a list of the signal vectors in all inlets.
+	// After these two lines, ins1 holds the signal vector ofthe first
+	// inlet, index 0, and ins2 holds the signal vector of the second
+	// inlet, with index 1.
+	
+	float *outs          = out[0];
+	// Now outs holds the signal vector at the one signal outlet we have.
+	
+	// We are now ready for the main signal loop
+	while (n--)
+	{
+		
+		// The "++" after the pointers outs, ins1 and ins2 walks us
+		// through the signal vector with each n, of course. Before
+		// each step we change the signal value in the outlet *outs
+		// according to our panning factor "f_pan" and according to the
+		// signals at the two signal inlets, *ins1 and *ins2 
+		
+		*outs++  = (*ins1++) * (1-f_pan) + (*ins2++) * f_pan;
+	}
+}  // end m_signal
diff --git a/externals/grill/flext/tutorial/signal1/signal1.cw b/externals/grill/flext/tutorial/signal1/signal1.cw
new file mode 100644
index 00000000..f273b763
--- /dev/null
+++ b/externals/grill/flext/tutorial/signal1/signal1.cw
diff --git a/externals/grill/flext/tutorial/signal1/signal1.dsp b/externals/grill/flext/tutorial/signal1/signal1.dsp
new file mode 100644
index 00000000..42916c07
--- /dev/null
+++ b/externals/grill/flext/tutorial/signal1/signal1.dsp
@@ -0,0 +1,95 @@
+# Microsoft Developer Studio Project File - Name="signal1" - Package Owner=<4>
+# Microsoft Developer Studio Generated Build File, Format Version 6.00
+# ** NICHT BEARBEITEN **
+
+# TARGTYPE "Win32 (x86) Dynamic-Link Library" 0x0102
+
+CFG=signal1 - Win32 Debug
+!MESSAGE Dies ist kein gültiges Makefile. Zum Erstellen dieses Projekts mit NMAKE
+!MESSAGE verwenden Sie den Befehl "Makefile exportieren" und führen Sie den Befehl
+!MESSAGE 
+!MESSAGE NMAKE /f "signal1.mak".
+!MESSAGE 
+!MESSAGE Sie können beim Ausführen von NMAKE eine Konfiguration angeben
+!MESSAGE durch Definieren des Makros CFG in der Befehlszeile. Zum Beispiel:
+!MESSAGE 
+!MESSAGE NMAKE /f "signal1.mak" CFG="signal1 - Win32 Debug"
+!MESSAGE 
+!MESSAGE Für die Konfiguration stehen zur Auswahl:
+!MESSAGE 
+!MESSAGE "signal1 - Win32 Release" (basierend auf  "Win32 (x86) Dynamic-Link Library")
+!MESSAGE "signal1 - Win32 Debug" (basierend auf  "Win32 (x86) Dynamic-Link Library")
+!MESSAGE 
+
+# Begin Project
+# PROP AllowPerConfigDependencies 0
+# PROP Scc_ProjName "max/flext/tutorial/signal1"
+# PROP Scc_LocalPath "."
+CPP=cl.exe
+MTL=midl.exe
+RSC=rc.exe
+
+!IF  "$(CFG)" == "signal1 - Win32 Release"
+
+# PROP BASE Use_MFC 0
+# PROP BASE Use_Debug_Libraries 0
+# PROP BASE Output_Dir "Release"
+# PROP BASE Intermediate_Dir "Release"
+# PROP BASE Target_Dir ""
+# PROP Use_MFC 0
+# PROP Use_Debug_Libraries 0
+# PROP Output_Dir "msvc"
+# PROP Intermediate_Dir "msvc"
+# PROP Ignore_Export_Lib 0
+# PROP Target_Dir ""
+# ADD BASE CPP /nologo /MT /W3 /GX /O2 /D "WIN32" /D "NDEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /YX /FD /c
+# ADD CPP /nologo /W3 /GR- /GX- /O2 /I "..\..\source" /D "WIN32" /D "NDEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "NT" /D "PD" /YX /FD /c
+# ADD BASE MTL /nologo /D "NDEBUG" /mktyplib203 /win32
+# ADD MTL /nologo /D "NDEBUG" /mktyplib203 /win32
+# ADD BASE RSC /l 0xc07 /d "NDEBUG"
+# ADD RSC /l 0xc07 /d "NDEBUG"
+BSC32=bscmake.exe
+# ADD BASE BSC32 /nologo
+# ADD BSC32 /nologo
+LINK32=link.exe
+# ADD BASE LINK32 kernel32.lib /nologo /dll /machine:I386
+# ADD LINK32 kernel32.lib user32.lib pd.lib flext-pdwin.lib /nologo /dll /machine:I386 /out:"../msvc/signal1~.dll" /libpath:"..\..\pd-msvc"
+
+!ELSEIF  "$(CFG)" == "signal1 - Win32 Debug"
+
+# PROP BASE Use_MFC 0
+# PROP BASE Use_Debug_Libraries 1
+# PROP BASE Output_Dir "Debug"
+# PROP BASE Intermediate_Dir "Debug"
+# PROP BASE Target_Dir ""
+# PROP Use_MFC 0
+# PROP Use_Debug_Libraries 1
+# PROP Output_Dir "msvc-debug"
+# PROP Intermediate_Dir "msvc-debug"
+# PROP Ignore_Export_Lib 0
+# PROP Target_Dir ""
+# ADD BASE CPP /nologo /MTd /W3 /Gm /GX /ZI /Od /D "WIN32" /D "_DEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /YX /FD /GZ /c
+# ADD CPP /nologo /W3 /Gm /GR- /GX- /ZI /Od /I "..\..\source" /D "WIN32" /D "_DEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "NT" /D "PD" /Fr /YX /FD /GZ /c
+# ADD BASE MTL /nologo /D "_DEBUG" /mktyplib203 /win32
+# ADD MTL /nologo /D "_DEBUG" /mktyplib203 /win32
+# ADD BASE RSC /l 0xc07 /d "_DEBUG"
+# ADD RSC /l 0xc07 /d "_DEBUG"
+BSC32=bscmake.exe
+# ADD BASE BSC32 /nologo
+# ADD BSC32 /nologo
+LINK32=link.exe
+# ADD BASE LINK32 kernel32.lib user32.lib /nologo /dll /debug /machine:I386 /pdbtype:sept
+# ADD LINK32 kernel32.lib user32.lib pd.lib flext_d-pdwin.lib /nologo /dll /debug /machine:I386 /out:"msvc-debug/signal1~.dll" /pdbtype:sept /libpath:"..\..\pd-msvc"
+
+!ENDIF 
+
+# Begin Target
+
+# Name "signal1 - Win32 Release"
+# Name "signal1 - Win32 Debug"
+# Begin Source File
+
+SOURCE=.\main.cpp
+# End Source File
+# End Target
+# End Project