feat(web): add scene image format authoring

web/protocol/animation-render-commands.ts

@@ -65,4 +65,7 @@ export const animationRenderCommands = Object.freeze({
   setSceneColorManagement(dataId: string, properties: AnimationCommand<"setSceneColorManagement">["properties"]): AnimationCommand<"setSceneColorManagement"> {
     return { type: "setSceneColorManagement", dataId, properties: { ...properties } };
   },
+  setSceneImageFormat(dataId: string, properties: AnimationCommand<"setSceneImageFormat">["properties"]): AnimationCommand<"setSceneImageFormat"> {
+    return { type: "setSceneImageFormat", dataId, properties: { ...properties } };
+  },
 } satisfies Record<string, (...args: never[]) => WebEngineEditCommand>);

web/protocol/scene-ir.ts

@@ -574,6 +574,7 @@ export interface SceneIR {
   viewLayers?: Array<{ name: string; useRender: boolean; useFreestyle: boolean; samples: number }>;
   borderSettings?: { enabled: boolean; minX: number; maxX: number; minY: number; maxY: number };
   simplifySettings?: { subsurfViewport: number; subsurfRender: number; particlesViewport: number; particlesRender: number; volumes: number };
+  imageFormatSettings?: { fileType: string; colorMode: number; depth: number; quality: number; compression: number; exrCodec: number };
   compositorGraph?: CompositorGraphIR;
   compositorStatus?: "AVAILABLE" | "BLOCKED";
   sequencerTimeline?: SequencerTimelineIR;
@@ -1609,6 +1610,11 @@ export function parseSceneSnapshotIR(value: unknown): SceneSnapshotIR {
       if (!isRecord(scene.simplifySettings)) throw new Error(`SceneIR.scenes[${index}].simplifySettings must be an object`);
       for (const field of ["subsurfViewport", "subsurfRender", "particlesViewport", "particlesRender", "volumes"] as const) requireNumber(scene.simplifySettings[field], `scenes[${index}].simplifySettings.${field}`);
     }
+    if (scene.imageFormatSettings !== undefined) {
+      if (!isRecord(scene.imageFormatSettings)) throw new Error(`SceneIR.scenes[${index}].imageFormatSettings must be an object`);
+      requireString(scene.imageFormatSettings.fileType, `scenes[${index}].imageFormatSettings.fileType`);
+      for (const field of ["colorMode", "depth", "quality", "compression", "exrCodec"] as const) requireNumber(scene.imageFormatSettings[field], `scenes[${index}].imageFormatSettings.${field}`);
+    }
     if (scene.compositorStatus !== undefined && !["AVAILABLE", "BLOCKED"].includes(scene.compositorStatus as string)) {
       throw new Error(`scenes[${index}].compositorStatus is invalid`);
     }

web/protocol/web-engine-capabilities.ts

@@ -91,6 +91,7 @@ export const WEB_ENGINE_COMMAND_CAPABILITIES = {
   setSceneBorderSettings: { family: "CORE_SCENE_GRAPH", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },
   setSceneSimplifySettings: { family: "CORE_SCENE_GRAPH", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },
   setSceneColorManagement: { family: "CORE_SCENE_GRAPH", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },
+  setSceneImageFormat: { family: "CORE_SCENE_GRAPH", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },
   setMetaballElements: { family: "GEOMETRY", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },
   sculptStroke: { family: "SCULPT", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },
   setSculptMeshAttributes: { family: "SCULPT", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },

web/protocol/web-engine.ts

@@ -155,6 +155,7 @@ export type WebEngineEditCommand =
   | { type: "setSceneBorderSettings"; dataId: string; properties: { enabled?: boolean; minX?: number; maxX?: number; minY?: number; maxY?: number } }
   | { type: "setSceneSimplifySettings"; dataId: string; properties: { subsurfViewport?: number; subsurfRender?: number; particlesViewport?: number; particlesRender?: number; volumes?: number } }
   | { type: "setSceneColorManagement"; dataId: string; properties: { displayDevice?: string; temperature?: number; tint?: number } }
+  | { type: "setSceneImageFormat"; dataId: string; properties: { fileType?: "PNG" | "JPEG" | "OPEN_EXR" | "TIFF" | "WEBP"; colorMode?: number; depth?: number; quality?: number; compression?: number; exrCodec?: number } }
   | { type: "setMetaballElements"; dataId: string; elements: Array<{ type: number; position: [number, number, number]; radius: number; scale: [number, number, number] }> }
   | { type: "sculptStroke"; stroke: SculptStrokeIR }
   | { type: "setSculptMeshAttributes"; attributes: SculptMeshAttributesIR }

web/protocol/workbench-command-groups.ts

@@ -4,7 +4,7 @@ export const WORKBENCH_COMMAND_GROUPS = Object.freeze({
   OBJECT: ["createPrimitive", "duplicateObject", "deleteObject", "setObjectTransform", "setParent", "createCollection", "moveObjectToCollection", "renameId", "applyObjectTransform", "setObjectOrigin"],
   MESH: ["meshEdit", "translateMeshVertices", "createUVMap", "setActiveUVMap", "unwrapUV", "setVertexColors", "setVertexWeights"],
   ANIMATION: ["setFrame", "insertObjectKeyframe", "deleteObjectKeyframe", "setFCurveInterpolation", "setConstraint", "setNLAStack"],
-  RENDER: ["setCameraProperties", "setLightProperties", "setWorldProperties", "setSceneProperties", "setSceneRenderSettings", "setSceneAudioSettings", "setSceneUnitSettings", "setSceneTimelineSettings", "setScenePipelineSettings", "setSceneBindings", "setSceneViewLayerSettings", "setSceneCollectionSettings", "setSceneBorderSettings", "setSceneSimplifySettings", "setSceneColorManagement"],
+  RENDER: ["setCameraProperties", "setLightProperties", "setWorldProperties", "setSceneProperties", "setSceneRenderSettings", "setSceneAudioSettings", "setSceneUnitSettings", "setSceneTimelineSettings", "setScenePipelineSettings", "setSceneBindings", "setSceneViewLayerSettings", "setSceneCollectionSettings", "setSceneBorderSettings", "setSceneSimplifySettings", "setSceneColorManagement", "setSceneImageFormat"],
   IO: ["importImage", "importVFont", "setMaterialImageNode"],
 } as const satisfies Record<string, readonly WebEngineCommandType[]>);