Umfeld is a C++ environment for audio and graphics based applications. it is inspired by Processing.org and similar environments.
- processing-style API in C/C++
- simple structure ( e.g
setup()anddraw()) - shape-based drawing (e.g
line(),ellipse(),beginShape()…) - cross-platform ( macOS, Linux, Raspberry Pi, Windows and potentially iOS, Android, WebGL etcetera )
- simple application structure
.cppfile +CMakeLists.txt - based on CMake build system
- native access to real APIs e.g OpenGL, FFmpeg, PortAudio, and others
- small, portable builds
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/dennisppaul/umfeld/refs/heads/main/install.sh)"this script installs all required packages on macOS, Linux, or Windows ( in MSYS2 UCRT64 ).
git clone https://github.com/dennisppaul/umfeld
git clone https://github.com/dennisppaul/umfeld-examplescd umfeld-examples/Basics/minimal
cmake -B build
cmake --build build
./build/minimalif something goes wrong consult the detailed DOCUMENTATION.
- install MSYS2 first
- run all commands from the
MSYS2 UCRT64console - if needed, install
git,bashandcurlwithpacman -S git bash curl
MSYS2 updates itself. this is normal! just reopen MSYS2 UCRT64 and run the Install Dependencies command again.
the quickest way to get started on Raspberry Pi is to use the pre-configured image or see Umfeld-on-RPI / Quickstart for platform-specific instructions.
on some systems, you may need to install git and curl with sudo apt install -y git curl before installing the dependencies.
well, Umfeld is actually imitating Processing.org quite bluntly ;) or a compliment to the original Processing.org project, or a token of respect.
this project aims to supply a framework that allows writing applications that more or less look like original Processing.org sketches.
Umfeld may also function as a statement on what is good and valuable about the Processing.org idiom while at the same time suggesting disconnecting it from one specific group, application or project … maybe a bit like markdown in that sense.
Umfeld is yet another programming environment for designers, makers, and artists. so why does it exist? and why not use Processing.org, OpenFrameworks, Cinder or any of the other frameworks out there?
well, the main reason why we even created Umfeld was basically to have a C++ derivative of Processing.org that stays very close to the original idiom. while Cinder and OpenFrameworks, for example, are fantastic projects, they differ quite a lot from the Processing.org Idiom ( i.e a setup()-draw() structure, stroke()+fill() and shape-based drawing, etcetera ). Umfeld, however, literally imitates core Processing classes and functions.
why not use the original Java-based Processing.org then? there are a few key aspects that just cannot and probably will never be resolved due to limitations imposed by Java. while Java is a very well-designed language and does many things better than C/C++, it has some drawbacks.
the most important benefit of moving to C/C++ is the availability of many extremely powerful and widespread libraries and APIs ( e.g OpenGL, OpenCV, FFmpeg, PortAudio ) that can be natively used and integrated into applications and sketches without the need for a native binding library. while many of these libraries have been fully or partly made accessible in Processing through native bindings, oftentimes these libraries or their bindings introduce significant overhead ( technically, administratively, etcetera ), are not at the current version, are incompatible with newer versions of OSes, or do not expose all functionality ( e.g unstable webcam support on macOS ). while this also happens with C/C++ libraries and APIs, the problems are greatly reduced. also, there is still a significant number of libraries and APIs not available for Java-based Processing or that are impossible to port because of limitations posed by Java VM implementations ( e.g multi-channel audio ).
in addition to this, due to the nature of C/C++ and the way Umfeld is implemented, applications and sketches developed with Umfeld can be built and deployed with a very(!) small memory and CPU footprint. this means that applications and sketches can potentially run on smaller or older hardware like, e.g Raspberry Pi. some modules can even be excluded from a build to reduce the footprint even more. Umfeld can even run truly headless ( i.e it does not require any virtual offscreen graphics driver if no window is required ).
furthermore, Umfeld uses CMake as a build system. CMake is very well-designed and more or less easy to learn and extend. this also means that Umfeld applications and sketches can be developed in more or less any text editor or IDE ( e.g Visual Studio Code, Zed, CLion, Vim ). it does not require proprietary build systems like Xcode.
and finally, although C and especially C++ is known for its horrific errors, confusing error messages, and volatile behavior at times, with the advent of LLM-based programming assistants, the entry threshold can be greatly reduced. trust the process. PS ( if vibe coding is even a thing this should be easy ;) )
PS note the character of this project is that features will be added as they are needed. it might partly replicate but not fully emulate the original Processing.org environment.
see DOCUMENTATION for usage information and examples for applications.
some relevant Umfeld repositories are:
- Umfeld :: this repository, containing the Umfeld library
- Umfeld Example :: a repository containing all the examples
- Umfeld Libraries :: a repository containing some libraries ( e.g Dear ImGui ) to extend Umfeld
- Umfeld Arduino :: an ( experimental ) board definition to run Umfeld applications from Arduino IDE or
arduino-cli
this project relies on the following packages:
- CMake
@version(macOS, 3.31.6) - pkg-config
@version(macOS, 2.4.3) - SDL3
@version(macOS, 3.2.8) - HarfBuzz
@version(macOS, 11.0.0) - Freetype
@version(macOS, 2.13.3) - ffmpeg
@version(macOS, 7.1.1) - rtmidi
@version(macOS, 6.0.0) - glm
@version(macOS, 1.0.1) - glad
@version(2.0.8)( included as source files ) - dylibbundler ( only required for bundling standalone macOS applications. it can also be installed via homebrew with
brew install dylibbundler)@version(macOS, 1.0.5) - PortAudio ( can be used as a replacement for SDL-based audio. in contrast to SDL it can output audio to multiple channels. it can also be installed via homebrew with
brew install portaudio)@version(macOS, 19.7.0) - oscpack ( included as source files )
- dr_libs ( included as source files )
- SimplexNoise ( included as source files )
- stb_image + stb_image_write ( included as source files )
- tiny_obj_load ( included as source files )
- tinyfiledialogs ( included as source files )
- PolyPartition ( included as source files )
- earcut.hpp ( included as source files )
- libtess2 ( included as source files )
( @version(macOS, X.X.X) states the platform and version number of the library with which Umfeld has been tested on macOS. other versions might work as well but are not guaranteed to. )
and as mentioned before of course Processing.org
- DOCUMENTATION :: detailed documentation on how to build from source, caveats, application structure etcetera
- Processing Function Availability Status :: list of functions that are part of Processing.org and available in Umfeld
- Additional Umfeld Functions :: list of functions added to Umfeld that are not part of Processing.org
- Umfeld in CLion :: instructions on how to run an Umfeld application as a CMake project in CLion
- Umfeld in Visual Studio Code :: instructions on how to run an Umfeld application as a CMake project in isual Studio Code