TimeStretch - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T04:52:38Z

add link to avs+ documentation

← Older revision		Revision as of 06:52, 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/timestretch.html https://avisynthplus.readthedocs.io]
			</div>


	TimeStretch allows changing the sound tempo, [[Wikipedia:Pitch_(music)\|pitch]] and playback rate parameters independently from each other, i.e.:		TimeStretch allows changing the sound tempo, [[Wikipedia:Pitch_(music)\|pitch]] and playback rate parameters independently from each other, i.e.:
	{\| border="0"		{\| border="0"

Raffriff42: note AVS+ differences

2017-07-04T23:07:47Z

note AVS+ differences

← Older revision		Revision as of 01:07, 5 July 2017
Line 23:		Line 23:

	:{{Par2\|clip\|clip\|}}		:{{Par2\|clip\|clip\|}}
	::Source clip. ~~Incoming audio sample type~~ is ~~automatically~~ converted to [[Float~~\|float~~]].		::Source clip. Audio is always converted to [[Float]].
			::{{AvsPluscon}} no conversion is performed. Accepts [[Float]] audio only.
	::Starting from v2.61 multichannel audio is supported.		::Starting from v2.61 multichannel audio is supported.
	::Prior to v2.61: If {{FuncArg\|clip}}.[[Clip_properties\|AudioChannels]]=2, special processing is used to preserve [[Wikipedia:Stereo_imaging\|stereo imaging]]. Otherwise, channels are processed independently. Independent processing works well for unrelated audio tracks, but not very well for [[Wikipedia:5.1_surround_sound\|surround sound]]; pending the release of AviSynth v2.61, try [[TimeStretchPlugin]] instead. <sup>[http://forum.doom9.org/showthread.php?t=71632] [http://forum.doom9.org/showthread.php?t=172054#post1718302]</sup>		::Prior to v2.61: If {{FuncArg\|clip}}.[[Clip_properties\|AudioChannels]]=2, special processing is used to preserve [[Wikipedia:Stereo_imaging\|stereo imaging]]. Otherwise, channels are processed independently. Independent processing works well for unrelated audio tracks, but not very well for [[Wikipedia:5.1_surround_sound\|surround sound]]; pending the release of AviSynth v2.61, try [[TimeStretchPlugin]] instead. <sup>[http://forum.doom9.org/showthread.php?t=71632] [http://forum.doom9.org/showthread.php?t=172054#post1718302]</sup>

Admin at 20:44, 8 July 2016

2016-07-08T20:44:34Z

← Older revision		Revision as of 22:44, 8 July 2016
Line 74:		Line 74:
	::The overlap length in milliseconds. When the sound sequences are mixed back together to form a continuous sound stream again, {{FuncArg\|overlap}} defines how much of the ends of the consecutive sequences will be overlapped. This shouldn't be a critical parameter. If you reduce the {{FuncArg\|sequence}} by a large amount, you might wish to try a smaller {{FuncArg\|overlap}}.		::The overlap length in milliseconds. When the sound sequences are mixed back together to form a continuous sound stream again, {{FuncArg\|overlap}} defines how much of the ends of the consecutive sequences will be overlapped. This shouldn't be a critical parameter. If you reduce the {{FuncArg\|sequence}} by a large amount, you might wish to try a smaller {{FuncArg\|overlap}}.

	:{{Par2\|quickseek\|bool\|~~true~~ *}}		:{{Par2\|quickseek\|bool\|false *}}
	::The time-stretch routine has a 'quick' mode that substantially speeds up the algorithm but may degrade the sound quality.		::The time-stretch routine has a 'quick' mode that substantially speeds up the algorithm but may degrade the sound quality when {{FuncArg\|quickseek}} is set to true.
	::*'''Try {{Template:FuncArg\|quickseek}}=false''' if you hear artifacts like warbling, clicking etc.		::*'''Try {{Template:FuncArg\|quickseek}}=false''' if you hear artifacts like warbling, clicking etc.

Admin at 21:26, 7 July 2016

2016-07-07T21:26:54Z

← Older revision		Revision as of 23:26, 7 July 2016
Line 116:		Line 116:
	\|style="vertical-align:top"\| Larger value increases CPU burden.		\|style="vertical-align:top"\| Larger value increases CPU burden.
	\|}		\|}
	:'''*''' {{FuncArg\|sequence}} and {{FuncArg\|seekwindow}} have default values 100 and 22. However they are updated if the calculated tempo is different from the default value (100). The calculated tempo depends on the specified tempo or pitch in your script. It will be different from 100 if tempo or pitch in your script is different from 100. The update of the default values happens in TDStretch::calcSeqParameters()		:'''*''' {{FuncArg\|sequence}} and {{FuncArg\|seekwindow}} have default values 100 and 22. However they are updated if the calculated tempo is different from the default value (100). The calculated tempo depends on the specified tempo or pitch in your script. It will be different from 100 if tempo or pitch in your script is different from 100. The update of the default values happens in TDStretch::calcSeqParameters().
	</div>		</div>

Admin at 21:26, 7 July 2016

2016-07-07T21:26:19Z

← Older revision		Revision as of 23:26, 7 July 2016
Line 116:		Line 116:
	\|style="vertical-align:top"\| Larger value increases CPU burden.		\|style="vertical-align:top"\| Larger value increases CPU burden.
	\|}		\|}
	:'''*''' {{FuncArg\|sequence}} and {{FuncArg\|seekwindow}} have default values 100 and 22. However they are updated if the calculated tempo is different from the default value (100). The calculated tempo depends on the specified tempo or pitch in your script. It will be different from 100 if tempo or pitch in your script is different from 100.		:'''*''' {{FuncArg\|sequence}} and {{FuncArg\|seekwindow}} have default values 100 and 22. However they are updated if the calculated tempo is different from the default value (100). The calculated tempo depends on the specified tempo or pitch in your script. It will be different from 100 if tempo or pitch in your script is different from 100. The update of the default values happens in TDStretch::calcSeqParameters()

	the ~~update~~ happens in TDStretch::calcSeqParameters()
	</div>		</div>

