Trim - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T04:50:21Z

add link to avs+ documentation

Reel.Deal: /* Examples */ add "return only the last frame" examples

2021-07-21T02:21:47Z

‎Examples: add "return only the last frame" examples

Raffriff42: re-phrase, still not happy

2016-04-30T21:00:13Z

re-phrase, still not happy

Raffriff42: /* AudioTrim */ new clip again starts at zero

2016-04-30T01:19:03Z

‎AudioTrim: new clip again starts at zero

Raffriff42: new clip again starts at zero

2016-04-29T13:08:56Z

new clip again starts at zero

Raffriff42: one more touch-up

2016-03-18T14:05:38Z

one more touch-up

Raffriff42: correction? audio always trimmed if longer

2016-03-18T14:02:40Z

correction? audio always trimmed if longer

Raffriff42: one more touch-up

2016-03-18T13:04:38Z

one more touch-up

Raffriff42: /* Examples */

2016-03-18T13:01:27Z

‎Examples

Raffriff42: link to ShowFrameNumber, ShowTime redux

2016-03-13T21:52:29Z

link to ShowFrameNumber, ShowTime redux

← Older revision		Revision as of 04:50, 18 September 2022
Line 1:		Line 1:
		+	<div {{BlueBox2\|40\|0\|3px solid purple}} >
		+	{{AvsPlusFullname}}<br>
		+	Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/trim.html https://avisynthplus.readthedocs.io]
		+	</div>
		+
		+
	== Trim ==		== Trim ==
	<div style="max-width:62em" >		<div style="max-width:62em" >

@@ Line 104: / Line 104: @@
   Trim(0, end=0)
   Trim(0, length=1)
 </div>
@@ Line 146: / Line 153: @@
   AudioTrim(1, length=5.5)
 </div>
 == Changes ==

@@ Line 5: / Line 5: @@
 '''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 '''Trim'''ed clip starts with frame number = '''zero'''. Keeping track of edits with multiple '''Trim''' statements can be difficult sometimes. To view the frame number that AviSynth sees at any point in your script, temporarily insert an [[Info]] or [[ShowFrameNumber]] statement.
+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.
@@ Line 59: / Line 59: @@
 '''AudioTrim''' cannot trim a clip if there is no audio. Use '''Trim''' for that case.
-The '''AudioTrim'''ed clip starts with time = '''zero'''. Keeping track of edits with multiple '''AudioTrim''' statements can be difficult sometimes. To view the time that AviSynth sees at any point in your script, temporarily insert an [[Info]] or [[ShowTime]] statement.
+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.

@@ Line 5: / Line 5: @@
 '''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''.
-After '''Trim'''ming, the new clip again starts with frame number and time = '''zero'''. To view the frame number or time at any point in your script, temporarily insert an [[Info]] or [[ShowFrameNumber]] statement.
+The '''Trim'''ed clip starts with frame number = '''zero'''. Keeping track of edits with multiple '''Trim''' statements can be difficult sometimes. To view the frame number that AviSynth sees at any point in your script, temporarily insert an [[Info]] or [[ShowFrameNumber]] statement.
@@ Line 59: / Line 59: @@
 '''AudioTrim''' cannot trim a clip if there is no audio. Use '''Trim''' for that case.
-For any non-trivial editing, in order to keep track of your edits you will want to use [[Info]] or [[ShowTime]] on the source clip.
+The '''AudioTrim'''ed clip starts with time = '''zero'''. Keeping track of edits with multiple '''AudioTrim''' statements can be difficult sometimes. To view the time that AviSynth sees at any point in your script, temporarily insert an [[Info]] or [[ShowTime]] statement.

← Older revision		Revision as of 13:08, 29 April 2016
Line 5:		Line 5:
	'''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''.		'''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 any non-trivial editing~~, in ~~order to keep track of~~ your ~~edits you will want to use~~ [[Info]] or [[ShowFrameNumber]] ~~on the source clip~~.	+	After '''Trim'''ming, the new clip again starts with frame number and time = '''zero'''. To view the frame number or time at any point in your script, temporarily insert an [[Info]] or [[ShowFrameNumber]] statement.

@@ Line 122: / Line 122: @@
 </div>
-* Trim audio if longer than video
+* Trim audio if longer than video ({{FuncArg|pad}} does affect this action)
 <div {{BoxWidthIndent|26|2}} >
