The Guide !

Spatial Mass







M I D I  a n d  C O N T R O L L E R S

Contrairement à l'ensemble des autres plugins, ceux ci ne traitent PAS les sons, mais uniquement des contrôles, sous la forme de messages MIDI ou directement de paramètres VST pour les hôtes qui supportent ce mode (Bidule, Reaper, Max/Msp...).

Les plugins générant automatiquement des variations permettent d'obtenir des évolutions et des animations de paramètres complexes, enfin, les processeurs et convertisseurs MIDI permettent d'adapter les contrôles à des périphériques particuliers, ou simplement de transformer les messages MIDI.

Pour l'instant, seules les versions 32 bits pour Windows disposent de sorties MIDI, les quelques versions 64 bits VST3 et AU ne permettent que les connexions directes entre paramètres.

Unlike all other plugins, these will not deal with sound, but solely controls, in the form of MIDI messages or directly VST parameters, for hosts that support this mode (Bidule, Reaper, Max/Msp...).

The plugins that automatically generates variations make possible to obtain complex parameters changes and animations, while the processors and MIDI converters can be used to adapt the controllers to specific devices, or simply transform MIDI messages.

For now, only the 32-bit versions for Windows have MIDI outputs, the few 64 bit versions VST3 and AU only allow the connections of parameters. 


x 6 4   v e r s i o n s

Note : you will need a host that is able to make connections between plugins parameters, here the controller's X, Y, Z values, to the corresponding ones of the plugin you whish to control. Modular hosts present no problem but I don't know other DAWs than Reaper that can do it.
Known issue : the plugins UI must be visible to make them working.


S c a l e C o n t r o l   3 D X



Since it is not possible to process MIDI datas in VST3 effects plugins (and since VST3 instruments cannot process correctly the sound...), there is a third possibility that consists to use an intermediary plugin to receive and to process MIDI messages, the parameters being linked between the two plugins. Not all hosts can do it, but at least Reaper handles it perfectly...
Why processing MIDI messages ?
With free arrangement loudspeakers tools, like Reaper's ReaSurround or like the 3D Acousmodules, there is some cases where you have to place your graphic objects in other manners than following a perfect square, or here, cube. It can be to optimize the Influences/Areas settings or to follow more precisely the shape of the physical space, whatever.
If you use your mouse to move the objects this is normaly not a big deal, but if you use a MIDI controller you can find it difficult to limit your gestures.
The ScaleControl 3D can scale, shift and invert all the incoming MIDI messages, linked to up to four sets of 3D spatial positions.
If you need more, for example to use with a Spat3D 8X just add another instance.


Known issue : the values may need to be triggered by hand to make the links working.
To do : default MIDI controllers compatible with the other Acousmodules. 
Current build date : 22/12/2018
Status :







S h a p e C o n t r o l   3 D X



ControlShape3DX.jpgIt is intended to be used with a Spat3D 8X or with Reaper's ReaSurround with Parameter Link.
It can be also interesting to control several "Focus" plugins, or, why not, use it as a kind of "3D macro controller" with what you want...
The plugin has 8 fake inputs/outputs to make it work as a Audio Unit but it doesn't process audio.



Known issue : the values may need to be triggered by hand to make the links working.
To do : default MIDI controllers compatible with the other Acousmodules.
Current build date : 22/12/2018
Status :







S p h e r e C o n t r o l   8 X  /  1 6 X



ControlShape3DX.jpgIt brings the same kind of shapes interpolation than the ShapeControl to the specific case of a Sphere speakers arrangement (note that it can also work with other 3D ones). 
Some of them could already be possible by using an ambisonic plugin together with an encoding and a decoding one, but even in 7th order the process will always result in a loss of sound and spatial precision.
The SphereControl is also not limited to move the points accross the surface but can work with "solid sphere" loudspeakers arrangements, that is to say with speakers also placed inside the sphere.
- Diameter : dimension of the sphere from a single center point
- Angle : rotation in the Azimut plane
- Elevation : position and rotation in the Elevation plane
- Ring : length in th Azimut plane from a point to a full ring
- Arch : length in the Elevation plane
- Ray : line ray extension (normaly with a Diameter = 0)
- Scatter : random shift from the equal distribution
The 16X version can drive for example two Spat3D 8n.


