:mod:`pygame2.sdlmixer.channel` -- SDL_mixer sound channel handling
===================================================================

This module takes care of general sound channel management and operations,
which can apply to one or multiple channels at once without having a
concrete :class:`Channel` object around.


.. module:: pygame2.sdlmixer.channel
   :synopsis: SDL_mixer sound channel handling

Module Functions
----------------
.. function:: allocate (amount) -> (Channel, Channel, ...)

  (Pre-)Allocates a set of Channel objects.



.. function:: expire (ms) -> None

  Halts the playback of all channels after *ms* milliseconds.


.. function:: fade_out (ms) -> int

  Fades out the current audio playback for all channels.

  This gradually reduces the volume for all channels to 0 over *ms*
  milliseconds. The channels will be halted after the fadeout is complete.

  The number of channels set to fade out will be returned.



.. function:: get_volume () -> int

  Gets the currently set overall volume for all Channel objects.


.. function:: halt () -> None

  Stops the sound playback for all Channel objects.


.. function:: opened () -> int

  Gets the number of currently open (allocated) channels.


.. function:: pause () -> None

  Pauses the sound playback for all Channel objects.


.. function:: paused () -> int

  Gets the number of channels being currently paused.


.. function:: playing () -> int

  Gets the number of channels currently playing.


.. function:: resume () -> None

  Resumes the playback for all paused Channel objects.


.. function:: set_volume (volume) -> int

  Sets the overall volume for all available Channel objects.

  Sets the volume for all available Channel objects and returns the previous
  set volume.