-  Trim(0, FrameCount-1) ## ''pad'' does not matter
+  Trim(0, FrameCount-1)
 </div>

@@ Line 117: / Line 117: @@
 </div>
-* Delete the first 100 frames of audio and video; the resulting stream lengths remain independent.
+* Delete the first 100 frames of audio and video; the resulting stream lengths remain independent.{{Dubious|Talk:Trim}}
 <div {{BoxWidthIndent|26|2}} >
   Trim(100, 0, pad=false)
@@ Line 124: / Line 124: @@
 * Trim audio if longer than video
 <div {{BoxWidthIndent|26|2}} >
-  Trim(0, FrameCount-1, pad=false)
+  Trim(0, FrameCount-1) ## ''pad'' does not matter
 </div>

@@ Line 137: / Line 137: @@
 </div>
-* AudioTrim: keep the audio between 1.0 and 5.5 seconds
+* AudioTrim: keep the audio between 1.0 and 6.5 seconds
-<div {{BoxWidthIndent|26|2}} >
+<div {{ListItemContinue}} >
- AudioTrim(1, 5.5)
+(ie, delete the first second, keep the following 5.5 seconds)
- AudioTrim(1, end=5.5)
 </div>
 <div {{BoxWidthIndent|26|2}} >
   AudioTrim(1, 6.5)

@@ Line 19: / Line 19: @@
 :*If you set {{FuncArg|last_frame}} to 0, you will get a clip starting at {{FuncArg|first_frame}} and running to the end of the clip.
-:{{Par2|pad|bool|true}}
+{{Par2h5|pad|bool|true}}
-:True by default, {{FuncArg|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 {{FuncArg|pad}}=false when the soundtracks being joined were originally contiguous &ndash; compare to [[UnalignedSplice]].
+::True by default, {{FuncArg|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 {{FuncArg|pad}}=false when the soundtracks being joined were originally contiguous &ndash; compare to [[UnalignedSplice]].
@@ Line 99: / Line 99: @@
 == Examples ==
-<div {{BoxWidthIndent|56|0}} >
+* Return only the first frame (frame 0)
-  Trim(100,0)             # delete the first 100 frames, audio padded
+<div {{BoxWidthIndent|26|2}} >
-                         # or trimmed to match the video length.
+  Trim(0, -1)
 </div>
-<div {{BoxWidthIndent|56|0}} >
+* Return frames 100-199 (duration=100)
-  Trim(100,0,false)       # delete the first 100 frames of audio and video,
+<div {{BoxWidthIndent|26|2}} >
-                         # the resulting stream lengths remain independent.
+  Trim(100, 199)
 </div>
-<div {{BoxWidthIndent|56|0}} >
+* Delete the first 100 frames; audio padded or trimmed to match the video length.
-  Trim(100,-100)          # is the same as trim(100,199) ie, start=100, duration=100
+<div {{BoxWidthIndent|26|2}} >
 </div>
-<div {{BoxWidthIndent|56|0}} >
+* Delete the first 100 frames of audio and video; the resulting stream lengths remain independent.
-  Trim(100,199,false)     # audio will be trimmed if longer but not
+<div {{BoxWidthIndent|26|2}} >
-                         # padded if shorter to frame 199
+  Trim(100, 0, pad=false)
 </div>
-<div {{BoxWidthIndent|56|0}} >
+* Trim audio if longer than video
-  Trim(0,-1)              # returns only the first frame
+<div {{BoxWidthIndent|26|2}} >
- Trim(0,end=0)           #
+  Trim(0, FrameCount-1, pad=false)
- Trim(0,length=1)        #
 </div>
-<div {{BoxWidthIndent|56|0}} >
+* Audio will be trimmed if longer, but not padded if shorter to frame 199
-  AudioTrim(1,5.5)        # keeps the audio samples between 1 and 5.5 seconds
+<div {{BoxWidthIndent|26|2}} >
- AudioTrim(1,end=5.5)    #
+  Trim(100, 199, pad=false)
 </div>
-<div {{BoxWidthIndent|56|0}} >
+* AudioTrim: trim video if longer than audio
-  AudioTrim(1,-5.5)       # cuts the first second and keeps the following 5.5 seconds
+<div {{BoxWidthIndent|26|2}} >
-  AudioTrim(1,length=5.5) #
+ AudioTrim(0, AudioDuration)
 </div>