Known issue : the values may need to be triggered by hand to make the links working.
To do : smoothing values.
Current build date :
Status : 



Windows  8  16

MacOS  8  16



N o d e C o n t r o l   3 D X



ControlShape3DX.jpgControls 16 parameters at once with a 3D gesture, from for example a Leap Motion.
Each node represents a parameter, its value depending on its distance to the input controller.
The Area settings here means at the same time the "length" of the parameter and how it will change along with the other ones.
It can be very useful to control together the shapes and the animations parameters of an AnimaSpat or even parameters of different plugins.



Known issue : the values may need to be triggered by hand to make the links working.
To do : better values scaling ; change some colors or objects ; visual sphere areas.
Current build date : 22/12/2018
Status : 







Z y l i a T o u c h   L E



It is a simplified version of the Win32 ZyliaTouch (below) with just the 19 level controllers.
Like the other X64 plugins, you will have to connect the plugins parameters between the plugins.


Current build date : work in progress...
Status :

Audio IN / Param OUT









 3 2  b i t s   v e r s i o n s




P l u g i n s   C o n t r o l l e r s



Reaper permet de placer directement des plugins sur les objets audio, mais ceci devient vite fastidieux à configurer et potentiellement gourmand en ressources.
Cette série de mini contrôleurs permet de n'utiliser qu'une seule occurence de SpatSurround et de la contrôler à partir des objets placés sur cette piste :- placer un plugin de la série Spat... sur la piste
- placer le mini contrôleur sur des objet de cette piste
- régler les positions X/Y/Z sur les mini contrôleurs : elles sont répercutées directement sur le plugin de la piste sans avoir à configurer quoique ce soit


M i n i   C o n t r o l   2


Basic controls for the x64 Spat3D 2n series and all the x32 SpatSurround ones. It works also with the Focus series and in general with every plugin which has two XYZ inputs controllers.







M i n i   C o n t r o l   4


Controls the 8 XYZ positions of a Spat3D 8n.







S p a t C o n t r o l   3 D 1 6


Specific for the Win32 SpatMass 3D 16.








S P A C E S  3 D - C o n t r o l


This one is dedicated to the GRM-Tools Spaces3D :
- XYZ position
- Size
- Spread
- XYZ rotation
You will have first to assign the MIDI CC to the corresponding Spaces3D parameters.







C o n t r o l S h a p e   3 D 8


It can control the position of eight inputs in various plugins like Reaper's ReaSurroud, in the same manner as the SpatMass series by doing interpolation between four basic shapes : cube, lines, cercles and chaotic, plus the global 3D position.
Of course, it will have an effect only if there is some speakers inside the overal space...
See also the 64 bits ShapeControl 3DX above.








MIDI Converters



Z Y L I A T o u c h


