Tone - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T04:51:18Z

add link to avs+ documentation

Admin: /* Changes */

2016-01-16T20:55:23Z

‎Changes

Admin at 20:45, 16 January 2016

2016-01-16T20:45:50Z

Raffriff42: typo

2016-01-13T21:04:14Z

typo

Raffriff42: one more touch-up

2016-01-13T14:47:26Z

one more touch-up

Raffriff42: formatting, links, equations

2016-01-13T07:05:59Z

formatting, links, equations

Raffriff42: note re: default sample_type

2015-09-05T20:27:29Z

note re: default sample_type

Raffriff42: added category:Debugging/Diagnostic_filters

2015-06-03T22:34:54Z

added category:Debugging/Diagnostic_filters

Raffriff42: formatting

2014-11-07T19:45:03Z

formatting

Admin: no latex installed

2013-12-28T15:18:36Z

no latex installed

← Older revision		Revision as of 04:51, 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/tone.html https://avisynthplus.readthedocs.io]
		+	</div>
		+
		+
	This will generate sound (a waveform) at a given {{FuncArg\|frequency}} for a given {{FuncArg\|length}} of time in seconds.		This will generate sound (a waveform) at a given {{FuncArg\|frequency}} for a given {{FuncArg\|length}} of time in seconds.

@@ Line 55: / Line 55: @@
 |-
 | v2.56
-| Added Level in v2.56.
+| Added Level.
 |-
 | v2.54

← Older revision		Revision as of 20:45, 16 January 2016
Line 1:		Line 1:
−	This will generate sound at a given {{FuncArg\|frequency}} for a given {{FuncArg\|length}} of time in seconds.	+	This will generate sound (a waveform) at a given {{FuncArg\|frequency}} for a given {{FuncArg\|length}} of time in seconds.

@@ Line 36: / Line 36: @@
 |}
 </div>
-:In the figure above, a sinus is generated (on a gray clip with framerate 24 fps). :The period of the waveform (in frames) is the ''framerate'' divided by ''frequency'' (or fps/freq, which is 24/2=12 frames in our example). The part of the graph which is light-green represents all samples of the frame under consideration (which is frame 1 here). The number of samples in a particular frame is given by the ''samplerate'' divided by the ''framerate'' (which is 48000/24 = 2000 samples in our example).
+:In the figure above, a sinus is generated (on a gray clip with framerate 24 fps). The period of the waveform (in frames) is the ''framerate'' divided by ''frequency'' (or fps/freq, which is 24/2=12 frames in our example). The part of the graph which is light-green represents all samples of the frame under consideration (which is frame 1 here). The number of samples in a particular frame is given by the ''samplerate'' divided by the ''framerate'' (which is 48000/24 = 2000 samples in our example).
 :More generally, the waveform above is described by

@@ Line 21: / Line 21: @@
 :{{Par2|level|float|1.0}}
 ::The amplitude of the waveform. Default = 1.0 (or 0[[Wikipedia:Decibel|dB]], the maximum level possible without [[Wikipedia:Clipping_%28audio%29|clipping]]).
-::For a particular decibel level, use the equation {{FuncArg|level}} = 10<sup> dB / 20</sup>
+::For a particular decibel level, use the equation {{FuncArg|level}} = {{Serif|10}}<sup> {{Serif|'''dB''' / 20}}</sup>
-::For example, {{FuncArg|level}} = 0.251 gives a -12dB tone.
+::For example, create a -12dB tone with {{FuncArg|level}} = 10<sup>-12/20</sup> or 0.251.

@@ Line 1: / Line 1: @@
-{{Template:FuncDef|Tone(float ''length'', float ''frequency'', int ''samplerate'', int ''channels'', string ''type'', float ''level'')}}
+This will generate sound at a given {{FuncArg|frequency}} for a given {{FuncArg|length}} of time in seconds.
-;length
+{{Template:FuncDef|Tone( [ float ''length'', float ''frequency'', int ''samplerate'', int ''channels'', string ''type'', float ''level'' ] )}}
-:Length of time in seconds. Default = 10.0.
-;frequency
-: Tone frequency. Default = 440.
-;samplerate
-: Audio sample rate. Default = 48000.
-;channels
-: Number of audio channels. Default = 2.
-;type
-: "Silence", "Sine", "Noise", "Square", "Triangle" or "Sawtooth". Default = "Sine".
-;level
-: The amplitude of the waveform. Default = maximum = 1.0.
-The audio sample type is '''32-bit float'''. Use [[ConvertAudio]] if this is not what you want.
+:{{Par2|frequency|float|440}}
-{| border=1 cellspacing=0 cellpadding=5
+:{{Par2|channels|int|2}}
-| [[Image:Tone.jpg]]
+::Number of audio channels.
-|-
-| Tone(frequency=2, samplerate=48000, channels=2, type="sine", level=0.4)
-|}
-In the figure above, a sinus is generated (on a gray clip with framerate 24 fps). The period of the waveform (in frames) is the framerate divided by ''frequency'' (or fps/freq, which is 24/2=12 frames in our example). The part of the graph which is light-green represents all samples of the frame under consideration (which is frame 1 here). The number of samples in a particular frame is given by the ''samplerate'' divided by the framerate (which is 48000/24 = 2000 samples in our example). (Note that the bars are made with [[Histogram]] and the graph with the AudioGraph plugin.)
-More generally, the waveform above is described by
+:{{Par2|type|string|"Sine"}}
- g(n,s) = level * sin(2*pi*(frequency*n/framerate + s*frequency/samplerate))
+:{{Par2|level|float|1.0}}
-In the example above, this reduces to
+The audio sample type is '''32-bit float'''. Use [[ConvertAudio]] if this is not what you want.
- g(n,s) = 0.4 * sin(2*pi*(2*n/24 + s*2/48000))
+:In the example above, this reduces to
-with "n" the frame and "s" the sample under consideration (note that s runs from 0 to 1999).
+:Note that the bars are made with [[Histogram]] and the graph with the [[AudioGraph]] plugin.
-'''Changes:'''
+==== Changes ====
 {| border="1"
 |-

← Older revision		Revision as of 20:27, 5 September 2015
Line 15:		Line 15:
	;level		;level
	: The amplitude of the waveform. Default = maximum = 1.0.		: The amplitude of the waveform. Default = maximum = 1.0.
		+
		+
		+	The audio sample type is '''32-bit float'''. Use [[ConvertAudio]] if this is not what you want.

← Older revision		Revision as of 22:34, 3 June 2015
Line 48:		Line 48:

	[[Category:Internal filters]]		[[Category:Internal filters]]
		+	[[Category:Debugging/Diagnostic filters]]