Rémi Verschelde
d516aab8fa
Also enhance RigidBody docs as per https://github.com/godotengine/godot-docs/pull/1018 and fix the version tag in all files (not really stable yet, but it makes no sense to hardcode rc3 at this stage).
356 lines
11 KiB
XML
356 lines
11 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="AudioServer" inherits="Object" category="Core" version="3.0-stable">
|
|
<brief_description>
|
|
Server interface for low level audio access.
|
|
</brief_description>
|
|
<description>
|
|
AudioServer is a low level server interface for audio access. It is in charge of creating sample data (playable audio) as well as its playback via a voice interface.
|
|
</description>
|
|
<tutorials>
|
|
http://docs.godotengine.org/en/3.0/learning/features/audio/audio_buses.html
|
|
</tutorials>
|
|
<demos>
|
|
</demos>
|
|
<methods>
|
|
<method name="add_bus">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="at_position" type="int" default="-1">
|
|
</argument>
|
|
<description>
|
|
Adds a bus at [code]at_position[/code].
|
|
</description>
|
|
</method>
|
|
<method name="add_bus_effect">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="effect" type="AudioEffect">
|
|
</argument>
|
|
<argument index="2" name="at_position" type="int" default="-1">
|
|
</argument>
|
|
<description>
|
|
Adds an [AudioEffect] effect to the bus [code]bus_idx[/code] at [code]at_position[/code].
|
|
</description>
|
|
</method>
|
|
<method name="generate_bus_layout" qualifiers="const">
|
|
<return type="AudioBusLayout">
|
|
</return>
|
|
<description>
|
|
Generates an [AudioBusLayout] using the available busses and effects.
|
|
</description>
|
|
</method>
|
|
<method name="get_bus_count" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the number of available busses.
|
|
</description>
|
|
</method>
|
|
<method name="get_bus_effect">
|
|
<return type="AudioEffect">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="effect_idx" type="int">
|
|
</argument>
|
|
<description>
|
|
Returns the [AudioEffect] at position [code]effect_idx[/code] in bus [code]bus_idx[/code].
|
|
</description>
|
|
</method>
|
|
<method name="get_bus_effect_count">
|
|
<return type="int">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<description>
|
|
Returns the number of effects on the bus at [code]bus_idx[/code].
|
|
</description>
|
|
</method>
|
|
<method name="get_bus_index" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<argument index="0" name="bus_name" type="String">
|
|
</argument>
|
|
<description>
|
|
Returns the index of the bus with the name [code]bus_name[/code].
|
|
</description>
|
|
</method>
|
|
<method name="get_bus_name" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<description>
|
|
Returns the name of the bus with the index [code]bus_idx[/code].
|
|
</description>
|
|
</method>
|
|
<method name="get_bus_peak_volume_left_db" qualifiers="const">
|
|
<return type="float">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="channel" type="int">
|
|
</argument>
|
|
<description>
|
|
Returns the peak volume of the left speaker at bus index [code]bus_idx[/code] and channel index [code]channel[/code].
|
|
</description>
|
|
</method>
|
|
<method name="get_bus_peak_volume_right_db" qualifiers="const">
|
|
<return type="float">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="channel" type="int">
|
|
</argument>
|
|
<description>
|
|
Returns the peak volume of the right speaker at bus index [code]bus_idx[/code] and channel index [code]channel[/code].
|
|
</description>
|
|
</method>
|
|
<method name="get_bus_send" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<description>
|
|
Returns the name of the bus that the bus at index [code]bus_idx[/code] sends to.
|
|
</description>
|
|
</method>
|
|
<method name="get_bus_volume_db" qualifiers="const">
|
|
<return type="float">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<description>
|
|
Returns the volume of the bus at index [code]bus_idx[/code] in dB.
|
|
</description>
|
|
</method>
|
|
<method name="get_mix_rate" qualifiers="const">
|
|
<return type="float">
|
|
</return>
|
|
<description>
|
|
Returns the sample rate at the output of the audioserver.
|
|
</description>
|
|
</method>
|
|
<method name="get_speaker_mode" qualifiers="const">
|
|
<return type="int" enum="AudioServer.SpeakerMode">
|
|
</return>
|
|
<description>
|
|
Returns the speaker configuration.
|
|
</description>
|
|
</method>
|
|
<method name="is_bus_bypassing_effects" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<description>
|
|
If [code]true[/code] the bus at index [code]bus_idx[/code] is bypassing effects.
|
|
</description>
|
|
</method>
|
|
<method name="is_bus_effect_enabled" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="effect_idx" type="int">
|
|
</argument>
|
|
<description>
|
|
If [code]true[/code] the effect at index [code]effect_idx[/code] on the bus at index [code]bus_idx[/code] is enabled.
|
|
</description>
|
|
</method>
|
|
<method name="is_bus_mute" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<description>
|
|
If [code]true[/code] the bus at index [code]bus_idx[/code] is muted.
|
|
</description>
|
|
</method>
|
|
<method name="is_bus_solo" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<description>
|
|
If [code]true[/code] the bus at index [code]bus_idx[/code] is in solo mode.
|
|
</description>
|
|
</method>
|
|
<method name="lock">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Locks the audio drivers mainloop. Remember to unlock it afterwards.
|
|
</description>
|
|
</method>
|
|
<method name="move_bus">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="index" type="int">
|
|
</argument>
|
|
<argument index="1" name="to_index" type="int">
|
|
</argument>
|
|
<description>
|
|
Moves the bus from index [code]index[/code] to index [code]to_index[/code].
|
|
</description>
|
|
</method>
|
|
<method name="remove_bus">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="index" type="int">
|
|
</argument>
|
|
<description>
|
|
Removes the bus at index [code]index[/code].
|
|
</description>
|
|
</method>
|
|
<method name="remove_bus_effect">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="effect_idx" type="int">
|
|
</argument>
|
|
<description>
|
|
Removes the effect at index [code]effect_idx[/code] from the bus at index [code]bus_idx[/code].
|
|
</description>
|
|
</method>
|
|
<method name="set_bus_bypass_effects">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="enable" type="bool">
|
|
</argument>
|
|
<description>
|
|
If [code]true[/code] the bus at index [code]bus_idx[/code] is bypassing effects.
|
|
</description>
|
|
</method>
|
|
<method name="set_bus_count">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="amount" type="int">
|
|
</argument>
|
|
<description>
|
|
Adds and removes busses to make the number of busses match [code]amount[/code].
|
|
</description>
|
|
</method>
|
|
<method name="set_bus_effect_enabled">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="effect_idx" type="int">
|
|
</argument>
|
|
<argument index="2" name="enabled" type="bool">
|
|
</argument>
|
|
<description>
|
|
If [code]true[/code] the effect at index [code]effect_idx[/code] on the bus at index [code]bus_idx[/code] is enabled.
|
|
</description>
|
|
</method>
|
|
<method name="set_bus_layout">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="bus_layout" type="AudioBusLayout">
|
|
</argument>
|
|
<description>
|
|
Overwrites the currently used [AudioBusLayout].
|
|
</description>
|
|
</method>
|
|
<method name="set_bus_mute">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="enable" type="bool">
|
|
</argument>
|
|
<description>
|
|
If [code]true[/code] the bus at index [code]bus_idx[/code] is muted.
|
|
</description>
|
|
</method>
|
|
<method name="set_bus_name">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="name" type="String">
|
|
</argument>
|
|
<description>
|
|
Sets the name of the bus at index [code]bus_idx[/code] to [code]name[/code].
|
|
</description>
|
|
</method>
|
|
<method name="set_bus_send">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="send" type="String">
|
|
</argument>
|
|
<description>
|
|
Connects the output of the bus at [code]bus_idx[/code] to the bus named [code]send[/code].
|
|
</description>
|
|
</method>
|
|
<method name="set_bus_solo">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="enable" type="bool">
|
|
</argument>
|
|
<description>
|
|
If [code]true[/code] the bus at index [code]bus_idx[/code] is in solo mode.
|
|
</description>
|
|
</method>
|
|
<method name="set_bus_volume_db">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="volume_db" type="float">
|
|
</argument>
|
|
<description>
|
|
Sets the volume of the bus at index [code]bus_idx[/code] to [code]volume_db[/code].
|
|
</description>
|
|
</method>
|
|
<method name="swap_bus_effects">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="bus_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="effect_idx" type="int">
|
|
</argument>
|
|
<argument index="2" name="by_effect_idx" type="int">
|
|
</argument>
|
|
<description>
|
|
Swaps the position of two effects in bus [code]bus_idx[/code].
|
|
</description>
|
|
</method>
|
|
<method name="unlock">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Unlocks the audiodriver's main loop. After locking it always unlock it.
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<signals>
|
|
<signal name="bus_layout_changed">
|
|
<description>
|
|
Emitted when the [AudioBusLayout] changes.
|
|
</description>
|
|
</signal>
|
|
</signals>
|
|
<constants>
|
|
<constant name="SPEAKER_MODE_STEREO" value="0" enum="SpeakerMode">
|
|
Two or fewer speakers are detected.
|
|
</constant>
|
|
<constant name="SPEAKER_SURROUND_51" value="2" enum="SpeakerMode">
|
|
A 5.1 channel surround setup detected.
|
|
</constant>
|
|
<constant name="SPEAKER_SURROUND_71" value="3" enum="SpeakerMode">
|
|
A 7.1 channel surround setup detected.
|
|
</constant>
|
|
</constants>
|
|
</class>
|