@gannochenko/staticstripes 0.0.22 → 0.0.24

package/src/sample-sequences.ts

@@ -36,8 +36,19 @@ export const getSampleSequences = (
           objectFitContainAmbientBrightness: -0.1,
           objectFitContainAmbientSaturation: 0.7,
           objectFitContainPillarboxColor: '#000000',
+          objectFitKenBurns: 'zoom-in' as const,
+          objectFitKenBurnsZoom: 30,
+          objectFitKenBurnsEffectDuration: 0,
+          objectFitKenBurnsEasing: 'linear' as const,
+          objectFitKenBurnsFocalX: 50,
+          objectFitKenBurnsFocalY: 50,
+          objectFitKenBurnsPanStartX: 0,
+          objectFitKenBurnsPanStartY: 0,
+          objectFitKenBurnsPanEndX: 100,
+          objectFitKenBurnsPanEndY: 100,
           chromakey: false,
           chromakeyBlend: 0.1,
+          sound: 'on' as const,
           chromakeySimilarity: 0.1,
           chromakeyColor: '#000000',
         },
@@ -59,8 +70,19 @@ export const getSampleSequences = (
           objectFitContainAmbientBrightness: -0.1,
           objectFitContainAmbientSaturation: 0.7,
           objectFitContainPillarboxColor: '#000000',
+          objectFitKenBurns: 'zoom-in' as const,
+          objectFitKenBurnsZoom: 30,
+          objectFitKenBurnsEffectDuration: 0,
+          objectFitKenBurnsEasing: 'linear' as const,
+          objectFitKenBurnsFocalX: 50,
+          objectFitKenBurnsFocalY: 50,
+          objectFitKenBurnsPanStartX: 0,
+          objectFitKenBurnsPanStartY: 0,
+          objectFitKenBurnsPanEndX: 100,
+          objectFitKenBurnsPanEndY: 100,
           chromakey: false,
           chromakeyBlend: 0.1,
+          sound: 'on' as const,
           chromakeySimilarity: 0.1,
           chromakeyColor: '#000000',
         },
