xref: /illumos-gate/usr/src/cmd/audio/include/libaudio.h (revision 9164a50bf932130cbb5097a16f6986873ce0e6e5)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License, Version 1.0 only
6  * (the "License").  You may not use this file except in compliance
7  * with the License.
8  *
9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10  * or http://www.opensolaris.org/os/licensing.
11  * See the License for the specific language governing permissions
12  * and limitations under the License.
13  *
14  * When distributing Covered Code, include this CDDL HEADER in each
15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16  * If applicable, add the following below this CDDL HEADER, with the
17  * fields enclosed by brackets "[]" replaced with your own identifying
18  * information: Portions Copyright [yyyy] [name of copyright owner]
19  *
20  * CDDL HEADER END
21  */
22 /*
23  * Copyright 1992-2003 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  */
26 
27 #ifndef _MULTIMEDIA_LIBAUDIO_H
28 #define	_MULTIMEDIA_LIBAUDIO_H
29 
30 #include <audio_types.h>
31 #include <audio_hdr.h>
32 #include <audio_device.h>
33 #include <audio_errno.h>
34 #include <audio_encode.h>
35 #include <audio/au.h>
36 #include <aiff.h>
37 #include <wav.h>
38 
39 #ifdef __cplusplus
40 extern "C" {
41 #endif
42 
43 /* define various constants for general use */
44 
45 /* Theoretical maximum length of hh:mm:ss.dd string */
46 #define	AUDIO_MAX_TIMEVAL	(32)
47 
48 /* Theoretical maximum length of encoding information string */
49 #define	AUDIO_MAX_ENCODE_INFO	(80)
50 
51 
52 /* Why aren't these stupid values defined in a standard place?! */
53 #ifndef TRUE
54 #define	TRUE	(1)
55 #endif
56 #ifndef FALSE
57 #define	FALSE	(0)
58 #endif
59 #ifndef NULL
60 #define	NULL	0
61 #endif
62 
63 /* Help for endian-ness */
64 #define	SWABI(I)							\
65 	I = (((I >> 24) & 0xff) | ((I & 0xff) << 24) |			\
66 	((I >> 8) & 0xff00) | ((I & 0xff00) << 8))
67 
68 /* Defines for the audio file formats we support */
69 #define	FILE_ERROR	0
70 #define	FILE_AU		1
71 #define	FILE_WAV	2
72 #define	FILE_AIFF	3
73 
74 /* Declare libaudio C routines */
75 
76 /* File Header routines */
77 EXTERN_FUNCTION(int audio_write_filehdr, (int, Audio_hdr *, int, char *,
78 		    unsigned));
79 EXTERN_FUNCTION(int audio_rewrite_filesize, (int, int, unsigned,
80 		    unsigned, unsigned));
81 EXTERN_FUNCTION(int audio_read_filehdr, (int, Audio_hdr*, int *, char *,
82 		    unsigned));
83 EXTERN_FUNCTION(int audio_isaudiofile, (char *));
84 EXTERN_FUNCTION(int audio_decode_filehdr,
85 		    (int, unsigned char *, int *, Audio_hdr *, int *));
86 
87 extern int audio_write_filehdr(int, Audio_hdr *, int, char *, unsigned);
88 extern int audio_rewrite_filesize(int, int, unsigned int, unsigned int,
89 	unsigned int);
90 
91 
92 
93 /* Audio Header routines */
94 EXTERN_FUNCTION(double audio_bytes_to_secs, (Audio_hdr*, unsigned));
95 EXTERN_FUNCTION(unsigned audio_secs_to_bytes, (Audio_hdr*, double));
96 EXTERN_FUNCTION(double audio_str_to_secs, (char *));
97 EXTERN_FUNCTION(char *audio_secs_to_str, (double, char *, int));
98 EXTERN_FUNCTION(int audio_cmp_hdr, (Audio_hdr*, Audio_hdr *));
99 EXTERN_FUNCTION(int audio_enc_to_str, (Audio_hdr*, char *));
100 
101 
102 /* Device Control routines */
103 EXTERN_FUNCTION(int audio_getinfo, (int, Audio_info*));
104 EXTERN_FUNCTION(int audio_setinfo, (int, Audio_info*));
105 EXTERN_FUNCTION(int audio__setplayhdr, (int, Audio_hdr *, unsigned));
106 EXTERN_FUNCTION(int audio__setval, (int, unsigned *, unsigned));
107 EXTERN_FUNCTION(int audio__setgain, (int, double *, unsigned));
108 EXTERN_FUNCTION(int audio__setpause, (int, unsigned));
109 EXTERN_FUNCTION(int audio__flush, (int, unsigned int));
110 EXTERN_FUNCTION(int audio_drain, (int, int));
111 EXTERN_FUNCTION(int audio_play_eof, (int));
112 
113 #ifdef __cplusplus
114 }
115 #endif
116 
117 #endif /* !_MULTIMEDIA_LIBAUDIO_H */
118