#### [Ollin](../index.md) → Examples
---
## Ollin examples
| [](3d/index.md) | [](audio/index.md) | [](basic/index.md) | [](color/index.md) |
|---|---|---|---|
| [3D](3d/index.md) | [Audio](audio/index.md) | [Basic](basic/index.md) | [Color](color/index.md) |
| [](compute/index.md) | [](data/index.md) | [](effects/index.md) | [](export/index.md) |
| [Compute](compute/index.md) | [Data](data/index.md) | [Effects](effects/index.md) | [Export](export/index.md) |
| [](images/index.md) | [](input/index.md) | [](installation/index.md) | [](integration/index.md) |
| [Images](images/index.md) | [Input](input/index.md) | [Installation](installation/index.md) | [Integration](integration/index.md) |
| [](live/index.md) | [](motion/index.md) | [](patterns/index.md) | [](physics/index.md) |
| [Live](live/index.md) | [Motion](motion/index.md) | [Patterns](patterns/index.md) | [Physics](physics/index.md) |
| [](randomness/index.md) | [](recreations/index.md) | [](rendering/index.md) | [](shaders/index.md) |
| [Randomness](randomness/index.md) | [Recreations](recreations/index.md) | [Rendering](rendering/index.md) | [Shaders](shaders/index.md) |
| [](shapes/index.md) | [](simulation/index.md) | [](text/index.md) | [](video/index.md) |
| [Shapes](shapes/index.md) | [Simulation](simulation/index.md) | [Text](text/index.md) | [Video](video/index.md) |
| [](vision/index.md) | [](web/index.md) | | |
| [Vision](vision/index.md) | [Web](web/index.md) | | |
The examples are small, runnable sketches. Together they form a learning path, in the style of openFrameworks. Each example is one self-contained `@main` file that shows a single idea. The examples are maintained and versioned with the API, so they always build against current Ollin.
### Layout
Examples are grouped into **category** folders, and each example gets its own folder inside its category. One example is one executable target, because SwiftPM allows only one `@main` per target. The sketch file is always `Sketch.swift`, at `Examples///Sketch.swift`. The folder name is therefore the example's identity, and the folder also holds the sketch's own resources (fonts, images, shaders). A category that has grown large can group its sketches one level deeper, at `Examples////Sketch.swift`. `3D/` is grouped by topic this way, and `Recreations/` is grouped by artist. The group name also becomes part of the target name (`Example---`). Each category has its own README that lists the sketches inside it:
| Category | What's inside |
|---|---|
| [3D](3d/index.md) | the 3D mode: meshes, camera, materials, lighting, environments, raymarched SDFs, depth feeds |
| [Audio](audio/index.md) | sound-reactive sketches (`import OllinAudio`) |
| [Basic](basic/index.md) | the smallest starting point |
| [Color](color/index.md) | palettes, colormaps, and color over time |
| [Compute](compute/index.md) | GPU compute: a million particles, and reaction-diffusion / texture simulations |
| [Data](data/index.md) | drawing from data: CSV tables and JSON documents, a polled feed, a pushed stream, and the weather over a city |
| [Effects](effects/index.md) | layered effects: GPU filters, feedback, generators, and the `compose { }` stack |
| [Export](export/index.md) | saving a sketch out: raster frame grab, vector SVG, and plotter hatching |
| [Images](images/index.md) | loading, drawing, tinting, and authoring images, plus glyph mosaics, pixel sorting, single-line renderings, and slit scan |
| [Input](input/index.md) | mouse-driven sketches |
| [Installation](installation/index.md) | pieces left running unattended, on a wall or in a window |
| [Integration](integration/index.md) | connecting to other apps and hardware: OSC, MIDI, DMX lighting, Syphon (`import OllinOSC` / `OllinMIDI` / `OllinDMX` / `OllinSyphon`) |
| [Live](live/index.md) | tunable `@Param` parameters under OllinLive |
| [Motion](motion/index.md) | animation driven by `time` |
| [Patterns](patterns/index.md) | generative patterns: grids, tessellations, rule-based repetition |
| [Physics](physics/index.md) | simulated motion (`import OllinPhysics`) |
| [Randomness](randomness/index.md) | `random`, `noise`, and scatter |
| [Rendering](rendering/index.md) | how the frame composites: blending, accumulation, HDR tone mapping, sandpainting |
| [Shaders](shaders/index.md) | writing your own GPU code: user shaders inline and from files, and fluent `Visual` chains |
| [Shapes](shapes/index.md) | the shape-drawing vocabulary: primitives, stroke and hollow modes, booleans, and SDF combinators |
| [Simulation](simulation/index.md) | systems evolving on the GPU: sim fields (`simField`), artificial life, particle fluids and soft bodies |
| [Text](text/index.md) | drawing text: bitmap, outline, and stroke fonts over one `drawText` |
| [Video](video/index.md) | recorded footage as drawing material (`import OllinVideo`) |
| [Vision](vision/index.md) | the camera plus on-device perception (`import OllinVision`) |
| [Web](web/index.md) | sketches made for a web page, limited to what a browser supports |
| [Recreations](recreations/index.md) | homages to past computer artists, by artist |
### Running
The examples are a package of their own, so run them from this directory. Each
one is a target whose name starts with `Example-`:
```sh
cd Examples
swift run Example-Basic-HelloCircle
swift run Example-Motion-SineSweep
```
Run `swift run` with no argument to list every runnable target. To run an example
from the repo root instead, name the package: `swift run --package-path Examples Example-Basic-HelloCircle`.
The commands in each category's README assume you are in this directory.
The examples are a separate package because SwiftPM builds every target of a
package. When the 350 sketch executables were in the root package, that meant
every `swift test` linked all of them.
You can also browse them all in one window. From the repo root, run:
```sh
swift run OllinExamples
```
The example list is on the left, grouped like the folders, with a filter bar at the bottom. The arrow keys move through the list. When you click a sketch, it compiles and runs in the middle. An inspector with live stats and `@Param` parameters is docked on the right. Both sidebars collapse from the title bar.
### Adding an example
1. Create `Examples///Sketch.swift` with an `@main final class : Sketch { … }`. You do not need an `OllinApp.run(...)` line, because `Sketch.main()` starts the sketch for you.
2. Add one line, `example("/")`, to the targets list in `Examples/Package.swift`. The helper derives the target name from the folder path, so the two cannot drift apart. A sketch that needs a satellite library passes it as the second argument, and co-located assets go in `resources:`.
3. Add a row to the category's `README.md`. A new category also needs its own `README.md` and a row in the table above.
By convention, a feature is not done until it has an example, and every example must compile. If a sketch is awkward to write, treat that as a sign that the API needs work, not the example.
### Recreations
`Recreations/` is a special section. Its sketches **recreate the work of past computer artists**, and they are organized by artist. SFPC's [Recreating the Past](https://sfpc.io/recreatingthepast-spring2020/) class inspired the section. Each sketch is a homage after the artist, not a reproduction, and the artist has not endorsed it. A short per-artist `README.md` introduces each artist. Each target name includes the artist's name:
```sh
swift run Example-Recreations-VeraMolnar-Interruptions
```
See [`Recreations/README.md`](recreations/index.md) for the full explanation.
### Attribution & sources
An example often *ports* a sketch from somewhere else. When one does, credit the source and respect its license:
- Add a header at the top of `Sketch.swift` that names the source:
```swift
// Ported from "" by —
// Original license: . Reworked for Ollin's API (Swift; Vector2/polyline).
```
- **Only port sources whose license permits redistribution under MIT:** MIT, BSD, Apache-2.0, CC0/public domain, or CC-BY (with credit). For GPL/LGPL, CC-BY-NC, or CC-BY-SA sources, rewrite the sketch as original work and use the source only as inspiration. Then credit it as "inspired by" instead.
An original sketch with no specific source needs no header. When something inspired it, you can add a one-line "inspired by …" note.
A sketch based on the maintainer's own work is credited by **serial number**. The header names the author and the S/N, not the private sketchbook the sketch came from. Use `// Ported from @eaviles's sketch 2025.003.` for a faithful port, or `// Based on elements of @eaviles's sketch 2023.023.` for a sketch that takes only some elements from the original. In both cases, follow the line with `Reworked for Ollin's API.`
For a **recreation** of a named artist's work (see `Recreations/`), also credit the artist in the header and in the per-artist `README.md`. Frame the sketch as a homage after the artist, not a reproduction, and note that the artist or their estate has not endorsed it.