summaryrefslogtreecommitdiff
path: root/doc/classes/AudioStreamPlaybackPolyphonic.xml
blob: 8b0951153b40b12f0c74e48f0dcad99ae2da3a9b (plain)
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
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AudioStreamPlaybackPolyphonic" inherits="AudioStreamPlayback" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
	<brief_description>
		Playback instance for [AudioStreamPolyphonic].
	</brief_description>
	<description>
		Playback instance for [AudioStreamPolyphonic]. After setting the [code]stream[/code] property of [AudioStreamPlayer], [AudioStreamPlayer2D], or [AudioStreamPlayer3D], the playback instance can be obtained by calling [method AudioStreamPlayer.get_stream_playback], [method AudioStreamPlayer2D.get_stream_playback] or [method AudioStreamPlayer3D.get_stream_playback] methods.
	</description>
	<tutorials>
	</tutorials>
	<methods>
		<method name="is_stream_playing" qualifiers="const">
			<return type="bool" />
			<param index="0" name="stream" type="int" />
			<description>
				Return true whether the stream associated with an integer ID is still playing. Check [method play_stream] for information on when this ID becomes invalid.
			</description>
		</method>
		<method name="play_stream">
			<return type="int" />
			<param index="0" name="stream" type="AudioStream" />
			<param index="1" name="from_offset" type="float" default="0" />
			<param index="2" name="volume_db" type="float" default="0" />
			<param index="3" name="pitch_scale" type="float" default="1.0" />
			<description>
				Play an [AudioStream] at a given offset, volume and pitch scale. Playback starts immediately.
				The return value is an unique integer ID that is associated to this playback stream and which can be used to control it.
				This ID becomes invalid when the stream ends (if it does not loop), when the [AudioStreamPlaybackPolyphonic] is stopped, or when [method stop_stream] is called.
				This function returns [constant INVALID_ID] if the amount of streams currently playing equals [member AudioStreamPolyphonic.polyphony]. If you need a higher amount of maximum polyphony, raise this value.
			</description>
		</method>
		<method name="set_stream_pitch_scale">
			<return type="void" />
			<param index="0" name="stream" type="int" />
			<param index="1" name="pitch_scale" type="float" />
			<description>
				Change the stream pitch scale. The [param stream] argument is an integer ID returned by [method play_stream].
			</description>
		</method>
		<method name="set_stream_volume">
			<return type="void" />
			<param index="0" name="stream" type="int" />
			<param index="1" name="volume_db" type="float" />
			<description>
				Change the stream volume (in db). The [param stream] argument is an integer ID returned by [method play_stream].
			</description>
		</method>
		<method name="stop_stream">
			<return type="void" />
			<param index="0" name="stream" type="int" />
			<description>
				Stop a stream. The [param stream] argument is an integer ID returned by [method play_stream], which becomes invalid after calling this function.
			</description>
		</method>
	</methods>
	<constants>
		<constant name="INVALID_ID" value="-1">
			Returned by [method play_stream] in case it could not allocate a stream for playback.
		</constant>
	</constants>
</class>