Admin at 21:25, 7 July 2016

2016-07-07T21:25:23Z

← Older revision		Revision as of 23:25, 7 July 2016
Line 116:		Line 116:
	\|style="vertical-align:top"\| Larger value increases CPU burden.		\|style="vertical-align:top"\| Larger value increases CPU burden.
	\|}		\|}
	:'''*''' {{FuncArg\|sequence}} and {{FuncArg\|seekwindow}} have default values 100 and 22. However they are updated if the calculated tempo is different from the default value (100). ~~This~~ will be ~~the case~~ if tempo or pitch ~~is specified~~ in ~~the~~ script ~~(and~~ different from ~~the default value (~~100)).		:'''*''' {{FuncArg\|sequence}} and {{FuncArg\|seekwindow}} have default values 100 and 22. However they are updated if the calculated tempo is different from the default value (100). The calculated tempo depends on the specified tempo or pitch in your script. It will be different from 100 if tempo or pitch in your script is different from 100.

	the update happens in TDStretch::calcSeqParameters()		the update happens in TDStretch::calcSeqParameters()

Admin: added default values

2016-07-07T21:21:48Z

added default values

← Older revision		Revision as of 23:21, 7 July 2016
Line 63:		Line 63:
	:These parameters affect the time-stretch algorithm as follows:		:These parameters affect the time-stretch algorithm as follows:

	:{{Par2\|sequence\|int\|~~108~~ *}}		:{{Par2\|sequence\|int\|100 *}}
	::This is the length of a single ''processing sequence'' in milliseconds, which determines how the original sound is chopped in the time-stretch algorithm. Larger values mean fewer, and longer, sequences are used. In general,		::This is the length of a single ''processing sequence'' in milliseconds, which determines how the original sound is chopped in the time-stretch algorithm. Larger values mean fewer, and longer, sequences are used. In general,
	::* a larger {{FuncArg\|sequence}} value sounds better with a lower {{FuncArg\|tempo}} and/or {{FuncArg\|pitch}};		::* a larger {{FuncArg\|sequence}} value sounds better with a lower {{FuncArg\|tempo}} and/or {{FuncArg\|pitch}};
	::* a smaller {{FuncArg\|sequence}} value sounds better with a higher {{FuncArg\|tempo}} and/or {{FuncArg\|pitch}}.		::* a smaller {{FuncArg\|sequence}} value sounds better with a higher {{FuncArg\|tempo}} and/or {{FuncArg\|pitch}}.

	:{{Par2\|seekwindow\|int\|23 *}}		:{{Par2\|seekwindow\|int\|22 *}}
	::The length in milliseconds for the algorithm that searches for the best possible overlap location. For larger {{FuncArg\|seekwindow}} values, the possibility of finding a better mixing position increases, but an overly large {{FuncArg\|seekwindow}} may cause '''''drifting''''' (a disturbing artifact where audio pitch seems unsteady) because neighboring sequences may be chosen at more uneven intervals.		::The length in milliseconds for the algorithm that searches for the best possible overlap location. For larger {{FuncArg\|seekwindow}} values, the possibility of finding a better mixing position increases, but an overly large {{FuncArg\|seekwindow}} may cause '''''drifting''''' (a disturbing artifact where audio pitch seems unsteady) because neighboring sequences may be chosen at more uneven intervals.

