noisemaker-for-ruby

This is not a classic noise library. This is a new effort centered around software shader execution.

A pure-Ruby CPU implementation of the Noisemaker shader engine — the Ruby port of noisemaker-cpu, sibling to the Python and Perl ports.

Effect kernels are transpiled directly from the upstream GLSL served by the shaders.noisedeck.app CDN (sha256-locked), not hand-maintained: a pure-Ruby GLSL ES 3.00 front end lexes, preprocesses, parses, and emits a Ruby kernel per shader pass, and a float32-faithful runtime reproduces the reference engine's arithmetic — float32 register rounding, half-float render-target quantization, GLSL uint32 wraparound with bit-exact PCG hashing, screen-space derivatives, and GL texture sampling.

All 205 catalog effects are bundled (297 kernels) and render at byte-parity with the JavaScript engine's effect CLI — verified by scripts/parity.rb against a sibling noisemaker-cpu checkout.

Install

Core stdlib only — no runtime gem dependencies. Ruby 3.2+.

gem build noisemaker-for-ruby.gemspec
gem install noisemaker-for-ruby-0.0.0.gem

Or straight from a checkout: ruby -Ilib exe/noisemaker-rb ...

Render an effect

CLI:

# generate a single frame
noisemaker-rb generate synth/curl --width 512 --height 512 --filename curl.png
noisemaker-rb generate random --seed 42

# apply an effect to an existing image
noisemaker-rb apply filter/chrome photo.png --filename chrome.png

# animate an effect over time (needs ffmpeg for .mp4)
noisemaker-rb animate synth/curl --frame-count 60 --filename curl.mp4

# render a Polymorphic DSL program from stdin
echo 'search synth, filter
noise(seed: 3, ridges: true).vignette().write(o0)
render(o0)' | noisemaker-rb run --width 512 --height 512

Library:

require "noisemaker_cpu"

surface = NoisemakerCpu::Renderer.render_effect(
  "synth/curl", { "scale" => 16 }, nil, width: 512, height: 512, seed: 1
)
File.binwrite("curl.png", NoisemakerCpu::PNG.encode_png(surface))

Regenerating the bundle

The vendored kernels + metadata under lib/noisemaker_cpu/bundle/ are generated from the CDN (cached to .cdn-cache/, sha256-locked in bundle-lock.json):

ruby scripts/build-bundle.rb --all

Tests

rake test

Cross-language parity against the JS engine (scripts/parity.rb) needs a sibling noisemaker-cpu checkout (or NOISEMAKER_CPU_DIR) and Node.

License

MIT © Noise Factor LLC. See LICENSE.