3D engine that AI agents drive
import { createCameraPath } from './camera-path.js';
function lerpVector(first, second, amount) {
return first.map((value, axis) => value + (second[axis] - value) * amount);
}
/**
* Turns camera keys into a function from seconds to a camera pose. Keys are either { fps, frames: [[eye, target], ...] },
* sampled with a linear blend between neighbouring frames, or the keys createCameraPath takes (duration, eye, target, fov...).
*/
export function createCameraSampler(keys) {
if (Array.isArray(keys.frames)) {
const { frames } = keys;
const framesPerSecond = keys.fps ?? 24;
return {
duration: frames.length / framesPerSecond,
sample(seconds) {
const position = Math.max(0, Math.min(frames.length - 1, seconds * framesPerSecond));
const before = Math.floor(position);
const after = Math.min(frames.length - 1, before + 1);
const amount = position - before;
return {
eye: lerpVector(frames[before][0], frames[after][0], amount),
target: lerpVector(frames[before][1], frames[after][1], amount),
};
},
};
}
const path = createCameraPath({ loop: false, ...keys });
return {
duration: keys.duration,
sample(seconds) {
const pose = path.sample(Math.min(seconds, keys.duration));
return { eye: Array.from(pose.eye), target: Array.from(pose.target), up: Array.from(pose.up), fov: pose.fov };
},
};
}