aboutsummaryrefslogtreecommitdiff
path: root/externals/grill/xsample
diff options
context:
space:
mode:
Diffstat (limited to 'externals/grill/xsample')
-rw-r--r--externals/grill/xsample/readme.txt155
1 files changed, 0 insertions, 155 deletions
diff --git a/externals/grill/xsample/readme.txt b/externals/grill/xsample/readme.txt
index 26f9b54b..f884c80e 100644
--- a/externals/grill/xsample/readme.txt
+++ b/externals/grill/xsample/readme.txt
@@ -1,310 +1,155 @@
xsample - extended sample objects for Max/MSP and pd (pure data)
-
-
Copyright (c) 2001-2003 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.
-
-
Donations for further development of the package are highly appreciated.
-
-
----------------------------------------------------------------------------
-
-
IMPORTANT INFORMATION for all MaxMSP users:
-
-
1) For OSX it is best to put the xsample file somewhere in your Max/MSP search path and drop the file
-
xsample-objectmappings.txt into the folder /Library/Application Support/Cycling '74/init .
-
-
2) Otherwise (or for OS9) it is advisable to put the xsample shared library file into the "max-startup" folder.
-
Hence it will be loaded at Max startup.
-
-
3) If you want to load the xsample library on demand, create a [xsample] object in Max/MSP.
-
-
----------------------------------------------------------------------------
-
-
You will need the flext C++ layer for PD and Max/MSP externals to compile this.
-
see http://www.parasitaere-kapazitaeten.net/ext
-
-
-
Package files:
-
- readme.txt: this one
-
- gpl.txt,license.txt: GPL license stuff
-
- main.h,main.cpp,inter.cpp,inter.ci: base class definition for all the other objects
-
- record.cpp: xrecord~
-
- play.cpp: xplay~
-
- groove.cpp: xgroove~
-
-
----------------------------------------------------------------------------
-
-
The package should at least compile (and is tested) with the following compilers:
-
-
pd - Windows:
-
-------------
-
o Microsoft Visual C++ 6: edit "xsample.dsp" project file
-
> due to a compiler bug the optimization using templates is not functional
-
-
pd - linux:
-
-----------
-
o GCC: edit "config-pd-linux.txt" and run "sh ./build-pd-linux.sh"
-
> various versions of GCC die during compile with template optimization turned on
-
-
pd - OSX:
-
-----------
-
o GCC: edit "config-pd-darwin.txt" and run "sh ./build-pd-darwin.sh"
-
> various versions of GCC die during compile with template optimization turned on
-
-
Max/MSP - MacOS9:
-
----------------
-
o Metrowerks CodeWarrior: edit "xsample.cw" project file functions
-
-
o Apple MPW-PR: edit & use the "flext.mpw" makefile
-
-
Max/MSP - MacOSX:
-
----------------
-
o Metrowerks CodeWarrior: edit "xsample.cw" project file functions
-
-
-
----------------------------------------------------------------------------
-
-
Goals/features of the package:
-
-
- portable and effective sample recording/playing objects for pd and Max/MSP
-
- MSP-like groove~ object for PD
-
- message- or signal-triggered recording object with mix-in capability
-
- avoid the various bugs of the original MSP2 objects
-
- multi-channel capability
-
- live update of respective buffer/array content
-
- switchable 4-point or linear interpolation for xplay~/xgroove~ object
-
- cross-fading loop zone (inside or outside to loop) for xgroove~
-
-
----------------------------------------------------------------------------
-
-
Version history:
-
-
0.3.0:
-
- added resources to MaxMSP build
-
- xgroove~, xrecord~: introduced a loop/end bang outlet
-
- added MaxMSP buffer resize recognition
-
- xgroove~: introduced a crossfading loop zone
-
- adapted source for flext 0.4.1 - most methods within class scope
-
- introduced attributes
-
- restructured make procedures
-
- corrected names of PD makefile, set help names
-
- fixed scale mode bug with xgroove~
-
- added validity check for buffers
-
- Max/MSP OSX: new file xsample-objectmappings.txt fixes load of library on finding correct helpfiles!
-
-
0.2.4:
-
- according to flext 0.2.3 changed sample type to t_sample (S)
-
- xrecord~: fixed mix mode bug
-
- fixed argument buffer problem
-
-
0.2.3:
-
- using flext 0.2.2 - xsample is now a library under MaxMSP
-
- cleaner gcc makefile
-
- xgroove~, xrecord~: added "all" message to select entire buffer length
-
- xgroove~, xplay~: revisited dsp methods, restructured the code, fixed small interpolation bugs
-
- xgroove~, xplay~: added linear interpolation (message "interp 2")
-
- enabled 0 output channels -> xgroove~: position output only
-
- xgroove~: added bidirectional looping (message "loop 2")
-
-
0.2.2:
-
- using flext 0.2.0
-
- xrecord~ for PD: new flext brings better graphics update behavior
-
- xrecord~: recording position doesn't jump to start when recording length is reached
-
- fixed bug with refresh message (min/max reset)
-
- xgroove~: position (by pos message) isn't sample rounded anymore
-
- reset/refresh messages readjust dsp routines to current buffer format (e.g. channel count)
-
- corrected Max/MSP assist method for multi-channel
-
- fixed xplay~ help method
-
- changed syntax to x*~ [channels=1] [buffer] for future enhancements (MaxMSP only, warning for old syntax)
-
- fixed small bug concerning startup position in xgroove~ and xrecord~
-
- fixed deadly bug in xplay~ dsp code (only active with template optimization)
-
-
0.2.1:
-
- no leftmost float inlet for position setting - use pos method
-
- changed dsp handling for flext 0.1.1 conformance
-
- workarounds for buggy/incomplete compilers
-
- prevent buffer warning message at patcher load (wait for loadbang)
-
- fixed bug: current pos is reset when changing min or max points
-
-
0.2.0:
-
- first version for flext
-
-
---------------------------------------------------------------------------
-
-
-
TODO list:
-
-
general:
-
-
- do a smooth (line~) mixin in xrecord~ help patch
-
-
features:
-
- multi-buffer handling (aka multi-channel for pd)
-
- vasp handling
-
- performance comparison to respective PD/Max objects
-
- anti-alias filter? (possible?)
-
-
- delay min/max changes when cur pos in cross-fade zone
-
-
tests:
-
- reconsider startup sequence of set buffer,set units,set sclmode,set pos/min/max
-
-
bugs:
-
- PD: problems with timed buffer redrawing (takes a lot of cpu time) - flext bug?
-
- Apple MPW doesn't correctly compile template optimization
-
- Max help files aren't correctly opened due to xsample objects residing in a library (FIXED for OSX!!!)
-