Home Explore Help
Sign In
blitz
/
blitz3d
mirror of https://github.com/blitz-research/blitz3d.git
2
0
Fork 0
Files Issues 0 Wiki
Branch: master
Branches Tags
blitz3d
/
_release
/
help
/
commands
/
2d_commands
/
PauseChannel.htm

PauseChannel.htm 2.0 KB
Permalink History Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576 
  1. <html>
    2. 

  2. <head>
    3. 

  3. <title>Blitz3D Docs</title>
    4. 

  4. <link rel=stylesheet href=../css/commands.css type=text/css>
    5. 

  5. </head>
    6. 

  6. <body>
    7. 

  7. <h1>PauseChannel channel_handle</h1>
    8. 

  8. <h1>Parameters</h1>
    9. 

  9. <table>
    10. 

  10. <tr>
    11. 

  11. <td>
    12. 

  12. channel_handle = variable assigned to the channel when played 
    13. 

  13. </td>
    14. 

  14. </tr>
    15. 

  15. </table>
    16. 

  16. <h1>Description</h1>
    17. 

  17. <table>
    18. 

  18. <tr>
    19. 

  19. <td>
    20. 

  20. When you are playing a sound channel, there may come a time you wish to  pause the sound for whatever reason (like to play another sound effect). This  command does this - and the channel can be resumed with the ResumeChannel command. You can use StopChannel to actually halt the sound. This works  with any channel playback (WAV, MP3, MIDI, etc.).
    21. 

  21. </td>
    22. 

  22. </tr>
    23. 

  23. </table>
    24. 

  24. <h1><a href=../2d_examples/PauseChannel.bb>Example</a></h1>
    25. 

  25. <table>
    26. 

  26. <tr>
    27. 

  27. <td>
    28. 

  28. ; Channel examples
<br />
    29. 

  29. 
<br />
    30. 

  30. Print "Loading sound ..."
<br />
    31. 

  31. ; Load the sample - you'll need to point this to a sound on your computer
<br />
    32. 

  32. ; For best results, make it about 5-10 seconds...
<br />
    33. 

  33. sndWave=LoadSound("level1.wav")
<br />
    34. 

  34. ; Prepare the sound for looping
<br />
    35. 

  35. LoopSound sndWave
<br />
    36. 

  36. 
<br />
    37. 

  37. chnWave=PlaySound(sndWave)
<br />
    38. 

  38. 
<br />
    39. 

  39. Print "Playing sound for 2 seconds ..."
<br />
    40. 

  40. Delay 2000
<br />
    41. 

  41. 
<br />
    42. 

  42. Print "Pausing sound for 2 seconds ..."
<br />
    43. 

  43. PauseChannel chnWave
<br />
    44. 

  44. Delay 2000
<br />
    45. 

  45. 
<br />
    46. 

  46. Print "Restarting sound ..."
<br />
    47. 

  47. ResumeChannel chnWave
<br />
    48. 

  48. Delay 2000
<br />
    49. 

  49. 
<br />
    50. 

  50. Print "Changing Pitch of sound ..."
<br />
    51. 

  51. ;StopChannel chnWave
<br />
    52. 

  52. ChannelPitch chnWave, 22000
<br />
    53. 

  53. Delay 2000
<br />
    54. 

  54. 
<br />
    55. 

  55. Print "Playing new pitched sound ..."
<br />
    56. 

  56. Delay 2000
<br />
    57. 

  57. 
<br />
    58. 

  58. Print "Left speaker only"
<br />
    59. 

  59. ChannelPan chnWave,-1
<br />
    60. 

  60. Delay 2000
<br />
    61. 

  61. 
<br />
    62. 

  62. Print "Right speaker only"
<br />
    63. 

  63. ChannelPan chnWave,1
<br />
    64. 

  64. Delay 2000
<br />
    65. 

  65. 
<br />
    66. 

  66. Print "All done!"
<br />
    67. 

  67. StopChannel chnWave
<br />
    68. 

  68. 

  69. </td>
    70. 

  70. </tr>
    71. 

  71. </table>
    72. 

  72. <br>
    73. 

  73. <a target=_top href=../index.htm>Index</a><br>
    74. 

  74. <br>
    75. 

  75. Click <a href=http://www.blitzbasic.co.nz/b3ddocs/command.php?name=PauseChannel&ref=comments target=_blank>here</a> to view the latest version of this page online</body>
    76. 

  76. </html>
    77.