Skip to content

Latest commit

 

History

History
119 lines (81 loc) · 3.99 KB

README.md

File metadata and controls

119 lines (81 loc) · 3.99 KB

XY Coordinates Generator Pack

A Max/MSP package of gen~ based tools to generate XY (and XYZ) coordinates — exploring different methods to interact with movements, trajectories and location in a two dimensional space.

Every generator is a gen~ patcher that outputs signal-rate coordinates normalised between 0. and 1., ready to drive panning, granular playback, wavetable scanning, Jitter matrices, MIDI or OSC.

  • Version: 1.2.0
  • Author: Daniele Fabris — danielefabris.com
  • Requires: Max 8.0 or later (macOS Intel/Apple Silicon, Windows x64)

Installation

Option A — manual

  1. Download or clone this repository.
  2. Rename the folder to XY Coordinates Generator Pack.
  3. Move it into your Max packages folder:
    • macOS: ~/Documents/Max 9/Packages/
    • Windows: Documents\Max 9\Packages\
  4. Restart Max.

Option B — clone directly

cd ~/Documents/Max\ 9/Packages
git clone https://github.com/dnlfbr/xy-coordinates-generator-pack.git "XY Coordinates Generator Pack"

Once installed, open Extras → XY_overview in Max to browse the whole package.


The generators

2D — xy.*

Object What it does
xy.MANUAL~ / xy.MANUAL4~ Hand-drawn positions, 1 or 4 independent points
xy.RANDOM~ Randomised drift across the plane
xy.WAVE~ Lissajous-style motion from paired oscillators
xy.FM~ / xy.FM3~ FM modulation of the coordinate pair, 2 or 3 operators
xy.GALAXY~ Orbital / spiral trajectories
xy.MASS~ Physics-driven motion with mass and inertia
xy.GRAINS~ Scattered cloud of points, granular-oriented
xy.MULTI~ Multiple simultaneous coordinate streams
xy.SEQUENCE4~ / xy.SEQUENCE8~ Step-sequenced positions, 4 or 8 steps

3D strange attractors — xyz.*

xyz.lorenz~ · xyz.chen~ · xyz.thomas~ · xyz.halvorsen~ · xyz.sprott~ · xyz.dadras~ · xyz.fourwing~

Each outputs three normalised signal coordinates tracing the attractor's phase space.


Examples

Found under examples/, openable from Max's file browser:

Example Focus
XY Spatialisation Multichannel panning driven by coordinates
XY Granular Sampler Coordinates as grain position / spread
XY Vector Wavetable 2D wavetable scanning
XY Jitter / XY Jitter 2 Writing coordinates into Jitter matrices
XY Collision Boundary and collision behaviours
XY MIDI Coordinates to MIDI control
XY OSC Coordinates over OSC

Repository layout

The folder structure follows the Max package specification — the directory names are fixed and must not be renamed or reorganised, or Max will stop finding the contents.

.
├── package-info.json   Package manifest read by Max
├── patchers/           The gen~ generator abstractions (the objects you use)
├── code/               .gendsp sources for each generator
├── help/               Help patchers (right-click an object → Open Help)
├── examples/           Complete example patches
├── extras/             XY_overview.maxpat — the package home patcher
├── clippings/          Drag-and-drop clippings
├── snippets/           Max snippets
├── collections/        Snippet collection
├── media/              SVG assets used by the UI
└── icon.png            Package icon

Notes

  • All outlets carry a signal ranging from 0. to 1.
  • The gen~ code is optimised to work in multichannel (mc.) contexts.

Thanks

For support, collaboration and inspiration:

Music Informatics — Umanesimo Artificiale, Tauro Venturini, Filippo Rosati, Francesco Corvi, Emanuele Balia, Artiom Costantinov, Sasha Petra

GRAIM — Nicola Di Paolo, Franco Conte, Davide Tiso, Lorenzo Pagliei, Carmine Emanuele Cella

STEIM — Fedde ten Berge


License

Released under the MIT License — see LICENSE.

Daniele Fabris — LEDEN / @musicinformatics