@remotion/media-utils 4.0.279 → 4.0.280

package/dist/get-partial-wave-data.js

@@ -5,15 +5,18 @@ const fetch_with_cors_catch_1 = require("./fetch-with-cors-catch");
 const probe_wave_file_1 = require("./probe-wave-file");
 const getPartialWaveData = async ({ dataOffset, src, bitsPerSample, channelIndex, sampleRate, fromSeconds, toSeconds, blockAlign, fileSize, signal, }) => {
     const startByte = dataOffset + Math.floor(fromSeconds * sampleRate) * blockAlign;
-    const endByte = Math.min(fileSize - 1, dataOffset + Math.floor(toSeconds * sampleRate - 1) * blockAlign);
+    const endByte = Math.min(fileSize, (dataOffset + Math.floor(toSeconds * sampleRate)) * blockAlign) - 1;
     const response = await (0, fetch_with_cors_catch_1.fetchWithCorsCatch)(src, {
         headers: {
             range: `bytes=${startByte}-${endByte}`,
         },
         signal,
     });
+    if (response.status === 416) {
+        throw new Error(`Tried to read bytes ${startByte}-${endByte} from ${src}, but the response status code was 416 "Range Not Satisfiable". Were too many bytes requested? The file is ${fileSize} bytes long.`);
+    }
     if (response.status !== 206) {
-        throw new Error(`Tried to read bytes ${startByte}-${endByte} from ${src}, but the response status code was not 206. This means the server might not support returning a partial response.`);
+        throw new Error(`Tried to read bytes ${startByte}-${endByte} from ${src}, but the response status code was ${response.status} (expected was 206). This means the server might not support returning a partial response.`);
     }
     const arrayBuffer = await response.arrayBuffer();
     const uintArray = new Uint8Array(arrayBuffer);

package/dist/get-wave-form-samples.d.ts

@@ -1,6 +1,7 @@
 export type SampleOutputRange = 'minus-one-to-one' | 'zero-to-one';
-export declare const getWaveformSamples: ({ audioBuffer, numberOfSamples, outputRange, }: {
+export declare const getWaveformSamples: ({ audioBuffer, numberOfSamples, outputRange, normalize, }: {
     audioBuffer: Float32Array;
     numberOfSamples: number;
     outputRange: SampleOutputRange;
+    normalize: boolean;
 }) => number[];

package/dist/get-wave-form-samples.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getWaveformSamples = void 0;
-const getWaveformSamples = ({ audioBuffer, numberOfSamples, outputRange, }) => {
+const normalize_data_1 = require("./normalize-data");
+const getWaveformSamples = ({ audioBuffer, numberOfSamples, outputRange, normalize, }) => {
     const blockSize = Math.floor(audioBuffer.length / numberOfSamples); // the number of samples in each subdivision
     if (blockSize === 0) {
         return [];
@@ -13,8 +14,26 @@ const getWaveformSamples = ({ audioBuffer, numberOfSamples, outputRange, }) => {
         for (let j = 0; j < blockSize; j++) {
             sum += Math.abs(audioBuffer[blockStart + j]); // find the sum of all the samples in the block
         }
-        filteredData.push((sum / blockSize) *
-            (i % 2 === 0 && outputRange === 'minus-one-to-one' ? -1 : 1)); // divide the sum by the block size to get the average
+        filteredData.push(sum / blockSize); // divide the sum by the block size to get the average
+    }
+    if (normalize) {
+        if (outputRange === 'minus-one-to-one') {
+            return (0, normalize_data_1.normalizeData)(filteredData).map((n, i) => {
+                if (i % 2 === 0) {
+                    return n * -1;
+                }
+                return n;
+            });
+        }
+        return (0, normalize_data_1.normalizeData)(filteredData);
+    }
+    if (outputRange === 'minus-one-to-one') {
+        return filteredData.map((n, i) => {
+            if (i % 2 === 0) {
+                return n * -1;
+            }
+            return n;
+        });
     }
     return filteredData;
 };

package/dist/get-waveform-portion.d.ts

@@ -12,6 +12,7 @@ export type GetWaveformPortion = {
     channel?: number;
     outputRange?: SampleOutputRange;
     dataOffsetInSeconds?: number;
+    normalize?: boolean;
 };
-export declare const getWaveformPortion: ({ audioData, startTimeInSeconds, durationInSeconds, numberOfSamples, channel, outputRange, dataOffsetInSeconds, }: GetWaveformPortion) => Bar[];
+export declare const getWaveformPortion: ({ audioData, startTimeInSeconds, durationInSeconds, numberOfSamples, channel, outputRange, dataOffsetInSeconds, normalize, }: GetWaveformPortion) => Bar[];
 export { Bar };

package/dist/get-waveform-portion.js

@@ -21,7 +21,7 @@ const concatArrays = (arrays) => {
  * @description Takes bulky waveform data (for example fetched by getAudioData()) and returns a trimmed and simplified version of it, for simpler visualization
  * @see [Documentation](https://remotion.dev/docs/get-waveform-portion)
  */
-const getWaveformPortion = ({ audioData, startTimeInSeconds, durationInSeconds, numberOfSamples, channel = 0, outputRange = 'zero-to-one', dataOffsetInSeconds, }) => {
+const getWaveformPortion = ({ audioData, startTimeInSeconds, durationInSeconds, numberOfSamples, channel = 0, outputRange = 'zero-to-one', dataOffsetInSeconds, normalize = true, }) => {
     (0, validate_channel_1.validateChannel)(channel, audioData.numberOfChannels);
     const waveform = audioData.channelWaveforms[channel];
     const startSample = Math.floor((startTimeInSeconds - (dataOffsetInSeconds !== null && dataOffsetInSeconds !== void 0 ? dataOffsetInSeconds : 0)) * audioData.sampleRate);
@@ -45,6 +45,7 @@ const getWaveformPortion = ({ audioData, startTimeInSeconds, durationInSeconds,
         audioBuffer,
         numberOfSamples,
         outputRange,
+        normalize,
     }).map((w, i) => {
         return {
             index: i,

package/dist/normalize-data.d.ts

@@ -0,0 +1 @@
+export declare const normalizeData: (filteredData: number[]) => number[];

package/dist/normalize-data.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeData = void 0;
+const normalizeData = (filteredData) => {
+    const max = Math.max(...filteredData);
+    const multiplier = max === 0 ? 0 : max ** -1;
+    return filteredData.map((n) => n * multiplier);
+};
+exports.normalizeData = normalizeData;

package/dist/probe-wave-file.js

@@ -37,8 +37,11 @@ const probeWaveFile = async (src) => {
             range: 'bytes=0-256',
         },
     });
+    if (response.status === 416) {
+        throw new Error(`Tried to read bytes 0-256 from ${src}, but the response status code was 416 "Range Not Satisfiable". Is the file at least 256 bytes long?`);
+    }
     if (response.status !== 206) {
-        throw new Error(`Tried to read bytes 0-256 from ${src}, but the response status code was not 206. This means the server might not support returning a partial response.`);
+        throw new Error(`Tried to read bytes 0-256 from ${src}, but the response status code was ${response.status} (expected was 206). This means the server might not support returning a partial response.`);
     }
     const buffer = await response.arrayBuffer();
     const uintArray = new Uint8Array(buffer);

package/dist/use-windowed-audio-data.js

@@ -55,7 +55,10 @@ const useWindowedAudioData = ({ src, frame, fps, windowInSeconds, channelIndex =
         if (!waveProbe) {
             return [];
         }
-        const maxWindowIndex = Math.floor(waveProbe.durationInSeconds / windowInSeconds);
+        const maxWindowIndex = Math.floor(
+        // If an audio is exactly divisible by windowInSeconds, we need to
+        // subtract 0.000000000001 to avoid fetching an extra window.
+        waveProbe.durationInSeconds / windowInSeconds - 0.000000000001);
         // needs to be in order because we rely on the concatenation below
         return [
             currentWindowIndex === 0 ? null : currentWindowIndex - 1,

package/dist/visualize-audio-waveform.d.ts

@@ -7,5 +7,6 @@ export type VisualizeAudioWaveformOptions = {
     numberOfSamples: number;
     channel?: number;
     dataOffsetInSeconds?: number;
+    normalize?: boolean;
 };
 export declare const visualizeAudioWaveform: (parameters: VisualizeAudioWaveformOptions) => number[];

package/dist/visualize-audio-waveform.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.visualizeAudioWaveform = void 0;
 const get_waveform_portion_1 = require("./get-waveform-portion");
 const cache = {};
-const visualizeAudioWaveformFrame = ({ audioData, frame, fps, numberOfSamples, windowInSeconds, channel, dataOffsetInSeconds, }) => {
+const visualizeAudioWaveformFrame = ({ audioData, frame, fps, numberOfSamples, windowInSeconds, channel, dataOffsetInSeconds, normalize = false, }) => {
     if (windowInSeconds * audioData.sampleRate < numberOfSamples) {
         throw new TypeError(windowInSeconds +
             's audiodata does not have ' +
@@ -29,6 +29,7 @@ const visualizeAudioWaveformFrame = ({ audioData, frame, fps, numberOfSamples, w
         outputRange: 'minus-one-to-one',
         channel,
         dataOffsetInSeconds,
+        normalize,
     });
 };
 const visualizeAudioWaveform = (parameters) => {

package/package.json

@@ -3,7 +3,7 @@
     "url": "https://github.com/remotion-dev/remotion/tree/main/packages/media-utils"
   },
   "name": "@remotion/media-utils",
-  "version": "4.0.279",
+  "version": "4.0.280",
   "description": "Utilities for working with media files",
   "main": "dist/index.js",
   "sideEffects": false,
@@ -13,7 +13,7 @@
     "url": "https://github.com/remotion-dev/remotion/issues"
   },
   "dependencies": {
-    "remotion": "4.0.279"
+    "remotion": "4.0.280"
   },
   "peerDependencies": {
     "react": ">=16.8.0",
@@ -21,7 +21,7 @@
   },
   "devDependencies": {
     "eslint": "9.19.0",
-    "@remotion/eslint-config-internal": "4.0.279"
+    "@remotion/eslint-config-internal": "4.0.280"
   },
   "keywords": [
     "remotion",