Release 1.6.6

Author: Sportinger

docs/Features/3D-Layers.md

@@ -55,6 +55,7 @@ Prepared splat runtime metadata, native splat rasterization, preview, nested com
 - glTF / GLB base color textures are loaded from data URIs, external image URIs, or embedded bufferViews when `baseColorTexture` and `TEXCOORD_0` are present.
 - Textured glTF / GLB materials render unlit in the native pass, matching scan/photogrammetry assets better than the simple fallback directional light.
 - GLB sequences normalize every frame against the first renderable frame's bounds and preload nearby playback frames, avoiding per-frame center/scale jumps and visible current-frame loading flicker.
+- GLB sequences imported into an open project are copied to `Raw/<sequence-name>/` using the original frame names; existing same-size frame files are reused instead of written again.
 - Untextured models use ambient plus directional fallback lighting.
 - The Transform panel exposes a wireframe debug toggle for model clips.
 - Imported models use a native runtime/cache path.
@@ -117,6 +118,7 @@ Gaussian splat clips are imported through the SuperSplat-compatible `@playcanvas
 - Gaussian splats participate in scene cameras, object transforms, object-level effectors, preview, nested compositions, export, preload, and readiness checks through the same native shared-scene path.
 - Realtime splat rendering uses a worker-backed back-to-front order buffer based on the SuperSplat/PlayCanvas sorter approach. Precise export can still fall back to the existing GPU sort path.
 - Sequence splats follow the same shared runtime contract and preload nearby frames without replacing foreground playback with repeated loading overlays.
+- PLY/splat sequences imported into an open project are copied to `Raw/<sequence-name>/` using the original frame names; existing same-size frame files are reused instead of written again.
 - Imported splats and numbered splat sequences store media-panel stats: container label, file size, per-frame splat count, and total sequence splat count.
 - The Transform tab now exposes normal object transforms for gaussian splats. Scene navigation lives on camera clips.
 - Large gaussian splats show viewport loading progress during project restore, URL fetch, parser work, normalization, and GPU upload.

docs/Features/Project-Persistence.md

@@ -98,6 +98,12 @@ MyProject/
 +-- Raw/                   # Auto-copied media files (portable)
 |   +-- Interview_01.mp4
 |   +-- Music.wav
+|   +-- hero/              # Imported GLB sequence frames
+|   |   +-- hero000000.glb
+|   |   +-- hero000001.glb
+|   +-- scan/              # Imported PLY/splat sequence frames
+|   |   +-- scan000000.ply
+|   |   +-- scan000001.ply
 +-- Downloads/             # Downloaded videos (platform subfolders)
 |   +-- YT/
 |   |   +-- video_title.mp4
@@ -141,6 +147,8 @@ const PROJECT_FOLDERS = {
 ### Auto-Copy to Raw Folder
 When importing media files (controlled by `copyMediaToProject` setting):
 - Files are **copied** to the project's `Raw/` folder
+- Numbered `.glb`, `.ply`, and `.splat` sequences are copied whenever a project is open, even when global auto-copy is off, so sequence frames survive reloads and project moves
+- Sequence frames are stored under `Raw/<sequence-name>/` with their original frame filenames
 - Original files remain untouched at their source location
 - If a file with the same name and size already exists, reuses the existing copy
 - If a file with the same name but different size exists, adds a numeric suffix
@@ -327,7 +335,7 @@ interface ProjectFile {
 - Composition view state per composition (playhead, zoom, scroll, in/out points)
 - Media panel column order and name width
 - Transcript language preference
-- Global MIDI state: enabled flag, transport bindings (`Play / Pause`, `Stop`), parameter mappings, mapping ranges, and invert flags
+- Global MIDI state: enabled flag, transport bindings (`Play / Pause`, `Stop`), parameter mappings, mapping ranges, invert flags, and damping flags
 - View toggles: thumbnails, waveforms, proxy, transcript markers
 - Changelog preferences (`showChangelogOnStartup`, `lastSeenChangelogVersion`)
 - Export panel state: live export settings, named export presets, and the selected preset

docs/Features/UI-Panels.md

@@ -183,8 +183,9 @@ MasterSelects currently exposes 17 dockable panel types, plus the Slot Grid over
 - Includes global transport bindings, per-marker bindings, Slot Grid trigger bindings, and property parameter bindings
 - Each row shows the note, target, and resulting command behavior
 - Click any transport, marker, or slot mapping card to trigger the assigned action and preview what the MIDI note does
+- Mappings flash live while matching MIDI input is currently driving them
 - `Edit` opens inline controls for manual channel/note changes and marker reassignment
-- Parameter mappings expose inline `Min` / `Max` range inputs plus an `Invert` toggle
+- Parameter mappings expose inline `Min` / `Max` range inputs, an `Invert` toggle, and a `Damp` checkbox for smoothed value changes
 - `Learn` and `Clear` remain available directly from the panel
 - Marker bindings support `Jump To Marker`, `Play From Marker`, and `Jump To Marker And Stop`
 - Slot bindings can be created from the Slot Grid filled-slot context menu, which opens this panel with a pending `Listening...` mapping
@@ -426,7 +427,8 @@ MIDI Control (N devices)
 - `View -> Panels -> MIDI Mapping` opens the dedicated mapping panel
 - The panel lists all assigned transport, marker, slot, and parameter bindings
 - Clicking a binding previews the exact trigger path without needing a physical MIDI note
-- Parameter bindings can be range-adjusted and inverted directly in the mapping panel
+- Matching mappings flash in the panel when the hardware input is used
+- Parameter bindings can be range-adjusted, inverted, and damped directly in the mapping panel
 - Empty-state guidance points back to Settings and the marker right-click menu
 - Right-click a numeric parameter name in the Properties panel to open its MIDI menu and learn or clear a MIDI note/CC binding. Right-clicking the numeric value itself still resets the value to its default. Learned CC values map across the parameter's configured range and then use the same edit path as manual changes.
 

src/changelog-data.json

@@ -1,4 +1,25 @@
 [
+  {
+    "date": "2026-04-30",
+    "type": "fix",
+    "title": "3D Sequence Playback and Scrubbing Stay Responsive",
+    "description": "GLB frame sequences now throttle realtime model loading and hold the last renderable frame while the next asset prepares. PLY splat scrubbing keeps requesting the dragged target frame in the background instead of freezing on held frames.",
+    "section": "3D / Native Scene"
+  },
+  {
+    "date": "2026-04-30",
+    "type": "improve",
+    "title": "Sequence Imports Keep Project Raw Folders Tidy",
+    "description": "PLY and GLB frame sequences copied into project storage now land in stable Raw subfolders and skip duplicate copies when matching files are already present.",
+    "section": "Project Persistence"
+  },
+  {
+    "date": "2026-04-30",
+    "type": "improve",
+    "title": "MIDI Mapping Controls Gain Broader Command Coverage",
+    "description": "MIDI mappings now carry richer command metadata, range handling, and panel summaries so live-control setups are easier to inspect and restore.",
+    "section": "MIDI"
+  },
   {
     "date": "2026-04-27",
     "type": "new",

src/components/panels/MIDIMappingPanel.css

@@ -106,6 +106,14 @@
     0 0 20px color-mix(in srgb, var(--accent) 12%, transparent);
 }
 
+.midi-mapping-card.is-active {
+  border-color: color-mix(in srgb, var(--success-light) 70%, var(--border-color));
+  background: color-mix(in srgb, var(--success-light) 10%, var(--bg-tertiary));
+  box-shadow:
+    0 0 0 1px color-mix(in srgb, var(--success-light) 38%, transparent),
+    0 0 18px color-mix(in srgb, var(--success-light) 16%, transparent);
+}
+
 .midi-mapping-card.is-learning {
   border-color: color-mix(in srgb, var(--accent) 60%, var(--border-color));
   background: color-mix(in srgb, var(--accent-subtle) 45%, var(--bg-tertiary));
@@ -190,7 +198,7 @@
   padding-top: var(--sp-2);
   border-top: 1px solid var(--border-color);
   display: grid;
-  grid-template-columns: minmax(80px, 1fr) minmax(80px, 1fr) auto;
+  grid-template-columns: minmax(80px, 1fr) minmax(80px, 1fr) auto auto;
   align-items: end;
   gap: var(--sp-2);
 }
@@ -212,6 +220,29 @@
   color: var(--accent);
 }
 
+.midi-mapping-checkbox {
+  min-height: 30px;
+  display: inline-flex;
+  align-items: center;
+  gap: var(--sp-1);
+  color: var(--text-secondary);
+  font-size: var(--font-xs);
+  white-space: nowrap;
+}
+
+.midi-mapping-checkbox input {
+  width: 14px;
+  height: 14px;
+  accent-color: var(--accent);
+}
+
+.midi-mapping-checkbox span {
+  color: inherit;
+  font-size: inherit;
+  text-transform: none;
+  letter-spacing: 0;
+}
+
 .midi-mapping-editor {
   margin-top: var(--sp-2);
   padding-top: var(--sp-2);

src/components/panels/MIDIMappingPanel.tsx

@@ -122,6 +122,7 @@ export function MIDIMappingPanel() {
     cancelLearning,
     slotBindings,
     parameterBindings,
+    activeMappingIds,
   } = useMIDI();
   const markers = useTimelineStore((state) => state.markers);
   const compositions = useMediaStore((state) => state.compositions);
@@ -334,6 +335,10 @@ export function MIDIMappingPanel() {
     updateParameterMIDIBinding(binding.id, { invert: !binding.invert });
   };
 
+  const toggleParameterDamping = (binding: MIDIParameterBinding) => {
+    updateParameterMIDIBinding(binding.id, { damping: !binding.damping });
+  };
+
   const clearMapping = (mapping: MIDIMappingSummaryEntry) => {
     if (mapping.scope === 'transport') {
       setTransportMIDIBinding(mapping.action as MIDITransportAction, null);
@@ -528,6 +533,7 @@ export function MIDIMappingPanel() {
           {mappings.map((mapping) => {
             const isEditing = draft?.mappingId === mapping.id;
             const isParameterMapping = mapping.scope === 'parameter';
+            const isActiveMapping = activeMappingIds[mapping.id] !== undefined;
             const channelValue = isEditing ? draft.channel : String(mapping.binding.channel);
             const noteValue = isEditing && !isParameterMapping
               ? draft.note
@@ -572,7 +578,7 @@ export function MIDIMappingPanel() {
             return (
               <div
                 key={mapping.id}
-                className={`midi-mapping-card${isPreviewable && !isEditing ? ' is-clickable' : ''}${previewingMappingId === mapping.id ? ' is-previewing' : ''}`}
+                className={`midi-mapping-card${isPreviewable && !isEditing ? ' is-clickable' : ''}${previewingMappingId === mapping.id ? ' is-previewing' : ''}${isActiveMapping ? ' is-active' : ''}`}
                 role={isPreviewable && !isEditing ? 'button' : undefined}
                 tabIndex={isPreviewable && !isEditing ? 0 : undefined}
                 onClick={isPreviewable && !isEditing ? () => previewMapping(mapping) : undefined}
@@ -652,6 +658,17 @@ export function MIDIMappingPanel() {
                     >
                       Invert
                     </button>
+                    <label
+                      className="midi-mapping-checkbox"
+                      title="Smooth MIDI parameter changes"
+                    >
+                      <input
+                        type="checkbox"
+                        checked={!!mapping.parameterBinding.damping}
+                        onChange={() => toggleParameterDamping(mapping.parameterBinding!)}
+                      />
+                      <span>Damp</span>
+                    </label>
                   </div>
                 )}
 

src/engine/WebGPUEngine.ts

@@ -2,6 +2,7 @@
 // Orchestrates: PerformanceStats, RenderTargetManager, OutputWindowManager,
 //               RenderLoop, LayerCollector, Compositor, NestedCompRenderer
 
+import type { ModelSequenceData } from '../types';
 import type { Layer, EngineStats } from './core/types';
 // OutputWindow type no longer needed — state lives in renderTargetStore
 import { WebGPUContext, type GPUPowerPreference } from './core/WebGPUContext';
@@ -661,6 +662,8 @@ export class WebGPUEngine {
     url?: string;
     fileName: string;
     file?: File;
+    showProgress?: boolean;
+    maxSplats?: number;
   }): Promise<boolean> {
     return this.renderDispatcher?.ensureGaussianSplatSceneLoaded(options) ?? false;
   }
@@ -669,8 +672,8 @@ export class WebGPUEngine {
     return this.renderDispatcher?.ensureSceneRendererInitialized(width, height) ?? false;
   }
 
-  async preloadSceneModelAsset(url: string, fileName: string): Promise<boolean> {
-    return this.renderDispatcher?.preloadSceneModelAsset(url, fileName) ?? false;
+  async preloadSceneModelAsset(url: string, fileName: string, modelSequence?: ModelSequenceData): Promise<boolean> {
+    return this.renderDispatcher?.preloadSceneModelAsset(url, fileName, modelSequence) ?? false;
   }
 
   async ensureExportLayersReady(layers: Layer[]): Promise<void> {

src/engine/export/preloadGaussianSplats.ts

@@ -148,6 +148,7 @@ export async function preloadGaussianSplatsForExport(options: PreloadOptions): P
           url,
           fileName,
           file,
+          showProgress: false,
         }),
       ),
   );
@@ -194,24 +195,37 @@ export async function preload3DAssetsForExport(options: Preload3DOptions): Promi
   const modelPreloads = [...new Map(
     clips
       .filter((clip) => clip.source?.type === 'model' && !!clip.source.modelUrl)
-      .map((clip) => [
-        clip.source!.modelUrl!,
-        {
-          clipId: clip.id,
-          modelUrl: clip.source!.modelUrl!,
-          fileName: clip.file?.name ?? clip.name,
-        },
-      ]),
+      .map((clip) => {
+        const mediaFileId = clip.mediaFileId ?? clip.source?.mediaFileId;
+        const mediaFile = mediaFileId
+          ? useMediaStore.getState().files.find((file) => file.id === mediaFileId) ?? null
+          : null;
+        const modelSequence = clip.source?.modelSequence ?? mediaFile?.modelSequence;
+        const preloadKey = modelSequence
+          ? `${clip.source!.modelUrl!}|sequence|${modelSequence.sequenceName ?? ''}|${modelSequence.frameCount}|${modelSequence.fps}`
+          : clip.source!.modelUrl!;
+        return [
+          preloadKey,
+          {
+            clipId: clip.id,
+            modelUrl: clip.source!.modelUrl!,
+            fileName: clip.file?.name ?? clip.name,
+            ...(modelSequence ? { modelSequence } : {}),
+          },
+        ] as const;
+      }),
   ).values()];
 
   if (modelPreloads.length === 0) {
     return;
   }
 
   const results = await Promise.allSettled(
-    modelPreloads.map((preload) =>
-      engine.preloadSceneModelAsset(preload.modelUrl, preload.fileName),
-    ),
+    modelPreloads.map((preload) => (
+      preload.modelSequence
+        ? engine.preloadSceneModelAsset(preload.modelUrl, preload.fileName, preload.modelSequence)
+        : engine.preloadSceneModelAsset(preload.modelUrl, preload.fileName)
+    )),
   );
   results.forEach((result, index) => {
     const clip = modelPreloads[index];