Web Design: shader canvases in web pages¶
Open Noise Factor | Open alex.ayars.info
Two websites use Noisemaker canvases as page graphics.
The Noise Factor site header has a shader background.
alex.ayars.info has a shader panel with a code editor, where visitors can change the program.
Both sites use a helper module, shader-renderer.js, that exports createBackgroundShader(). [W1] [W2]
The helper¶
createBackgroundShader(canvas, program, options) runs these steps. options gives the canvas width and height. [W1]
Import
CanvasRendererfromhttps://shaders.noisedeck.app/1/noisemaker-shaders-core.esm.js.Create a
CanvasRendererwithpreferWebGPU: false.Load the effect manifest.
Load the effects that the program names.
Compile the program and start rendering.
It returns the renderer, or null if a step fails.
Each site has its own copy of shader-renderer.js, and the two copies are different. [W1] [W2]
The Noise Factor header¶
<nf-header> is a custom element that noisefactor.io, downloads.noisefactor.io, and forum.noisefactor.io use.
It contains a canvas, a logo link, and a <nav aria-label="Site"> element.
The canvas has aria-hidden="true" and pointer-events: none, so it does not affect the links. [W4] [W5]
This is the header program: [W4]
search synth, filter, mixer
cell(
shape: triangle,
scale: 100,
cellScale: 100,
variation: 100,
speed: 1
)
.write(o0)
solid(color: #aad604ff)
.blendMode(
tex: read(o0),
mode: overlay,
mix: -10.59
)
.lighting(
normalStrength: 5,
smoothing: 1.6,
specularIntensity: 1.68,
shininess: 94,
ambientColor: #000000ff,
lightDirection: vec3(0.733, 0.367, 0.573),
reflection: 27,
refraction: 37,
aberration: 27.8
)
.write(o1)
render(o1)
The header starts the shader like this: [W4]
async startHeaderShader(canvas) {
try {
const size = sizeCanvasToHeader(canvas);
const renderer = await createBackgroundShader(canvas, HEADER_SHADER_PROGRAM, size);
// The lime .nf-header background is the no-WebGL fallback; if the
// shader failed to compile there is nothing to keep in resize step.
if (!renderer) return;
window.addEventListener('resize', () => {
const next = sizeCanvasToHeader(canvas);
renderer.resize(next.width, next.height);
});
} catch (e) {
console.error('Shader init failed:', e);
}
}
sizeCanvasToHeader() multiplies the header size by the device pixel ratio.
The canvas is at least 160 × 30 pixels. [W4]
If the shader does not start, the header shows its CSS background, a lime color close to the shader output. [W5]
The alex.ayars.info shader panel¶
The page shows the program in a code editor on top of the canvas. The canvas renders at half the device pixel ratio. [W3]
The editor uses the personal site’s BackgroundShaderRenderer.apply(program).
This method loads the effects that the program names and compiles it.
It returns { ok, error } and keeps the new program only after a successful compile. [W2]
The page adds these rules around apply(): [W3]
It waits until 500 ms pass with no typing, and then compiles.
Cmd+Enter or Ctrl+Enter compiles at once.
It ignores the result of a compile if the user made a newer edit during that compile.
It shows a compile error only when the program still fails 1500 ms later. The error stays until the program compiles again.
Limits¶
Both sites resize the canvas only on the window
resizeevent. [W3] [W4]The header element is hidden until its script defines it, so a page without JavaScript has no header. [W5]
On alex.ayars.info, the editor is hidden on screens 768 pixels wide or less. Edits are not saved. [W3]
Neither the header nor the alex.ayars.info page checks
prefers-reduced-motion. [W3] [W4] [W5]
Sources¶
These are the files that the two sites serve. The source repositories are private.