It uses the multichannel audio input from a Zylia microphone to send MIDI messages :
- 19 channels audio input with 19 envelope followers modules
- threshold detection to trig notes with velocity
- direct amplitude to CC values with inertia setting
- spatial position interpolation to drive 3 CC for XYZ control
It is intended to be used with a direct contact on the surface microphone, but it may also work with proximity sounds !
It can work well with the LightPads 25, the MassInFaders 3264X, and with every Spat3D-like plugin as soon as the speaker arrangement is nearly spherical.
Since you cannot use in the same application both the Zylia's driver and your soundcard one, the ZyliaTouch is provided as a standalone application which you must set with the Zylia audio driver and use a MIDI loopback such as loopMIDI as an output. Then you can receive the MIDI messages in your prefered application (like Reaper...).
There is also a VST version that you can use with another host of your choice.
(note : the Pitch to MIDI doesn't work yet) 








3 D   M I D I Z


It was originaly made for the mouse "The Z", but it is now better optimized for the Lexip Pro mouse.
It provides 7 controls :
- mouse X/Y
- mouse wheel
- mouse Pitch / Yaw
- joystick X/Y







3 D   M I D I T r a k


For the Mad Catz's GameTrak :
- Left Hand : 3 axis
- Right Hand : only Z axis currently
- range setting for the Z axis
- inertia setting







3 D   M I D I R u d d e r


For the 3DRudder foot controller.
It provides the following controls (7 degrees of freedom) :
- Left/Right and Front/Back inclination
- orientation
- Left and Right foot pressure







3 D   M I D I J o y


Convertisseur MIDI pour Joystick avec manche rotatif :
- convertit les deux axes X/Y, la rotation du manche et le levier en contrôleurs MIDI
- 8 boutons
- réglage d'adoucissement
- envoi des messages MIDI par la sortie du plugin ou via un des ports MIDI installés

Voir également ShoRyuKen et JoystickCtrl (entre autres) qui proposent plus ou moins la même chose.







3 D   M I D I P a d


Convertisseur MIDI pour Joypad :
- convertit les axes X/Y de chaque joystick
- 4 boutons
- réglage d'adoucissement
- envoi des messages MIDI par la sortie du plugin ou via un des ports MIDI installés







P 5   K e y b o a r d


Un "clavier" virtuel pour le P5 Glove ! Il nécessite le programme P5GloveMIDI de Ross Bencina (joint dans l'archive) et un MIDI Routeur.
- reçoit les coordonnées X, X, Z ainsi que la courbure des cinq doigts
- déclenchement indépendant de cinq notes en fonction de la courbure des quatre doigts et de la position verticale
- réglages de note centrale, de l'étendue de hauteur, du canal et du programme pour chaque note
- visualisation de la note jouée sur les cinq octaves centrales
- déclenchement simple ou avec répétition
- modulation de la vitesse de répétition en fonction de la position spatiale, avec le pouce ou selon la courbure du doigt
- vélocité en fonction de la vitesse de déclenchement ou de la position
- le pouce peut être utilisé comme contrôleur, comme sustain, ou pour changer de patch (actuellement pas très fiable) 
- transformation des trois axes : choix de dix courbes, inversion, changement d'échelle, inertie








M I D I   P r o c e s s o r s   a n  d   G e n e r a t o r s



A n i m a P h y   3 D 8


- eight 3D generators (= 24 MIDI controllers) driven by a "master" 3D controller according to four "physical" models :
- trail with inertia
- pulse
- chaos, trigged or automatic
- bounces
- 3D MIDI input to use a Leap Motion or other 3 dimensionnal controllers







A n i m a M I D   2 D


Génération de contrôleurs comnbinés complexes :
- version MIDI de l'AnimaSpat 2D
- huit à seize contôleurs MIDI
- dix courbes de modulation
- utilisation d'une entrée audio comme source de modulation
Deux sections d'animation peuvent être utilisés simultanément et combinés :
Section Steps :
- trajectoires 2D en pas à pas sur seize points
- paramètre de lissage pour obtenir des mouvements continus
- quatre modes de lecture : linéaire, pas, temps et cycle
- mode "linéaire" : déplacement manuel le long de la trajectoire (souris ou contrôleur MIDI), modulation possible selon l'intensité
- mode "pas" : déplacement point par point en fonction d'un seuil de déclenchement sur l'entrée audio, du tempo du logiciel hôte ou indiqué manuellement (tap tempo), détermination des points de départ et de fin ainsi que de la direction
- mode "time" :
- pad de déformation de la trajectoire (échelle et miroirs)
- déplacement 2D global
Section Curves :
- deux modulateurs à multiples formes d'ondes contrôlent les mouvements en X et Y
- contrôle de la vitesse et de l'amplitude du mouvement pour chaque axe par un contrôleur 2D
- réglages de phase et d'accélération
- modulateur global
- sous-modulateurs pour contrôler la vitesse et l'amplitude afin d'obtenir des trajectoires évolutives
- asservissement de la vitesse au tempo (hôte / seuils du signal audio / tap tempo)
Section Instant Gestures :
Mode temporaire qui désactive les deux sections d'animation. Il n'est pas soumis au changements de patch et les réglages restent mémorisés tant que le plugin n'est pas désactivé.
- mode Bounces : il consiste à "lancer" l'anneau qui représente la position du son pour le faire ricocher sur les bords de l'espace 2D, réglage de puissance et de friction (non linéaire aux valeurs élevées), il peut être déclenché automatiquement avec des valeurs aléatoires par l'entrée audio.
- mode Scratchpad : enregistrement à la volée d'une trajectoire continue jusqu'à 30 secondes, lecture à vitesse et à direction variable, contrôle en temps réel des points de bouclage, déformation globale (échelle et miroirs).
Global :
- utilisation du tempo de l'hôte comme source de modulation
- détection du tempo de l'entrée audio
- fonction tap tempo
- subdivisions de la ronde à la quadruple croche, support des triolets
- contrôleurs MIDI pré-assignés
- jusqu'à 64 patches peuvent être enchaînés sans interruptions par un clavier MIDI ou à la souris
- option "NotesOFF default" : définition d'un réglage par défaut lorsque aucune touche n'est jouée.







M I D I P l u g   G   ( G r a p h i c s )


Génération de messages de contrôleurs
- quatre enveloppes graphiques
- dix segments (enveloppes bouclables)
- déclenchement par quatre zones de notes MIDI
- réglage des points de départ et de fin de lecture
- durée de une à trente secondes
- dix courbes d'accélération

Applications : pseudo automation de plugins dans les logiciels modulaires, création de trajectoires avec un SpatSurround en coordonnées cartésiennes...
Voir la version en paramètres VST "Enveoppes" plus bas.







M I D I P l u g   A   ( A n a l y z e r )


Génération de contrôleurs en fonction d'un signal audio
- entrée audio stéréo
- analyse de la fréquence et de l'amplitude de chaque canal pour moduler deux "joysticks"
- génération de deux fois huit contrôleurs en fonction de la distance entre les deux "joysticks" et huit points disposés arbitrairement







M I D I P l u g   C   ( C y c l e s )


Génération cyclique de messages de contrôleurs
- quatre oscillateurs basse fréquence
- "morphing" en temps réel entre 7 formes d'ondes parmi 15
- synchronisation possible du départ des quatre oscillateurs
- les principaux paramètres sont eux-mêmes contrôlables en MIDI de manière à pouvoir créer des modulations complexes en enchaînant plusieurs plugins







M I D I P l u g   N   ( N o t e s )


Génération de notes
Quatre générateurs combinables :
- cycles complexes par morphing entre sept formes d'ondes
- enveloppe graphique à dix segments avec points de bouclage réglables
- série de huit segments à vitesse et courbe variable
- modulation de fréquence de trois oscillateurs
- modulation indépendante de la vitesse d'émission des notes, de la hauteur, de la vélocité et du numéro de programme
- jeu au clavier de 64 configurations







M I D I P l u g   C S  II   ( C o n t r o l   S h a p e )


Transformation de la courbe de huit contrôleurs
- étendue, décalage, inversion, courbe, limites inférieures et supérieures, inertie
- bornes inférieures et supérieures pour les messages entrant.
Applications : traitement des informations en provenance de capteurs gestuels comme le P5 Glove, une tablette graphique, un Joystick (via le JoyMid 3D) ou d'analyses vidéo du mouvement.







M I D I v i d e r


Keyboard splitter :
Divise les notes reçues sur un canal MIDI en seize zones, sur seize canaux.







M I D I P l u g   V   ( V i e w )


Visualisation / contrôle des messages MIDI :
Celui-ci ne traite pas les messages MIDI mais permet d'afficher :
- huit contrôleurs
- trois contrôleurs sous la forme de pad XYZ
- pitch bend
- note
- vélocité
- pression monophonique
- monitoring des messages complets









Simple Program Change generator.
It is intended to initialize a plugin's Preset placed on an audio object in Reaper.
It can be automated too.







S n a p S h o o t e r   4


- quatre "snapshots" correspondant à seize paramètres (modules ou VSTs)
- pad gestuel 2D pour morphing en temps réel entre les snapshots
- paramètre d'inertie
- representation graphique des valeurs
- édition possible des valeurs des snapshots
Applications : rappel et interpolation entre les paramètres de modules internes ou de plugins (Bidule et Usine).







C C S p e e d F o l l o w e r


Extract the movement's speed of two MIDI controllers and sends the result to another CC :
- sensitivity : from fast movement with low values to small movement with high values
- inertia :  controls the reactivity








A M 2 M I D I


La MetaSurface d'AudioMulch est un outils fantastique, mais ne fonctionne qu'avec les modules et plugins du logiciel. Il est notamment impossible de l'utiliser pour contrôler un autre logiciel.
Ce plugin permet d'envoyer 16 messages de contrôleurs MIDI selon le contrôle de la Metasurface :
- seize contrôleurs MIDI
- choix de la sortie MIDI (nécessite un MIDI Routeur d'installé)
- labels pour nommer et identifier les paramètres commandés