@osmo.inc/cli-linux-arm64 0.1.23 → 0.1.25

package/runtime/packages/scene/src/metadata.mjs

@@ -18,17 +18,17 @@ export function readGroupPlayback(props) {
 }
 
 /** Optional lane metadata indexed by the same 0–99 numbers as clip.track.
- * @param {unknown} value @returns {Record<number, {label?: string, hidden?: boolean, solo?: boolean, muted?: boolean}>} */
+ * @param {unknown} value @returns {Record<number, {label?: string, hidden?: boolean, solo?: boolean, muted?: boolean, motionBlur?: boolean}>} */
 export function readSceneTracks(value) {
   if (value === undefined) return {};
   if (!value || typeof value !== 'object' || Array.isArray(value))
     throw new Error('Scene.tracks: expected an object keyed by track numbers (0–99)');
   return Object.fromEntries(Object.entries(value).map(([key, metadata]) => {
     if (!/^(?:0|[1-9]\d?)$/.test(key)) throw new Error('Scene.tracks: track numbers must be integers from 0 to 99');
-    if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata) || Object.keys(metadata).some(key => !['label','hidden','solo','muted'].includes(key)))
-      throw new Error(`Scene.tracks.${key}: expected label, hidden, solo or muted metadata`);
+    if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata) || Object.keys(metadata).some(key => !['label','hidden','solo','muted','motionBlur'].includes(key)))
+      throw new Error(`Scene.tracks.${key}: expected label, hidden, solo, muted or motionBlur metadata`);
     const label = readLabel(metadata.label, 1, `Scene.tracks.${key}.label`);
-    for (const field of ['hidden','solo','muted'])
+    for (const field of ['hidden','solo','muted','motionBlur'])
       if (metadata[field] !== undefined && typeof metadata[field] !== 'boolean')
         throw new Error(`Scene.tracks.${key}.${field}: expected a static boolean`);
     return [key, {...metadata, ...(label === undefined ? {} : {label})}];

package/runtime/packages/scene/src/motion-blur.ts

@@ -0,0 +1,30 @@
+/** Composition-wide temporal supersampling. Angles are fractions of one frame. */
+export interface MotionBlurSettings {
+  shutterAngle?: number;
+  shutterPhase?: number;
+  samples?: number;
+}
+export interface ResolvedMotionBlur { shutterAngle: number; shutterPhase: number; samples: number }
+export function resolveMotionBlur(value: unknown): ResolvedMotionBlur | undefined {
+  if (value === undefined || value === false) return;
+  if (value !== true && (!value || typeof value !== 'object' || Array.isArray(value)))
+    throw new Error('Scene.motionBlur must be a boolean or shutter settings');
+  const settings = (value === true ? {} : value) as Record<string, unknown>;
+  for (const key of Object.keys(settings)) if (!['shutterAngle','shutterPhase','samples'].includes(key))
+    throw new Error(`Unknown motionBlur setting: ${key}`);
+  const shutterAngle = settings.shutterAngle ?? 180;
+  const shutterPhase = settings.shutterPhase ?? -(shutterAngle as number) / 2;
+  const samples = settings.samples ?? 16;
+  if (typeof shutterAngle !== 'number' || !Number.isFinite(shutterAngle) || shutterAngle < 0 || shutterAngle > 720)
+    throw new Error('motionBlur.shutterAngle must be between 0 and 720 degrees');
+  if (typeof shutterPhase !== 'number' || !Number.isFinite(shutterPhase) || shutterPhase < -720 || shutterPhase > 720)
+    throw new Error('motionBlur.shutterPhase must be between -720 and 720 degrees');
+  if (typeof samples !== 'number' || !Number.isInteger(samples) || samples < 2 || samples > 64)
+    throw new Error('motionBlur.samples must be an integer between 2 and 64');
+  return shutterAngle === 0 ? undefined : {shutterAngle, shutterPhase, samples};
+}
+/** Midpoint quadrature; endpoints hold the first/last valid frame, never wrap. */
+export function shutterFrames(frame: number, totalFrames: number, settings: ResolvedMotionBlur): number[] {
+  return Array.from({length: settings.samples}, (_, i) => Math.max(0, Math.min(totalFrames - 1,
+    frame + settings.shutterPhase / 360 + (i + 0.5) / settings.samples * settings.shutterAngle / 360)));
+}

package/src/starter/scene.tsx

@@ -14,7 +14,7 @@ const grade = defineEffect({
   },
 });
 
-export default <Scene width={1920} height={1080} duration={2.7666666666666666} fps={60} background="#f1ede4"
+export default <Scene stacking="tracks" width={1920} height={1080} duration={2.7666666666666666} fps={60} background="#f1ede4"
   effects={[grade({}), grain({ amount: 0.055 })]}>
   <Group id="osmo-brand" track={0} label="Osmo intro">
     <Logo />