Build and revise procedural 3D assets with your coding agent. Local MCP server, CLI and TypeScript engine with rendered review, editable source and GLB export.
JavaScript 3d3d-assets3d-modelingagent-skillsagent-toolsai-agentsasset-pipelinecligame-assetsglbgltfmcpmcp-servermodel-context-protocolprocedural-generationprocedural-modelingtext-to-3dthreejstypescript
import assert from 'node:assert/strict';
import { test } from 'node:test';
import { BACKDROP_HEX, BACKDROP_IDS } from '../src/backdrops.mjs';
import {
backdropClearColor,
displayBytes,
hexToBytes,
linearForDisplayBytes,
srgbDecode,
toneMap,
} from '../src/display-transform.mjs';
import { PRESENTATION_PRESET_IDS, getPresentationPreset } from '../src/presentation-presets.mjs';
test('the forward transform reproduces pixels measured on the GPU', () => {
// Read back from a dawn-d3d12 device at the studio exposure of 1.38, when the
// backdrop was still cleared as a plain colour. This is the calibration that
// says the port is the transform the output pass really applies.
for (const [hex, measured] of [
['#aab1bc', [203, 207, 213]],
['#1a1a1a', [14, 14, 14]],
['#dfe3e8', [227, 228, 230]],
]) {
const linear = hexToBytes(hex).map((byte) => srgbDecode(byte / 255));
assert.deepEqual(displayBytes(linear, 1.38), measured, hex);
}
});
test('every backdrop reads back as its own table bytes at every preset exposure', () => {
for (const id of PRESENTATION_PRESET_IDS) {
const { exposure, toneMapping } = getPresentationPreset(id);
for (const backdrop of BACKDROP_IDS) {
const hex = BACKDROP_HEX[backdrop];
const clear = backdropClearColor(hex, exposure, toneMapping);
// A clear above 1.0 is fine: the framebuffer is HalfFloat, and a lower
// exposure needs a brighter scene value to reach the same byte.
assert.ok(
clear.every((c) => c >= 0),
`${backdrop} at ${id}: ${clear}`,
);
assert.deepEqual(
displayBytes(clear, exposure, toneMapping),
hexToBytes(hex),
`${backdrop} at ${id}`,
);
}
}
});
test('the inverse is exact for every grey at any exposure', () => {
for (const exposure of [0.9, 1.38, 2.5]) {
for (let grey = 0; grey <= 255; grey++) {
const bytes = [grey, grey, grey];
assert.deepEqual(displayBytes(linearForDisplayBytes(bytes, exposure), exposure), bytes);
}
}
});
test('refuses what the tone mapping cannot reach and what it cannot parse', () => {
assert.throws(() => linearForDisplayBytes([255, 0, 0], 1.38), /not reachable/);
assert.throws(() => linearForDisplayBytes([170, 177], 1.38), /three integers/);
assert.throws(() => backdropClearColor('#aab1bc', 0), /exposure/);
assert.throws(() => backdropClearColor('aab1bc', 1.38), /hex/);
});
test('review transform reproduces independent GPU radiance and preserves highlight hue', () => {
// HalfFloat radiance from the calibrated GLB on Dawn/D3D12, not albedo values.
assert.deepEqual(
displayBytes([0.61181640625, 0.05377197265625, 0.040435791015625], 0.9, 'review-neutral'),
[193, 51, 40],
);
for (const gain of [1, 2, 4, 8, 16]) {
const rgb = displayBytes([gain, gain * 0.3, gain * 0.05], 1, 'review-neutral');
assert.ok(rgb[0] > rgb[1] && rgb[1] > rgb[2], `highlight channel order: ${rgb}`);
// At high radiance an 8-bit channel can round to 255 while the continuous
// shoulder remains below one; that is different from hard clipping.
assert.ok(toneMap([gain, gain * 0.3, gain * 0.05], 1, 'review-neutral')[0] < 1);
}
});
test('review inverse exactly reaches named backdrops through both branches and exposures', () => {
for (const exposure of [0.2, 0.9, 2.5]) {
for (const hex of [
...Object.values(BACKDROP_HEX),
'#000000',
'#010101',
'#333333',
'#f8f8f8',
]) {
const clear = backdropClearColor(hex, exposure, 'review-neutral');
assert.deepEqual(displayBytes(clear, exposure, 'review-neutral'), hexToBytes(hex));
}
for (let grey = 0; grey < 255; grey++) {
const bytes = [grey, grey, grey];
assert.deepEqual(
displayBytes(
linearForDisplayBytes(bytes, exposure, 'review-neutral'),
exposure,
'review-neutral',
),
bytes,
);
}
}
assert.throws(() => linearForDisplayBytes([255, 0, 0], 0.9, 'review-neutral'), /not reachable/);
assert.throws(() => backdropClearColor('#aab1bc', 0.9, 'unknown'), /tone mapping/);
});