aboutsummaryrefslogtreecommitdiffhomepage
path: root/include/sound.hpp
blob: d78e4b69e567b7dd23af9dcf69fbdd4d3645ec95 (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
86
87
88
89
90
91
/*
    Copyright (C) 2020 dec05eba

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program 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 General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.
*/

#ifndef GPU_SCREEN_RECORDER_H
#define GPU_SCREEN_RECORDER_H

#include <optional>
#include <vector>
#include <string>

typedef struct {
    void *handle;
    unsigned int frames;
} SoundDevice;

struct AudioDevice {
    std::string name;
    std::string description;
};

struct AudioDevices {
    std::string default_output;
    std::string default_input;
    std::vector<AudioDevice> audio_inputs;
};

enum class AudioInputType {
    DEVICE,
    APPLICATION
};

struct AudioInput {
    std::string name;
    AudioInputType type = AudioInputType::DEVICE;
    bool inverted = false;
};

struct MergedAudioInputs {
    std::optional<std::string> custom_name;
    std::string track_name;
    std::vector<AudioInput> audio_inputs;
};

typedef enum {
    S16,
    S32,
    F32
} AudioFormat;

/*
    Get a sound device by name, returning the device into the |device| parameter.
    |device_name| can be a device name or "default_output", "default_input" or "" to not connect to any device (used for app audio for example).
    If the device name is "default_output" or "default_input" then it will automatically switch which
    device is records from when the default output/input is changed in the system audio settings.
    Returns 0 on success, or a negative value on failure.
*/
int sound_device_get_by_name(SoundDevice *device, const char *node_name, const char *device_name, const char *description, unsigned int num_channels, unsigned int period_frame_size, AudioFormat audio_format);

void sound_device_close(SoundDevice *device);

/*
    Discards the audio that has been captured so far.
    Call this before the first call to sound_device_read_next_chunk to not get audio that was captured before that point,
    since the sound device can be created a while before audio capture starts.
*/
void sound_device_flush(SoundDevice *device);

/*
    Returns the next chunk of audio into @buffer.
    Returns the number of frames read, or a negative value on failure.
*/
int sound_device_read_next_chunk(SoundDevice *device, void **buffer, double timeout_sec, double *latency_seconds);

AudioDevices get_pulseaudio_inputs();
bool pulseaudio_server_is_pipewire();

#endif /* GPU_SCREEN_RECORDER_H */