Line 116:		Line 116:
	\|style="vertical-align:top"\| Larger value increases CPU burden.		\|style="vertical-align:top"\| Larger value increases CPU burden.
	\|}		\|}
	:'''*''' ~~[[TODO]] ''(~~ default values are ~~under investigation at~~ the ~~time of updating this documentation~~ )''		:'''*''' {{FuncArg\|sequence}} and {{FuncArg\|seekwindow}} have default values 100 and 22. However they are updated if the calculated tempo is different from the default value (100). This will be the case if tempo or pitch is specified in the script (and different from the default value (100)).

			the update happens in TDStretch::calcSeqParameters()
	</div>		</div>

Admin at 21:19, 4 July 2016

2016-07-04T21:19:42Z

← Older revision		Revision as of 23:19, 4 July 2016
Line 78:		Line 78:
	::*'''Try {{Template:FuncArg\|quickseek}}=false''' if you hear artifacts like warbling, clicking etc.		::*'''Try {{Template:FuncArg\|quickseek}}=false''' if you hear artifacts like warbling, clicking etc.

	:{{Par2\|aa\|int\|? *}}		:{{Par2\|aa\|int\|64 *}}
	::Controls the number of ''taps'' the [[Wikipedia:Finite_impulse_response\|anti-alias filter]] uses. Set to 0 to disable the filter. Must be a multiple of 4.		::Controls the number of ''taps'' the [[Wikipedia:Finite_impulse_response\|anti-alias filter]] uses. Set to 0 to disable the filter. Must be a multiple of 4.

Admin at 21:18, 4 July 2016

2016-07-04T21:18:27Z

