Trim - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T04:50:21Z

add link to avs+ documentation

← Older revision		Revision as of 06: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" >

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

2021-07-21T02:21:47Z

Examples: add "return only the last frame" examples

← Older revision		Revision as of 04:21, 21 July 2021
Line 104:		Line 104:
	Trim(0, end=0)		Trim(0, end=0)
	Trim(0, length=1)		Trim(0, length=1)
			</div>

			* Return only the last frame
			<div {{BoxWidthIndent\|26\|2}} >
			Trim(FrameCount, -1)
			Trim(FrameCount, end=Framecount)
			Trim(FrameCount, length=1)
	</div>		</div>

Line 146:		Line 153:
	AudioTrim(1, length=5.5)		AudioTrim(1, length=5.5)
	</div>		</div>


	== Changes ==		== Changes ==

Raffriff42: re-phrase, still not happy

2016-04-30T21:00:13Z

re-phrase, still not happy

← Older revision		Revision as of 23:00, 30 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''.

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

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

2016-04-30T01:19:03Z

AudioTrim: new clip again starts at zero

← Older revision		Revision as of 03:19, 30 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''.

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

Raffriff42: new clip again starts at zero

2016-04-29T13:08:56Z

new clip again starts at zero

← Older revision		Revision as of 15: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.

Raffriff42: one more touch-up

2016-03-18T14:05:38Z

one more touch-up

← Older revision		Revision as of 16:05, 18 March 2016
Line 122:		Line 122:
	</div>		</div>

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

Raffriff42: correction? audio always trimmed if longer

2016-03-18T14:02:40Z

correction? audio always trimmed if longer

← Older revision		Revision as of 16:02, 18 March 2016
Line 117:		Line 117:
	</div>		</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}} >		<div {{BoxWidthIndent\|26\|2}} >
	Trim(100, 0, pad=false)		Trim(100, 0, pad=false)
Line 124:		Line 124:
	* Trim audio if longer than video		* Trim audio if longer than video
	<div {{BoxWidthIndent\|26\|2}} >		<div {{BoxWidthIndent\|26\|2}} >
	Trim(0, FrameCount-1, pad~~=false)~~		Trim(0, FrameCount-1) ## ''pad'' does not matter
	</div>		</div>

Raffriff42: one more touch-up

2016-03-18T13:04:38Z

one more touch-up

← Older revision		Revision as of 15:04, 18 March 2016
Line 137:		Line 137:
	</div>		</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>

	* AudioTrim: delete the first second and keep the following 5.5 seconds
	<div {{BoxWidthIndent\|26\|2}} >		<div {{BoxWidthIndent\|26\|2}} >
	AudioTrim(1, 6.5)		AudioTrim(1, 6.5)

Raffriff42: /* Examples */

2016-03-18T13:01:27Z

Examples

← Older revision		Revision as of 15:01, 18 March 2016
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.		:*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 – 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 – compare to [[UnalignedSplice]].


Line 99:		Line 99:

	== Examples ==		== 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)
			Trim(0, end=0)
			Trim(0, length=1)
	</div>		</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)
			Trim(100, -100)
	</div>		</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}} >
			Trim(100, 0) # (pad=true by default)
	</div>		</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>

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

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

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

			* AudioTrim: keep the audio between 1.0 and 5.5 seconds
			<div {{BoxWidthIndent\|26\|2}} >
			AudioTrim(1, 5.5)
			AudioTrim(1, end=5.5)
			</div>

			* AudioTrim: delete the first second and keep the following 5.5 seconds
			<div {{BoxWidthIndent\|26\|2}} >
			AudioTrim(1, 6.5)
			AudioTrim(1, -5.5)
			AudioTrim(1, length=5.5)
	</div>		</div>

Raffriff42: link to ShowFrameNumber, ShowTime redux

2016-03-13T21:52:29Z

link to ShowFrameNumber, ShowTime redux

← Older revision		Revision as of 23:52, 13 March 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, you will want to use [[ShowFrameNumber]] on the source clip~~, to keep track of your edits~~.		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.


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

	For any non-trivial editing, you will want to use [[ShowTime]] on the source clip~~, to keep track of your edits~~.		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.