Welcome to the documentation website for Field — a live-coding environment for making digital art.
If you are completely new to Field you’ll want to start with the survival guide. This will go over how to write and execute code, what error messages look like, and how to draw very simple things in 2d just to warm up. Moving towards more advanced 2d drawing will give you some new tools for building geometry in Field. These prompts from January’s UChicago class provide a good set of example code for this topic as well.
Drawing in, and sending code to, web-browsers is supported in the most recent versions of Field. A (very) simplified drawing system, based on-top of Three.js is available. Note that much of the complex parts of
FLine are not yet available inside the browser - we’ll edge towards parity between the two graphics systems over time.
As far as 2d drawing goes, the most important documentation concerns ‘the Stage’ — which is where drawing inside Field ends up.
If you want to start building time-lines and scores, you’ll be interested in time in Field which lets the boxes that contain code respond to where they are in the sheet. This leads to more complex, notational strategies.
Our VR support in Field is based on various VR-aware
Stage implementations. These places for drawing, and other VR related activities are documented here. Advanced shading techniques touched upon in class are here.
If you are intrigued, or puzzled, by the
_ symbol that keeps appearing in example code, or you are getting frustrated trying to build longer, more complex passages of code in Field and need help structuring them, here is some documentation on what that underscore
_. is doing.
Field, while primarily intended as a programming environment for making visual things, seems to have accumulated a few features for interacting with sound. These include support for reading and writing MIDI files as well as real time midi output, and support for sound analysis and a ‘toy’ sound mapping system. Field also supports reading motion capture data and video tracking files.
The current version of Field is Field ‘alpha.16’, and is available for download for OS X.
Do not run Field from inside the Downloads folder on OS X (this folder is very special); Running Field from a directory that has a ‘space’ in its name (or any parent directory) is for the brave. And when things go wrong (and they will), be specific.
The Windows build is here.
_.wait()and the like.
Stage, with handy keyboard control.