source: roaraudio/include/roaraudio.h @ 4494:7a2fcbb1c891

Last change on this file since 4494:7a2fcbb1c891 was 4494:7a2fcbb1c891, checked in by phi, 13 years ago

added global files for caps

File size: 8.3 KB
Line 
1//roaraudio.h:
2
3/*
4 *      Copyright (C) Philipp 'ph3-der-loewe' Schafft - 2008-2010
5 *
6 *  This file is part of RoarAudio,
7 *  a cross-platform sound system for both, home and professional use.
8 *  See README for details.
9 *
10 *  This file is free software; you can redistribute it and/or modify
11 *  it under the terms of the GNU Lesser General Public License version 3
12 *  as published by the Free Software Foundation.
13 *
14 *  RoarAudio is distributed in the hope that it will be useful,
15 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
16 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17 *  GNU Lesser General Public License for more details.
18 *
19 *  You should have received a copy of the GNU Lesser General Public License
20 *  along with this software; see the file COPYING.  If not, write to
21 *  the Free Software Foundation, 51 Franklin Street, Fifth Floor,
22 *  Boston, MA 02110-1301, USA.
23 *
24 *  NOTE: Even though this file is LGPLed it (may) include GPLed files
25 *  so the license of this file is/may therefore downgraded to GPL.
26 *  See HACKING for details.
27 */
28
29#ifndef _ROARAUDIO_H_
30#define _ROARAUDIO_H_
31
32#define  _ROAR_MKVERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c))
33
34#include <roaraudio/config.h>
35#include <roaraudio/targethacks.h>
36#include <roaraudio/muconthacks.h>
37#include <roaraudio/win32hacks.h> // we include this at the beginning of the file
38                                  // so we can define well known standard types known to everyone
39                                  // and everywhere but win32 here
40
41// consts we need to set depending on the OS and features:
42#if defined(ROAR_NEED_GNU_SOURCE) && !defined(_GNU_SOURCE)
43#define _GNU_SOURCE
44#endif
45
46#if defined(ROAR_NEED_BSD_VISIBLE) && !defined(__BSD_VISIBLE)
47#define __BSD_VISIBLE 1
48#endif
49
50#include <stdint.h>
51#include <stdlib.h>
52
53#ifdef ROAR_HAVE_H_UNISTD
54#include <unistd.h>
55#endif
56
57#include <stdio.h>
58#include <string.h>
59#include <errno.h>
60
61#ifdef ROAR_HAVE_H_SYS_TYPES
62#include <sys/types.h>
63#endif
64
65#include <limits.h>
66#if !defined(ROAR_TARGET_WIN32) && !defined(ROAR_TARGET_MICROCONTROLLER)
67#include <sys/mman.h>
68#endif
69
70// TODO: can we move the next block into roard specific includes?
71#if !defined(ROAR_TARGET_WIN32) && !defined(ROAR_TARGET_MICROCONTROLLER)
72#include <grp.h>
73#include <pwd.h>
74#include <sys/stat.h>
75#endif
76
77#ifdef ROAR_TARGET_WIN32
78#include <winsock2.h>
79#else /* ROAR_TARGET_WIN32 */
80#ifdef ROAR_HAVE_BSDSOCKETS
81
82#if defined(ROAR_HAVE_IPV4) || defined(ROAR_HAVE_IPV6)
83#include <arpa/inet.h>
84#endif
85
86#ifdef ROAR_HAVE_SELECT
87#include <sys/socket.h>
88#endif
89
90#ifdef ROAR_HAVE_IPV4
91#include <netinet/in.h>
92#include <netinet/tcp.h>
93#endif
94#ifdef ROAR_HAVE_UNIX
95#include <sys/un.h>
96#endif
97
98#endif /* ROAR_HAVE_BSDSOCKETS */
99#endif /* ROAR_TARGET_WIN32 */
100
101#ifdef __NetBSD__
102#include <netinet/in_systm.h>
103#endif
104
105#if !defined(ROAR_TARGET_WIN32) && !defined(ROAR_TARGET_MICROCONTROLLER)
106#include <netdb.h>
107#endif
108
109// NOTE: we need this macro in some of our header files.
110// TODO: This is oubslute, we will remove it soon.
111#if INT_MAX >= 32767
112#define roar_intm16  int
113#define roar_uintm16 unsigned int
114#else
115#define roar_intm16  int16_t
116#define roar_uintm16 uint16_t
117#endif
118
119// this is to avoid warning messages on platforms
120// where sizeof(void*) == 8 and szeof(int) == 4
121#ifdef __LP64__
122#define ROAR_INSTINT long int
123#else
124#define ROAR_INSTINT int
125#endif
126
127#ifndef __BEGIN_DECLS
128#ifdef __cplusplus
129# define __BEGIN_DECLS extern "C" {
130# define __END_DECLS }
131#else
132# define __BEGIN_DECLS
133# define __END_DECLS
134#endif
135#endif
136
137__BEGIN_DECLS
138
139#include <roaraudio/proto.h>
140#include <roaraudio/caps.h>
141#include <roaraudio/error.h>
142#include <roaraudio/audio.h>
143#include <roaraudio/stream.h>
144#include <roaraudio/client.h>
145#include <roaraudio/sample.h>
146#include <roaraudio/beep.h>
147#include <roaraudio/meta.h>
148#include <roaraudio/genre.h>
149#include <roaraudio/acl.h>
150#include <roaraudio/misc.h>
151#include <roaraudio/byteorder.h>
152#include <roaraudio/socket.h>
153#include <roaraudio/ltm.h>
154#include <roaraudio/notify.h>
155
156#include <libroar/libroar.h>
157
158// Some glocal network defaults:
159#ifndef ROAR_NET_INET4_LOCALHOST
160#define ROAR_NET_INET4_LOCALHOST "localhost"
161#endif
162#ifndef ROAR_NET_INET4_ANYHOST
163#define ROAR_NET_INET4_ANYHOST   "0.0.0.0"
164#endif
165
166#ifndef ROAR_NET_INET6_LOCALHOST
167#define ROAR_NET_INET6_LOCALHOST "ipv6-localhost"
168#endif
169#ifndef ROAR_NET_INET6_ANYHOST
170#define ROAR_NET_INET6_ANYHOST   "::"
171#endif
172
173// IP:
174#define ROAR_DEFAULT_PORT        16002
175
176// IPv4
177#define ROAR_DEFAULT_INET4_PORT  ROAR_DEFAULT_PORT
178#define ROAR_DEFAULT_INET4_HOST  ROAR_NET_INET4_LOCALHOST
179// aliases:
180#define ROAR_DEFAULT_HOST        ROAR_DEFAULT_INET4_HOST
181
182// IPv6:
183#define ROAR_DEFAULT_INET6_PORT  ROAR_DEFAULT_PORT
184#define ROAR_DEFAULT_INET6_HOST  ROAR_NET_INET6_LOCALHOST
185
186// UNIX Domain Sockets
187#define ROAR_DEFAULT_SOCK_GLOBAL "/tmp/roar"
188#define ROAR_DEFAULT_SOCK_USER   ".roar"
189
190// DECnet
191#define ROAR_DEFAULT_OBJECT      "roar"
192#define ROAR_DEFAULT_NUM         0
193#define ROAR_DEFAULT_LISTEN_OBJECT "::" ROAR_DEFAULT_OBJECT
194
195// now handled by configure:
196//#define ROAR_DEFAULT_SOCKGRP     "audio"
197
198
199// defines for emulations:
200// ESD:
201#define ROAR_DEFAULT_ESD_GSOCK   "/tmp/.esd/socket"
202#define ROAR_DEFAULT_ESD_PORT    16001
203// RSound:
204#define ROAR_DEFAULT_RSOUND_GSOCK  "/tmp/rsound"
205#define ROAR_DEFAULT_RSOUND_PORT   12345
206#define ROAR_DEFAULT_RSOUND_OBJECT "::rsound"
207// PulseAudio:
208#define ROAR_DEFAULT_PA_PORT     4712
209// RPlay:
210#define ROAR_DEFAULT_RPLAY_PORT  5556
211
212#if defined(ROAR_HAVE_LIBWSOCK32) && defined(ROAR_HAVE_LIBWS2_32)
213#define ROAR_LIBS_WIN32          " -lwsock32 -lws2_32"
214#else
215#define ROAR_LIBS_WIN32          ""
216#endif
217
218#ifdef ROAR_HAVE_LIBSOCKET
219#define ROAR_LIBS_LIBSOCKET      " -lsocket"
220#else
221#define ROAR_LIBS_LIBSOCKET      ""
222#endif
223
224#ifdef ROAR_HAVE_LIBSENDFILE
225#define ROAR_LIBS_LIBSENDFILE    " -lsendfile"
226#else
227#define ROAR_LIBS_LIBSENDFILE    ""
228#endif
229
230#define ROAR_LIBS_NET_LIBS       ROAR_LIBS_LIBSOCKET ROAR_LIBS_WIN32
231
232#define ROAR_LIBS                "-lroar"       ROAR_LIBS_LIBSENDFILE ROAR_LIBS_NET_LIBS
233#define ROAR_LIBS_DSP            "-lroardsp "   ROAR_LIBS
234#define ROAR_LIBS_MIDI           "-lroarmidi "  ROAR_LIBS_DSP
235#define ROAR_LIBS_LIGHT          "-lroarlight " ROAR_LIBS
236#define ROAR_LIBS_EIO            "-lroareio "   ROAR_LIBS
237#define ROAR_CFLAGS              ""
238
239// comp libs:
240#define ROAR_LIBS_C_ESD          "-lroaresd "   ROAR_LIBS
241#define ROAR_LIBS_C_ARTSC        "-lroarartsc " ROAR_LIBS
242#define ROAR_LIBS_C_PULSE        "-lroarpulse " ROAR_LIBS
243#define ROAR_LIBS_C_PULSE_SIMPLE "-lroarpulse-simple " ROAR_LIBS_C_PULSE
244#define ROAR_LIBS_C_SNDIO        "-lroarsndio " ROAR_LIBS
245#define ROAR_LIBS_C_YIFF         "-lroaryiff "  ROAR_LIBS
246
247//some basic macros:
248#define ROAR_STDIN  0
249#define ROAR_STDOUT 1
250#define ROAR_STDERR 2
251
252#define ROAR_DEBUG_OUTFH stderr
253
254#ifndef ROAR_DBG_PREFIX
255#define ROAR_DBG_PREFIX "roaraudio"
256#endif
257
258#define ROAR_DBG_FULLPREFIX "(" ROAR_DBG_PREFIX ": " __FILE__ ":%i): "
259
260// some default info levels:
261#define ROAR_DBG_INFO_NONE             0
262#define ROAR_DBG_INFO_NOTICE           1
263#define ROAR_DBG_INFO_INFO             2
264#define ROAR_DBG_INFO_VERBOSE          3
265
266#if __GNUC__ < 3
267 #define ROAR_DBG(format, args...)
268 #define ROAR_ERR(format, args...)
269 #define ROAR_WARN(format, args...)
270 #define ROAR_INFO(format, level, args...)
271#else
272
273#ifdef DEBUG
274 #define ROAR_DBG(format, args...)  roar_debug_msg(ROAR_DEBUG_TYPE_DEBUG, __LINE__, __FILE__, ROAR_DBG_PREFIX, format, ## args)
275#else
276 #define ROAR_DBG(format, args...)
277#endif
278
279#define ROAR_ERR(format, args...)  roar_debug_msg(ROAR_DEBUG_TYPE_ERROR, __LINE__, __FILE__, ROAR_DBG_PREFIX, format, ## args)
280#define ROAR_WARN(format, args...) roar_debug_msg(ROAR_DEBUG_TYPE_WARNING, __LINE__, __FILE__, ROAR_DBG_PREFIX, format, ## args)
281
282// INFO function:
283#ifdef DEBUG
284 #define ROAR_INFO(format, level, args...) roar_debug_msg(ROAR_DEBUG_TYPE_INFO, __LINE__, __FILE__, ROAR_DBG_PREFIX, format, ## args)
285#elif defined(ROAR_DBG_INFOVAR)
286 #define ROAR_INFO(format, level, args...) if ( (ROAR_DBG_INFOVAR) >= (level) ) roar_debug_msg(ROAR_DEBUG_TYPE_INFO, __LINE__, __FILE__, ROAR_DBG_PREFIX, format, ## args)
287#else
288 #define ROAR_INFO(format, level, args...)
289#endif
290
291#endif
292
293#ifdef ROAR_HAVE_SAFE_OVERFLOW
294#define ROAR_MATH_OVERFLOW_ADD(a, b) ((a)+(b))
295#else
296#define ROAR_MATH_OVERFLOW_ADD(a, b) ((4294967295U - (a)) + 1 + (b))
297#endif
298
299#ifdef ROAR_HAVE_STRCASESTR
300#define _roar_strcasestr(a,b) strcasestr((a), (b))
301#else
302#define _roar_strcasestr(a,b) NULL
303#endif
304
305__END_DECLS
306
307#endif
308
309//ll
Note: See TracBrowser for help on using the repository browser.