Trim

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.

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.

bool  pad = true

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 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.

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(100,0)             # delete the first 100 frames, audio padded
                        # or trimmed to match the video length.

Trim(100,0,false)       # delete the first 100 frames of audio and video,
                        # the resulting stream lengths remain independent.

Trim(100,-100)          # is the same as trim(100,199) ie, start=100, duration=100

Trim(100,199,false)     # audio will be trimmed if longer but not
                        # padded if shorter to frame 199

Trim(0,-1)              # returns only the first frame
Trim(0,end=0)           #
Trim(0,length=1)        #

AudioTrim(1,5.5)        # keeps the audio samples between 1 and 5.5 seconds
AudioTrim(1,end=5.5)    #

AudioTrim(1,-5.5)       # cuts the first second and keeps the following 5.5 seconds
AudioTrim(1,length=5.5) #