aboutsummaryrefslogtreecommitdiffstats
path: root/src/audiomixer.h
blob: 941179fc07d5ddef3ed95a8cf17e8e4cedef7da7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
/*
 * Copyright © 2019 Collabora Ltd.
 *   @author George Kiagiadakis <george.kiagiadakis@collabora.com>
 *
 * SPDX-License-Identifier: MIT
 */

#ifndef _AUDIOMIXER_H
#define _AUDIOMIXER_H

#ifdef __cplusplus
extern "C" {
#endif

#include <stdbool.h>

struct audiomixer;

struct mixer_control
{
	char name[32];
	double volume;
	double lvolume; /* left channel volume */
	double rvolume; /* right channel volume */
	float gain;
	bool mute;
};

#define MIXER_CONTROL_CHANGE_FLAG_VOLUME		(1<<0)
#define MIXER_CONTROL_CHANGE_FLAG_CHANNEL_VOLUME	(1<<1)
#define MIXER_CONTROL_CHANGE_FLAG_MUTE			(1<<2)
#define MIXER_CONTROL_CHANGE_FLAG_GAIN			(1<<3)

struct audiomixer_events
{
	void (*controls_changed) (void *data);

	void (*value_changed) (void *data,
				unsigned int change_mask,
				const struct mixer_control *control);
};

struct audiomixer * audiomixer_new(void);
void audiomixer_free(struct audiomixer *self);

/* locking is required to call any of the methods below
 * and to access any structure maintained by audiomixer */
void audiomixer_lock(struct audiomixer *self);
void audiomixer_unlock(struct audiomixer *self);

int audiomixer_ensure_controls(struct audiomixer *self, int timeout_sec);

const struct mixer_control ** audiomixer_get_active_controls(
	struct audiomixer *self,
	unsigned int *n_controls);

const struct mixer_control * audiomixer_find_control(
	struct audiomixer *self,
	const char *name);

void audiomixer_add_event_listener(struct audiomixer *self,
	const struct audiomixer_events *events,
	void *data);

void audiomixer_change_volume(struct audiomixer *self,
	const struct mixer_control *control,
	double volume);

void audiomixer_change_channel_volume (struct audiomixer *self,
	const struct mixer_control *control,
	double left_channel_volume, double right_channel_volume);

void audiomixer_change_gain(struct audiomixer *self,
	const struct mixer_control *control,
	float gain);

void audiomixer_change_mute(struct audiomixer *self,
	const struct mixer_control *control,
	bool mute);

#ifdef __cplusplus
}
#endif

#endif // _AUDIOMIXER_H