@@ -82,10 +104,21 @@ export const getSampleSequences = (
           objectFitContainAmbientBrightness: -0.1,
           objectFitContainAmbientSaturation: 0.7,
           objectFitContainPillarboxColor: '#000000',
+          objectFitKenBurns: 'zoom-in' as const,
+          objectFitKenBurnsZoom: 30,
+          objectFitKenBurnsEffectDuration: 0,
+          objectFitKenBurnsEasing: 'linear' as const,
+          objectFitKenBurnsFocalX: 50,
+          objectFitKenBurnsFocalY: 50,
+          objectFitKenBurnsPanStartX: 0,
+          objectFitKenBurnsPanStartY: 0,
+          objectFitKenBurnsPanEndX: 100,
+          objectFitKenBurnsPanEndY: 100,
           chromakey: true,
           chromakeyBlend: 0.1,
           chromakeySimilarity: 0.1,
           chromakeyColor: '#000000',
+          sound: 'on' as const,
         },
         {
           id: 'f_04',
@@ -105,8 +138,19 @@ export const getSampleSequences = (
           objectFitContainAmbientBrightness: -0.1,
           objectFitContainAmbientSaturation: 0.7,
           objectFitContainPillarboxColor: '#000000',
+          objectFitKenBurns: 'zoom-in' as const,
+          objectFitKenBurnsZoom: 30,
+          objectFitKenBurnsEffectDuration: 0,
+          objectFitKenBurnsEasing: 'linear' as const,
+          objectFitKenBurnsFocalX: 50,
+          objectFitKenBurnsFocalY: 50,
+          objectFitKenBurnsPanStartX: 0,
+          objectFitKenBurnsPanStartY: 0,
+          objectFitKenBurnsPanEndX: 100,
+          objectFitKenBurnsPanEndY: 100,
           chromakey: false,
           chromakeyBlend: 0.1,
+          sound: 'on' as const,
           chromakeySimilarity: 0.1,
           chromakeyColor: '#000000',
         },
@@ -128,8 +172,19 @@ export const getSampleSequences = (
           objectFitContainAmbientBrightness: -0.1,
           objectFitContainAmbientSaturation: 0.7,
           objectFitContainPillarboxColor: '#000000',
+          objectFitKenBurns: 'zoom-in' as const,
+          objectFitKenBurnsZoom: 30,
+          objectFitKenBurnsEffectDuration: 0,
+          objectFitKenBurnsEasing: 'linear' as const,
+          objectFitKenBurnsFocalX: 50,
+          objectFitKenBurnsFocalY: 50,
+          objectFitKenBurnsPanStartX: 0,
+          objectFitKenBurnsPanStartY: 0,
+          objectFitKenBurnsPanEndX: 100,
+          objectFitKenBurnsPanEndY: 100,
           chromakey: false,
           chromakeyBlend: 0.1,
+          sound: 'on' as const,
           chromakeySimilarity: 0.1,
           chromakeyColor: '#000000',
         },
@@ -163,8 +218,19 @@ export const getSampleSequences = (
           objectFitContainAmbientBrightness: -0.1,
           objectFitContainAmbientSaturation: 0.7,
           objectFitContainPillarboxColor: '#000000',
+          objectFitKenBurns: 'zoom-in' as const,
+          objectFitKenBurnsZoom: 30,
+          objectFitKenBurnsEffectDuration: 0,
+          objectFitKenBurnsEasing: 'linear' as const,
+          objectFitKenBurnsFocalX: 50,
+          objectFitKenBurnsFocalY: 50,
+          objectFitKenBurnsPanStartX: 0,
+          objectFitKenBurnsPanStartY: 0,
+          objectFitKenBurnsPanEndX: 100,
+          objectFitKenBurnsPanEndY: 100,
           chromakey: false,
           chromakeyBlend: 0.1,
+          sound: 'on' as const,
           chromakeySimilarity: 0.1,
           chromakeyColor: '#000000',
         },
@@ -198,8 +264,19 @@ export const getSampleSequences = (
           objectFitContainAmbientBrightness: -0.1,
           objectFitContainAmbientSaturation: 0.7,
           objectFitContainPillarboxColor: '#000000',
+          objectFitKenBurns: 'zoom-in' as const,
+          objectFitKenBurnsZoom: 30,
+          objectFitKenBurnsEffectDuration: 0,
+          objectFitKenBurnsEasing: 'linear' as const,
+          objectFitKenBurnsFocalX: 50,
+          objectFitKenBurnsFocalY: 50,
+          objectFitKenBurnsPanStartX: 0,
+          objectFitKenBurnsPanStartY: 0,
+          objectFitKenBurnsPanEndX: 100,
+          objectFitKenBurnsPanEndY: 100,
           chromakey: false,
           chromakeyBlend: 0.1,
+          sound: 'on' as const,
           chromakeySimilarity: 0.1,
           chromakeyColor: '#000000',
         },
@@ -211,6 +288,229 @@ export const getSampleSequences = (
   );
   seq3.build();
 
+  // Ken Burns effect test sequence - using intro_image for all effect types
+  const seq4 = new Sequence(
+    buf,
+    {
+      fragments: [
+        // zoom-in effect with custom focal point
+        {
+          id: 'kb_zoom_in',
+          enabled: true,
+          assetName: 'intro_image',
+          duration: 3000,
+          trimLeft: 0,
+          overlayLeft: 0,
+          overlayZIndex: 1,
+          transitionIn: '',
+          transitionInDuration: 0,
+          transitionOut: '',
+          transitionOutDuration: 0,
+          objectFit: 'ken-burns',
+          objectFitContain: 'ambient',
+          objectFitContainAmbientBlurStrength: 25,
+          objectFitContainAmbientBrightness: -0.1,
+          objectFitContainAmbientSaturation: 0.7,
+          objectFitContainPillarboxColor: '#000000',
+          objectFitKenBurns: 'zoom-in' as const,
+          objectFitKenBurnsZoom: 50,
+          objectFitKenBurnsEffectDuration: 1000,
+          objectFitKenBurnsEasing: 'ease-in-out' as const,
+          objectFitKenBurnsFocalX: 30,
+          objectFitKenBurnsFocalY: 40,
+          objectFitKenBurnsPanStartX: 0,
+          objectFitKenBurnsPanStartY: 0,
+          objectFitKenBurnsPanEndX: 100,
+          objectFitKenBurnsPanEndY: 100,
+          chromakey: false,
+          chromakeyBlend: 0.1,
+          sound: 'on' as const,
+          chromakeySimilarity: 0.1,
+          chromakeyColor: '#000000',
+        },
+        // zoom-out effect with center focal point
+        {
+          id: 'kb_zoom_out',
+          enabled: true,
+          assetName: 'intro_image',
+          duration: 3000,
+          trimLeft: 0,
+          overlayLeft: 0,
+          overlayZIndex: 1,
+          transitionIn: '',
+          transitionInDuration: 0,
+          transitionOut: '',
+          transitionOutDuration: 0,
+          objectFit: 'ken-burns',
+          objectFitContain: 'ambient',
+          objectFitContainAmbientBlurStrength: 25,
+          objectFitContainAmbientBrightness: -0.1,
+          objectFitContainAmbientSaturation: 0.7,
+          objectFitContainPillarboxColor: '#000000',
+          objectFitKenBurns: 'zoom-out' as const,
+          objectFitKenBurnsZoom: 40,
+          objectFitKenBurnsEffectDuration: 2000,
+          objectFitKenBurnsEasing: 'ease-in' as const,
+          objectFitKenBurnsFocalX: 50,
+          objectFitKenBurnsFocalY: 50,
+          objectFitKenBurnsPanStartX: 0,
+          objectFitKenBurnsPanStartY: 0,
+          objectFitKenBurnsPanEndX: 100,
+          objectFitKenBurnsPanEndY: 100,
+          chromakey: false,
+          chromakeyBlend: 0.1,
+          sound: 'on' as const,
+          chromakeySimilarity: 0.1,
+          chromakeyColor: '#000000',
+        },
+        // pan-left effect
+        {
+          id: 'kb_pan_left',
+          enabled: true,
+          assetName: 'intro_image',
+          duration: 3000,
+          trimLeft: 0,
+          overlayLeft: 0,
+          overlayZIndex: 1,
+          transitionIn: '',
+          transitionInDuration: 0,
+          transitionOut: '',
+          transitionOutDuration: 0,
+          objectFit: 'ken-burns',
+          objectFitContain: 'ambient',
+          objectFitContainAmbientBlurStrength: 25,
+          objectFitContainAmbientBrightness: -0.1,
+          objectFitContainAmbientSaturation: 0.7,
+          objectFitContainPillarboxColor: '#000000',
+          objectFitKenBurns: 'pan-left' as const,
+          objectFitKenBurnsZoom: 30,
+          objectFitKenBurnsEffectDuration: 1500,
+          objectFitKenBurnsEasing: 'linear' as const,
+          objectFitKenBurnsFocalX: 50,
+          objectFitKenBurnsFocalY: 50,
+          objectFitKenBurnsPanStartX: 0,
+          objectFitKenBurnsPanStartY: 0,
+          objectFitKenBurnsPanEndX: 100,
+          objectFitKenBurnsPanEndY: 100,
+          chromakey: false,
+          chromakeyBlend: 0.1,
+          sound: 'on' as const,
+          chromakeySimilarity: 0.1,
+          chromakeyColor: '#000000',
+        },
+        // pan-right effect
+        {
+          id: 'kb_pan_right',
+          enabled: true,
+          assetName: 'intro_image',
+          duration: 3000,
+          trimLeft: 0,
+          overlayLeft: 0,
+          overlayZIndex: 1,
+          transitionIn: '',
+          transitionInDuration: 0,
+          transitionOut: '',
+          transitionOutDuration: 0,
+          objectFit: 'ken-burns',
+          objectFitContain: 'ambient',
+          objectFitContainAmbientBlurStrength: 25,
+          objectFitContainAmbientBrightness: -0.1,
+          objectFitContainAmbientSaturation: 0.7,
+          objectFitContainPillarboxColor: '#000000',
+          objectFitKenBurns: 'pan-right' as const,
+          objectFitKenBurnsZoom: 50,
+          objectFitKenBurnsEffectDuration: 1500,
+          objectFitKenBurnsEasing: 'ease-out' as const,
+          objectFitKenBurnsFocalX: 50,
+          objectFitKenBurnsFocalY: 50,
+          objectFitKenBurnsPanStartX: 0,
+          objectFitKenBurnsPanStartY: 0,
+          objectFitKenBurnsPanEndX: 100,
+          objectFitKenBurnsPanEndY: 100,
+          chromakey: false,
+          chromakeyBlend: 0.1,
+          sound: 'on' as const,
+          chromakeySimilarity: 0.1,
+          chromakeyColor: '#000000',
+        },
+        // pan-top effect
+        {
+          id: 'kb_pan_top',
+          enabled: true,
+          assetName: 'intro_image',
+          duration: 3000,
+          trimLeft: 0,
+          overlayLeft: 0,
+          overlayZIndex: 1,
+          transitionIn: '',
+          transitionInDuration: 0,
+          transitionOut: '',
+          transitionOutDuration: 0,
+          objectFit: 'ken-burns',
+          objectFitContain: 'ambient',
+          objectFitContainAmbientBlurStrength: 25,
+          objectFitContainAmbientBrightness: -0.1,
+          objectFitContainAmbientSaturation: 0.7,
+          objectFitContainPillarboxColor: '#000000',
+          objectFitKenBurns: 'pan-top' as const,
+          objectFitKenBurnsZoom: 30,
+          objectFitKenBurnsEffectDuration: 1500,
+          objectFitKenBurnsEasing: 'ease-in' as const,
+          objectFitKenBurnsFocalX: 50,
+          objectFitKenBurnsFocalY: 50,
+          objectFitKenBurnsPanStartX: 0,
+          objectFitKenBurnsPanStartY: 0,
+          objectFitKenBurnsPanEndX: 100,
+          objectFitKenBurnsPanEndY: 100,
+          chromakey: false,
+          chromakeyBlend: 0.1,
+          sound: 'on' as const,
+          chromakeySimilarity: 0.1,
+          chromakeyColor: '#000000',
+        },
+        // pan-bottom effect
+        {
+          id: 'kb_pan_bottom',
+          enabled: true,
+          assetName: 'intro_image',
+          duration: 3000,
+          trimLeft: 0,
+          overlayLeft: 0,
+          overlayZIndex: 1,
+          transitionIn: '',
+          transitionInDuration: 0,
+          transitionOut: '',
+          transitionOutDuration: 0,
+          objectFit: 'ken-burns',
+          objectFitContain: 'ambient',
+          objectFitContainAmbientBlurStrength: 25,
+          objectFitContainAmbientBrightness: -0.1,
+          objectFitContainAmbientSaturation: 0.7,
+          objectFitContainPillarboxColor: '#000000',
+          objectFitKenBurns: 'pan-bottom' as const,
+          objectFitKenBurnsZoom: 40,
+          objectFitKenBurnsEffectDuration: 1500,
+          objectFitKenBurnsEasing: 'ease-in-out' as const,
+          objectFitKenBurnsFocalX: 50,
+          objectFitKenBurnsFocalY: 50,
+          objectFitKenBurnsPanStartX: 0,
+          objectFitKenBurnsPanStartY: 0,
+          objectFitKenBurnsPanEndX: 100,
+          objectFitKenBurnsPanEndY: 100,
+          chromakey: false,
+          chromakeyBlend: 0.1,
+          sound: 'on' as const,
+          chromakeySimilarity: 0.1,
+          chromakeyColor: '#000000',
+        },
+      ],
+    },
+    output,
+    project.getAssetManager(),
+    expressionContext,
+  );
+  seq4.build();
+
   seq1.overlayWith(seq2);
   seq1.overlayWith(seq3);
 

package/src/sequence.ts

@@ -16,13 +16,14 @@ import {
   Stream,
   VisualFilter,
 } from './stream';
-import { Output, SequenceDefinition } from './type';
+import { Output, SequenceDefinition, FragmentDebugInfo } from './type';
 
 export class Sequence {
   private time: number = 0; // time is absolute
 
   private videoStream!: Stream;
   private audioStream!: Stream;
+  private debugInfo: FragmentDebugInfo[] = []; // Collect debug info during build
 
   constructor(
     private buf: FilterBuffer,
@@ -44,6 +45,11 @@ export class Sequence {
         this.expressionContext,
       );
 
+      const calculatedDuration = calculateFinalValue(
+        fragment.duration,
+        this.expressionContext,
+      );
+
       if (fragment.id === 'outro_message') {
         debugger;
       }
@@ -51,7 +57,7 @@ export class Sequence {
       const timeContext: TimeData = {
         start: 0,
         end: 0,
-        duration: fragment.duration,
+        duration: calculatedDuration,
       };
 
       const asset = this.assetManager.getAssetByName(fragment.assetName);
@@ -69,7 +75,7 @@ export class Sequence {
       } else {
         // Create blank transparent video stream for audio-only assets
         currentVideoStream = makeBlankStream(
-          fragment.duration,
+          calculatedDuration,
           this.output.resolution.width,
           this.output.resolution.height,
           this.output.fps,
@@ -78,40 +84,50 @@ export class Sequence {
       }
 
       // Create audio stream: use actual audio if available, otherwise create silent stream
+      // If fragment has -sound: off, always use silence
       let currentAudioStream: Stream;
-      if (asset.hasAudio) {
+      if (fragment.sound === 'off') {
+        // Force silent audio when -sound: off
+        currentAudioStream = makeSilentStream(calculatedDuration, this.buf);
+      } else if (asset.hasAudio) {
         currentAudioStream = makeStream(
           this.assetManager.getAudioInputLabelByAssetName(fragment.assetName),
           this.buf,
         );
       } else {
         // Create silent audio stream matching the video duration
-        currentAudioStream = makeSilentStream(fragment.duration, this.buf);
+        currentAudioStream = makeSilentStream(calculatedDuration, this.buf);
       }
 
       // duration and clipping adjustment
-      if (fragment.trimLeft != 0 || fragment.duration < asset.duration) {
+      if (fragment.trimLeft != 0 || calculatedDuration < asset.duration) {
         // console.log('fragment.trimLeft=' + fragment.trimLeft);
-        // console.log('fragment.duration=' + fragment.duration);
+        // console.log('fragment.duration=' + calculatedDuration);
         // console.log('asset.duration=' + asset.duration);
 
         // Only trim video if it came from an actual source
         if (asset.hasVideo) {
           currentVideoStream.trim(
             fragment.trimLeft,
-            fragment.trimLeft + fragment.duration,
+            fragment.trimLeft + calculatedDuration,
           );
         }
 
-        // Only trim audio if it came from an actual source
-        if (asset.hasAudio) {
+        // Only trim audio if it came from an actual source AND sound is not off
+        if (asset.hasAudio && fragment.sound !== 'off') {
           currentAudioStream.trim(
             fragment.trimLeft,
-            fragment.trimLeft + fragment.duration,
+            fragment.trimLeft + calculatedDuration,
           );
         }
       }
 
+      // Convert deprecated JPEG pixel format (yuvj420p) to standard yuv420p early
+      // This prevents swscaler warnings from appearing in all subsequent filters
+      if (asset.hasVideo && asset.type === 'image') {
+        currentVideoStream.convertPixelFormat('yuv420p');
+      }
+
       // Apply visual filter early for static images (before padding/cloning)
       // This is more efficient as ffmpeg processes the filter once, then clones the filtered frame
       if (
@@ -124,12 +140,14 @@ export class Sequence {
 
       if (
         asset.duration === 0 &&
-        fragment.duration > 0 &&
-        asset.type === 'image'
+        calculatedDuration > 0 &&
+        asset.type === 'image' &&
+        fragment.objectFit !== 'ken-burns'
       ) {
         // special case for images - extend static image to desired duration
+        // Skip tpad for Ken Burns - zoompan will generate the frames
         currentVideoStream.tPad({
-          start: fragment.duration,
+          start: calculatedDuration,
           startMode: 'clone',
         });
       }
@@ -140,7 +158,25 @@ export class Sequence {
         currentVideoStream.fps(this.output.fps);
 
         // fitting the video stream into the output frame
-        if (fragment.objectFit === 'cover') {
+        if (fragment.objectFit === 'ken-burns') {
+          // Ken Burns effect (zoom/pan)
+          currentVideoStream.kenBurns({
+            effect: fragment.objectFitKenBurns,
+            zoom: fragment.objectFitKenBurnsZoom,
+            effectDuration: fragment.objectFitKenBurnsEffectDuration,
+            fragmentDuration: calculatedDuration,
+            easing: fragment.objectFitKenBurnsEasing,
+            width: this.output.resolution.width,
+            height: this.output.resolution.height,
+            fps: this.output.fps,
+            focalX: fragment.objectFitKenBurnsFocalX,
+            focalY: fragment.objectFitKenBurnsFocalY,
+            panStartX: fragment.objectFitKenBurnsPanStartX,
+            panStartY: fragment.objectFitKenBurnsPanStartY,
+            panEndX: fragment.objectFitKenBurnsPanEndX,
+            panEndY: fragment.objectFitKenBurnsPanEndY,
+          });
+        } else if (fragment.objectFit === 'cover') {
           currentVideoStream.fitOutputCover(this.output.resolution);
         } else {
           const options: ObjectFitContainOptions = {};
@@ -202,7 +238,7 @@ export class Sequence {
           fades: [
             {
               type: 'out',
-              startTime: fragment.duration - fragment.transitionOutDuration,
+              startTime: calculatedDuration - fragment.transitionOutDuration,
               duration: fragment.transitionOutDuration,
             },
           ],
@@ -211,7 +247,7 @@ export class Sequence {
           fades: [
             {
               type: 'out',
-              startTime: fragment.duration - fragment.transitionOutDuration,
+              startTime: calculatedDuration - fragment.transitionOutDuration,
               duration: fragment.transitionOutDuration,
             },
           ],
@@ -239,7 +275,7 @@ export class Sequence {
 
           // console.log('this.time=' + this.time);
           // console.log('streamDuration=' + this.time);
-          // console.log('otherStreamDuration=' + fragment.duration);
+          // console.log('otherStreamDuration=' + calculatedDuration);
           // console.log('otherStreamOffsetLeft=' + otherStreamOffsetLeft);
 
           // use overlay
@@ -247,14 +283,14 @@ export class Sequence {
             flipLayers: fragment.overlayZIndex < 0,
             offset: {
               streamDuration: this.time,
-              otherStreamDuration: fragment.duration,
+              otherStreamDuration: calculatedDuration,
               otherStreamOffsetLeft: otherStreamOffsetLeft,
             },
           });
           this.audioStream.overlayStream(currentAudioStream, {
             offset: {
               streamDuration: this.time,
-              otherStreamDuration: fragment.duration,
+              otherStreamDuration: calculatedDuration,
               otherStreamOffsetLeft: otherStreamOffsetLeft,
             },
           });
@@ -291,13 +327,25 @@ export class Sequence {
       }
 
       timeContext.start = this.time + calculatedOverlayLeft;
-      timeContext.end = this.time + fragment.duration + calculatedOverlayLeft;
-      this.time += fragment.duration + calculatedOverlayLeft;
+      timeContext.end = this.time + calculatedDuration + calculatedOverlayLeft;
+      this.time += calculatedDuration + calculatedOverlayLeft;
 
       this.expressionContext.fragments.set(fragment.id, {
         time: timeContext,
       });
 
+      // Collect debug info
+      this.debugInfo.push({
+        id: fragment.id,
+        assetName: fragment.assetName,
+        startTime: timeContext.start,
+        endTime: timeContext.end,
+        duration: calculatedDuration,
+        trimLeft: fragment.trimLeft,
+        overlayLeft: calculatedOverlayLeft,
+        enabled: fragment.enabled,
+      });
+
       // console.log('new time=' + this.time);
 
       firstOne = false;
@@ -327,4 +375,12 @@ export class Sequence {
   public getAudioStream(): Stream {
     return this.audioStream;
   }
+
+  public getDebugInfo(): FragmentDebugInfo[] {
+    return this.debugInfo;
+  }
+
+  public getTotalDuration(): number {
+    return this.time;
+  }
 }

package/src/stream.ts

@@ -4,6 +4,7 @@ import {
   Millisecond,
   makeNull,
   makeFps,
+  makeFormat,
   makeTranspose,
   makeTrim,
   makeTPad,
@@ -17,6 +18,7 @@ import {
   makeOverlay,
   makeEq,
   makeChromakey,
+  makeKenBurns,
   makeConcat,
   makeFade,
   makeAmix,
@@ -311,6 +313,45 @@ export class Stream {
     return this;
   }
 
+  public kenBurns(parameters: {
+    effect: 'zoom-in' | 'zoom-out' | 'pan-left' | 'pan-right' | 'pan-top' | 'pan-bottom';
+    zoom: number;
+    effectDuration: number;
+    fragmentDuration: number;
+    easing: 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out';
+    width: number;
+    height: number;
+    fps: number;
+    focalX?: number;
+    focalY?: number;
+    panStartX?: number;
+    panStartY?: number;
+    panEndX?: number;
+    panEndY?: number;
+  }): Stream {
+    // Apply Ken Burns effect
+    const kenBurnsRes = makeKenBurns([this.looseEnd], {
+      effect: parameters.effect,
+      zoom: parameters.zoom,
+      effectDuration: parameters.effectDuration,
+      fragmentDuration: parameters.fragmentDuration,
+      easing: parameters.easing,
+      width: parameters.width,
+      height: parameters.height,
+      fps: parameters.fps,
+      focalX: parameters.focalX,
+      focalY: parameters.focalY,
+      panStartX: parameters.panStartX,
+      panStartY: parameters.panStartY,
+      panEndX: parameters.panEndX,
+      panEndY: parameters.panEndY,
+    });
+    this.looseEnd = kenBurnsRes.outputs[0];
+    this.buf.append(kenBurnsRes);
+
+    return this;
+  }
+
   public fps(value: number): Stream {
     const res = makeFps([this.looseEnd], value);
     this.looseEnd = res.outputs[0];
@@ -320,6 +361,15 @@ export class Stream {
     return this;
   }
 
+  public convertPixelFormat(format: string): Stream {
+    const res = makeFormat([this.looseEnd], format);
+    this.looseEnd = res.outputs[0];
+
+    this.buf.append(res);
+
+    return this;
+  }
+
   public blur(strength: number): Stream {
     const res = makeGblur([this.looseEnd], {
       sigma: strength,