feat(web): extend scene render audio and unit authoring

web/app/src/app/App.tsx

@@ -722,6 +722,7 @@ function Properties({ snapshot, selectedFaceIndices, selectedVertexIndices, grea
   const activeCamera = snapshot?.cameras.find((camera) => camera.id === activeNode?.dataId);
   const activeLight = snapshot?.lights.find((light) => light.id === activeNode?.dataId);
   const activeWorld = snapshot?.worlds.find((world) => world.id === activeNode?.dataId);
+  const activeScene = snapshot?.scenes.find((scene) => scene.id === snapshot.sceneId) ?? snapshot?.scenes[0];
   const packedImages = snapshot?.images.filter((image) => image.packed && image.assetId) ?? [];
   useEffect(() => {
     if (!activeMaterial) return;
@@ -938,6 +939,10 @@ function Properties({ snapshot, selectedFaceIndices, selectedVertexIndices, grea
       {activeCamera ? <div className="property-section" data-testid="camera-workbench"><h3>Camera</h3><output>{activeCamera.projection} · {activeCamera.lensMm.toFixed(1)}mm</output><button type="button" onClick={() => onCommand(animationRenderCommands.setCameraProperties(activeCamera.id, { projection: activeCamera.projection === "ORTHOGRAPHIC" ? "PERSPECTIVE" : "ORTHOGRAPHIC" }))}>切换投影</button><button type="button" onClick={() => onCommand(animationRenderCommands.setCameraProperties(activeCamera.id, { lensMm: Math.min(10000, activeCamera.lensMm + 5) }))}>增加焦距</button></div> : null}
       {activeLight ? <div className="property-section" data-testid="light-workbench"><h3>Light</h3><output>{activeLight.energy.toFixed(1)} energy</output><button type="button" onClick={() => onCommand(animationRenderCommands.setLightProperties(activeLight.id, { energy: Math.min(1e9, activeLight.energy + 10) }))}>增加能量</button><button type="button" onClick={() => onCommand(animationRenderCommands.setLightProperties(activeLight.id, { castsShadow: !(activeLight.castsShadow ?? true) }))}>切换阴影</button></div> : null}
       {activeWorld ? <div className="property-section" data-testid="world-workbench"><h3>World</h3><output>Exposure {activeWorld.exposure.toFixed(2)}</output><button type="button" onClick={() => onCommand(animationRenderCommands.setWorldProperties(activeWorld.id, { exposure: Math.max(-20, Math.min(20, activeWorld.exposure + 0.5)) }))}>增加曝光</button></div> : null}
+      {activeScene ? <div className="property-section" data-testid="scene-properties-workbench"><h3>Scene Render</h3><output>{activeScene.name} · {activeScene.renderEngine ?? "UNKNOWN"}</output><output>{activeScene.colorManagement ? `${activeScene.colorManagement.viewTransform} · ${activeScene.colorManagement.look} · Exposure ${activeScene.colorManagement.exposure.toFixed(2)} · Gamma ${activeScene.colorManagement.gamma.toFixed(2)}` : "Color management unavailable"}</output><div className="property-actions"><button type="button" onClick={() => onCommand(animationRenderCommands.setSceneProperties(activeScene.id, { exposure: Math.max(-1000, Math.min(1000, (activeScene.colorManagement?.exposure ?? 0) + 0.5)) }))}>增加曝光</button><button type="button" onClick={() => onCommand(animationRenderCommands.setSceneProperties(activeScene.id, { gamma: Math.max(0, Math.min(1000, (activeScene.colorManagement?.gamma ?? 1) + 0.1)) }))}>增加 Gamma</button><button type="button" onClick={() => onCommand(animationRenderCommands.setSceneProperties(activeScene.id, { viewTransform: activeScene.colorManagement?.viewTransform === "AgX" ? "Standard" : "AgX" }))}>切换 View Transform</button></div></div> : null}
+      {activeScene?.renderSettings ? <div className="property-section" data-testid="scene-render-settings-workbench"><h3>Render Output</h3><output>{activeScene.renderSettings.resolutionX} × {activeScene.renderSettings.resolutionY} @ {activeScene.renderSettings.resolutionPercentage}%</output><output>Frames {activeScene.renderSettings.frameStart} - {activeScene.renderSettings.frameEnd} · {activeScene.renderSettings.outputPath}</output><div className="property-actions"><button type="button" onClick={() => onCommand(animationRenderCommands.setSceneRenderSettings(activeScene.id, { resolutionX: Math.min(65536, activeScene.renderSettings!.resolutionX + 64), resolutionY: Math.min(65536, activeScene.renderSettings!.resolutionY + 64) }))}>增加分辨率</button><button type="button" onClick={() => onCommand(animationRenderCommands.setSceneRenderSettings(activeScene.id, { resolutionPercentage: Math.min(1000, activeScene.renderSettings!.resolutionPercentage + 10) }))}>增加百分比</button><button type="button" onClick={() => onCommand(animationRenderCommands.setSceneRenderSettings(activeScene.id, { frameEnd: Math.min(1000000, activeScene.renderSettings!.frameEnd + 1) }))}>延长帧范围</button></div></div> : null}
+      {activeScene?.audioSettings ? <div className="property-section" data-testid="scene-audio-settings-workbench"><h3>Scene Audio</h3><output>Volume {activeScene.audioSettings.volume.toFixed(2)} · Speed {activeScene.audioSettings.speedOfSound.toFixed(1)} · Doppler {activeScene.audioSettings.dopplerFactor.toFixed(2)}</output><output>Distance model {activeScene.audioSettings.distanceModel} · {activeScene.audioSettings.muted ? "Muted" : "Audible"} · {activeScene.audioSettings.sync ? "Synced" : "Free"}</output><div className="property-actions"><button type="button" onClick={() => onCommand(animationRenderCommands.setSceneAudioSettings(activeScene.id, { volume: Math.min(10, activeScene.audioSettings!.volume + 0.1) }))}>增加音量</button><button type="button" onClick={() => onCommand(animationRenderCommands.setSceneAudioSettings(activeScene.id, { muted: !activeScene.audioSettings!.muted }))}>{activeScene.audioSettings.muted ? "取消静音" : "静音"}</button><button type="button" onClick={() => onCommand(animationRenderCommands.setSceneAudioSettings(activeScene.id, { sync: !activeScene.audioSettings!.sync }))}>切换同步</button></div></div> : null}
+      {activeScene?.unitSettings ? <div className="property-section" data-testid="scene-unit-settings-workbench"><h3>Scene Units</h3><output>System {activeScene.unitSettings.system} · Scale {activeScene.unitSettings.scaleLength.toFixed(4)} · Rotation {activeScene.unitSettings.rotationSystem}</output><output>Length {activeScene.unitSettings.lengthUnit} · Mass {activeScene.unitSettings.massUnit} · Time {activeScene.unitSettings.timeUnit}</output><div className="property-actions"><button type="button" onClick={() => onCommand(animationRenderCommands.setSceneUnitSettings(activeScene.id, { system: activeScene.unitSettings!.system === 1 ? 2 : 1 }))}>切换单位系统</button><button type="button" onClick={() => onCommand(animationRenderCommands.setSceneUnitSettings(activeScene.id, { scaleLength: Math.min(1000000, Math.max(0.000001, activeScene.unitSettings!.scaleLength || 1) * 1.1) }))}>调整单位缩放</button><button type="button" onClick={() => onCommand(animationRenderCommands.setSceneUnitSettings(activeScene.id, { rotationSystem: activeScene.unitSettings!.rotationSystem === 2 ? 0 : 2 }))}>切换旋转单位</button></div></div> : null}
       {activeFont ? <div className="property-section" data-testid="font-workbench"><h3>Font</h3><label>Text <textarea aria-label="Font body" value={fontBody} maxLength={65536} onChange={(event) => setFontBody(event.target.value)} /></label><div className="property-actions"><button type="button" disabled={fontBody === activeFont.text} onClick={() => onCommand(nonMeshGeometryCommands.setFontBody(activeFont.id, fontBody))}>Apply Text</button>{activeFont.fontProperties ? <button type="button" onClick={() => onCommand(nonMeshGeometryCommands.setFontProperties(activeFont.id, { extrude: Math.min(1000, activeFont.fontProperties!.extrude + 0.01) }))}>Increase Extrude</button> : null}</div><output>{activeFont.text?.length ?? 0} characters</output></div> : null}
       {activeVolume ? <div className="property-section" data-testid="volume-workbench"><h3>Volume</h3><output>{activeVolume.sourcePath ?? "No source path"}</output><output>{activeVolume.volumeGrids?.length ?? 0} grids</output>{activeVolume.volumeProperties ? <><output>Density {activeVolume.volumeProperties.displayDensity.toFixed(3)} · Step {activeVolume.volumeProperties.stepSize.toFixed(4)}</output><div className="property-actions"><button type="button" onClick={() => onCommand(nonMeshGeometryCommands.setVolumeProperties(activeVolume.id, activeVolume.sourcePath ?? "", Math.min(1e6, activeVolume.volumeProperties!.displayDensity + 0.1), activeVolume.volumeProperties!.interpolation, activeVolume.volumeProperties!.stepSize))}>Increase Density</button><button type="button" onClick={() => onCommand(nonMeshGeometryCommands.setVolumeProperties(activeVolume.id, activeVolume.sourcePath ?? "", activeVolume.volumeProperties!.displayDensity, activeVolume.volumeProperties!.interpolation === "LINEAR" ? "NEAREST" : "LINEAR", activeVolume.volumeProperties!.stepSize))}>Toggle Interpolation</button></div></> : <output>Volume properties unavailable</output>}</div> : null}
       {activeMetaball ? <div className="property-section" data-testid="metaball-workbench"><h3>Metaball</h3><output>{activeMetaball.elements?.length ?? 0} elements</output>{activeMetaball.elements?.length ? <div className="property-actions"><button type="button" onClick={() => onCommand(nonMeshGeometryCommands.setMetaballElements(activeMetaball.id, activeMetaball.elements!.map((element, index) => index === 0 ? { ...element, radius: Math.min(100000, element.radius + 0.05) } : element)))}>Increase Active Radius</button></div> : <output>No editable elements</output>}</div> : null}

web/app/src/workers/web-engine.worker.ts

@@ -597,6 +597,54 @@ function assertFutureCapability(payload: Extract<WebEngineRequest["command"], {
       }
       return;
     }
+    case "setSceneProperties": {
+      const scene = currentSnapshot?.scenes.find((candidate) => candidate.id === payload.dataId);
+      const properties = payload.properties;
+      if (!scene || !validPropertyKeys(properties, ["renderEngine", "viewTransform", "look", "exposure", "gamma"])) throw report("RENDER_PROPERTY_INVALID", "Scene target or properties are invalid");
+      for (const field of ["renderEngine", "viewTransform", "look"] as const) {
+        const value = properties[field];
+        if (value !== undefined && (typeof value !== "string" || value.length === 0 || new TextEncoder().encode(value).byteLength > 63)) throw report("RENDER_PROPERTY_INVALID", `Scene ${field} is not a bounded string`);
+      }
+      for (const [field, minimum, maximum] of [["exposure", -1000, 1000], ["gamma", 0, 1000]] as const) {
+        const value = properties[field];
+        if (value !== undefined && !boundedNumber(value, minimum, maximum)) throw report("RENDER_PROPERTY_INVALID", `Scene ${field} is outside the bounded range`);
+      }
+      return;
+    }
+    case "setSceneRenderSettings": {
+      const scene = currentSnapshot?.scenes.find((candidate) => candidate.id === payload.dataId);
+      const properties = payload.properties;
+      if (!scene || !validPropertyKeys(properties, ["resolutionX", "resolutionY", "resolutionPercentage", "frameStart", "frameEnd", "outputPath"])) throw report("RENDER_PROPERTY_INVALID", "Scene render target or properties are invalid");
+      for (const [field, minimum, maximum] of [["resolutionX", 1, 65536], ["resolutionY", 1, 65536], ["resolutionPercentage", 1, 1000], ["frameStart", -1000000, 1000000], ["frameEnd", -1000000, 1000000]] as const) {
+        const value = properties[field];
+        if (value !== undefined && (!Number.isSafeInteger(value) || value < minimum || value > maximum)) throw report("RENDER_PROPERTY_INVALID", `Scene ${field} is outside the bounded integer range`);
+      }
+      if (properties.frameStart !== undefined && properties.frameEnd !== undefined && properties.frameEnd < properties.frameStart) throw report("RENDER_PROPERTY_INVALID", "Scene frameEnd must not precede frameStart");
+      if (properties.outputPath !== undefined && (typeof properties.outputPath !== "string" || properties.outputPath.length === 0 || new TextEncoder().encode(properties.outputPath).byteLength > 1023)) throw report("RENDER_PROPERTY_INVALID", "Scene outputPath is not a bounded path");
+      return;
+    }
+    case "setSceneAudioSettings": {
+      const scene = currentSnapshot?.scenes.find((candidate) => candidate.id === payload.dataId);
+      const properties = payload.properties;
+      if (!scene || !validPropertyKeys(properties, ["volume", "speedOfSound", "dopplerFactor", "distanceModel", "muted", "sync"])) throw report("RENDER_PROPERTY_INVALID", "Scene audio target or properties are invalid");
+      for (const [field, minimum, maximum] of [["volume", 0, 10], ["speedOfSound", 0, 10000], ["dopplerFactor", 0, 100], ["distanceModel", 0, 32]] as const) {
+        const value = properties[field];
+        if (value !== undefined && !boundedNumber(value, minimum, maximum)) throw report("RENDER_PROPERTY_INVALID", `Scene ${field} is outside the bounded range`);
+      }
+      for (const field of ["muted", "sync"] as const) if (properties[field] !== undefined && typeof properties[field] !== "boolean") throw report("RENDER_PROPERTY_INVALID", `Scene ${field} must be boolean`);
+      return;
+    }
+    case "setSceneUnitSettings": {
+      const scene = currentSnapshot?.scenes.find((candidate) => candidate.id === payload.dataId);
+      const properties = payload.properties;
+      if (!scene || !validPropertyKeys(properties, ["system", "scaleLength", "rotationSystem", "lengthUnit", "massUnit", "timeUnit", "temperatureUnit"])) throw report("RENDER_PROPERTY_INVALID", "Scene unit target or properties are invalid");
+      for (const [field, minimum, maximum] of [["system", 0, 8], ["rotationSystem", 0, 8], ["lengthUnit", 0, 32], ["massUnit", 0, 32], ["timeUnit", 0, 32], ["temperatureUnit", 0, 32]] as const) {
+        const value = properties[field];
+        if (value !== undefined && (!Number.isSafeInteger(value) || value < minimum || value > maximum)) throw report("RENDER_PROPERTY_INVALID", `Scene ${field} is outside the bounded unit enum`);
+      }
+      if (properties.scaleLength !== undefined && !boundedNumber(properties.scaleLength, 0, 1_000_000)) throw report("RENDER_PROPERTY_INVALID", "Scene scaleLength is outside the bounded range");
+      return;
+    }
     case "setGeometryNodeGraph": {
       const snapshot = currentSnapshot;
       const availableResourceIds = new Set([