mirrors/pulseaudio
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/pulseaudio/pulseaudio.git synced 2025-11-05 13:29:57 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

stream-util: Add pa_stream_get_volume_channel_map()

Browse source 
The new function isn't used yet, but it soon will.
This commit is contained in:
Tanu Kaskinen 2013-12-17 21:17:55 +02:00
parent a3a795ef3d
commit 6cdb569b83
3 changed files with 137 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

50
src/pulsecore/stream-util.h Normal file
View file

@ -0,0 +1,50 @@
#ifndef foostreamutilhfoo
#define foostreamutilhfoo
/***
This file is part of PulseAudio.
Copyright 2013 Intel Corporation
PulseAudio is free software; you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published
by the Free Software Foundation; either version 2.1 of the License,
or (at your option) any later version.
PulseAudio is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with PulseAudio; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
USA.
***/
#include <pulse/format.h>
#include <pulse/volume.h>
/* This is a helper function that is called from pa_sink_input_new() and
* pa_source_output_new(). The job of this function is to figure out what
* channel map should be used for interpreting the volume that was set for the
* stream. The channel map that the client intended for the volume may be
* different than the final stream channel map, because the client may want the
* server to decide the stream channel map.
*
* volume is the volume for which the channel map should be figured out.
*
* original_map is the channel map that is set in the new data struct's
* channel_map field. If the channel map hasn't been set in the new data, then
* original_map should be NULL.
*
* format is the negotiated format for the stream. It's used as a fallback if
* original_map is not available.
*
* On success, the result is saved in volume_map. It's possible that this
* function fails to figure out the right channel map for the volume, in which
* case a negative error code is returned. */
int pa_stream_get_volume_channel_map(const pa_cvolume *volume, const pa_channel_map *original_map, const pa_format_info *format,
pa_channel_map *volume_map);
#endif