← Older revision		Revision as of 23:18, 4 July 2016
Line 63:		Line 63:
	:These parameters affect the time-stretch algorithm as follows:		:These parameters affect the time-stretch algorithm as follows:

	:{{Par2\|sequence\|int\|82 *}}		:{{Par2\|sequence\|int\|108 *}}
	::This is the length of a single ''processing sequence'' in milliseconds, which determines how the original sound is chopped in the time-stretch algorithm. Larger values mean fewer, and longer, sequences are used. In general,		::This is the length of a single ''processing sequence'' in milliseconds, which determines how the original sound is chopped in the time-stretch algorithm. Larger values mean fewer, and longer, sequences are used. In general,
	::* a larger {{FuncArg\|sequence}} value sounds better with a lower {{FuncArg\|tempo}} and/or {{FuncArg\|pitch}};		::* a larger {{FuncArg\|sequence}} value sounds better with a lower {{FuncArg\|tempo}} and/or {{FuncArg\|pitch}};
	::* a smaller {{FuncArg\|sequence}} value sounds better with a higher {{FuncArg\|tempo}} and/or {{FuncArg\|pitch}}.		::* a smaller {{FuncArg\|sequence}} value sounds better with a higher {{FuncArg\|tempo}} and/or {{FuncArg\|pitch}}.

	:{{Par2\|seekwindow\|int\|28 *}}		:{{Par2\|seekwindow\|int\|23 *}}
	::The length in milliseconds for the algorithm that searches for the best possible overlap location. For larger {{FuncArg\|seekwindow}} values, the possibility of finding a better mixing position increases, but an overly large {{FuncArg\|seekwindow}} may cause '''''drifting''''' (a disturbing artifact where audio pitch seems unsteady) because neighboring sequences may be chosen at more uneven intervals.		::The length in milliseconds for the algorithm that searches for the best possible overlap location. For larger {{FuncArg\|seekwindow}} values, the possibility of finding a better mixing position increases, but an overly large {{FuncArg\|seekwindow}} may cause '''''drifting''''' (a disturbing artifact where audio pitch seems unsteady) because neighboring sequences may be chosen at more uneven intervals.

	:{{Par2\|overlap\|int\|12 *}}		:{{Par2\|overlap\|int\|8 *}}
	::The overlap length in milliseconds. When the sound sequences are mixed back together to form a continuous sound stream again, {{FuncArg\|overlap}} defines how much of the ends of the consecutive sequences will be overlapped. This shouldn't be a critical parameter. If you reduce the {{FuncArg\|sequence}} by a large amount, you might wish to try a smaller {{FuncArg\|overlap}}.		::The overlap length in milliseconds. When the sound sequences are mixed back together to form a continuous sound stream again, {{FuncArg\|overlap}} defines how much of the ends of the consecutive sequences will be overlapped. This shouldn't be a critical parameter. If you reduce the {{FuncArg\|sequence}} by a large amount, you might wish to try a smaller {{FuncArg\|overlap}}.

	:{{Par2\|quickseek\|bool\|true? *}}		:{{Par2\|quickseek\|bool\|true *}}
	::The time-stretch routine has a 'quick' mode that substantially speeds up the algorithm but may degrade the sound quality.		::The time-stretch routine has a 'quick' mode that substantially speeds up the algorithm but may degrade the sound quality.
	::*'''Try {{Template:FuncArg\|quickseek}}=false''' if you hear artifacts like warbling, clicking etc.		::*'''Try {{Template:FuncArg\|quickseek}}=false''' if you hear artifacts like warbling, clicking etc.

Admin: /* Examples */

2016-06-23T15:57:18Z

Examples

← Older revision		Revision as of 17:57, 23 June 2016
Line 134:		Line 134:
	<div {{BoxWidthIndent\|36\|3}} >		<div {{BoxWidthIndent\|36\|3}} >
	TimeStretch(pitch=200.0)		TimeStretch(pitch=200.0)
	# TimeStretch(pitch_n=~~200~~, pitch_d=1) # more accurate processing		# TimeStretch(pitch_n=2, pitch_d=1) # more accurate processing
	</div>		</div>

← Older revision		Revision as of 22:44, 8 July 2016
Line 74:		Line 74:
	::The overlap length in milliseconds. When the sound sequences are mixed back together to form a continuous sound stream again, {{FuncArg\|overlap}} defines how much of the ends of the consecutive sequences will be overlapped. This shouldn't be a critical parameter. If you reduce the {{FuncArg\|sequence}} by a large amount, you might wish to try a smaller {{FuncArg\|overlap}}.		::The overlap length in milliseconds. When the sound sequences are mixed back together to form a continuous sound stream again, {{FuncArg\|overlap}} defines how much of the ends of the consecutive sequences will be overlapped. This shouldn't be a critical parameter. If you reduce the {{FuncArg\|sequence}} by a large amount, you might wish to try a smaller {{FuncArg\|overlap}}.

	:{{Par2\|quickseek\|bool\|~~true~~ *}}		:{{Par2\|quickseek\|bool\|false *}}
	::The time-stretch routine has a 'quick' mode that substantially speeds up the algorithm but may degrade the sound quality.		::The time-stretch routine has a 'quick' mode that substantially speeds up the algorithm but may degrade the sound quality when {{FuncArg\|quickseek}} is set to true.
	::*'''Try {{Template:FuncArg\|quickseek}}=false''' if you hear artifacts like warbling, clicking etc.		::*'''Try {{Template:FuncArg\|quickseek}}=false''' if you hear artifacts like warbling, clicking etc.

