Trim

AviSynth+
Up-to-date documentation: https://avisynthplus.readthedocs.io

Trims a clip – removes frames from one or both ends.

Trim cannot trim a clip if there is no video. Use AudioTrim (from AviSynth v2.60) for that case; for versions prior to v2.60, you must AudioDub your audio-only clip to a video clip and Trim that.

The resulting clip starts with frame number 0, and this must be taken into account when making additional edits using that clip. To view a clip's frame number at any point in your script, temporarily insert an Info or ShowFrameNumber statement.

For convenience, Trim can be called in four slightly different ways:

Trim(clip, int first_frame, int last_frame [, bool pad] )

Returns a clip starting at first_frame and running up to and including last_frame.

• For example, Trim(3, 5) returns source clip frames 3, 4 and 5.
• Remember, AviSynth starts counting at frame 0.
• If you set last_frame to 0, you will get a clip starting at first_frame and running to the end of the clip.

 pad

True by default, pad causes the audio stream to be padded to align with the video stream. Otherwise the tail of a short audio stream is left so. You should use pad=false when the soundtracks being joined were originally contiguous – compare to UnalignedSplice.

Trim(clip, int first_frame, int -num_frames [, bool pad] )

With a negative value for the second argument, you get a clip starting at first_frame and running for num_frames frames.

• For example, Trim(0, -4) returns source clip frames 0, 1, 2 and 3.

Trim(clip, int first_frame, [int end , bool pad] )

Returns a clip starting at first_frame and running up to and including frame end. From Avisynth v2.60.

• For example, Trim(3, end=7) is equivalent to Trim(3, 7); both return frames 3, 4, 5, 6 and 7.
• end default = 0; must be >= first_frame.
• Unlike the last_frame syntax, the end syntax has no discontinuous boundary values: end=0 means end at frame 0. This feature is useful in avoiding unexpected boundary conditions in your user functions.

Trim(clip, int first_frame, [int length , bool pad] )

Returns a clip starting at first_frame and running for length frames. From Avisynth v2.60.

• For example, Trim(3, length=5) is equivalent to Trim(3, -5); both return frames 3, 4, 5, 6 and 7.
• length default = 0; must be >= 0.
• Unlike the num_frames syntax, the length syntax has no discontinuous boundary values: length=0 means return a zero length clip. This feature is useful in avoiding unexpected boundary conditions in your user functions.

AudioTrim (from Avisynth v2.60) trims a clip based on time, not on frames. This is most useful for audio-only clips, where "frames" have no meaning anyway, and you may want to edit with finer precision than whole frames (at 30fps, 1 frame=33.3ms).

All time arguments are in seconds, floating-point.

• Trims on audio-only clips are accurate to the nearest audio sample.
• Trims on clips with video are accurate to the nearest whole video frame.

AudioTrim cannot trim a clip if there is no audio. Use Trim for that case.

The resulting clip starts with time = 0.0, and this must be taken into account when making additional edits to that clip. To view a clip's time at any point in your script, temporarily insert an Info or ShowTime statement.

For convenience, AudioTrim can be called in four slightly different ways:

AudioTrim(clip, float start_time, float end_time)

Returns a clip starting at start_time and running up to and including time end_time.

• For example, AudioTrim(3.0, 5.0) returns source clip from time 00:00:03.000 to 00:00:05.000.
• If you set end_time to 0.0, you will get a clip starting at start_time seconds and running to the end of the clip.

AudioTrim(clip, float start_time, float -duration)

With a negative value for the second argument, you will get a clip starting at start_time and running for duration seconds.

• For example, AudioTrim(0.0, -4.0) returns the source clip from time 00:00:00.000 to 00:00:04.000.

AudioTrim(clip, float start_time [, float end] )

Returns a clip starting at start_time and running up to and including time end.

• For example, AudioTrim(3.0, end=7.0) is equivalent to AudioTrim(3.0, 7.0)
• end default = 0.0; must be >= start_time.
• Unlike the end_time syntax, the end syntax has no discontinuous boundary values: end=0.0 means return a zero length clip. This feature is useful in avoiding unexpected boundary conditions in your user functions.

AudioTrim(clip, float start_time [, float length] )

Returns a clip starting at start_time and running for length seconds.

• For example, AudioTrim(3.0, length=4.0) is equivalent to AudioTrim(3.0, -4.0)
• length default = 0.0; must be >= 0.
• Unlike the duration syntax, the length syntax has no discontinuous boundary values: length=0.0 means return a zero length clip. This feature is useful in avoiding unexpected boundary conditions in your user functions.

Trim(0, -1)
Trim(0, end=0)
Trim(0, length=1)

Trim(FrameCount, -1)
Trim(FrameCount, end=Framecount)
Trim(FrameCount, length=1)

Trim(100, 199)
Trim(100, -100)

Trim(100, 0) # (pad=true by default)

Trim(100, 0, pad=false)

Trim(0, FrameCount-1) 

Trim(100, 199, pad=false)

AudioTrim(0, AudioDuration)

(ie, delete the first second, keep the following 5.5 seconds)

AudioTrim(1, 6.5)       
AudioTrim(1, -5.5)       
AudioTrim(1, length=5.5)