1 /**************************************************************************\
2  * Copyright (c) Kongsberg Oil & Gas Technologies AS
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are
7  * met:
8  *
9  * Redistributions of source code must retain the above copyright notice,
10  * this list of conditions and the following disclaimer.
11  *
12  * Redistributions in binary form must reproduce the above copyright
13  * notice, this list of conditions and the following disclaimer in the
14  * documentation and/or other materials provided with the distribution.
15  *
16  * Neither the name of the copyright holder nor the names of its
17  * contributors may be used to endorse or promote products derived from
18  * this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24  * HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 \**************************************************************************/
32 
33 #ifndef COIN_SOVRMLSOUND_H
34 #define COIN_SOVRMLSOUND_H
35 
36 #include <Inventor/nodes/SoSubNode.h>
37 #include <Inventor/fields/SoSFNode.h>
38 #include <Inventor/fields/SoSFBool.h>
39 #include <Inventor/fields/SoSFFloat.h>
40 #include <Inventor/fields/SoSFVec3f.h>
41 #include <Inventor/SbTime.h>
42 
43 class SoVRMLSoundP;
44 class SoPath;
45 
46 class COIN_DLL_API SoVRMLSound : public SoNode
47 {
48   typedef SoNode inherited;
49   SO_NODE_HEADER(SoVRMLSound);
50 
51 public:
52   static void initClass(void);
53   SoVRMLSound(void);
54 
55   SoSFNode source;
56   SoSFFloat intensity;
57   SoSFFloat priority;
58   SoSFVec3f location;
59   SoSFVec3f direction;
60   SoSFFloat minFront;
61   SoSFFloat maxFront;
62   SoSFFloat minBack;
63   SoSFFloat maxBack;
64   SoSFBool spatialize;
65   SoSFFloat dopplerFactor;
66   SoSFFloat dopplerVelocity;
67 
68   void setDopplerVelocity(float velocity);
69   float getDopplerVelocity(void) const;
70   void setDopplerFactor(float factor);
71   float getDopplerFactor(void) const;
72 
73   void startPlaying(SoPath *path, void *userdataptr);
74   void stopPlaying(SoPath *path, void *userdataptr);
75 
76   static void setDefaultBufferingProperties(int bufferLength, int numBuffers,
77                                             SbTime sleepTime);
78   void setBufferingProperties(int bufferLength, int numBuffers,
79                               SbTime sleepTime);
80   void getBufferingProperties(int &bufferLength, int &numBuffers,
81                               SbTime &sleepTime);
82 
83   virtual void audioRender(SoAudioRenderAction *action);
84 
85 protected:
86   virtual ~SoVRMLSound(void);
87 
88 private:
89   SoVRMLSoundP *pimpl;
90   friend class SoVRMLSoundP;
91 };
92 
93 #endif // ! COIN_SOVRMLSOUND_H
94