Sculpting Data: Overview

Sculpting Data is a guided sequence that teaches MayaFlux through one principle:

Data is material. You shape it.

It is meant to be read progressively, but each part stands alone.

This page explains how to use the series and what to expect in each tutorial.

Before You Begin

You don’t need detailed C++ knowledge; only curiosity and willingness to experiment. It is recommended to read the cards below before starting the tutorials, as it explains the structure and flow of the series.

👉 Part I — Foundations of Form

!IMPORTANT: Terminology Note Across Versions

Click to expand (read once)

What changed?

  • (OLD)ContainerBuffer → SoundContainerBuffer
  • (OLD)ContainerToBufferAdapter → SoundStreamReader
  • (OLD)StreamWriteProcessor → SoundStreamWriter
  • (OLD)FileBridgeBuffer → SoundFileBridge

MayaFlux is currently in active architectural consolidation. As part of this, several internal classes were renamed to make domain boundaries explicit before graphics and multi-domain I/O support arrive.

You may notice names in this tutorial that differ from those in MayaFlux 0.1.x. This is intentional.

These renames do not introduce new behavior. They clarify that these components are audio-domain infrastructure, and prevent accidental misuse as graphics and video containers are added.

MayaFlux is currently in active architectural consolidation. As part of this, several internal classes were renamed to make domain boundaries explicit before graphics and multi-domain I/O support arrive.

How to read this tutorial

  • If you are on MayaFlux 0.1.x, mentally substitute the older names.
  • If you are on 0.2+, the names here match the codebase directly.
  • In all cases, the architecture, data flow, and concepts are identical.

These tutorials describe roles and relationships, not version-specific symbols.

How to Use These Tutorials

Flow First

Move linearly through each tutorial. Sections are designed to be short and runnable.

Return When Ready

Advanced readers can thumb through the explanations. You can skip them and return at any time without losing the thread.

Optional Depth

Open collapsed API/Design panels only when you want to dive deeper.

Structure of Every Section

1. Section Heading

Each section begins with Tutorial: <Concept>. This signals that a runnable example follows.

2. Runnable Example

The spine of the section. Short, minimal, and executable immediately.

3. Optional Panels

API notes, design notes, and advanced variations — all collapsed by default.

4. Try It → Recap

A quick checkpoint: summary, modified snippet, optional variant.

5. Flow Controls

Every part ends with navigation to the next part, the overview, and the full tutorials index.

  1. Read the section heading
  2. Run the example
  3. Skip to next section named "Tutorial", OR
  4. Open deep-dive only if needed
  5. Use Try It → Recap
  6. Move on

You can complete the series linearly in 1–2 hours,
or spend days exploring optional subsections.

Sculpting Data Tutorials

Part I — Foundations of Form

Containers → Buffers → Form.

Part II — Processing Expression

Processors, operations, shaping behaviour.

Part III — Visual Materiality I

Introduction to declarative graphics

Part IV — Contextual Intelligence (planned)

Conditional adaptation and dynamic pipelines.