[398] | 1 | //simple.c: |
---|
| 2 | |
---|
[706] | 3 | /* |
---|
[4708] | 4 | * Copyright (C) Philipp 'ph3-der-loewe' Schafft - 2008-2011 |
---|
[706] | 5 | * The code (may) include prototypes and comments (and maybe |
---|
| 6 | * other code fragements) from libpulse*. They are mostly copyrighted by: |
---|
| 7 | * Lennart Poettering <poettering@users.sourceforge.net> and |
---|
| 8 | * Pierre Ossman <drzeus@drzeus.cx> |
---|
| 9 | * |
---|
| 10 | * This file is part of libroarpulse a part of RoarAudio, |
---|
| 11 | * a cross-platform sound system for both, home and professional use. |
---|
| 12 | * See README for details. |
---|
| 13 | * |
---|
| 14 | * This file is free software; you can redistribute it and/or modify |
---|
| 15 | * it under the terms of the GNU General Public License version 3 |
---|
| 16 | * as published by the Free Software Foundation. |
---|
| 17 | * |
---|
| 18 | * RoarAudio is distributed in the hope that it will be useful, |
---|
| 19 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
| 20 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
| 21 | * GNU General Public License for more details. |
---|
| 22 | * |
---|
| 23 | * You should have received a copy of the GNU General Public License |
---|
| 24 | * along with this software; see the file COPYING. If not, write to |
---|
[3517] | 25 | * the Free Software Foundation, 51 Franklin Street, Fifth Floor, |
---|
| 26 | * Boston, MA 02110-1301, USA. |
---|
[706] | 27 | * |
---|
| 28 | * NOTE for everyone want's to change something and send patches: |
---|
| 29 | * read README and HACKING! There a addition information on |
---|
| 30 | * the license of this document you need to read before you send |
---|
| 31 | * any patches. |
---|
| 32 | * |
---|
| 33 | * NOTE for uses of non-GPL (LGPL,...) software using libesd, libartsc |
---|
| 34 | * or libpulse*: |
---|
| 35 | * The libs libroaresd, libroararts and libroarpulse link this libroar |
---|
| 36 | * and are therefore GPL. Because of this it may be illigal to use |
---|
| 37 | * them with any software that uses libesd, libartsc or libpulse*. |
---|
| 38 | */ |
---|
| 39 | |
---|
[398] | 40 | #include <libroarpulse/libroarpulse.h> |
---|
| 41 | |
---|
[4960] | 42 | #define _seterr() if ( error != NULL ) { *error = roar_pa_raerror2paerror(err); } |
---|
| 43 | |
---|
[402] | 44 | /** Create a new connection to the server */ |
---|
| 45 | pa_simple* pa_simple_new( |
---|
| 46 | const char *server, /**< Server name, or NULL for default */ |
---|
| 47 | const char *name, /**< A descriptive name for this client (application name, ...) */ |
---|
| 48 | pa_stream_direction_t dir, /**< Open this stream for recording or playback? */ |
---|
| 49 | const char *dev, /**< Sink (resp. source) name, or NULL for default */ |
---|
| 50 | const char *stream_name, /**< A descriptive name for this client (application name, song title, ...) */ |
---|
| 51 | const pa_sample_spec *ss, /**< The sample type to use */ |
---|
| 52 | const pa_channel_map *map, /**< The channel map to use, or NULL for default */ |
---|
| 53 | const pa_buffer_attr *attr, /**< Buffering attributes, or NULL for default */ |
---|
| 54 | int *error /**< A pointer where the error code is stored when the routine returns NULL. It is OK to pass NULL here. */ |
---|
| 55 | ) { |
---|
[4960] | 56 | struct roar_keyval kv[1]; |
---|
| 57 | roar_vs_t * vss = NULL; |
---|
[3384] | 58 | struct roar_audio_info info; |
---|
[416] | 59 | int roar_dir; |
---|
[4960] | 60 | int err = ROAR_ERROR_NONE; |
---|
[406] | 61 | |
---|
| 62 | if ( dir == PA_STREAM_PLAYBACK ) { |
---|
[416] | 63 | roar_dir = ROAR_DIR_PLAY; |
---|
[406] | 64 | } else if ( dir == PA_STREAM_RECORD ) { |
---|
[416] | 65 | roar_dir = ROAR_DIR_RECORD; |
---|
[406] | 66 | } else { |
---|
| 67 | return NULL; |
---|
| 68 | } |
---|
| 69 | |
---|
[3384] | 70 | if ( roar_pa_sspec2auinfo(&info, ss) == -1 ) { |
---|
| 71 | return NULL; |
---|
| 72 | } |
---|
[410] | 73 | |
---|
[3389] | 74 | server = roar_pa_find_server((char*)server); |
---|
[418] | 75 | |
---|
[4960] | 76 | vss = roar_vs_new(server, name, &err); |
---|
| 77 | if ( vss == NULL ) { |
---|
| 78 | _seterr(); |
---|
[416] | 79 | return NULL; |
---|
| 80 | } |
---|
| 81 | |
---|
[4960] | 82 | if ( roar_vs_stream(vss, &info, roar_dir, &err) == -1 ) { |
---|
| 83 | roar_vs_close(vss, ROAR_VS_TRUE, NULL); |
---|
| 84 | _seterr(); |
---|
[416] | 85 | return NULL; |
---|
| 86 | } |
---|
| 87 | |
---|
[3848] | 88 | if ( stream_name != NULL && stream_name[0] != 0 ) { |
---|
[4960] | 89 | kv[0].key = "DESCRIPTION"; |
---|
[4961] | 90 | kv[0].value = (char*)stream_name; |
---|
[416] | 91 | |
---|
[4960] | 92 | roar_vs_meta(vss, kv, 1, NULL); |
---|
[418] | 93 | } |
---|
[406] | 94 | |
---|
[4960] | 95 | return (pa_simple*) vss; |
---|
[402] | 96 | } |
---|
| 97 | |
---|
| 98 | /** Close and free the connection to the server. The connection objects becomes invalid when this is called. */ |
---|
| 99 | void pa_simple_free(pa_simple *s) { |
---|
[3848] | 100 | if ( s == NULL ) |
---|
[404] | 101 | return; |
---|
| 102 | |
---|
[4960] | 103 | roar_vs_close((roar_vs_t*)s, ROAR_VS_FALSE, NULL); |
---|
[402] | 104 | } |
---|
| 105 | |
---|
| 106 | /** Write some data to the server */ |
---|
| 107 | int pa_simple_write(pa_simple *s, const void*data, size_t length, int *error) { |
---|
[4960] | 108 | int ret; |
---|
| 109 | int err = ROAR_ERROR_NONE; |
---|
[3848] | 110 | |
---|
| 111 | if ( s == NULL ) |
---|
[404] | 112 | return -1; |
---|
| 113 | |
---|
[4960] | 114 | ret = roar_vs_write((roar_vs_t*)s, data, length, &err); |
---|
| 115 | |
---|
| 116 | _seterr(); |
---|
| 117 | |
---|
| 118 | return ret; |
---|
[402] | 119 | } |
---|
| 120 | |
---|
| 121 | /** Wait until all data already written is played by the daemon */ |
---|
| 122 | int pa_simple_drain(pa_simple *s, int *error) { |
---|
[4960] | 123 | int ret; |
---|
| 124 | int err = ROAR_ERROR_NONE; |
---|
[3848] | 125 | |
---|
| 126 | if ( s == NULL ) |
---|
[404] | 127 | return -1; |
---|
| 128 | |
---|
[4960] | 129 | ret = roar_vs_sync((roar_vs_t*)s, ROAR_VS_WAIT, &err); |
---|
[405] | 130 | |
---|
[4960] | 131 | _seterr(); |
---|
| 132 | |
---|
| 133 | return ret; |
---|
[402] | 134 | } |
---|
| 135 | |
---|
| 136 | /** Read some data from the server */ |
---|
| 137 | int pa_simple_read(pa_simple *s, void*data, size_t length, int *error) { |
---|
[4960] | 138 | int ret; |
---|
| 139 | int err = ROAR_ERROR_NONE; |
---|
[3848] | 140 | |
---|
| 141 | if ( s == NULL ) |
---|
[404] | 142 | return -1; |
---|
| 143 | |
---|
[4960] | 144 | ret = roar_vs_read((roar_vs_t*)s, data, length, &err); |
---|
| 145 | |
---|
| 146 | _seterr(); |
---|
| 147 | |
---|
| 148 | return ret; |
---|
[402] | 149 | } |
---|
| 150 | |
---|
| 151 | /** Return the playback latency. \since 0.5 */ |
---|
| 152 | pa_usec_t pa_simple_get_latency(pa_simple *s, int *error) { |
---|
[4960] | 153 | roar_mus_t ret; |
---|
| 154 | int err = ROAR_ERROR_NONE; |
---|
[3848] | 155 | |
---|
| 156 | if ( s == NULL ) |
---|
[404] | 157 | return -1; |
---|
| 158 | |
---|
[4960] | 159 | ret = roar_vs_latency((roar_vs_t*)s, ROAR_VS_BACKEND_DEFAULT, &err); |
---|
| 160 | |
---|
| 161 | if ( ret < 0 ) |
---|
| 162 | ret *= -1; |
---|
| 163 | |
---|
| 164 | if ( ret == 0 && err != ROAR_ERROR_NONE ) { |
---|
| 165 | _seterr(); |
---|
| 166 | return -1; |
---|
| 167 | } |
---|
| 168 | |
---|
| 169 | return ret; |
---|
[402] | 170 | } |
---|
| 171 | |
---|
| 172 | /** Flush the playback buffer. \since 0.5 */ |
---|
| 173 | int pa_simple_flush(pa_simple *s, int *error) { |
---|
[4960] | 174 | int ret; |
---|
| 175 | int err = ROAR_ERROR_NONE; |
---|
[3848] | 176 | |
---|
| 177 | if ( s == NULL ) |
---|
[404] | 178 | return -1; |
---|
| 179 | |
---|
[4960] | 180 | ret = roar_vs_sync((roar_vs_t*)s, ROAR_VS_NOWAIT, &err); |
---|
| 181 | |
---|
| 182 | _seterr(); |
---|
| 183 | |
---|
| 184 | return ret; |
---|
[402] | 185 | } |
---|
| 186 | |
---|
[398] | 187 | //ll |
---|