← Older revision		Revision as of 23:19, 4 July 2016
Line 78:		Line 78:
	::*'''Try {{Template:FuncArg\|quickseek}}=false''' if you hear artifacts like warbling, clicking etc.		::*'''Try {{Template:FuncArg\|quickseek}}=false''' if you hear artifacts like warbling, clicking etc.

	:{{Par2\|aa\|int\|? *}}		:{{Par2\|aa\|int\|64 *}}
	::Controls the number of ''taps'' the [[Wikipedia:Finite_impulse_response\|anti-alias filter]] uses. Set to 0 to disable the filter. Must be a multiple of 4.		::Controls the number of ''taps'' the [[Wikipedia:Finite_impulse_response\|anti-alias filter]] uses. Set to 0 to disable the filter. Must be a multiple of 4.

← Older revision		Revision as of 23:18, 4 July 2016
Line 63:		Line 63:
	:These parameters affect the time-stretch algorithm as follows:		:These parameters affect the time-stretch algorithm as follows:

	:{{Par2\|sequence\|int\|82 *}}		:{{Par2\|sequence\|int\|108 *}}
	::This is the length of a single ''processing sequence'' in milliseconds, which determines how the original sound is chopped in the time-stretch algorithm. Larger values mean fewer, and longer, sequences are used. In general,		::This is the length of a single ''processing sequence'' in milliseconds, which determines how the original sound is chopped in the time-stretch algorithm. Larger values mean fewer, and longer, sequences are used. In general,
	::* a larger {{FuncArg\|sequence}} value sounds better with a lower {{FuncArg\|tempo}} and/or {{FuncArg\|pitch}};		::* a larger {{FuncArg\|sequence}} value sounds better with a lower {{FuncArg\|tempo}} and/or {{FuncArg\|pitch}};
	::* a smaller {{FuncArg\|sequence}} value sounds better with a higher {{FuncArg\|tempo}} and/or {{FuncArg\|pitch}}.		::* a smaller {{FuncArg\|sequence}} value sounds better with a higher {{FuncArg\|tempo}} and/or {{FuncArg\|pitch}}.

	:{{Par2\|seekwindow\|int\|28 *}}		:{{Par2\|seekwindow\|int\|23 *}}
	::The length in milliseconds for the algorithm that searches for the best possible overlap location. For larger {{FuncArg\|seekwindow}} values, the possibility of finding a better mixing position increases, but an overly large {{FuncArg\|seekwindow}} may cause '''''drifting''''' (a disturbing artifact where audio pitch seems unsteady) because neighboring sequences may be chosen at more uneven intervals.		::The length in milliseconds for the algorithm that searches for the best possible overlap location. For larger {{FuncArg\|seekwindow}} values, the possibility of finding a better mixing position increases, but an overly large {{FuncArg\|seekwindow}} may cause '''''drifting''''' (a disturbing artifact where audio pitch seems unsteady) because neighboring sequences may be chosen at more uneven intervals.

	:{{Par2\|overlap\|int\|12 *}}		:{{Par2\|overlap\|int\|8 *}}
	::The overlap length in milliseconds. When the sound sequences are mixed back together to form a continuous sound stream again, {{FuncArg\|overlap}} defines how much of the ends of the consecutive sequences will be overlapped. This shouldn't be a critical parameter. If you reduce the {{FuncArg\|sequence}} by a large amount, you might wish to try a smaller {{FuncArg\|overlap}}.		::The overlap length in milliseconds. When the sound sequences are mixed back together to form a continuous sound stream again, {{FuncArg\|overlap}} defines how much of the ends of the consecutive sequences will be overlapped. This shouldn't be a critical parameter. If you reduce the {{FuncArg\|sequence}} by a large amount, you might wish to try a smaller {{FuncArg\|overlap}}.

	:{{Par2\|quickseek\|bool\|true? *}}		:{{Par2\|quickseek\|bool\|true *}}
	::The time-stretch routine has a 'quick' mode that substantially speeds up the algorithm but may degrade the sound quality.		::The time-stretch routine has a 'quick' mode that substantially speeds up the algorithm but may degrade the sound quality.
	::*'''Try {{Template:FuncArg\|quickseek}}=false''' if you hear artifacts like warbling, clicking etc.		::*'''Try {{Template:FuncArg\|quickseek}}=false''' if you hear artifacts like warbling, clicking etc.