Morrowdock MartyGraphics
Menu

Open source · early preview · Apache-2.0

MartyGraphics

The Swift scene engine that draws Morrowdock’s teaching pictures. A scene is validated JSON; MartyGraphics turns it into drawing primitives, parametric templates, layout, animation, patches and streaming, rendered with SwiftUI or SceneKit. No external Swift package dependencies.

Source on GitHub Get started

What these pictures are

Native exports. Every image on this page is a frame from the public MGCanvasRenderer and MGTimeline, rendered offscreen with SwiftUI’s ImageRenderer inside a small caption card. They are not screenshots of the Morrowdock app and not browser re-creations. The interactive stops on the homepage are browser re-creations, written separately in JavaScript.

All six scenes are original synthetic examples under Apache-2.0. They use the engine’s two public built-in templates (binary-search tree and two-pointer array) and its generic primitives. They don’t imply a curriculum, a solver, a running service or an AI model. No video, live interactive playback, accessibility or performance result is claimed for them.

Tree search

MGTemplates built-in: binary-search tree

Native binary search tree: the path twelve, five, eight is highlighted.
Search 12 → 5 → 8, finding 8 in three comparisons.

Follow the comparisons down a binary search tree: each one rules out the other branch.

Scene source (tree.json) · Run it locally

Two pointers

MGTemplates built-in: two-pointer array

Native array with five and nine selected for the target fourteen.
The final step selects 5 + 9 = 14 from [2, 5, 9, 14].

Two indices move through a sorted array by one rule until the pair totals 14.

Play the native animation (4 frames, 1.2 s each: 4.8 s, loops) Native array with five and nine selected for the target fourteen. Animated export; with reduced motion the still is shown.

Scene source (two-pointers.json) · Run it locally

Message handoff

Generic primitives

Native directed diagram, Source to Queue to Worker, with Worker highlighted.
Source → Queue → Worker; the final step highlights Worker.

A step changes the highlighted node in a directed diagram. This is a diagram: no queue is executed.

Scene source (handoff.json) · Run it locally

Sampled function

Generic primitives

Native plot of seven supplied samples of x squared.
Seven supplied points sketch y = x² from x = −3 to 3.

The points are supplied in the scene; the engine draws them and does not derive or solve anything.

Scene source (function.json) · Run it locally

Synthetic counts

Generic primitives

Native labelled bars comparing eighteen, thirty and twenty-four.
Alpha 18, Beta 30, Gamma 24. Every quantity is invented.

Labelled bars compare three invented values; nothing is measured.

Scene source (counts.json) · Run it locally

Geometric motion

MGTimeline

Native geometric marker midway between A and B, sampled at one second.
A marker takes two seconds from A to B, then returns. This still is sampled at one second.

MGTimeline animates position along a path; it does not simulate forces.

Play the native animation (32 frames, 0.13 s each: 4.16 s, loops) Native geometric marker midway between A and B, sampled at one second. Animated export; with reduced motion the still is shown.

Scene source (motion.json) · Run it locally

Six-scene overview (1172 × 1640, 454 KiB) · Capture receipt (JSON) · Showcase notes

Use it

Requires Swift 6 and macOS 14+, or iOS 17+ when embedded in an app. From a checkout: swift build && swift test. Add it as a local Swift package and draw a scene from a SwiftUI view:

import Foundation
import MartyGraphics

let json = #"{"v":1,"items":[{"id":"dot","k":"body","at":[3,4],"shape":"ball","size":1}]}"#
let scene = try MGParser.scene(data: Data(json.utf8)).get()
// Inside your SwiftUI view:
MartyGraphicsView(scene: scene)

Early preview: APIs and the wire format may change, and there is no versioned release yet. The renderers use Apple frameworks, so Windows and Linux builds are unsupported. Packs are code a host registers; no catalog, downloader or trust store is bundled.

Reproduce the exports

The receipt pins the exporter source at 7c7c280e. Build, 23 package tests (zero failures), scene verification and native export passed on macOS 26.6.2 with Apple Swift 6.3.3 (arm64, SwiftPM debug, renderer scale 1). The files here are byte-identical to the accepted copies in docs/assets/native; their SHA-256 digests are in the receipt.

swift build
swift test
swift run --package-path Examples/Showcase marty-showcase --verify
swift run --package-path Examples/Showcase marty-showcase --export <new output directory>