Difference between revisions of "SNDBAL"

From QB64 Wiki
Jump to navigation Jump to search
imported>Clippy
m
imported>Clippy
m
Line 21: Line 21:
  
 
{{PageExamples}}
 
{{PageExamples}}
{{CodeStart}}
+
{{CodeStart}} '' ''
 
+
h& = {{Cl|_SNDOPEN}}("LOL.wav", "SYNC,VOL")
{{Cl|_SNDBAL}} h&, -1 'sound coming from the left
+
{{Cl|_SNDBAL}} h&, 1
 
+
{{Cl|_SNDPLAY}} h& '' ''
 
{{CodeEnd}}
 
{{CodeEnd}}
  

Revision as of 20:47, 22 August 2011

The _SNDBAL statement attempts to set the balance or 3D position of a sound.


Syntax

_SNDBAL handle&[, x!][, y!][, z!]


Description

  • Attempts to position a sound in 3D space, or as close to it as the underlying software libraries allow. In some cases, this will be true 3D positioning, in others, a mere volume adjustment based on distance alone.
  • x distance values go from left(negative) to right(positive).
  • y distance values go from below(negative) to above(positive).
  • z distance values go from behind(negative) to in front(positive).
  • Omitted x, y or z SINGLE values are set to 0.
  • By setting the x value to -1 or 1 it plays the sound at full volume from the appropriate speaker.
  • Sounds at a distance of 1 or -1 are played at full volume. Sounds further than a distance of 1000 cannot be heard.
  • The volume decreases linearly (at a constant gradient) over distance. Half volume = 500.
  • Opened sound files must have the "VOL" capability to use this statement.
  • The sound file should have the "SYNC" capability when more than one sound is being used at the same time!
  • An "ILLEGAL FUNCTION CALL" error can occur if another sound is using the primary or same channel position.


Examples

h& = _SNDOPEN("LOL.wav", "SYNC,VOL") _SNDBAL h&, 1 _SNDPLAY h&



See also




Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page