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 (c) 1992-2001 by Sun Microsystems, Inc.
24*0Sstevel@tonic-gate  * All rights reserved.
25*0Sstevel@tonic-gate  */
26*0Sstevel@tonic-gate 
27*0Sstevel@tonic-gate #ifndef _MULTIMEDIA_AUDIOBUFFER_H
28*0Sstevel@tonic-gate #define	_MULTIMEDIA_AUDIOBUFFER_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 <AudioStream.h>
33*0Sstevel@tonic-gate 
34*0Sstevel@tonic-gate #ifdef __cplusplus
35*0Sstevel@tonic-gate extern "C" {
36*0Sstevel@tonic-gate #endif
37*0Sstevel@tonic-gate 
38*0Sstevel@tonic-gate // This is the class describing a mapped buffer of audio data.
39*0Sstevel@tonic-gate // In addition to the standard Read and Write methods, the address
40*0Sstevel@tonic-gate // of the buffer may be obtained and the data accessed directly.
41*0Sstevel@tonic-gate 
42*0Sstevel@tonic-gate class AudioBuffer : public AudioStream {
43*0Sstevel@tonic-gate private:
44*0Sstevel@tonic-gate 	Double		buflen;			// buffer size, in seconds
45*0Sstevel@tonic-gate 	int		zflag;			// malloc'd with zmalloc?
46*0Sstevel@tonic-gate protected:
47*0Sstevel@tonic-gate 	size_t		bufsize;		// buffer size, in bytes
48*0Sstevel@tonic-gate 	void*		bufaddr;		// buffer address
49*0Sstevel@tonic-gate 
50*0Sstevel@tonic-gate 	// class AudioStream methods specialized here
51*0Sstevel@tonic-gate 	virtual Boolean opened() const;			// TRUE, if open
52*0Sstevel@tonic-gate 	virtual AudioError alloc();			// Allocate buffer
53*0Sstevel@tonic-gate 
54*0Sstevel@tonic-gate public:
55*0Sstevel@tonic-gate 	// Constructor
56*0Sstevel@tonic-gate 	AudioBuffer(
57*0Sstevel@tonic-gate 	    double len = 0.,			// buffer size, in seconds
58*0Sstevel@tonic-gate 	    const char *name = "(buffer)");	// name
59*0Sstevel@tonic-gate 	~AudioBuffer();					// Destructor
60*0Sstevel@tonic-gate 
61*0Sstevel@tonic-gate 	virtual void* GetAddress() const;		// Get buffer address
62*0Sstevel@tonic-gate 	virtual void* GetAddress(Double) const;		// Get address at offset
63*0Sstevel@tonic-gate 	virtual AudioError SetSize(Double len);		// Change buffer size
64*0Sstevel@tonic-gate 	virtual Double GetSize() const;			// Get buffer size
65*0Sstevel@tonic-gate 	virtual size_t GetByteCount() const;		// Get size, in bytes
66*0Sstevel@tonic-gate 
67*0Sstevel@tonic-gate 	// class AudioStream methods specialized here
68*0Sstevel@tonic-gate 	// Set header
69*0Sstevel@tonic-gate 	virtual AudioError SetHeader(
70*0Sstevel@tonic-gate 	    const AudioHdr& h);			// header to copy
71*0Sstevel@tonic-gate 
72*0Sstevel@tonic-gate 	// Set data length
73*0Sstevel@tonic-gate 	virtual void SetLength(
74*0Sstevel@tonic-gate 	    Double len);			// new length, in secs
75*0Sstevel@tonic-gate 
76*0Sstevel@tonic-gate 	// class Audio methods specialized here
77*0Sstevel@tonic-gate 
78*0Sstevel@tonic-gate 	// Read from position
79*0Sstevel@tonic-gate 	virtual AudioError ReadData(
80*0Sstevel@tonic-gate 	    void* buf,				// buffer to fill
81*0Sstevel@tonic-gate 	    size_t& len,			// buffer length (updated)
82*0Sstevel@tonic-gate 	    Double& pos);			// start position (updated)
83*0Sstevel@tonic-gate 
84*0Sstevel@tonic-gate 	// Write at position
85*0Sstevel@tonic-gate 	virtual AudioError WriteData(
86*0Sstevel@tonic-gate 	    void* buf,				// buffer to copy
87*0Sstevel@tonic-gate 	    size_t& len,			// buffer length (updated)
88*0Sstevel@tonic-gate 	    Double& pos);			// start position (updated)
89*0Sstevel@tonic-gate 
90*0Sstevel@tonic-gate 	// Append at position
91*0Sstevel@tonic-gate 	virtual AudioError AppendData(
92*0Sstevel@tonic-gate 	    void* buf,				// buffer to copy
93*0Sstevel@tonic-gate 	    size_t& len,			// buffer length (updated)
94*0Sstevel@tonic-gate 	    Double& pos);			// start position (updated)
95*0Sstevel@tonic-gate 
96*0Sstevel@tonic-gate 	// copy to another audio obj.
97*0Sstevel@tonic-gate 	virtual AudioError AsyncCopy(
98*0Sstevel@tonic-gate 	    Audio* to,				// dest audio object
99*0Sstevel@tonic-gate 	    Double& frompos,
100*0Sstevel@tonic-gate 	    Double& topos,
101*0Sstevel@tonic-gate 	    Double& limit);
102*0Sstevel@tonic-gate 
103*0Sstevel@tonic-gate 	virtual Boolean isBuffer() const { return (TRUE); }
104*0Sstevel@tonic-gate };
105*0Sstevel@tonic-gate 
106*0Sstevel@tonic-gate #ifdef __cplusplus
107*0Sstevel@tonic-gate }
108*0Sstevel@tonic-gate #endif
109*0Sstevel@tonic-gate 
110*0Sstevel@tonic-gate #endif /* !_MULTIMEDIA_AUDIOBUFFER_H */
111