| import { CatmullRomCurve3, Vector3, Quaternion, Euler } from "three"; |
| import { bindTrackTrigger, validateTrackTriggers } from "./track-triggers.mjs"; |
| import { clearEntityTargets } from "./entity-targets.mjs"; |
| const finite = (n, min, max) => Number.isFinite(n) && n >= min && n <= max; |
| const vector = (p, n = 3) => Array.isArray(p) && p.length === n && p.every((v) => finite(v, -100, 100)); |
| const isCamera = (o) => o?.kind === "camera"; |
| const isLight = (o) => o?.kind === "light"; |
| const isRig = (o) => isCamera(o) || isLight(o); |
| function objectQuaternion(o) { |
| return o.quaternion ? [...o.quaternion] : new Quaternion().setFromEuler(new Euler(0, o.yaw ?? o.rotation ?? 0, 0)).toArray(); |
| } |
| function validateCinema(scene) { |
| if (scene.productionReady !== void 0 && typeof scene.productionReady !== "boolean") throw Error("Invalid setup state"); |
| for (const o of scene.objects) { |
| if (o.aimTargetId && (![...scene.objects, ...scene.actors || []].some((a) => a.id === o.aimTargetId) || o.aimTargetId === o.id)) throw Error("Invalid camera target"); |
| if (o.quaternion && (!vector(o.quaternion, 4) || Math.abs(Math.hypot(...o.quaternion) - 1) > 0.01)) throw Error("Invalid object pose"); |
| if (o.kind !== void 0 && !["camera", "light"].includes(o.kind)) throw Error("Invalid tool type"); |
| if (isCamera(o) && (!o.camera || !finite(o.camera.fov, 15, 110) || !finite(o.camera.aspect, 0.5, 3))) throw Error("Invalid camera settings"); |
| if (isLight(o) && (!o.light || !["point", "spot"].includes(o.light.type) || !finite(o.light.intensity, 0, 100) || !finite(o.light.range, 0.1, 100) || !finite(o.light.angle, 1, 85) || !/^#[\da-f]{6}$/i.test(o.light.color))) throw Error("Invalid light settings"); |
| if (o.track) { |
| const t = o.track; |
| if (!scene.curves?.some((c) => c.id === t.curveId) || !finite(t.duration, 0.25, 120) || !finite(t.delay, 0, 120) || !finite(t.fadeOut, 0, t.duration) || !["fixed", "target", "tangent"].includes(t.orientation)) throw Error("Invalid track or missing curve"); |
| if (t.targetId && ![...scene.objects, ...scene.actors || []].some((a) => a.id === t.targetId)) throw Error("Camera target no longer exists"); |
| } |
| } |
| if (scene.objects.filter(isCamera).length > 8 || scene.objects.filter(isLight).length > 8) throw Error("This edition supports up to 8 cameras and 8 lights"); |
| return validateTrackTriggers(scene); |
| } |
| function curvePoints(controls, smooth = true) { |
| if (!Array.isArray(controls) || controls.length < 2 || controls.length > 64 || controls.some((p) => !vector(p))) throw Error("Invalid control points (2–64 required)"); |
| if (controls.every((p) => new Vector3(...p).distanceTo(new Vector3(...controls[0])) < 1e-3)) throw Error("Curve endpoints are too close. Draw a longer path."); |
| if (!smooth || controls.length === 2) return structuredClone(controls); |
| return new CatmullRomCurve3(controls.map((p) => new Vector3(...p)), false, "centripetal").getSpacedPoints(Math.min(256, controls.length * 16)).map((p) => p.toArray()); |
| } |
| function editableControls(curve) { |
| if (curve.controls) return structuredClone(curve.controls); |
| const p = curve.points; |
| if (p.length <= 12) return structuredClone(p); |
| return Array.from({ length: 12 }, (_, i) => [...p[Math.round(i * (p.length - 1) / 11)]]); |
| } |
| function newRig(kind, id, position) { |
| if (!["camera", "spot", "point", "box"].includes(kind) || !vector(position)) throw Error("Invalid creation parameters"); |
| const o = { id, name: kind === "camera" ? "Camera" : kind === "box" ? "Box" : kind === "spot" ? "Spotlight" : "Point light", group: "Authoring tools", shape: kind === "point" ? "sphere" : "box", position: [...position], size: kind === "box" ? [0.4, 0.4, 0.4] : [0.22, 0.16, 0.28], rotation: 0, roughness: 0.6, metalness: 0, color: kind === "camera" ? "#4098df" : kind === "box" ? "#71b68c" : "#ffd266", editable: true }; |
| if (kind === "camera") { |
| o.kind = "camera"; |
| o.camera = { fov: 55, aspect: 16 / 9 }; |
| } |
| if (["spot", "point"].includes(kind)) { |
| o.kind = "light"; |
| o.light = { type: kind, intensity: 8, range: 12, angle: 35, color: "#fff2da" }; |
| } |
| return o; |
| } |
| function groundCreateCommand(command, point) { |
| if (!vector(point)) throw Error("Point at visible ground, then press A to place"); |
| const { position: ignored, ...values } = command.values || {}; |
| const position = [...point], body = newRig(command.kind, command.id, position); |
| position[1] += body.size[1] / 2; |
| if (!vector(position)) throw Error("Placement is outside the scene"); |
| return { ...command, op: "create", position, values }; |
| } |
| function applyCinema(scene, command) { |
| const next = structuredClone(scene), c = command; |
| next.productionReady = false; |
| const target = next.objects.find((o) => o.id === c.id); |
| if (c.op === "create") { |
| if (next.objects.some((o2) => o2.id === c.id) || !/^[-\w]{1,80}$/.test(c.id)) throw Error("Invalid object ID"); |
| const o = newRig(c.kind, c.id, c.position); |
| o.name = c.name?.slice(0, 80) || `${o.name} ${next.objects.filter((a) => a.kind === o.kind).length + 1}`; |
| next.objects.push(o); |
| if (c.values) return applyCinema(next, { op: "update", id: o.id, values: c.values }); |
| } else if (c.op === "poses") { |
| if (!Array.isArray(c.poses) || !c.poses.length || c.poses.length > 187) throw Error("No pose changes to save"); |
| for (const p of c.poses) { |
| const o = [...next.objects, ...next.actors || []].find((a) => a.id === p.id); |
| if (!o || !vector(p.position) || (!vector(p.quaternion, 4) || Math.hypot(...p.quaternion) < 0.01)) throw Error("Invalid pose target"); |
| if (o.editable !== true && (o.id === "ground" || o.category === "structure" || /^(wall|ceiling)(_|-|$)/.test(o.id))) throw Error("Reference structure is locked."); |
| o.position = [...p.position]; |
| const q = new Quaternion(...p.quaternion).normalize(); |
| if (o.assetId) o.yaw = new Euler().setFromQuaternion(q, "YXZ").y; |
| else { |
| o.quaternion = q.toArray(); |
| o.rotation = new Euler().setFromQuaternion(q, "YXZ").y; |
| } |
| } |
| } else if (c.op === "remove") { |
| if (!target || target.editable !== true && (target.id === "ground" || target.category === "structure")) throw Error("Select an editable object to delete"); |
| next.objects = clearEntityTargets(next.objects.filter((o) => o.id !== c.id), c.id); |
| if (next.regions) next.regions = next.regions.filter((r) => (r.objectId || r.doorId) !== c.id); |
| if (next.floods) next.floods = next.floods.filter((f) => (f.objectId || f.doorId) !== c.id); |
| } else if (c.op === "update") { |
| if (!target) throw Error("Select an object, camera or light first"); |
| const p = c.values || {}; |
| if (p.position !== void 0) { |
| if (!vector(p.position)) throw Error("Invalid position"); |
| target.position = [...p.position]; |
| } |
| if (p.fov !== void 0) { |
| if (!isCamera(target)) throw Error("This object is not a camera"); |
| target.camera.fov = p.fov; |
| } |
| if (p.lightType !== void 0) { |
| if (!isLight(target)) throw Error("This object is not a light"); |
| if (!["point", "spot"].includes(p.lightType)) throw Error("Invalid light type"); |
| target.light.type = p.lightType; |
| target.shape = p.lightType === "point" ? "sphere" : "box"; |
| } |
| if (p.color !== void 0) { |
| target.color = p.color; |
| if (isLight(target)) target.light.color = p.color; |
| } |
| for (const key of ["intensity", "range", "angle"]) if (p[key] !== void 0) { |
| if (!isLight(target)) throw Error("This object is not a light"); |
| target.light[key] = p[key]; |
| } |
| if (p.curveId !== void 0) { |
| if (p.curveId === null) delete target.track; |
| else target.track = { duration: 8, delay: 0, fadeOut: 0, orientation: "fixed", targetId: null, ...target.track, curveId: p.curveId }; |
| } |
| for (const key of ["duration", "delay", "fadeOut"]) if (p[key] !== void 0) { |
| if (!target.track) throw Error("Bind a saved curve first"); |
| target.track[key] = p[key]; |
| } |
| if (p.targetId !== void 0) { |
| if (target.track) target.track.targetId = p.targetId; |
| else target.aimTargetId = p.targetId; |
| } |
| if (p.orientation !== void 0) { |
| if (target.track) target.track.orientation = p.orientation; |
| else if (p.orientation === "fixed") delete target.aimTargetId; |
| else if (p.orientation !== "target" || !target.aimTargetId) throw Error("Bind a curve before using tangent orientation"); |
| } |
| } else if (c.op === "regionTrigger") { |
| bindTrackTrigger(next, c); |
| if (c.values) return applyCinema(next, { op: "update", id: c.id, values: c.values }); |
| } else if (c.op === "clearTrigger") { |
| if (!target?.track?.trigger) throw Error("This object has no region trigger"); |
| delete target.track.trigger; |
| } else if (c.op === "curve") { |
| const curve = next.curves?.find((p) => p.id === c.id); |
| if (!curve) throw Error("Curve no longer exists"); |
| curve.rawPoints ||= structuredClone(curve.points); |
| curve.controls = c.straight ? [[...curve.points[0]], [...curve.points.at(-1)]] : structuredClone(c.controls || editableControls(curve)); |
| curve.smooth = c.smooth ?? true; |
| curve.points = curvePoints(curve.controls, curve.smooth); |
| curve.editVersion = (curve.editVersion || 0) + 1; |
| } else if (c.op === "complete") { |
| next.productionReady = true; |
| } else throw Error("Unknown authoring operation"); |
| if (next.triggerRegions) { |
| const used = new Set(next.objects.map((o) => o.track?.trigger?.regionId)); |
| next.triggerRegions = next.triggerRegions.filter((r) => used.has(r.id)); |
| } |
| return validateCinema(next); |
| } |
| function rigFrame(o, curves, time, targets = []) { |
| let position = [...o.position], quaternion = objectQuaternion(o), intensity = o.light?.intensity; |
| const t = o.track, curve = t && curves.find((c) => c.id === t.curveId); |
| if (!curve) { |
| const target = targets.find((v) => v.id === o.aimTargetId); |
| if (target) quaternion = lookAt(position, target, quaternion); |
| return { id: o.id, position, quaternion, rotation: new Euler().setFromQuaternion(new Quaternion(...quaternion), "YXZ").y, intensity }; |
| } |
| const points = curve.points; |
| const lengths = [0]; |
| for (let i2 = 1; i2 < points.length; i2++) lengths.push(lengths[i2 - 1] + new Vector3(...points[i2]).distanceTo(new Vector3(...points[i2 - 1]))); |
| const progress = Math.max(0, Math.min(1, (time - t.delay) / t.duration)), distance = progress * lengths.at(-1); |
| let i = 1; |
| while (i < lengths.length - 1 && lengths[i] < distance) i++; |
| const ratio = (distance - lengths[i - 1]) / (lengths[i] - lengths[i - 1] || 1), a = new Vector3(...points[i - 1]), b = new Vector3(...points[i]); |
| position = a.clone().lerp(b, ratio).toArray(); |
| let direction = t.orientation === "tangent" ? b.sub(a) : null; |
| if (t.orientation === "target") { |
| const target = targets.find((v) => v.id === t.targetId); |
| if (target) direction = new Vector3(...target.position).add(new Vector3(0, target.assetId ? 1.1 : 0, 0)).sub(new Vector3(...position)); |
| } |
| if (direction?.lengthSq() > 1e-8) { |
| direction.normalize(); |
| const yaw = Math.atan2(-direction.x, -direction.z), pitch = Math.asin(Math.max(-1, Math.min(1, direction.y))); |
| quaternion = new Quaternion().setFromEuler(new Euler(pitch, yaw, 0, "YXZ")).toArray(); |
| } |
| if (intensity !== void 0 && t.fadeOut > 0) intensity *= Math.max(0, Math.min(1, (t.delay + t.duration - time) / t.fadeOut)); |
| return { id: o.id, position, quaternion, rotation: new Euler().setFromQuaternion(new Quaternion(...quaternion), "YXZ").y, intensity }; |
| } |
| function lookAt(position, target, fallback) { |
| const d = new Vector3(...target.position).add(new Vector3(0, target.assetId ? 1.1 : 0, 0)).sub(new Vector3(...position)); |
| if (d.lengthSq() < 1e-8) return fallback; |
| d.normalize(); |
| return new Quaternion().setFromEuler(new Euler(Math.asin(Math.max(-1, Math.min(1, d.y))), Math.atan2(-d.x, -d.z), 0, "YXZ")).toArray(); |
| } |
| export { |
| applyCinema, |
| curvePoints, |
| editableControls, |
| groundCreateCommand, |
| isCamera, |
| isLight, |
| isRig, |
| newRig, |
| objectQuaternion, |
| rigFrame, |
| validateCinema |
| }; |
|
|
