PulseAudio  3.0
format.h
Go to the documentation of this file.
1 #ifndef fooformathfoo
2 #define fooformathfoo
3 
4 /***
5  This file is part of PulseAudio.
6 
7  Copyright 2011 Intel Corporation
8  Copyright 2011 Collabora Multimedia
9  Copyright 2011 Arun Raghavan <arun.raghavan@collabora.co.uk>
10 
11  PulseAudio is free software; you can redistribute it and/or modify
12  it under the terms of the GNU Lesser General Public License as published
13  by the Free Software Foundation; either version 2.1 of the License,
14  or (at your option) any later version.
15 
16  PulseAudio is distributed in the hope that it will be useful, but
17  WITHOUT ANY WARRANTY; without even the implied warranty of
18  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19  General Public License for more details.
20 
21  You should have received a copy of the GNU Lesser General Public License
22  along with PulseAudio; if not, write to the Free Software
23  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
24  USA.
25 ***/
26 
27 #include <pulse/cdecl.h>
28 #include <pulse/gccmacro.h>
29 #include <pulse/proplist.h>
30 #include <pulse/sample.h>
31 #include <pulse/channelmap.h>
32 
36 PA_C_DECL_BEGIN
37 
39 typedef enum pa_encoding {
64 
67 
69 pa_encoding_t pa_encoding_from_string(const char *encoding);
70 
72 typedef struct pa_format_info {
79 
82 
85 
88 
91 
94 
103 
109 #define PA_FORMAT_INFO_SNPRINT_MAX 256
110 
112 char *pa_format_info_snprint(char *s, size_t l, const pa_format_info *f);
113 
117 
120 
127 
129 typedef enum pa_prop_type_t {
148 
151 
153 int pa_format_info_get_prop_int(pa_format_info *f, const char *key, int *v);
156 int pa_format_info_get_prop_int_range(pa_format_info *f, const char *key, int *min, int *max);
160 int pa_format_info_get_prop_int_array(pa_format_info *f, const char *key, int **values, int *n_values);
163 int pa_format_info_get_prop_string(pa_format_info *f, const char *key, char **v);
167 int pa_format_info_get_prop_string_array(pa_format_info *f, const char *key, char ***values, int *n_values);
168 
170 void pa_format_info_free_string_array(char **values, int n_values);
171 
173 void pa_format_info_set_prop_int(pa_format_info *f, const char *key, int value);
175 void pa_format_info_set_prop_int_array(pa_format_info *f, const char *key, const int *values, int n_values);
177 void pa_format_info_set_prop_int_range(pa_format_info *f, const char *key, int min, int max);
179 void pa_format_info_set_prop_string(pa_format_info *f, const char *key, const char *value);
181 void pa_format_info_set_prop_string_array(pa_format_info *f, const char *key, const char **values, int n_values);
182 
186 void pa_format_info_set_rate(pa_format_info *f, int rate);
188 void pa_format_info_set_channels(pa_format_info *f, int channels);
191 
192 PA_C_DECL_END
193 
194 #endif
pa_format_info * pa_format_info_from_string(const char *str)
Parse a human-readable string of the form generated by pa_format_info_snprint() into a pa_format_info...
pa_format_info * pa_format_info_copy(const pa_format_info *src)
Returns a new pa_format_info struct and representing the same format as src.
A sample format and attribute specification.
Definition: sample.h:243
void pa_format_info_set_channels(pa_format_info *f, int channels)
Convenience method to set the number of channels as a property on the given format.
EAC3 data encapsulated in IEC 61937 header/padding.
Definition: format.h:49
void pa_format_info_free(pa_format_info *f)
Frees a pa_format_info structure.
void pa_format_info_set_prop_string(pa_format_info *f, const char *key, const char *value)
Sets a string property on the given format info.
pa_encoding_t encoding
The encoding used for the format.
Definition: format.h:73
Integer range property.
Definition: format.h:133
pa_encoding
Represents the type of encoding used in a stream or accepted by a sink.
Definition: format.h:39
int pa_format_info_get_prop_int(pa_format_info *f, const char *key, int *v)
Gets an integer property from the given format info.
int pa_format_info_get_prop_int_array(pa_format_info *f, const char *key, int **values, int *n_values)
Gets an integer array property from the given format info.
#define PA_GCC_CONST
This function&#39;s return value depends only the arguments list (stricter version of PA_GCC_PURE) ...
Definition: gccmacro.h:84
enum pa_encoding pa_encoding_t
Represents the type of encoding used in a stream or accepted by a sink.
void pa_format_info_set_prop_int_array(pa_format_info *f, const char *key, const int *values, int n_values)
Sets a property with a list of integer values on the given format info.
Valid encoding types must be less than this value.
Definition: format.h:58
enum pa_sample_format pa_sample_format_t
Sample format.
pa_format_info * pa_format_info_new(void)
Allocates a new pa_format_info structure.
Represents an invalid type.
Definition: format.h:145
Constants and routines for channel mapping handling.
pa_prop_type_t
Represents the type of value type of a property on a pa_format_info.
Definition: format.h:129
void pa_format_info_set_channel_map(pa_format_info *f, const pa_channel_map *map)
Convenience method to set the channel map as a property on the given format.
pa_format_info * pa_format_info_from_sample_spec(pa_sample_spec *ss, pa_channel_map *map)
Utility function to take a pa_sample_spec and generate the corresponding pa_format_info.
pa_proplist * plist
Additional encoding-specific properties such as sample rate, bitrate, etc.
Definition: format.h:76
String property.
Definition: format.h:139
GCC attribute macros.
Integer array property.
Definition: format.h:136
Represents an invalid encoding.
Definition: format.h:61
int pa_format_info_valid(const pa_format_info *f)
Returns non-zero when the format info structure is valid.
DTS data encapsulated in IEC 61937 header/padding.
Definition: format.h:55
void pa_format_info_free_string_array(char **values, int n_values)
Frees a string array returned by pa_format_info_get_prop_string_array.
MPEG-1 or MPEG-2 (Part 3, not AAC) data encapsulated in IEC 61937 header/padding. ...
Definition: format.h:52
Integer property.
Definition: format.h:130
void pa_format_info_set_prop_string_array(pa_format_info *f, const char *key, const char **values, int n_values)
Sets a property with a list of string values on the given format info.
void pa_format_info_set_prop_int_range(pa_format_info *f, const char *key, int min, int max)
Sets a property which can have any value in a given integer range on the given format info...
Constants and routines for sample type handling.
char * pa_format_info_snprint(char *s, size_t l, const pa_format_info *f)
Return a human-readable string representing the given format.
int pa_format_info_get_prop_int_range(pa_format_info *f, const char *key, int *min, int *max)
Gets an integer range property from the given format info.
int pa_format_info_get_prop_string(pa_format_info *f, const char *key, char **v)
Gets a string property from the given format info.
void pa_format_info_set_prop_int(pa_format_info *f, const char *key, int value)
Sets an integer property on the given format info.
int pa_format_info_is_pcm(const pa_format_info *f)
Returns non-zero when the format info structure represents a PCM (i.e. uncompressed data) format...
int pa_format_info_get_prop_string_array(pa_format_info *f, const char *key, char ***values, int *n_values)
Gets a string array property from the given format info.
String array property.
Definition: format.h:142
Any PCM format.
Definition: format.h:43
int pa_format_info_is_compatible(pa_format_info *first, pa_format_info *second)
Returns non-zero if the format represented by first is a subset of the format represented by second...
const char * pa_encoding_to_string(pa_encoding_t e) PA_GCC_CONST
Returns a printable string representing the given encoding type.
Any encoding format, PCM or compressed.
Definition: format.h:40
pa_prop_type_t pa_format_info_get_prop_type(pa_format_info *f, const char *key)
Gets the type of property key in a given pa_format_info.
Represents the format of data provided in a stream or processed by a sink.
Definition: format.h:72
A channel map which can be used to attach labels to specific channels of a stream.
Definition: channelmap.h:264
struct pa_proplist pa_proplist
A property list object.
Definition: proplist.h:274
AC3 data encapsulated in IEC 61937 header/padding.
Definition: format.h:46
void pa_format_info_set_rate(pa_format_info *f, int rate)
Convenience method to set the sampling rate as a property on the given format.
Property list constants and functions.
struct pa_format_info pa_format_info
Represents the format of data provided in a stream or processed by a sink.
pa_encoding_t pa_encoding_from_string(const char *encoding)
Converts a string of the form returned by pa_encoding_to_string() back to a pa_encoding_t.
int pa_format_info_to_sample_spec(pa_format_info *f, pa_sample_spec *ss, pa_channel_map *map)
Utility function to generate a pa_sample_spec and pa_channel_map corresponding to a given pa_format_i...
void pa_format_info_set_sample_format(pa_format_info *f, pa_sample_format_t sf)
Convenience method to set the sample format as a property on the given format.