1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
|
# $Id$
# Documentation for KX_SoundActuator
from SCA_IActuator import *
class KX_SoundActuator(SCA_IActuator):
"""
Sound Actuator.
The L{startSound()}, L{pauseSound()} and L{stopSound()} do not require
the actuator to be activated - they act instantly provided that the actuator has
been activated once at least.
@ivar filename: Sets the filename of the sound this actuator plays.
@type filename: string
@ivar volume: Sets the volume (gain) of the sound.
@type volume: float
@ivar pitch: Sets the pitch of the sound.
@type pitch: float
@ivar rollOffFactor: Sets the roll off factor. Rolloff defines the rate of attenuation as the sound gets further away.
@type rollOffFactor: float
@ivar looping: Sets the loop mode of the actuator.
@type looping: integer
@ivar position: Sets the position of the sound.
@type position: float array
@ivar velocity: Sets the speed of the sound; The speed of the sound alter the pitch.
@type velocity: float array
@ivar orientation: Sets the orientation of the sound. When setting the orientation you can
also use quaternion [float,float,float,float] or euler angles [float,float,float]
@type orientation: 3x3 matrix [[float]]
@ivar type: Sets the operation mode of the actuator. You can use one of the following constant:
KX_SOUNDACT_PLAYSTOP (1)
KX_SOUNDACT_PLAYEND (2)
KX_SOUNDACT_LOOPSTOP (3)
KX_SOUNDACT_LOOPEND (4)
KX_SOUNDACT_LOOPBIDIRECTIONAL (5)
KX_SOUNDACT_LOOPBIDIRECTIONAL_STOP (6)
@type type: integer
@group Play Methods: startSound, pauseSound, stopSound.
"""
def setFilename(filename):
"""
DEPRECATED: Use the filename property instead.
Sets the filename of the sound this actuator plays.
@type filename: string
"""
def getFilename():
"""
DEPRECATED: Use the filename property instead.
Returns the filename of the sound this actuator plays.
@rtype: string
"""
def startSound():
"""
Starts the sound.
"""
def pauseSound():
"""
Pauses the sound.
"""
def stopSound():
"""
Stops the sound.
"""
def setGain(gain):
"""
DEPRECATED: Use the volume property instead
Sets the gain (volume) of the sound
@type gain: float
@param gain: 0.0 (quiet) <= gain <= 1.0 (loud)
"""
def getGain():
"""
DEPRECATED: Use the volume property instead.
Gets the gain (volume) of the sound.
@rtype: float
"""
def setPitch(pitch):
"""
DEPRECATED: Use the pitch property instead.
Sets the pitch of the sound.
@type pitch: float
"""
def getPitch():
"""
DEPRECATED: Use the pitch property instead.
Returns the pitch of the sound.
@rtype: float
"""
def setRollOffFactor(rolloff):
"""
DEPRECATED: Use the rollOffFactor property instead.
Sets the rolloff factor for the sounds.
Rolloff defines the rate of attenuation as the sound gets further away.
Higher rolloff factors shorten the distance at which the sound can be heard.
@type rolloff: float
"""
def getRollOffFactor():
"""
DEPRECATED: Use the rollOffFactor property instead.
Returns the rolloff factor for the sound.
@rtype: float
"""
def setLooping(loop):
"""
DEPRECATED: Use the looping property instead.
Sets the loop mode of the actuator.
@bug: There are no constants defined for this method!
@param loop: - Play Stop 1
- Play End 2
- Loop Stop 3
- Loop End 4
- Bidirection Stop 5
- Bidirection End 6
@type loop: integer
"""
def getLooping():
"""
DEPRECATED: Use the looping property instead.
Returns the current loop mode of the actuator.
@rtype: integer
"""
def setPosition(x, y, z):
"""
DEPRECATED: Use the position property instead.
Sets the position this sound will come from.
@type x: float
@param x: The x coordinate of the sound.
@type y: float
@param y: The y coordinate of the sound.
@type z: float
@param z: The z coordinate of the sound.
"""
def setVelocity(vx, vy, vz):
"""
DEPRECATED: Use the velocity property instead.
Sets the velocity this sound is moving at.
The sound's pitch is determined from the velocity.
@type vx: float
@param vx: The vx coordinate of the sound.
@type vy: float
@param vy: The vy coordinate of the sound.
@type vz: float
@param vz: The vz coordinate of the sound.
"""
def setOrientation(o11, o12, o13, o21, o22, o23, o31, o32, o33):
"""
DEPRECATED: Use the orientation property instead.
Sets the orientation of the sound.
The nine parameters specify a rotation matrix::
| o11, o12, o13 |
| o21, o22, o23 |
| o31, o32, o33 |
"""
def setType(mode):
"""
DEPRECATED: Use the type property instead.
Sets the operation mode of the actuator.
@param mode: KX_SOUNDACT_PLAYSTOP, KX_SOUNDACT_PLAYEND, KX_SOUNDACT_LOOPSTOP, KX_SOUNDACT_LOOPEND, KX_SOUNDACT_LOOPBIDIRECTIONAL, KX_SOUNDACT_LOOPBIDIRECTIONAL_STOP
@type mode: integer
"""
def getType():
"""
DEPRECATED: Use the type property instead.
Returns the operation mode of the actuator.
@rtype: integer
@return: KX_SOUNDACT_PLAYSTOP, KX_SOUNDACT_PLAYEND, KX_SOUNDACT_LOOPSTOP, KX_SOUNDACT_LOOPEND, KX_SOUNDACT_LOOPBIDIRECTIONAL, KX_SOUNDACT_LOOPBIDIRECTIONAL_STOP
"""
|
