mediabunny 1.56.3 → 1.57.0

package/dist/bundles/mediabunny.cjs

@@ -245,6 +245,8 @@ var Mediabunny = (() => {
       throw new Error("Assertion failed.");
     }
   }
+  var DEG_TO_RAD = Math.PI / 180;
+  var RAD_TO_DEG = 180 / Math.PI;
   var normalizeRotation = (rotation) => {
     const mappedRotation = (rotation % 360 + 360) % 360;
     if (mappedRotation === 0 || mappedRotation === 90 || mappedRotation === 180 || mappedRotation === 270) {
@@ -253,6 +255,86 @@ var Mediabunny = (() => {
       throw new Error(`Invalid rotation ${rotation}.`);
     }
   };
+  var IDENTITY_MATRIX = [1, 0, 0, 0, 1, 0, 0, 0, 1];
+  var centeredTransformationMatrix = (linear, width, height) => {
+    const [a, b, , c, d] = linear;
+    const transformedWidth = Math.abs(a) * width + Math.abs(c) * height;
+    const transformedHeight = Math.abs(b) * width + Math.abs(d) * height;
+    return multiplyMatrices(
+      multiplyMatrices(
+        translationMatrix(-width / 2, -height / 2),
+        linear
+      ),
+      translationMatrix(transformedWidth / 2, transformedHeight / 2)
+    );
+  };
+  var extractRotationFromMatrix = (matrix) => {
+    const [a, b] = matrix;
+    const radians = Math.atan2(b, matrixIsFlipped(matrix) ? -a : a);
+    return normalizeRotation(roundToMultiple(radians * RAD_TO_DEG, 90));
+  };
+  var matrixIsFlipped = (matrix) => {
+    const [a, b, , c, d] = matrix;
+    const det = a * d - b * c;
+    return det < 0;
+  };
+  var rotationMatrix = (rotationInDegrees) => {
+    const theta = rotationInDegrees * DEG_TO_RAD;
+    const cosTheta = Math.round(Math.cos(theta));
+    const sinTheta = Math.round(Math.sin(theta));
+    return [
+      cosTheta,
+      sinTheta,
+      0,
+      -sinTheta,
+      cosTheta,
+      0,
+      0,
+      0,
+      1
+    ];
+  };
+  var translationMatrix = (x, y) => {
+    return [
+      1,
+      0,
+      0,
+      0,
+      1,
+      0,
+      x,
+      y,
+      1
+    ];
+  };
+  var scaleMatrix = (x, y) => {
+    return [
+      x,
+      0,
+      0,
+      0,
+      y,
+      0,
+      0,
+      0,
+      1
+    ];
+  };
+  var multiplyMatrices = (a, b) => {
+    const result = new Array(9);
+    for (let i = 0; i < 3; i++) {
+      for (let j = 0; j < 3; j++) {
+        result[3 * i + j] = a[3 * i] * b[j] + a[3 * i + 1] * b[3 + j] + a[3 * i + 2] * b[6 + j];
+      }
+    }
+    return result;
+  };
+  var composeRotationAndFlip = (rotation1, flip1, rotation2, flip2) => {
+    return {
+      rotation: normalizeRotation(rotation1 + (flip1 ? -rotation2 : rotation2)),
+      flip: flip1 !== flip2
+    };
+  };
   var last = (arr) => {
     return arr && arr[arr.length - 1];
   };
@@ -6391,6 +6473,7 @@ var Mediabunny = (() => {
       this.metadataPromise = null;
       this.movieTimescale = -1;
       this.movieDurationInTimescale = -1;
+      this.movieMatrix = IDENTITY_MATRIX;
       this.isQuickTime = false;
       this.metadataTags = {};
       this.currentMetadataKeys = null;
@@ -6509,6 +6592,7 @@ var Mediabunny = (() => {
       await initDemuxer.readMetadata();
       this.movieTimescale = initDemuxer.movieTimescale;
       this.movieDurationInTimescale = initDemuxer.movieDurationInTimescale;
+      this.movieMatrix = initDemuxer.movieMatrix;
       this.metadataTags = initDemuxer.metadataTags;
       this.isFragmented = true;
       this.fragmentTrackDefaults = initDemuxer.fragmentTrackDefaults;
@@ -6522,7 +6606,7 @@ var Mediabunny = (() => {
           timescale: foreignTrack.timescale,
           durationInMediaTimescale: foreignTrack.durationInMediaTimescale,
           durationInMovieTimescale: foreignTrack.durationInMovieTimescale,
-          rotation: foreignTrack.rotation,
+          matrix: foreignTrack.matrix,
           internalCodecId: foreignTrack.internalCodecId,
           name: foreignTrack.name,
           languageCode: foreignTrack.languageCode,
@@ -6536,6 +6620,8 @@ var Mediabunny = (() => {
           encryptionInfo: foreignTrack.encryptionInfo,
           encryptionAuxInfo: null,
           frmaCodecString: null,
+          maxBitrate: foreignTrack.maxBitrate,
+          avgBitrate: foreignTrack.avgBitrate,
           info: foreignTrack.info
         };
         if (foreignTrack.trackBacking) {
@@ -6771,6 +6857,8 @@ var Mediabunny = (() => {
               this.movieTimescale = readU32Be(slice);
               this.movieDurationInTimescale = readU32Be(slice);
             }
+            slice.skip(4 + 2 + 2 + 2 * 4);
+            this.movieMatrix = readMatrix(slice);
           }
           ;
           break;
@@ -6788,7 +6876,7 @@ var Mediabunny = (() => {
               timescale: -1,
               durationInMovieTimescale: -1,
               durationInMediaTimescale: -1,
-              rotation: 0,
+              matrix: IDENTITY_MATRIX,
               internalCodecId: null,
               name: null,
               languageCode: UNDETERMINED_LANGUAGE,
@@ -6801,7 +6889,9 @@ var Mediabunny = (() => {
               editListOffset: 0,
               encryptionInfo: null,
               encryptionAuxInfo: null,
-              frmaCodecString: null
+              frmaCodecString: null,
+              maxBitrate: null,
+              avgBitrate: null
             };
             this.currentTrack = track;
             this.readContiguousBoxes(slice.slice(contentStartPos, boxInfo.contentSize));
@@ -6844,20 +6934,8 @@ var Mediabunny = (() => {
               throw new Error(`Incorrect track header version ${version}.`);
             }
             slice.skip(2 * 4 + 2 + 2 + 2 + 2);
-            const matrix = [
-              readFixed_16_16(slice),
-              readFixed_16_16(slice),
-              readFixed_2_30(slice),
-              readFixed_16_16(slice),
-              readFixed_16_16(slice),
-              readFixed_2_30(slice),
-              readFixed_16_16(slice),
-              readFixed_16_16(slice),
-              readFixed_2_30(slice)
-            ];
-            const rotation = normalizeRotation(roundToMultiple(extractRotationFromMatrix(matrix), 90));
-            assert(rotation === 0 || rotation === 90 || rotation === 180 || rotation === 270);
-            track.rotation = rotation;
+            const trackMatrix = readMatrix(slice);
+            track.matrix = multiplyMatrices(trackMatrix, this.movieMatrix);
           }
           ;
           break;
@@ -7413,6 +7491,20 @@ var Mediabunny = (() => {
           }
           ;
           break;
+        case "btrt":
+          {
+            const track = this.currentTrack;
+            if (!track) {
+              break;
+            }
+            slice.skip(4);
+            const maxBitrate = readU32Be(slice);
+            const avgBitrate = readU32Be(slice);
+            track.maxBitrate = maxBitrate > 0 ? maxBitrate : null;
+            track.avgBitrate = avgBitrate > 0 ? avgBitrate : null;
+          }
+          ;
+          break;
         case "wave":
           {
             this.readContiguousBoxes(slice.slice(contentStartPos, boxInfo.contentSize));
@@ -8631,10 +8723,10 @@ var Mediabunny = (() => {
       return 1n;
     }
     getBitrate() {
-      return null;
+      return this.internalTrack.maxBitrate;
     }
     getAverageBitrate() {
-      return null;
+      return this.internalTrack.avgBitrate;
     }
     async getDurationFromMetadata() {
       const track = this.internalTrack;
@@ -9027,8 +9119,8 @@ var Mediabunny = (() => {
     getSquarePixelHeight() {
       return this.internalTrack.info.squarePixelHeight;
     }
-    getRotation() {
-      return this.internalTrack.rotation;
+    getTransformationMatrix() {
+      return [...this.internalTrack.matrix];
     }
     async getColorSpace() {
       const decoderConfig = await this.getDecoderConfig();
@@ -9267,13 +9359,18 @@ var Mediabunny = (() => {
       entry.presentationTimestamp += timestamp;
     }
   };
-  var extractRotationFromMatrix = (matrix) => {
-    const [a, b] = matrix;
-    const radians = Math.atan2(b, a);
-    if (!Number.isFinite(radians)) {
-      return 0;
-    }
-    return radians * (180 / Math.PI);
+  var readMatrix = (slice) => {
+    return [
+      readFixed_16_16(slice),
+      readFixed_16_16(slice),
+      readFixed_2_30(slice),
+      readFixed_16_16(slice),
+      readFixed_16_16(slice),
+      readFixed_2_30(slice),
+      readFixed_16_16(slice),
+      readFixed_16_16(slice),
+      readFixed_2_30(slice)
+    ];
   };
   var sampleTableIsEmpty = (sampleTable) => {
     return sampleTable.sampleSizes.length === 0;
@@ -10750,6 +10847,8 @@ var Mediabunny = (() => {
                 displayUnit: null,
                 squarePixelWidth: -1,
                 squarePixelHeight: -1,
+                horizontalScale: 1,
+                verticalScale: 1,
                 rotation: 0,
                 codec: null,
                 codecDescription: null,
@@ -10979,6 +11078,32 @@ var Mediabunny = (() => {
           }
           ;
           break;
+        // Yaw and pitch rotate the frame in 3D space about the vertical and horizontal axis respectively. When
+        // snapped to multiples of 90 degrees, that amounts to scaling each axis by the cosine, which models flips.
+        case 30323 /* ProjectionPoseYaw */:
+          {
+            if (this.currentTrack?.info?.type !== "video") break;
+            const yaw = readFloat(slice, size);
+            try {
+              const normalized = normalizeRotation(yaw);
+              this.currentTrack.info.horizontalScale = Math.round(Math.cos(normalized * DEG_TO_RAD));
+            } catch {
+            }
+          }
+          ;
+          break;
+        case 30324 /* ProjectionPosePitch */:
+          {
+            if (this.currentTrack?.info?.type !== "video") break;
+            const pitch = readFloat(slice, size);
+            try {
+              const normalized = normalizeRotation(pitch);
+              this.currentTrack.info.verticalScale = Math.round(Math.cos(normalized * DEG_TO_RAD));
+            } catch {
+            }
+          }
+          ;
+          break;
         case 30325 /* ProjectionPoseRoll */:
           {
             if (this.currentTrack?.info?.type !== "video") break;
@@ -11955,8 +12080,13 @@ var Mediabunny = (() => {
     getSquarePixelHeight() {
       return this.internalTrack.info.squarePixelHeight;
     }
-    getRotation() {
-      return this.internalTrack.info.rotation;
+    getTransformationMatrix() {
+      const info = this.internalTrack.info;
+      const linear = multiplyMatrices(
+        scaleMatrix(info.horizontalScale, info.verticalScale),
+        rotationMatrix(info.rotation)
+      );
+      return centeredTransformationMatrix(linear, info.width, info.height);
     }
     async getColorSpace() {
       const decoderConfig = await this.getDecoderConfig();
@@ -15934,8 +16064,8 @@ var Mediabunny = (() => {
     getSquarePixelHeight() {
       return this.elementaryStream.info.squarePixelHeight;
     }
-    getRotation() {
-      return 0;
+    getTransformationMatrix() {
+      return [...IDENTITY_MATRIX];
     }
     async getColorSpace() {
       return this.elementaryStream.info.colorSpace;
@@ -16988,8 +17118,8 @@ var Mediabunny = (() => {
     getSquarePixelHeight() {
       return this.delegate(() => this.firstInputTrack._backing.getSquarePixelHeight());
     }
-    getRotation() {
-      return this.delegate(() => this.firstInputTrack._backing.getRotation());
+    getTransformationMatrix() {
+      return this.delegate(() => this.firstInputTrack._backing.getTransformationMatrix());
     }
     async getColorSpace() {
       return this.delegate(() => this.firstInputTrack._backing.getColorSpace());
@@ -19022,10 +19152,11 @@ var Mediabunny = (() => {
                 throw new Error(`Unsupported IV format '${ivString}'.`);
               }
               let hex = ivString.slice(2);
-              hex = hex.padStart(AES_128_BLOCK_SIZE * 2, "0");
+              hex = hex.padStart(2 * AES_128_BLOCK_SIZE, "0");
+              hex = hex.slice(-2 * AES_128_BLOCK_SIZE);
               iv = new Uint8Array(AES_128_BLOCK_SIZE);
               for (let i2 = 0; i2 < AES_128_BLOCK_SIZE; i2++) {
-                const startIndex = -AES_128_BLOCK_SIZE * 2 + i2;
+                const startIndex = 2 * i2;
                 iv[i2] = parseInt(hex.slice(startIndex, startIndex + 2), 16);
               }
             }
@@ -19931,8 +20062,8 @@ var Mediabunny = (() => {
       }
       return this.internalTrack.info.height;
     }
-    getRotation() {
-      return this.delegate(() => this.backingVideoTrack.getRotation());
+    getTransformationMatrix() {
+      return this.delegate(() => this.backingVideoTrack.getTransformationMatrix());
     }
     async getColorSpace() {
       await this.hydrate();
@@ -20732,6 +20863,9 @@ var Mediabunny = (() => {
         if (init.rotation !== void 0 && ![0, 90, 180, 270].includes(init.rotation)) {
           throw new TypeError("init.rotation, when provided, must be 0, 90, 180, or 270.");
         }
+        if (init.flip !== void 0 && typeof init.flip !== "boolean") {
+          throw new TypeError("init.flip, when provided, must be a boolean.");
+        }
         if (!Number.isFinite(init.timestamp)) {
           throw new TypeError("init.timestamp must be a number.");
         }
@@ -20770,6 +20904,7 @@ var Mediabunny = (() => {
         }
         this.format = init.format;
         this.rotation = init.rotation ?? 0;
+        this.flip = init.flip ?? false;
         this.timestamp = init.timestamp;
         this.duration = init.duration ?? 0;
         const layout = init.layout ?? createDefaultPlaneLayout(init.format, init.codedWidth, init.codedHeight);
@@ -20811,6 +20946,9 @@ var Mediabunny = (() => {
         if (init?.rotation !== void 0 && ![0, 90, 180, 270].includes(init.rotation)) {
           throw new TypeError("init.rotation, when provided, must be 0, 90, 180, or 270.");
         }
+        if (init?.flip !== void 0 && typeof init.flip !== "boolean") {
+          throw new TypeError("init.flip, when provided, must be a boolean.");
+        }
         if (init?.timestamp !== void 0 && !Number.isFinite(init?.timestamp)) {
           throw new TypeError("init.timestamp, when provided, must be a number.");
         }
@@ -20830,6 +20968,7 @@ var Mediabunny = (() => {
           height: data.visibleRect?.height ?? data.codedHeight
         };
         this.rotation = init?.rotation ?? 0;
+        this.flip = init?.flip ?? false;
         this.squarePixelWidth = data.displayWidth;
         this.squarePixelHeight = data.displayHeight;
         this.timestamp = init?.timestamp ?? data.timestamp / 1e6;
@@ -20842,6 +20981,9 @@ var Mediabunny = (() => {
         if (init.rotation !== void 0 && ![0, 90, 180, 270].includes(init.rotation)) {
           throw new TypeError("init.rotation, when provided, must be 0, 90, 180, or 270.");
         }
+        if (init.flip !== void 0 && typeof init.flip !== "boolean") {
+          throw new TypeError("init.flip, when provided, must be a boolean.");
+        }
         if (!Number.isFinite(init.timestamp)) {
           throw new TypeError("init.timestamp must be a number.");
         }
@@ -20903,6 +21045,7 @@ var Mediabunny = (() => {
         this.squarePixelWidth = visibleRect.width;
         this.squarePixelHeight = visibleRect.height;
         this.rotation = init.rotation ?? 0;
+        this.flip = init.flip ?? false;
         this.timestamp = init.timestamp;
         this.duration = init.duration ?? 0;
         this.colorSpace = new VideoSampleColorSpace({
@@ -20918,6 +21061,9 @@ var Mediabunny = (() => {
         if (init.rotation !== void 0 && ![0, 90, 180, 270].includes(init.rotation)) {
           throw new TypeError("init.rotation, when provided, must be 0, 90, 180, or 270.");
         }
+        if (init.flip !== void 0 && typeof init.flip !== "boolean") {
+          throw new TypeError("init.flip, when provided, must be a boolean.");
+        }
         if (!Number.isFinite(init.timestamp)) {
           throw new TypeError("init.timestamp must be a number.");
         }
@@ -20951,6 +21097,7 @@ var Mediabunny = (() => {
           throw new TypeError("getSquarePixelHeight() must return a positive integer.");
         }
         this.rotation = init.rotation ?? 0;
+        this.flip = init.flip ?? false;
         this.timestamp = init.timestamp;
         this.duration = init.duration ?? 0;
         this.colorSpace = data.getColorSpace();
@@ -20974,11 +21121,11 @@ var Mediabunny = (() => {
     get codedHeight() {
       return this.visibleRect.height;
     }
-    /** The display width of the frame in pixels, after aspect ratio adjustment and rotation. */
+    /** The display width of the frame in pixels, after aspect ratio adjustment, rotation and flip. */
     get displayWidth() {
       return this.rotation % 180 === 0 ? this.squarePixelWidth : this.squarePixelHeight;
     }
-    /** The display height of the frame in pixels, after aspect ratio adjustment and rotation. */
+    /** The display height of the frame in pixels, after aspect ratio adjustment, rotation and flip. */
     get displayHeight() {
       return this.rotation % 180 === 0 ? this.squarePixelHeight : this.squarePixelWidth;
     }
@@ -21008,6 +21155,7 @@ var Mediabunny = (() => {
           timestamp: this.timestamp,
           duration: this.duration,
           rotation: this.rotation,
+          flip: this.flip,
           encodeOptions: this.encodeOptions
         });
       } else if (isVideoFrame(this._data)) {
@@ -21015,6 +21163,7 @@ var Mediabunny = (() => {
           timestamp: this.timestamp,
           duration: this.duration,
           rotation: this.rotation,
+          flip: this.flip,
           encodeOptions: this.encodeOptions
         });
       } else if (this._data instanceof Uint8Array) {
@@ -21028,6 +21177,7 @@ var Mediabunny = (() => {
           duration: this.duration,
           colorSpace: this.colorSpace,
           rotation: this.rotation,
+          flip: this.flip,
           visibleRect: this.visibleRect,
           displayWidth: this.displayWidth,
           displayHeight: this.displayHeight,
@@ -21044,6 +21194,7 @@ var Mediabunny = (() => {
           duration: this.duration,
           colorSpace: this.colorSpace,
           rotation: this.rotation,
+          flip: this.flip,
           visibleRect: this.visibleRect,
           displayWidth: this.displayWidth,
           displayHeight: this.displayHeight,
@@ -21116,7 +21267,8 @@ var Mediabunny = (() => {
               {
                 timestamp: this.timestamp,
                 duration: this.duration,
-                rotation: this.rotation
+                rotation: this.rotation,
+                flip: this.flip
               },
               options.colorSpace ?? "srgb"
             ));
@@ -21372,12 +21524,15 @@ var Mediabunny = (() => {
       if (this._closed) {
         throw new Error("VideoSample is closed.");
       }
-      ({ sx, sy, sWidth, sHeight } = this._rotateSourceRegion(sx, sy, sWidth, sHeight, this.rotation));
+      ({ sx, sy, sWidth, sHeight } = this._unmapSourceRegion(sx, sy, sWidth, sHeight, this.rotation, this.flip));
       const source = this.toCanvasImageSource();
       context.save();
       const centerX = dx + dWidth / 2;
       const centerY = dy + dHeight / 2;
       context.translate(centerX, centerY);
+      if (this.flip) {
+        context.scale(-1, 1);
+      }
       context.rotate(this.rotation * Math.PI / 180);
       const aspectRatioChange = this.rotation % 180 === 0 ? 1 : dWidth / dHeight;
       context.scale(1 / aspectRatioChange, aspectRatioChange);
@@ -21410,12 +21565,16 @@ var Mediabunny = (() => {
       if (options.rotation !== void 0 && ![0, 90, 180, 270].includes(options.rotation)) {
         throw new TypeError("options.rotation, when provided, must be 0, 90, 180, or 270.");
       }
+      if (options.flip !== void 0 && typeof options.flip !== "boolean") {
+        throw new TypeError("options.flip, when provided, must be a boolean.");
+      }
       if (options.crop !== void 0) {
         validateCropRectangle(options.crop, "options.");
       }
       const canvasWidth = context.canvas.width;
       const canvasHeight = context.canvas.height;
       const rotation = options.rotation ?? this.rotation;
+      const flip = options.flip ?? this.flip;
       const [rotatedWidth, rotatedHeight] = rotation % 180 === 0 ? [this.squarePixelWidth, this.squarePixelHeight] : [this.squarePixelHeight, this.squarePixelWidth];
       let finalCrop = options.crop;
       if (finalCrop) {
@@ -21425,12 +21584,13 @@ var Mediabunny = (() => {
       let dy;
       let newWidth;
       let newHeight;
-      const { sx, sy, sWidth, sHeight } = this._rotateSourceRegion(
+      const { sx, sy, sWidth, sHeight } = this._unmapSourceRegion(
         options.crop?.left ?? 0,
         options.crop?.top ?? 0,
         options.crop?.width ?? rotatedWidth,
         options.crop?.height ?? rotatedHeight,
-        rotation
+        rotation,
+        flip
       );
       if (options.fit === "fill") {
         dx = 0;
@@ -21448,6 +21608,9 @@ var Mediabunny = (() => {
       context.save();
       const aspectRatioChange = rotation % 180 === 0 ? 1 : newWidth / newHeight;
       context.translate(canvasWidth / 2, canvasHeight / 2);
+      if (flip) {
+        context.scale(-1, 1);
+      }
       context.rotate(rotation * Math.PI / 180);
       context.scale(1 / aspectRatioChange, aspectRatioChange);
       context.translate(-canvasWidth / 2, -canvasHeight / 2);
@@ -21455,7 +21618,11 @@ var Mediabunny = (() => {
       context.restore();
     }
     /** @internal */
-    _rotateSourceRegion(sx, sy, sWidth, sHeight, rotation) {
+    _unmapSourceRegion(sx, sy, sWidth, sHeight, rotation, flip) {
+      if (flip) {
+        const rotatedWidth = rotation % 180 === 0 ? this.squarePixelWidth : this.squarePixelHeight;
+        sx = rotatedWidth - sx - sWidth;
+      }
       if (rotation === 90) {
         [sx, sy, sWidth, sHeight] = [
           sy,
@@ -21507,6 +21674,7 @@ var Mediabunny = (() => {
       this.drawWithFit(context, {
         fit: options.fit,
         rotation: options.rotation,
+        flip: options.flip,
         crop: options.crop
       });
       context.globalCompositeOperation = "copy";
@@ -21554,8 +21722,8 @@ var Mediabunny = (() => {
       }
     }
     /**
-     * Transform this video sample to a new video sample given the options. Can be used to resize, rotate, and crop
-     * the sample.
+     * Transform this video sample to a new video sample given the options. Can be used to resize, rotate, flip, and
+     * crop the sample.
      *
      * In non-browser environments, this method will not work by default. To make it work, register a custom
      * transformer function via {@link registerVideoSampleTransformer}.
@@ -21584,13 +21752,21 @@ var Mediabunny = (() => {
       if (options.rotate !== void 0 && ![0, 90, 180, 270].includes(options.rotate)) {
         throw new TypeError("options.rotate, when provided, must be 0, 90, 180 or 270.");
       }
+      if (options.flip !== void 0 && typeof options.flip !== "boolean") {
+        throw new TypeError("options.flip, when provided, must be a boolean.");
+      }
       if (options.crop !== void 0) {
         validateCropRectangle(options.crop, "options.");
       }
       if (options.alpha !== void 0 && !["keep", "discard"].includes(options.alpha)) {
         throw new TypeError("options.alpha, when provided, must be 'keep' or 'discard'.");
       }
-      const rotation = normalizeRotation(this.rotation + (options.rotate ?? 0));
+      const { rotation, flip } = composeRotationAndFlip(
+        this.rotation,
+        this.flip,
+        options.rotate ?? 0,
+        options.flip ?? false
+      );
       const [rotatedWidth, rotatedHeight] = rotation % 180 === 0 ? [this.squarePixelWidth, this.squarePixelHeight] : [this.squarePixelHeight, this.squarePixelWidth];
       let finalCrop = options.crop;
       if (finalCrop) {
@@ -21621,6 +21797,7 @@ var Mediabunny = (() => {
         height: targetHeight,
         fit: options.fit ?? "fill",
         rotation,
+        flip,
         crop: finalCrop ?? {
           left: 0,
           top: 0,
@@ -21640,6 +21817,7 @@ var Mediabunny = (() => {
       this._drawWithFitAndMipmapping(canvas, context, {
         fit: description.fit,
         rotation: description.rotation,
+        flip: description.flip,
         crop: description.crop,
         targetIsFresh: isNew,
         fillBlack: description.alpha === "discard"
@@ -21647,8 +21825,9 @@ var Mediabunny = (() => {
       return new _VideoSample(canvas, {
         timestamp: this.timestamp,
         duration: this.duration,
-        rotation: 0
-        // Any previous rotation is now baked in
+        // Any previous rotation and flip are now baked in
+        rotation: 0,
+        flip: false
       });
     }
     /** Sets the rotation metadata of this video sample. */
@@ -21658,6 +21837,13 @@ var Mediabunny = (() => {
       }
       this.rotation = newRotation;
     }
+    /** Sets the flip metadata of this video sample. */
+    setFlip(newFlip) {
+      if (typeof newFlip !== "boolean") {
+        throw new TypeError("newFlip must be a boolean.");
+      }
+      this.flip = newFlip;
+    }
     /** Sets the presentation timestamp of this video sample, in seconds. */
     setTimestamp(newTimestamp) {
       if (!Number.isFinite(newTimestamp)) {
@@ -22853,6 +23039,9 @@ var Mediabunny = (() => {
       if (config.transform.rotate !== void 0 && ![0, 90, 180, 270].includes(config.transform.rotate)) {
         throw new TypeError("config.transform.rotate, when provided, must be 0, 90, 180 or 270.");
       }
+      if (config.transform.flip !== void 0 && typeof config.transform.flip !== "boolean") {
+        throw new TypeError("config.transform.flip, when provided, must be a boolean.");
+      }
       if (config.transform.crop !== void 0) {
         validateCropRectangle(config.transform.crop, "config.transform.");
       }
@@ -23284,6 +23473,7 @@ var Mediabunny = (() => {
       quality,
       // eslint-disable-next-line @typescript-eslint/no-deprecated
       bitrate,
+      frameRate,
       ...restOptions
     } = options;
     if (!VIDEO_CODECS.includes(codec)) {
@@ -23304,6 +23494,9 @@ var Mediabunny = (() => {
     if (bitrate !== void 0 && !(bitrate instanceof Quality) && (!Number.isInteger(bitrate) || bitrate <= 0)) {
       throw new TypeError("bitrate must be a positive integer or a quality.");
     }
+    if (frameRate !== void 0 && (!Number.isFinite(frameRate) || frameRate <= 0)) {
+      throw new TypeError("frameRate, when provided, must be a finite positive number.");
+    }
     validateVideoEncodingAdditionalOptions(codec, restOptions);
     const resolvedQuality = resolveQuality(quality, bitrate) ?? new Quality("medium");
     let candidates;
@@ -23313,7 +23506,7 @@ var Mediabunny = (() => {
         width,
         height,
         quality: resolvedQuality,
-        framerate: void 0,
+        framerate: frameRate,
         ...restOptions,
         alpha: "discard"
         // Since we handle alpha ourselves
@@ -24237,11 +24430,12 @@ var Mediabunny = (() => {
     return decodedSampleQueueSize === 0 ? 40 : 8;
   };
   var VideoDecoderWrapper = class extends DecoderWrapper {
-    constructor(onSample, onError, codec, decoderConfig, rotation, timeResolution) {
+    constructor(onSample, onError, codec, decoderConfig, rotation, flip, timeResolution) {
       super(onSample, onError);
       this.codec = codec;
       this.decoderConfig = decoderConfig;
       this.rotation = rotation;
+      this.flip = flip;
       this.timeResolution = timeResolution;
       this.decoder = null;
       this.customDecoder = null;
@@ -24526,6 +24720,7 @@ var Mediabunny = (() => {
       sample.setTimestamp(Math.round(sample.timestamp * this.timeResolution) / this.timeResolution);
       sample.setDuration(Math.round(sample.duration * this.timeResolution) / this.timeResolution);
       sample.setRotation(this.rotation);
+      sample.setFlip(this.flip);
       this.onSample(sample);
     }
     async mergeAlpha(color, alpha) {
@@ -24860,6 +25055,7 @@ var Mediabunny = (() => {
       }
       const codec = await this._track.getCodec();
       const rotation = await this._track.getRotation();
+      const flip = await this._track.getFlip();
       let decoderConfig = await this._track.getDecoderConfig();
       const timeResolution = await this._track.getTimeResolution();
       assert(codec && decoderConfig);
@@ -24868,7 +25064,7 @@ var Mediabunny = (() => {
         hardwareAcceleration: this._decoderOptions.hardwareAcceleration,
         optimizeForLatency: this._decoderOptions.optimizeForLatency
       };
-      return new VideoDecoderWrapper(onSample, onError, codec, decoderConfig, rotation, timeResolution);
+      return new VideoDecoderWrapper(onSample, onError, codec, decoderConfig, rotation, flip, timeResolution);
     }
     /** @internal */
     _createPacketSink() {
@@ -24922,6 +25118,8 @@ var Mediabunny = (() => {
       /** @internal */
       this._rotation = 0;
       /** @internal */
+      this._flip = false;
+      /** @internal */
       this._initPromise = null;
       /** @internal */
       this._nextCanvasIndex = 0;
@@ -24951,6 +25149,9 @@ var Mediabunny = (() => {
       if (options.rotation !== void 0 && ![0, 90, 180, 270].includes(options.rotation)) {
         throw new TypeError("options.rotation, when provided, must be 0, 90, 180 or 270.");
       }
+      if (options.flip !== void 0 && typeof options.flip !== "boolean") {
+        throw new TypeError("options.flip, when provided, must be a boolean.");
+      }
       if (options.crop !== void 0) {
         validateCropRectangle(options.crop, "options.");
       }
@@ -24973,6 +25174,7 @@ var Mediabunny = (() => {
         const options = this._options;
         const videoTrack = this._videoTrack;
         const rotation = options.rotation ?? await videoTrack.getRotation();
+        const flip = options.flip ?? await videoTrack.getFlip();
         const squarePixelWidth = await videoTrack.getSquarePixelWidth();
         const squarePixelHeight = await videoTrack.getSquarePixelHeight();
         const [rotatedWidth, rotatedHeight] = rotation % 180 === 0 ? [squarePixelWidth, squarePixelHeight] : [squarePixelHeight, squarePixelWidth];
@@ -24995,6 +25197,7 @@ var Mediabunny = (() => {
         this._width = width;
         this._height = height;
         this._rotation = rotation;
+        this._flip = flip;
         this._crop = crop;
       })();
     }
@@ -25028,6 +25231,7 @@ var Mediabunny = (() => {
       sample._drawWithFitAndMipmapping(canvas, context, {
         fit: this._fit,
         rotation: this._rotation,
+        flip: this._flip,
         crop: this._crop,
         targetIsFresh: canvasIsNew,
         fillBlack: !this._alpha && isFirefox()
@@ -25893,16 +26097,38 @@ var Mediabunny = (() => {
     get codedHeight() {
       return requireSync(this._backing.getCodedHeight(), "codedHeight", "getCodedHeight");
     }
-    /** Returns the angle in degrees by which the track's frames should be rotated (clockwise). */
+    /**
+     * Returns the row-major 3x3 affine transformation matrix that is used to transform the raw video frames before they
+     * are displayed. The raw frames are assumed to be placed with their top-left corner at the origin (0,0).
+     *
+     * Usually, this matrix models a rotation and a flip. Depending on the file, it may also contain a translation
+     * component. When displaying video, you should typically ignore the translation component and display the center of
+     * the transformed frame in the center of the viewport.
+     */
+    async getTransformationMatrix() {
+      return this._backing.getTransformationMatrix();
+    }
+    /**
+     * Returns the angle in degrees by which the track's frames should be rotated (clockwise). The rotation is
+     * applied before flipping.
+     */
     async getRotation() {
-      return this._backing.getRotation();
+      return extractRotationFromMatrix(await this._backing.getTransformationMatrix());
     }
     /**
      * The angle in degrees by which the track's frames should be rotated (clockwise).
      * @deprecated Use {@link InputVideoTrack.getRotation} instead.
      */
     get rotation() {
-      return requireSync(this._backing.getRotation(), "rotation", "getRotation");
+      return extractRotationFromMatrix(
+        requireSync(this._backing.getTransformationMatrix(), "rotation", "getRotation")
+      );
+    }
+    /**
+     * Returns whether the track's frames should be flipped horizontally (about the vertical axis), after rotation.
+     */
+    async getFlip() {
+      return matrixIsFlipped(await this._backing.getTransformationMatrix());
     }
     /**
      * Returns the width of the track's frames in square pixels, adjusted for pixel aspect ratio but before rotation.
@@ -25972,7 +26198,9 @@ var Mediabunny = (() => {
           return metadata;
         }
       }
-      const rotation = requireSync(this._backing.getRotation(), "displayWidth", "getDisplayWidth");
+      const rotation = extractRotationFromMatrix(
+        requireSync(this._backing.getTransformationMatrix(), "displayWidth", "getDisplayWidth")
+      );
       const value = rotation % 180 === 0 ? this._backing.getSquarePixelWidth() : this._backing.getSquarePixelHeight();
       return requireSync(value, "displayWidth", "getDisplayWidth");
     }
@@ -25997,7 +26225,9 @@ var Mediabunny = (() => {
           return metadata;
         }
       }
-      const rotation = requireSync(this._backing.getRotation(), "displayHeight", "getDisplayHeight");
+      const rotation = extractRotationFromMatrix(
+        requireSync(this._backing.getTransformationMatrix(), "displayHeight", "getDisplayHeight")
+      );
       const value = rotation % 180 === 0 ? this._backing.getSquarePixelHeight() : this._backing.getSquarePixelWidth();
       return requireSync(value, "displayHeight", "getDisplayHeight");
     }
@@ -28768,23 +28998,6 @@ var Mediabunny = (() => {
     if (nullTerminated) bytes2.push(0);
     return bytes2;
   };
-  var rotationMatrix = (rotationInDegrees) => {
-    const theta = rotationInDegrees * (Math.PI / 180);
-    const cosTheta = Math.round(Math.cos(theta));
-    const sinTheta = Math.round(Math.sin(theta));
-    return [
-      cosTheta,
-      sinTheta,
-      0,
-      -sinTheta,
-      cosTheta,
-      0,
-      0,
-      0,
-      1
-    ];
-  };
-  var IDENTITY_MATRIX = /* @__PURE__ */ rotationMatrix(0);
   var matrixToBytes = (matrix) => {
     return [
       fixed_16_16(matrix[0]),
@@ -28944,26 +29157,6 @@ var Mediabunny = (() => {
       // Next track ID
     ]);
   };
-  var presentationSpan = (trackData) => {
-    if (trackData.samples.length === 0) {
-      return 0;
-    }
-    let minTimestamp = Infinity;
-    let maxEndTimestamp = -Infinity;
-    for (let i = 0; i < trackData.samples.length; i++) {
-      const sample = trackData.samples[i];
-      if (sample.timestamp < minTimestamp) {
-        minTimestamp = sample.timestamp;
-      }
-      if (sample.timestamp + sample.duration > maxEndTimestamp) {
-        maxEndTimestamp = sample.timestamp + sample.duration;
-      }
-    }
-    if (minTimestamp === Infinity) {
-      return 0;
-    }
-    return maxEndTimestamp - minTimestamp;
-  };
   var trak = (trackData, creationTime) => {
     const trackMetadata = getTrackMetadata(trackData);
     const needsEditList = trackData.startTimestampOffset !== null && trackData.startTimestampOffset !== 0;
@@ -28987,9 +29180,15 @@ var Mediabunny = (() => {
     const needsU64 = !isU32(creationTime) || !isU32(durationInGlobalTimescale);
     const u32OrU64 = needsU64 ? u64 : u32;
     let matrix;
-    if (trackData.type === "video") {
-      const rotation = trackData.track.metadata.rotation;
-      matrix = rotationMatrix(rotation ?? 0);
+    if (trackData.type === "video" && trackData.track.metadata.transformationMatrix) {
+      matrix = trackData.track.metadata.transformationMatrix;
+    } else if (trackData.type === "video") {
+      const { rotation, flip } = trackData.track.metadata;
+      const linear = multiplyMatrices(
+        rotationMatrix(rotation ?? 0),
+        scaleMatrix(flip ? -1 : 1, 1)
+      );
+      matrix = centeredTransformationMatrix(linear, trackData.info.width, trackData.info.height);
     } else {
       matrix = IDENTITY_MATRIX;
     }
@@ -29248,8 +29447,22 @@ var Mediabunny = (() => {
   ], [
     VIDEO_CODEC_TO_CONFIGURATION_BOX[trackData.track.source._codec]?.(trackData) ?? null,
     pasp(trackData),
-    colorSpaceIsEmpty(trackData.info.decoderConfig.colorSpace) ? null : colr(trackData)
+    colorSpaceIsEmpty(trackData.info.decoderConfig.colorSpace) ? null : colr(trackData),
+    btrt(trackData)
   ]);
+  var btrt = (trackData) => {
+    if (trackData.avgBitrate === 0 && trackData.maxBitrate === 0) {
+      return null;
+    }
+    return box("btrt", [
+      u32(0),
+      // Decoding buffer size (unknown)
+      u32(trackData.maxBitrate),
+      // Max bitrate
+      u32(trackData.avgBitrate)
+      // Average bitrate
+    ]);
+  };
   var pasp = (trackData) => {
     if (trackData.info.pixelAspectRatio.num === trackData.info.pixelAspectRatio.den) {
       return null;
@@ -29403,7 +29616,8 @@ var Mediabunny = (() => {
       ];
     }
     return box(compressionType, contents, [
-      audioCodecToConfigurationBox(trackData.track.source._codec, trackData.muxer.isQuickTime)?.(trackData) ?? null
+      audioCodecToConfigurationBox(trackData.track.source._codec, trackData.muxer.isQuickTime)?.(trackData) ?? null,
+      btrt(trackData)
     ]);
   };
   var esds = (trackData) => {
@@ -29437,9 +29651,9 @@ var Mediabunny = (() => {
       // stream type(6bits)=5 audio, flags(2bits)=1
       ...u24(0),
       // 24bit buffer size
-      ...u32(0),
+      ...u32(trackData.maxBitrate),
       // max bitrate
-      ...u32(0)
+      ...u32(trackData.avgBitrate)
       // avg bitrate
     ];
     if (trackData.info.decoderConfig.description) {
@@ -29627,7 +29841,8 @@ var Mediabunny = (() => {
     u16(1)
     // Data reference index
   ], [
-    SUBTITLE_CODEC_TO_CONFIGURATION_BOX[trackData.track.source._codec](trackData)
+    SUBTITLE_CODEC_TO_CONFIGURATION_BOX[trackData.track.source._codec](trackData),
+    btrt(trackData)
   ]);
   var vttC = (trackData) => box("vttC", [
     ...textEncoder.encode(trackData.info.config.description)
@@ -31062,6 +31277,26 @@ var Mediabunny = (() => {
     const value = timeInSeconds * timescale;
     return round ? Math.round(value) : value;
   };
+  var presentationSpan = (trackData) => {
+    if (trackData.samples.length === 0) {
+      return 0;
+    }
+    let minTimestamp = Infinity;
+    let maxEndTimestamp = -Infinity;
+    for (let i = 0; i < trackData.samples.length; i++) {
+      const sample = trackData.samples[i];
+      if (sample.timestamp < minTimestamp) {
+        minTimestamp = sample.timestamp;
+      }
+      if (sample.timestamp + sample.duration > maxEndTimestamp) {
+        maxEndTimestamp = sample.timestamp + sample.duration;
+      }
+    }
+    if (minTimestamp === Infinity) {
+      return 0;
+    }
+    return maxEndTimestamp - minTimestamp;
+  };
   var IsobmffMuxer2 = class extends Muxer {
     constructor(output, format) {
       super(output);
@@ -31275,7 +31510,9 @@ var Mediabunny = (() => {
         finalizedChunks: [],
         currentChunk: null,
         compactlyCodedChunkTable: [],
-        closed: false
+        closed: false,
+        avgBitrate: track.source._nominalBitrate ?? track.metadata.averageBitrate ?? 0,
+        maxBitrate: track.source._nominalBitrate ?? track.metadata.bitrate ?? 0
       };
       this.trackDatas.push(newTrackData);
       this.trackDatas.sort((a, b) => a.track.id - b.track.id);
@@ -31349,7 +31586,9 @@ var Mediabunny = (() => {
         finalizedChunks: [],
         currentChunk: null,
         compactlyCodedChunkTable: [],
-        closed: false
+        closed: false,
+        avgBitrate: track.source._nominalBitrate ?? track.metadata.averageBitrate ?? 0,
+        maxBitrate: track.source._nominalBitrate ?? track.metadata.bitrate ?? 0
       };
       this.trackDatas.push(newTrackData);
       this.trackDatas.sort((a, b) => a.track.id - b.track.id);
@@ -31387,6 +31626,8 @@ var Mediabunny = (() => {
         currentChunk: null,
         compactlyCodedChunkTable: [],
         closed: false,
+        avgBitrate: track.source._nominalBitrate ?? track.metadata.averageBitrate ?? 0,
+        maxBitrate: track.source._nominalBitrate ?? track.metadata.bitrate ?? 0,
         lastCueEndTimestamp: null,
         cueQueue: [],
         nextSourceId: 0,
@@ -32052,6 +32293,29 @@ var Mediabunny = (() => {
       } else {
         for (const trackData of this.trackDatas) {
           await this.finalizeCurrentChunk(trackData);
+          const span = presentationSpan(trackData);
+          if (span > 0) {
+            let totalBytes = 0;
+            for (const sample of trackData.samples) {
+              totalBytes += sample.size;
+            }
+            trackData.avgBitrate = Math.round(8 * totalBytes / span);
+          } else {
+            trackData.avgBitrate = 0;
+          }
+          let windowStart = 0;
+          let windowBytes = 0;
+          let maxWindowBytes = 0;
+          for (let i = 0; i < trackData.samples.length; i++) {
+            const sample = trackData.samples[i];
+            windowBytes += sample.size;
+            while (sample.decodeTimestamp - trackData.samples[windowStart].decodeTimestamp >= 1) {
+              windowBytes -= trackData.samples[windowStart].size;
+              windowStart++;
+            }
+            maxWindowBytes = Math.max(maxWindowBytes, windowBytes);
+          }
+          trackData.maxBitrate = 8 * maxWindowBytes;
           if (trackData.startTimestampOffset !== null) {
             for (let i = 0; i < trackData.samples.length; i++) {
               const sample = trackData.samples[i];
@@ -32350,14 +32614,34 @@ var Mediabunny = (() => {
       }
     }
     videoSpecificTrackInfo(trackData) {
-      const { frameRate, rotation } = trackData.track.metadata;
+      const { frameRate, transformationMatrix } = trackData.track.metadata;
       const elements = [
         frameRate ? {
           id: 2352003 /* DefaultDuration */,
           data: 1e9 / frameRate
         } : null
       ];
-      const flippedRotation = rotation ? normalizeRotation(-rotation) : 0;
+      let rotation;
+      let horizontalScale;
+      let verticalScale;
+      if (transformationMatrix) {
+        rotation = extractRotationFromMatrix(transformationMatrix);
+        const unrotated = multiplyMatrices(rotationMatrix(-rotation), transformationMatrix);
+        horizontalScale = Math.sign(unrotated[0]);
+        verticalScale = Math.sign(unrotated[4]);
+        if (verticalScale === -1) {
+          verticalScale = 1;
+          horizontalScale = -horizontalScale;
+          rotation = normalizeRotation(rotation + 180);
+        }
+      } else {
+        rotation = trackData.track.metadata.rotation ?? 0;
+        horizontalScale = trackData.track.metadata.flip ? -1 : 1;
+        verticalScale = 1;
+      }
+      const roll = rotation ? normalizeRotation(horizontalScale === -1 ? rotation : -rotation) : 0;
+      const yaw = Math.round(Math.acos(horizontalScale) * RAD_TO_DEG);
+      const pitch = Math.round(Math.acos(verticalScale) * RAD_TO_DEG);
       const hasNonSquarePixelAspectRatio = !!trackData.info.aspectRatio && trackData.info.aspectRatio.num * trackData.info.height !== trackData.info.aspectRatio.den * trackData.info.width;
       const colorSpace = trackData.info.decoderConfig.colorSpace;
       const videoElement = { id: 224 /* Video */, data: [
@@ -32389,7 +32673,7 @@ var Mediabunny = (() => {
             }
           ]
         },
-        flippedRotation ? {
+        roll || yaw || pitch ? {
           id: 30320 /* Projection */,
           data: [
             {
@@ -32397,11 +32681,19 @@ var Mediabunny = (() => {
               data: 0
               // rectangular
             },
-            {
+            yaw ? {
+              id: 30323 /* ProjectionPoseYaw */,
+              data: new EBMLFloat32(yaw)
+            } : null,
+            pitch ? {
+              id: 30324 /* ProjectionPosePitch */,
+              data: new EBMLFloat32(pitch)
+            } : null,
+            roll ? {
               id: 30325 /* ProjectionPoseRoll */,
-              data: new EBMLFloat32((flippedRotation + 180) % 360 - 180)
+              data: new EBMLFloat32((roll + 180) % 360 - 180)
               // [0, 270] -> [-180, 90]
-            }
+            } : null
           ]
         } : null
       ] };
@@ -34848,6 +35140,11 @@ ${cue.notes ?? ""}`;
       this._closingPromise = null;
       /** @internal */
       this._closed = false;
+      /**
+       * Set when the encoder is configured with a bitrate.
+       * @internal
+       */
+      this._nominalBitrate = null;
     }
     /** @internal */
     _ensureValidAdd() {
@@ -35024,7 +35321,7 @@ ${cue.notes ?? ""}`;
           this.codedWidth = videoSample.codedWidth;
           this.codedHeight = videoSample.codedHeight;
         }
-        const hasTransformConfig = config.transform?.width !== void 0 || config.transform?.height !== void 0 || config.transform?.rotate !== void 0 || config.transform?.crop !== void 0 || config.transform?.force === true;
+        const hasTransformConfig = config.transform?.width !== void 0 || config.transform?.height !== void 0 || config.transform?.rotate !== void 0 || config.transform?.flip !== void 0 || config.transform?.crop !== void 0 || config.transform?.force === true;
         const needsTransform = hasTransformConfig || isSizeChange && sizeChangeBehavior !== "passThrough";
         if (needsTransform) {
           let targetWidth = config.transform?.width;
@@ -35044,6 +35341,7 @@ ${cue.notes ?? ""}`;
             roundDimensionsTo: 2,
             crop: config.transform?.crop,
             rotate: config.transform?.rotate,
+            flip: config.transform?.flip,
             fit: appliedFit,
             alpha: config.alpha
           });
@@ -35338,6 +35636,8 @@ ${cue.notes ?? ""}`;
             this.encodingConfig.codec,
             selected.quantizer
           );
+        } else {
+          this.source._nominalBitrate = encoderConfig.bitrate ?? null;
         }
         if (MatchingCustomEncoder) {
           this.customEncoder = new MatchingCustomEncoder();
@@ -36008,39 +36308,42 @@ ${cue.notes ?? ""}`;
     }
     /** @internal */
     async _flushAndClose(forceClose) {
-      if (this._abortController) {
-        this._abortController.abort();
-        this._abortController = null;
-      }
-      if (this._timerHandle) {
-        clearIntervalUnthrottled(this._timerHandle);
-      }
-      this._lastVideoFrame?.close();
-      if (this._videoElement) {
-        this._videoElement.srcObject = null;
-        this._videoElement.remove();
-        this._videoElement = null;
-      }
-      if (this._workerTrackId !== null) {
-        assert(this._workerListener);
-        sendMessageToMediaStreamTrackProcessorWorker({
-          type: "stopTrack",
-          trackId: this._workerTrackId
-        });
-        await new Promise((resolve) => {
-          const listener = (event) => {
-            const message = event.data;
-            if (message.type === "trackStopped" && message.trackId === this._workerTrackId) {
-              assert(this._workerListener);
-              mediaStreamTrackProcessorWorker.removeEventListener("message", this._workerListener);
-              mediaStreamTrackProcessorWorker.removeEventListener("message", listener);
-              resolve();
-            }
-          };
-          mediaStreamTrackProcessorWorker.addEventListener("message", listener);
-        });
+      try {
+        if (this._abortController) {
+          this._abortController.abort();
+          this._abortController = null;
+        }
+        if (this._timerHandle) {
+          clearIntervalUnthrottled(this._timerHandle);
+        }
+        this._lastVideoFrame?.close();
+        if (this._videoElement) {
+          this._videoElement.srcObject = null;
+          this._videoElement.remove();
+          this._videoElement = null;
+        }
+        if (this._workerTrackId !== null) {
+          assert(this._workerListener);
+          sendMessageToMediaStreamTrackProcessorWorker({
+            type: "stopTrack",
+            trackId: this._workerTrackId
+          });
+          await new Promise((resolve) => {
+            const listener = (event) => {
+              const message = event.data;
+              if (message.type === "trackStopped" && message.trackId === this._workerTrackId) {
+                assert(this._workerListener);
+                mediaStreamTrackProcessorWorker.removeEventListener("message", this._workerListener);
+                mediaStreamTrackProcessorWorker.removeEventListener("message", listener);
+                resolve();
+              }
+            };
+            mediaStreamTrackProcessorWorker.addEventListener("message", listener);
+          });
+        }
+      } finally {
+        await this._encoder.flushAndClose(forceClose);
       }
-      await this._encoder.flushAndClose(forceClose);
     }
   };
   var AudioSource = class extends MediaSource {
@@ -36343,6 +36646,7 @@ ${cue.notes ?? ""}`;
           quality
         });
         this.encodingConfig.onEncoderConfig?.(encoderConfig);
+        this.source._nominalBitrate = encoderConfig.bitrate ?? null;
         const MatchingCustomEncoder = customAudioEncoders.find((x) => x.supports(
           this.encodingConfig.codec,
           encoderConfig
@@ -36787,16 +37091,19 @@ ${cue.notes ?? ""}`;
     }
     /** @internal */
     async _flushAndClose(forceClose) {
-      if (this._abortController) {
-        this._abortController.abort();
-        this._abortController = null;
-      }
-      if (this._audioContext) {
-        assert(this._scriptProcessorNode);
-        this._scriptProcessorNode.disconnect();
-        await this._audioContext.suspend();
+      try {
+        if (this._abortController) {
+          this._abortController.abort();
+          this._abortController = null;
+        }
+        if (this._audioContext) {
+          assert(this._scriptProcessorNode);
+          this._scriptProcessorNode.disconnect();
+          await this._audioContext.suspend();
+        }
+      } finally {
+        await this._encoder.flushAndClose(forceClose);
       }
-      await this._encoder.flushAndClose(forceClose);
     }
   };
   var mediaStreamTrackProcessorWorkerCode = () => {
@@ -37173,13 +37480,13 @@ ${cue.notes ?? ""}`;
         const codecs = [];
         let videoCount = 0;
         let audioCount = 0;
-        let requiresRotationMetadata = false;
+        let requiresTransformationMetadata = false;
         let candidate = null;
         let candidateScore = -Infinity;
         for (const track of tracks) {
           if (track.isVideoTrack()) {
             videoCount++;
-            requiresRotationMetadata ||= (track.metadata.rotation ?? 0) !== 0;
+            requiresTransformationMetadata ||= (track.metadata.rotation ?? 0) !== 0 || !!track.metadata.flip || !!track.metadata.transformationMatrix;
           } else if (track.isAudioTrack()) {
             audioCount++;
           }
@@ -37198,7 +37505,7 @@ ${cue.notes ?? ""}`;
             continue;
           }
           let score = 0;
-          if (requiresRotationMetadata && format.supportsVideoRotationMetadata) {
+          if (requiresTransformationMetadata && format.supportsVideoTransformationMetadata) {
             score++;
           }
           if (score > candidateScore) {
@@ -38126,6 +38433,13 @@ ${cue.notes ?? ""}`;
 
   // src/output-format.ts
   var OutputFormat = class {
+    /**
+     * Whether this output format supports video rotation metadata.
+     * @deprecated Use {@link OutputFormat.supportsVideoTransformationMetadata} instead.
+     */
+    get supportsVideoRotationMetadata() {
+      return this.supportsVideoTransformationMetadata;
+    }
     /** Returns a list of video codecs that this output format can contain. */
     getSupportedVideoCodecs() {
       return this.getSupportedCodecs().filter((codec) => VIDEO_CODECS.includes(codec));
@@ -38191,7 +38505,7 @@ ${cue.notes ?? ""}`;
         total: { min: 0, max }
       };
     }
-    get supportsVideoRotationMetadata() {
+    get supportsVideoTransformationMetadata() {
       return true;
     }
     get supportsTimestampedMediaData() {
@@ -38368,7 +38682,7 @@ ${cue.notes ?? ""}`;
         ...SUBTITLE_CODECS
       ];
     }
-    get supportsVideoRotationMetadata() {
+    get supportsVideoTransformationMetadata() {
       return false;
     }
     get supportsTimestampedMediaData() {
@@ -38448,7 +38762,7 @@ ${cue.notes ?? ""}`;
     getSupportedCodecs() {
       return ["mp3"];
     }
-    get supportsVideoRotationMetadata() {
+    get supportsVideoTransformationMetadata() {
       return false;
     }
     get supportsTimestampedMediaData() {
@@ -38505,7 +38819,7 @@ ${cue.notes ?? ""}`;
         )
       ];
     }
-    get supportsVideoRotationMetadata() {
+    get supportsVideoTransformationMetadata() {
       return false;
     }
     get supportsTimestampedMediaData() {
@@ -38558,7 +38872,7 @@ ${cue.notes ?? ""}`;
         ...AUDIO_CODECS.filter((codec) => ["vorbis", "opus"].includes(codec))
       ];
     }
-    get supportsVideoRotationMetadata() {
+    get supportsVideoTransformationMetadata() {
       return false;
     }
     get supportsTimestampedMediaData() {
@@ -38605,7 +38919,7 @@ ${cue.notes ?? ""}`;
     getSupportedCodecs() {
       return ["aac"];
     }
-    get supportsVideoRotationMetadata() {
+    get supportsVideoTransformationMetadata() {
       return false;
     }
     get supportsTimestampedMediaData() {
@@ -38652,7 +38966,7 @@ ${cue.notes ?? ""}`;
     getSupportedCodecs() {
       return ["flac"];
     }
-    get supportsVideoRotationMetadata() {
+    get supportsVideoTransformationMetadata() {
       return false;
     }
     get supportsTimestampedMediaData() {
@@ -38705,7 +39019,7 @@ ${cue.notes ?? ""}`;
         ...AUDIO_CODECS.filter((codec) => ["aac", "mp3", "ac3", "eac3", "dts"].includes(codec))
       ];
     }
-    get supportsVideoRotationMetadata() {
+    get supportsVideoTransformationMetadata() {
       return false;
     }
     get supportsTimestampedMediaData() {
@@ -38801,8 +39115,8 @@ ${cue.notes ?? ""}`;
         total: { min: 0, max: Infinity }
       };
     }
-    get supportsVideoRotationMetadata() {
-      return toArray(this._options.segmentFormat).some((format) => format.supportsVideoRotationMetadata);
+    get supportsVideoTransformationMetadata() {
+      return toArray(this._options.segmentFormat).some((format) => format.supportsVideoTransformationMetadata);
     }
     get supportsTimestampedMediaData() {
       return true;
@@ -38935,6 +39249,12 @@ ${cue.notes ?? ""}`;
     if (metadata.maximumPacketCount !== void 0 && (!Number.isInteger(metadata.maximumPacketCount) || metadata.maximumPacketCount < 0)) {
       throw new TypeError("metadata.maximumPacketCount, when provided, must be a non-negative integer.");
     }
+    if (metadata.bitrate !== void 0 && (!Number.isFinite(metadata.bitrate) || metadata.bitrate < 0)) {
+      throw new TypeError("metadata.bitrate, when provided, must be a non-negative number.");
+    }
+    if (metadata.averageBitrate !== void 0 && (!Number.isFinite(metadata.averageBitrate) || metadata.averageBitrate < 0)) {
+      throw new TypeError("metadata.averageBitrate, when provided, must be a non-negative number.");
+    }
     if (metadata.group !== void 0 && !(metadata.group instanceof OutputTrackGroup) && (!Array.isArray(metadata.group) || metadata.group.some((group) => !(group instanceof OutputTrackGroup)))) {
       throw new TypeError(
         "metadata.group, when provided, must be an OutputTrackGroup instance or an array of OutputTrackGroup instances."
@@ -39134,8 +39454,11 @@ ${cue.notes ?? ""}`;
       if (metadata.rotation !== void 0 && ![0, 90, 180, 270].includes(metadata.rotation)) {
         throw new TypeError(`Invalid video rotation: ${metadata.rotation}. Has to be 0, 90, 180 or 270.`);
       }
-      if (!this.format.supportsVideoRotationMetadata && metadata.rotation) {
-        throw new Error(`${this.format._name} does not support video rotation metadata.`);
+      if (metadata.flip !== void 0 && typeof metadata.flip !== "boolean") {
+        throw new TypeError("metadata.flip, when provided, must be a boolean.");
+      }
+      if (metadata.transformationMatrix !== void 0 && (!Array.isArray(metadata.transformationMatrix) || metadata.transformationMatrix.length !== 9 || !metadata.transformationMatrix.every((x) => Number.isFinite(x)))) {
+        throw new TypeError("metadata.transformationMatrix, when provided, must be an array of 9 finite numbers.");
       }
       if (metadata.frameRate !== void 0 && (!Number.isFinite(metadata.frameRate) || metadata.frameRate <= 0)) {
         throw new TypeError(
@@ -39361,9 +39684,8 @@ ${cue.notes ?? ""}`;
      * @returns A promise that resolves once all internal resources have been released.
      */
     async cancel() {
-      if (this._cancelPromise) {
-        Logging._warn("Output has already been canceled.");
-        return this._cancelPromise;
+      if (this.state === "canceled") {
+        return this._cancelPromise ?? void 0;
       } else if (this.state === "finalizing" || this.state === "finalized") {
         if (this.state === "finalized") {
           Logging._warn("Output has already been finalized.");
@@ -39416,6 +39738,9 @@ ${cue.notes ?? ""}`;
             await this._onFinalize();
           }
           this.state = "finalized";
+        } catch (error) {
+          this.state = "canceled";
+          throw error;
         } finally {
           await Promise.all([...this._unfinalizedTargets].map((target) => target._close().catch(() => {
           })));
@@ -39469,6 +39794,12 @@ ${cue.notes ?? ""}`;
     if (videoOptions?.rotate !== void 0 && ![0, 90, 180, 270].includes(videoOptions.rotate)) {
       throw new TypeError("options.video.rotate, when provided, must be 0, 90, 180 or 270.");
     }
+    if (videoOptions?.flip !== void 0 && typeof videoOptions.flip !== "boolean") {
+      throw new TypeError("options.video.flip, when provided, must be a boolean.");
+    }
+    if (videoOptions?.allowTransformationMetadata !== void 0 && typeof videoOptions.allowTransformationMetadata !== "boolean") {
+      throw new TypeError("options.video.allowTransformationMetadata, when provided, must be a boolean.");
+    }
     if (videoOptions?.allowRotationMetadata !== void 0 && typeof videoOptions.allowRotationMetadata !== "boolean") {
       throw new TypeError("options.video.allowRotationMetadata, when provided, must be a boolean.");
     }
@@ -40138,9 +40469,17 @@ The @mediabunny/mp3-encoder extension package provides support for encoding MP3.
       }
       let videoSource;
       const innateRotation = await track.getRotation();
-      const totalRotation = normalizeRotation(innateRotation + (trackOptions.rotate ?? 0));
+      const innateFlip = await track.getFlip();
+      const { rotation: totalRotation, flip: totalFlip } = composeRotationAndFlip(
+        innateRotation,
+        innateFlip,
+        trackOptions.rotate ?? 0,
+        trackOptions.flip ?? false
+      );
       let outputTrackRotation = totalRotation;
-      const canUseRotationMetadata = this.output.format.supportsVideoRotationMetadata && (trackOptions.allowRotationMetadata ?? true);
+      let outputTrackFlip = totalFlip;
+      let outputTrackMatrix = trackOptions.rotate || trackOptions.flip ? null : await track.getTransformationMatrix();
+      const canUseRotationMetadata = this.output.format.supportsVideoTransformationMetadata && (trackOptions.allowTransformationMetadata ?? trackOptions.allowRotationMetadata ?? true);
       const squarePixelWidth = await track.getSquarePixelWidth();
       const squarePixelHeight = await track.getSquarePixelHeight();
       const [rotatedWidth, rotatedHeight] = totalRotation % 180 === 0 ? [squarePixelWidth, squarePixelHeight] : [squarePixelHeight, squarePixelWidth];
@@ -40164,7 +40503,7 @@ The @mediabunny/mp3-encoder extension package provides support for encoding MP3.
       }
       let videoCodecs = this.output.format.getSupportedVideoCodecs();
       const alpha = trackOptions.alpha ?? "discard";
-      let needsTranscode = !this._copyMode || !!trackOptions.forceTranscode || !!trackOptions.frameRate || trackOptions.keyFrameInterval !== void 0 || trackOptions.process !== void 0 || trackOptions.quality !== void 0 || trackOptions.bitrate !== void 0 || !videoCodecs.includes(sourceCodec) || trackOptions.codec && trackOptions.codec !== sourceCodec || width !== originalWidth || height !== originalHeight || totalRotation !== 0 && !canUseRotationMetadata || !!crop;
+      let needsTranscode = !this._copyMode || !!trackOptions.forceTranscode || !!trackOptions.frameRate || trackOptions.keyFrameInterval !== void 0 || trackOptions.process !== void 0 || trackOptions.quality !== void 0 || trackOptions.bitrate !== void 0 || !videoCodecs.includes(sourceCodec) || trackOptions.codec && trackOptions.codec !== sourceCodec || width !== originalWidth || height !== originalHeight || totalRotation !== 0 && !canUseRotationMetadata || totalFlip && !canUseRotationMetadata || !!crop;
       let copyStartPacket = null;
       if (!needsTranscode) {
         const sink = new EncodedPacketSink(track);
@@ -40318,7 +40657,7 @@ The @mediabunny/mp3-encoder extension package provides support for encoding MP3.
           transform: {}
         };
         assert(encodingConfig.transform);
-        let needsRerender = width !== originalWidth || height !== originalHeight || totalRotation !== 0 && (!canUseRotationMetadata || trackOptions.process !== void 0) || !!crop || squarePixelWidth !== await track.getCodedWidth() || squarePixelHeight !== await track.getCodedHeight();
+        let needsRerender = width !== originalWidth || height !== originalHeight || totalRotation !== 0 && (!canUseRotationMetadata || trackOptions.process !== void 0) || totalFlip && (!canUseRotationMetadata || trackOptions.process !== void 0) || !!crop || squarePixelWidth !== await track.getCodedWidth() || squarePixelHeight !== await track.getCodedHeight();
         if (!needsRerender) {
           var _stack = [];
           try {
@@ -40363,10 +40702,13 @@ The @mediabunny/mp3-encoder extension package provides support for encoding MP3.
         }
         if (needsRerender) {
           outputTrackRotation = 0;
+          outputTrackFlip = false;
+          outputTrackMatrix = null;
           encodingConfig.transform.width = width;
           encodingConfig.transform.height = height;
           encodingConfig.transform.fit = trackOptions.fit ?? "fill";
-          encodingConfig.transform.rotate = normalizeRotation(totalRotation - innateRotation);
+          encodingConfig.transform.rotate = trackOptions.rotate;
+          encodingConfig.transform.flip = trackOptions.flip;
           encodingConfig.transform.crop = crop;
           encodingConfig.transform.alpha = alpha;
         }
@@ -40418,6 +40760,8 @@ The @mediabunny/mp3-encoder extension package provides support for encoding MP3.
       const videoTrackLanguageCode = await track.getLanguageCode();
       const trackName = await track.getName();
       const trackDisposition = await track.getDisposition();
+      const bitrate = needsTranscode ? null : await track.getBitrate();
+      const averageBitrate = needsTranscode ? null : await track.getAverageBitrate();
       this.output.addVideoTrack(videoSource, {
         frameRate: trackOptions.frameRate,
         // TODO: This condition can be removed when all demuxers properly homogenize to BCP47 in v2
@@ -40425,7 +40769,11 @@ The @mediabunny/mp3-encoder extension package provides support for encoding MP3.
         name: trackName ?? void 0,
         disposition: trackDisposition,
         rotation: outputTrackRotation,
-        group: ownGroup ?? trackOptions.group
+        flip: outputTrackFlip,
+        transformationMatrix: outputTrackMatrix ?? void 0,
+        group: ownGroup ?? trackOptions.group,
+        bitrate: bitrate ?? void 0,
+        averageBitrate: averageBitrate ?? void 0
       });
       this.utilizedTracks.push(track);
       this._outputTrackIds.push(outputTrackId);
@@ -40709,12 +41057,16 @@ The @mediabunny/mp3-encoder extension package provides support for encoding MP3.
       const audioTrackLanguageCode = await track.getLanguageCode();
       const trackName = await track.getName();
       const trackDisposition = await track.getDisposition();
+      const bitrate = needsTranscode ? null : await track.getBitrate();
+      const averageBitrate = needsTranscode ? null : await track.getAverageBitrate();
       this.output.addAudioTrack(audioSource, {
         // TODO: This condition can be removed when all demuxers properly homogenize to BCP47 in v2
         languageCode: isIso639Dash2LanguageCode(audioTrackLanguageCode) ? audioTrackLanguageCode : void 0,
         name: trackName ?? void 0,
         disposition: trackDisposition,
-        group: ownGroup ?? trackOptions.group
+        group: ownGroup ?? trackOptions.group,
+        bitrate: bitrate ?? void 0,
+        averageBitrate: averageBitrate ?? void 0
       });
       this.utilizedTracks.push(track);
       this._outputTrackIds.push(outputTrackId);