PlayTone - Revision history

Ghenne at 22:59, 24 July 2019

2019-07-24T22:59:18Z

@@ Line 32: / Line 32: @@
 From there, dig further into the docs. There are many more possibilities!)
-== Example (Basic) ==
+== Example ==
-== Example (JavaScript) ==
+<tabber>
-<pre>
+ JavaScript=
 PlayTone(440, 1000);
-Play a chord:
+// Play a chord:
 var C = 261.63;
 var E = 329.63;
@@ Line 66: / Line 46: @@
 PlayTone(E, 1000);
 PlayTone(G, 1000);
-Stop playing tone:
+// Stop playing tone:
 tone = PlayTone(440,1000);
 tone.oscillator.stop();
-</pre>
+</syntaxhighlight>
 == Output ==

Ghenne: /* Output */

2015-12-13T18:44:03Z

Output

← Older revision		Revision as of 18:44, 13 December 2015
Line 77:		Line 77:

	(single tone)		(single tone)

	(chord)		(chord)

	(nothing - it is stopped before you can hear it start)		(nothing - it is stopped before you can hear it start)

Ghenne: /* Example (Basic) */

2015-12-13T18:43:47Z

Example (Basic)

← Older revision		Revision as of 18:43, 13 December 2015
Line 49:		Line 49:
	Stop playing tone		Stop playing tone
	<pre>		<pre>
	tone = PlayTone(440,1000)		tone = PlayTone(440,1000)
	tone.oscillator.stop()		tone.oscillator.stop()
	</pre>		</pre>

Ghenne at 18:43, 13 December 2015

2015-12-13T18:43:28Z

← Older revision		Revision as of 18:43, 13 December 2015
Line 55:		Line 55:
	== Example (JavaScript) ==		== Example (JavaScript) ==
	<pre>		<pre>
	PlayTone(440, 1000);		PlayTone(440, 1000);
	</pre>		</pre>

Ghenne at 18:43, 13 December 2015

2015-12-13T18:43:07Z

← Older revision		Revision as of 18:43, 13 December 2015
Line 34:		Line 34:
	== Example (Basic) ==		== Example (Basic) ==
	<pre>		<pre>
	PlayTone(440, 1000);		PlayTone(440, 1000);
	</pre>		</pre>

	Play a chord:		Play a chord:
	<pre>		<pre>
	Dim C = 261.63		Dim C = 261.63
	Dim E = 329.63		Dim E = 329.63
	Dim G = 392.00		Dim G = 392.00
	PlayTone(C, 1000)		PlayTone(C, 1000)
	PlayTone(E, 1000)		PlayTone(E, 1000)
	PlayTone(G, 1000)		PlayTone(G, 1000)
	</pre>		</pre>

Line 60:		Line 60:
	Play a chord:		Play a chord:
	<pre>		<pre>
	var C = 261.63;		var C = 261.63;
	var E = 329.63;		var E = 329.63;
	var G = 392.00;		var G = 392.00;
	PlayTone(C, 1000);		PlayTone(C, 1000);
	PlayTone(E, 1000);		PlayTone(E, 1000);
	PlayTone(G, 1000);		PlayTone(G, 1000);
	</pre>		</pre>

	Stop playing tone:		Stop playing tone:
	<pre>		<pre>
	tone = PlayTone(440,1000);		tone = PlayTone(440,1000);
	tone.oscillator.stop();		tone.oscillator.stop();
	</pre>		</pre>

Ghenne: /* Properties and Methods */

2015-12-13T18:42:22Z

Properties and Methods

← Older revision		Revision as of 18:42, 13 December 2015
Line 27:		Line 27:

	For more information, see		For more information, see

	https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createOscillator		https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createOscillator

			From there, dig further into the docs. There are many more possibilities!)

	== Example (Basic) ==		== Example (Basic) ==

Ghenne at 18:40, 13 December 2015

2015-12-13T18:40:48Z

← Older revision		Revision as of 18:40, 13 December 2015
Line 1:		Line 1:
	~~''STILL UNDER CONSTRUCTION''~~		PlayTone(''frequency'', ''duration''[, ''volume'']) in vibrations per second. 440 corresponds to the normal frequency for A.

	PlayTone(''frequency'', ''duration''[, ''volume''])

	== Description ==		== Description ==
