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