diff options
author | Pierre Ossman <ossman@cendio.se> | 2006-04-09 19:31:09 +0000 |
---|---|---|
committer | Pierre Ossman <ossman@cendio.se> | 2006-04-09 19:31:09 +0000 |
commit | a6ce5c4b1d82870f5db7063680698cebb4ffe156 (patch) | |
tree | f60708ee269c4f11f0a7017896c8a63507166a5a /src/polyp/channelmap.h | |
parent | a74253606f4f5556e58cb12336d8900dd73226cc (diff) |
Big documentation update. Describe the client API in a more tutorial like
manner.
git-svn-id: file:///home/lennart/svn/public/pulseaudio/trunk@667 fefdeb5f-60dc-0310-8127-8f9354f1896f
Diffstat (limited to 'src/polyp/channelmap.h')
-rw-r--r-- | src/polyp/channelmap.h | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/src/polyp/channelmap.h b/src/polyp/channelmap.h index dd508abe..c74f2ceb 100644 --- a/src/polyp/channelmap.h +++ b/src/polyp/channelmap.h @@ -25,6 +25,40 @@ #include <polyp/sample.h> #include <polyp/cdecl.h> +/** \page channelmap Channel maps + * + * \section overv_sec Overview + * + * Channel maps provide a way to associate channels in a stream with a + * speaker. This relieves applications of having to make sure their channel + * order is identical to the final output. + * + * \section init_sec Initialisation + * + * A channel map consists of an array of \ref pa_channel_position values, + * one for each channel. This array is stored together with a channel count + * in a pa_channel_map structure. + * + * Before filling the structure, the application must initialise it using + * pa_channel_map_init(). There are also a number of convenience functions + * for standard channel mappings: + * + * \li pa_channel_map_init_mono() - Create a channel map with only mono audio. + * \li pa_channel_map_init_stereo() - Create a standard stereo mapping. + * \li pa_channel_map_init_auto() - Create a standard channel map for up to + * six channels. + * + * \section conv_sec Convenience functions + * + * The library contains a number of convenience functions for dealing with + * channel maps: + * + * \li pa_channel_map_valid() - Tests if a channel map is valid. + * \li pa_channel_map_equal() - Tests if two channel maps are identical. + * \li pa_channel_map_snprint() - Creates a textual description of a channel + * map. + */ + /** \file * Constants and routines for channel mapping handling */ |