Line 7:		Line 5:
	PlayTone generates a tone with the specified ''frequency'', ''duration'' and ''volume''. Playback is immediate, with no on screen controls, making it excellent for user interactions and gaming. The tone is played asynchronously, so if you do PlayTone before the previous tone is complete, two tones will play at the same time, making chords possible.		PlayTone generates a tone with the specified ''frequency'', ''duration'' and ''volume''. Playback is immediate, with no on screen controls, making it excellent for user interactions and gaming. The tone is played asynchronously, so if you do PlayTone before the previous tone is complete, two tones will play at the same time, making chords possible.

	''frequency''		''frequency'' defines the pitch of the tone, in vibrations per second. 440 corresponds to A in the most music.

	''duration''		''duration'' is the length of the tone, in milliseconds.

	''volume''		''volume'' is optional. 1 is the loudest volume.

	PlayTone returns a reference to the sound. You can use this reference to control the sound.		PlayTone returns a reference to the sound. You can use this reference to control the sound.

			== Properties and Methods ==

	~~== Properties~~ and ~~Methods =~~=		The following methods and properties apply to the object which is returned by tone = PlayTone(f,d):

	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	\| ~~soundRef~~.~~start(0)~~ \|\| ~~Start playing the sound. PlaySound auto plays, so this is not normally needed~~.		\| tone.oscillator.onended \|\| Name of function to call when tone completes.
	\|-		\|-
	\| ~~soundRef~~.stop(0) \|\| Stop playing the ~~sound~~.		\| tone.oscillator.stop() \|\| Stop playing the tone.
	\|-		\|-
	\| ~~soundRef~~.~~loop~~ \|\| ~~Make the sound loop endlessly~~		\| tone.oscillator.type \|\| Wave form to use. Sine is default. Can be sine, square, sawtooth, triangle or custom.
	\|}		\|}

			For more information, see
			https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createOscillator

	== Example (Basic) ==		== Example (Basic) ==
	<pre>		<pre>
	~~PlaySound "BellToll.wav"~~		PlayTone(440, 1000);
	</pre>		</pre>

	~~Make sound loop~~		Play a chord:
	<pre>		<pre>
	~~bell~~ = ~~PlaySound("BellToll~~.~~wav")~~		Dim C = 261.63
	~~bell~~.~~loop~~=~~True~~		Dim E = 329.63
			Dim G = 392.00
			PlayTone(C, 1000)
			PlayTone(E, 1000)
			PlayTone(G, 1000)
	</pre>		</pre>

	Stop playing ~~sound~~		Stop playing tone
	<pre>		<pre>
	~~bell~~.stop()		tone = PlayTone(440,1000)
			tone.oscillator.stop()
	</pre>		</pre>

	== Example (JavaScript) ==		== Example (JavaScript) ==
	<pre>		<pre>
	~~NSB.PlaySound~~(~~"BellToll.wav"~~);		PlayTone(440, 1000);
	</pre>		</pre>
	~~Make sound loop~~
			Play a chord:
	<pre>		<pre>
	~~bell~~ = ~~NSB~~.~~PlaySound~~(~~"BellToll.wav"~~);		var C = 261.63;
	~~bell.loop=true~~;		var E = 329.63;
			var G = 392.00;
			PlayTone(C, 1000);
			PlayTone(E, 1000);
			PlayTone(G, 1000);
	</pre>		</pre>

	Stop playing ~~sound~~		Stop playing tone:
	<pre>		<pre>
	~~bell~~.stop()		tone = PlayTone(440,1000);
			tone.oscillator.stop();
	</pre>		</pre>

	== Output ==		== Output ==

	(~~sound of a bell tolling~~)		(single tone)
			(chord)
			(nothing - it is stopped before you can hear it start)

	[[Category:Language Reference]]		[[Category:Language Reference]]

	[[Category:Messages]]		[[Category:Messages]]

Ghenne at 18:02, 13 December 2015

2015-12-13T18:02:05Z

← Older revision		Revision as of 18:02, 13 December 2015
Line 1:		Line 1:
			''STILL UNDER CONSTRUCTION''

	PlayTone(''frequency'', ''duration''[, ''volume''])		PlayTone(''frequency'', ''duration''[, ''volume''])

Ghenne: Created page with "PlayTone(''frequency'', ''duration''[, ''volume'']) == Description == PlayTone generates a tone with the specified ''frequency'', ''duration'' and ''volume''. Playback is im..."

2015-12-13T18:01:23Z

Created page with "PlayTone(''frequency'', ''duration''[, ''volume'']) == Description == PlayTone generates a tone with the specified ''frequency'', ''duration'' and ''volume''. Playback is im..."

New page

PlayTone(''frequency'', ''duration''[, ''volume''])

== Description ==

PlayTone generates a tone with the specified ''frequency'', ''duration'' and ''volume''. Playback is immediate, with no on screen controls, making it excellent for user interactions and gaming. The tone is played asynchronously, so if you do PlayTone before the previous tone is complete, two tones will play at the same time, making chords possible.

''frequency''

''duration''

''volume''

PlayTone returns a reference to the sound. You can use this reference to control the sound.

== Properties and Methods ==

{| class="wikitable"
|-
| soundRef.start(0) || Start playing the sound. PlaySound auto plays, so this is not normally needed.
|-
| soundRef.stop(0) || Stop playing the sound.
|-
| soundRef.loop || Make the sound loop endlessly
|}

== Example (Basic) ==
<pre>
PlaySound "BellToll.wav"
</pre>

Make sound loop
<pre>
bell = PlaySound("BellToll.wav")
bell.loop=True
</pre>

Stop playing sound
<pre>
bell.stop()
</pre>

== Example (JavaScript) ==
<pre>
NSB.PlaySound("BellToll.wav");
</pre>
Make sound loop
<pre>
bell = NSB.PlaySound("BellToll.wav");
bell.loop=true;
</pre>

Stop playing sound
<pre>
bell.stop()
</pre>

== Output ==

(sound of a bell tolling)

[[Category:Language Reference]]

[[Category:Messages]]