NAME
====
  vg_sound_startserver() - start sound-server


SYNOPSIS
========
  int vg_sound_startserver(int srate, int channels, const char * output)


DESCRIPTION
===========
  Starts the sound-server vgag-sound located in the VgaGames-install-directory
  "/usr/share/vgagames" under "bin/" (or in your local install directory).

  srate is the initial sample rate the sound-server uses at start.
    Valid are 11025, 22050 or 44100.
    Default (if srate is 0) is 22050.

  channels is 1=mono or 2=stereo.
    Default (if channels is 0) is 2=stereo.

  output is used only for debugging purposes, a filename (relative to
    your game-directory), where to give out the messages of the sound-server.
    For real life use NULL as value.

  End the sound-server with vg_sound_endserver().


RETURN VALUE
============
  If it succeeds, it returns 0.
  If an error occurs, it returns -1, giving out an error message to stderr.


NOTE
====
  You can play more sounds at the same time, they are mixed together.
  They can have different file-formats (wave, midi ...),
  different channel-numbers, e.g. one is mono, the other stereo,
  and different sample rates (11025, 22050, 44100).


SEE ALSO
========
  Index
  Understanding sound
  vg_sound_endserver()
  vg_sound_attach()
  vg_sound_play()
  vg_sound_paus()
  vg_sound_cont()
  vg_sound_pate()
  vg_sound_catb()
  vg_sound_stop()
  vg_sound_gclr()
  vg_sound_gadd()
  vg_sound_gdel()
  vg_sound_volm()
  vg_sound_volumename()