Repository navigation
Releases
Isohypse v0.1.0
The first release of Isohypse: contour lines of real worlds for Resolume Arena and Avenue, swept through by a line that climbs from the lowest ground to the highest. Two FFGL plugins in one download: SW Isohypse (IH01), a source, and SW Isohypse Over (IH02), an effect that draws a world over your clip, or reads the clip's own brightness as the height and contours that instead.
The one idea. A contour is where the ground is a whole number of intervals up, and Lines says how many there are from a world's lowest point to its highest. A pixel is on a contour when its level is within half a line of it, measured in pixels through the slope, so a line keeps the same width on a cliff as on a plain, the way a pen does. The sweep is one more contour whose height moves: up (Rise), down (Fall), both (Bounce) or where you put it (Manual), with every other line lit by how recently the sweep crossed it. With Floor at 0 a Rise draws the map from the bottom up, the way Sebastian Lague's pen plotter draws the Moon; with Flood up it's the sea coming in instead. A pass takes its own time or locks to 1 to 64 of Resolume's bars.
The worlds. Earth from NOAA's ETOPO 2022, sea floor and all; the Moon (LRO's laser altimeter), Mars (MGS MOLA), Mercury (MESSENGER), Venus (Magellan), Ceres and Vesta (Dawn), and Pluto and Charon (New Horizons, the side it saw; the rest is left blank rather than made up). Twenty-two places on Earth from the Terrarium elevation tiles, London to Everest. A Generated world of continents, ridges or craters, with a Seed and a Morph. And in the Over, Clip: your clip's brightness as the height, or any greyscale heightmap still you give it, which is also the only way to Middle-earth. That isn't bundled: every heightmap of it is drawn from Tolkien's maps, and those are the Tolkien Estate's to share. Gas giants have no ground to contour.
Controls: World (World, Place, View, Longitude, Latitude, Zoom, Spin, Rotation); Contours (Lines, Index Every, Line Width, Smooth, Sea Fill, Depths); Sweep (Sweep, Sweep Time, Sweep Bars, Sweep Level, Sweep Glow, Trail, Floor, Flood, Flow, Restart); Look (Style: Ink, Plotter, Neon or Survey; Hue, Height Colour, Glow, Shade, Tints, Wobble, and Background on the source); Generated (Terrain, Seed, Feature Size, Roughness, Sea, Morph); and on the Over, Clip Show, Invert and Mix.
Downloads: a universal macOS build (Apple silicon and Intel) as a .dmg or .zip, and a Windows x64 installer (-setup.exe) or .zip. Every map travels inside each plugin, so each is about 40 MB; every archive carries ATTRIBUTIONS.md and SOURCES.md, as some of the places' sources require. The macOS build is Developer ID-signed and notarised minutes after publication; if macOS refuses a download, it's from before that, so download it again. The Windows build isn't signed, so SmartScreen warns once.
What is measured (offline, by tools/verify.sh on an Apple M4 Max under macOS 26, driving the plugins' own classes in a headless GL context, on the GPU and again on Apple's software renderer):
- The contours. A ramp at 8, 20 and 50 Lines crosses exactly that many contours, each within 0.013 px of where the arithmetic puts it; a contour keeps its width within 3% on slopes eight times apart; a flat picture draws nothing.
- The sweep. Manual's line within 0.013 px of its level; every contour's strength behind the sweep within 0.0005 of the CPU's own model, in all five modes; a pass in Sweep Time to 1e-9, and on bars following a host's bar phase to 3e-8 of a pass.
- The worlds. Everest, the Mariana Trench, Olympus Mons, Hellas, Maxwell Montes and the Moon's far-side highlands at their heights in the data, and where the globe and the map put them; all 9 globes and 22 places load and draw; the first world on the first frame, and no blank frame while the next one decodes.
- The checks can fail. Five deliberately wrong models each fail their check, and thirteen one-character mutants of the shipped GLSL and C++ are all caught. All 41 controls change the picture, and each of the 37 the Over shares with the source changes the Over's too. Both bundles are universal, and
oxbowreadsSW Isohypse/IH01/ source andSW Isohypse Over/IH02/ effect and renders through both.
In Resolume on macOS: Arena 7.28.1, driven over its REST API (27 October, on the build before the About block gained its User guide button and the Over lost a control it never read): both plugins register, all 38 of the source's controls change Arena's output, Sweep Bars follows Arena's tempo and stops dead when it's paused, and the Over at Mix 0 hands its clip back to the bit.
On Windows it has been in Resolume too. The fleet's Arena gate ran CI's release build in Arena 7.27.1 on win-lab (software rendering, no GPU): both DLLs load, register as IH01 (a source) and IH02 (an effect) and appear in Arena's lists, all 43 and 46 controls match their names, order, types, ranges and defaults, both render, and Arena's log stays clean: 15 passed, 0 failed, 2 skipped. Against stills, 34 of the source's 35 testable controls and all 38 of the Over's changed the picture; Spin turns the globe, so a still can't pin it down, and Sweep Time and Sweep Bars only set a moving sweep's pace. Software rendering says nothing about a GPU or about speed.
Found before release, and fixed. Writing the user guide meant rendering every claim in it, and that found the Over offering a Background slider it never read (its ground is the clip, mixed in by Clip Show). It's gone from the Over, and ihtest --controls now checks every control the Over shares with the source on the Over itself, which would have caught it. The release workflow's own Windows check misread the parameter count on windows-latest (a PowerShell hex literal that masked nothing); it reads the low 32 bits now, as a host does.
What isn't verified, or is a limit. No GPU but one Mac's has run it, and Windows only on software rendering. A coastal place whose land survey has no depths has a flat sea that Survey's Tints colour as the deepest water, and Shade lays a purple-grey wash over any sea. Positive Spin turns a globe the opposite way to the real Earth. The maps are their own resolution (Earth about 10 km a pixel), so peaks and trenches are a little lower and shallower than their real heights. No audio input.
Cost, on an Apple M4 Max: the Moon at the defaults 0.44 ms a frame at 1080p and 1.35 ms at 4K; a morphing Generated crater world 3.3 and 4.3 ms; the Over with the clip as the map 0.49 and 1.88 ms. Nothing was timed inside Resolume.
Not done. No presets, no browser demo and no OpenFX port.
- User guide: https://stoatworks-labs.com/software/isohypse/guide/
- Project page: https://stoatworks-labs.com/software/isohypse/