Files
BlitzNext/_release/help/commands/2d_commands/StopChannel.htm
T
2014-12-08 12:43:20 +13:00

79 lines
2.0 KiB
HTML

<html>
<head>
<title>Blitz3D Docs</title>
<link rel=stylesheet href=../css/commands.css type=text/css>
</head>
<body>
<h1>StopChannel channel_handle</h1>
<h1>Parameters</h1>
<table>
<tr>
<td>
channel_handle = variable assigned to the channel when played
</td>
</tr>
</table>
<h1>Description</h1>
<table>
<tr>
<td>
This command replaced StopSound in the latter versions of Blitz Basic.
<br />
<br />
Once you have a sound playing, and a channel variable attached to it, you use this command to stop the sound. This works for all sound channel types, including MP3, WAV, MIDI, and CD track playback.
</td>
</tr>
</table>
<h1><a href=../2d_examples/StopChannel.bb>Example</a></h1>
<table>
<tr>
<td>
; Channel examples
<br />
<br />
Print "Loading sound ..."
<br />
; Load the sample - you'll need to point this to a sound on your computer
<br />
; For best results, make it about 5-10 seconds...
<br />
sndWave=LoadSound("level1.wav")
<br />
; Prepare the sound for looping
<br />
LoopSound sndWave
<br />
<br />
chnWave=PlaySound(sndWave)
<br />
<br />
Print "Playing sound for 2 seconds ..."
<br />
Delay 2000
<br />
<br />
Print "Pausing sound for 2 seconds ..."
<br />
PauseChannel chnWave
<br />
Delay 2000
<br />
<br />
Print "Restarting sound ..."
<br />
ResumeChannel chnWave
<br />
Delay 2000
<br />
<br />
Print "Changing Pitch of sound ..."
<br />
;StopChannel chnWave
<br />
ChannelPitch chnWave, 22000
<br />
Delay 2000
<br />
<br />
Print "Playing new pitched sound ..."
<br />
Delay 2000
<br />
<br />
Print "Left speaker only"
<br />
ChannelPan chnWave,-1
<br />
Delay 2000
<br />
<br />
Print "Right speaker only"
<br />
ChannelPan chnWave,1
<br />
Delay 2000
<br />
<br />
Print "All done!"
<br />
StopChannel chnWave
<br />
</td>
</tr>
</table>
<br>
<a target=_top href=../index.htm>Index</a><br>
<br>
Click <a href=http://www.blitzbasic.co.nz/b3ddocs/command.php?name=StopChannel&ref=comments target=_blank>here</a> to view the latest version of this page online</body>
</html>