TimeStretch - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T04:52:38Z

add link to avs+ documentation

Raffriff42: note AVS+ differences

2017-07-04T23:07:47Z

note AVS+ differences

Admin at 20:44, 8 July 2016

2016-07-08T20:44:34Z

Admin at 21:26, 7 July 2016

2016-07-07T21:26:54Z

Admin at 21:26, 7 July 2016

2016-07-07T21:26:19Z

Admin at 21:25, 7 July 2016

2016-07-07T21:25:23Z

Admin: added default values

2016-07-07T21:21:48Z

added default values

Admin at 21:19, 4 July 2016

2016-07-04T21:19:42Z

Admin at 21:18, 4 July 2016

2016-07-04T21:18:27Z

Admin: /* Examples */

2016-06-23T15:57:18Z

‎Examples

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

@@ Line 23: / Line 23: @@
 :{{Par2|clip|clip|}}
-::Source clip. Incoming audio sample type is automatically converted to [[Float|float]].
+::Source clip. Audio is always converted to [[Float]].
 ::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>

@@ 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}}.
-:{{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.

@@ Line 116: / Line 116: @@
 |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>

@@ Line 116: / Line 116: @@
 |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>

@@ Line 63: / Line 63: @@
 :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,
 ::* 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}}.
-:{{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.
@@ Line 116: / Line 116: @@
 |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)).
 </div>

@@ Line 78: / Line 78: @@
 ::*'''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.

@@ Line 134: / Line 134: @@
 <div {{BoxWidthIndent|36|3}} >
   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>