Trim

The Trim config allows you to specify a smaller subsect of media to be rendered in your composition by specifying start and end attributes. For example, if you have a 3 minute song or video and only want to use the portion starting at 15.5 seconds through 20.1 seconds.

Interface

interface Trim {
  trim?: {
    // number of seconds from
    // the beginning of layer to trim off
    // defaults to 0
    start?: number;


    // number of seconds that
    // a layer should last
    // defaults to original media duration
    // or composition duration for media without duration
    end?: number;
  };
}

Configuring Trim

You can modify a layer's trim-related settings by passing a configuration object or by calling its setters. You can read the layer's trim-related settings by calling its getters

Configuration Object

const video = await composition.addVideo(
  "https://editframe.com/docs/layer-configuration/trim/drone-lagoon-short.mp4",
  {
    trim: {
      start: 1.5, // original video is 10 seconds
      end: 3.5,
    },
  }
);

Output

Setters

setTrim

const audio = await composition.addAudio(
  "https://editframe.com/docs/layer-configuration/trim/audio-example.mp3"
);


audio.setTrim(2.1, 3);

Output

Getters

audio.trim; // -> { start: 2.2, end: 5.1}