SNDBAL

From QB64 Wiki
Revision as of 20:47, 22 August 2011 by imported>Clippy
Jump to navigation Jump to search

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