class_audioserver.rst 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234
  1. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  2. .. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
  3. .. _class_AudioServer:
  4. AudioServer
  5. ===========
  6. **Inherits:** :ref:`Object<class_object>`
  7. **Category:** Core
  8. Brief Description
  9. -----------------
  10. Server interface for low level audio access.
  11. Member Functions
  12. ----------------
  13. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  14. | void | :ref:`add_bus<class_AudioServer_add_bus>` **(** :ref:`int<class_int>` at_pos=-1 **)** |
  15. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  16. | void | :ref:`add_bus_effect<class_AudioServer_add_bus_effect>` **(** :ref:`int<class_int>` bus_idx, :ref:`AudioEffect<class_audioeffect>` effect, :ref:`int<class_int>` arg2=-1 **)** |
  17. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  18. | :ref:`AudioBusLayout<class_audiobuslayout>` | :ref:`generate_bus_layout<class_AudioServer_generate_bus_layout>` **(** **)** const |
  19. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  20. | :ref:`int<class_int>` | :ref:`get_bus_count<class_AudioServer_get_bus_count>` **(** **)** const |
  21. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  22. | :ref:`AudioEffect<class_audioeffect>` | :ref:`get_bus_effect<class_AudioServer_get_bus_effect>` **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx **)** |
  23. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  24. | void | :ref:`get_bus_effect_count<class_AudioServer_get_bus_effect_count>` **(** :ref:`int<class_int>` bus_idx, :ref:`Object<class_object>` arg1, :ref:`int<class_int>` arg2 **)** |
  25. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  26. | :ref:`int<class_int>` | :ref:`get_bus_index<class_AudioServer_get_bus_index>` **(** :ref:`String<class_string>` bus_name **)** const |
  27. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  28. | :ref:`String<class_string>` | :ref:`get_bus_name<class_AudioServer_get_bus_name>` **(** :ref:`int<class_int>` bus_idx **)** const |
  29. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  30. | :ref:`float<class_float>` | :ref:`get_bus_peak_volume_left_db<class_AudioServer_get_bus_peak_volume_left_db>` **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` channel **)** const |
  31. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  32. | :ref:`float<class_float>` | :ref:`get_bus_peak_volume_right_db<class_AudioServer_get_bus_peak_volume_right_db>` **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` channel **)** const |
  33. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  34. | :ref:`String<class_string>` | :ref:`get_bus_send<class_AudioServer_get_bus_send>` **(** :ref:`int<class_int>` bus_idx **)** const |
  35. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  36. | :ref:`float<class_float>` | :ref:`get_bus_volume_db<class_AudioServer_get_bus_volume_db>` **(** :ref:`int<class_int>` bus_idx **)** const |
  37. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  38. | :ref:`float<class_float>` | :ref:`get_mix_rate<class_AudioServer_get_mix_rate>` **(** **)** const |
  39. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  40. | :ref:`int<class_int>` | :ref:`get_speaker_mode<class_AudioServer_get_speaker_mode>` **(** **)** const |
  41. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  42. | :ref:`bool<class_bool>` | :ref:`is_bus_bypassing_effects<class_AudioServer_is_bus_bypassing_effects>` **(** :ref:`int<class_int>` bus_idx **)** const |
  43. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  44. | :ref:`bool<class_bool>` | :ref:`is_bus_effect_enabled<class_AudioServer_is_bus_effect_enabled>` **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx **)** const |
  45. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  46. | :ref:`bool<class_bool>` | :ref:`is_bus_mute<class_AudioServer_is_bus_mute>` **(** :ref:`int<class_int>` bus_idx **)** const |
  47. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  48. | :ref:`bool<class_bool>` | :ref:`is_bus_solo<class_AudioServer_is_bus_solo>` **(** :ref:`int<class_int>` bus_idx **)** const |
  49. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  50. | void | :ref:`lock<class_AudioServer_lock>` **(** **)** |
  51. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  52. | void | :ref:`move_bus<class_AudioServer_move_bus>` **(** :ref:`int<class_int>` index, :ref:`int<class_int>` to_index **)** |
  53. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  54. | void | :ref:`remove_bus<class_AudioServer_remove_bus>` **(** :ref:`int<class_int>` index **)** |
  55. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  56. | void | :ref:`remove_bus_effect<class_AudioServer_remove_bus_effect>` **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx **)** |
  57. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  58. | void | :ref:`set_bus_bypass_effects<class_AudioServer_set_bus_bypass_effects>` **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable **)** |
  59. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  60. | void | :ref:`set_bus_count<class_AudioServer_set_bus_count>` **(** :ref:`int<class_int>` amount **)** |
  61. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  62. | void | :ref:`set_bus_effect_enabled<class_AudioServer_set_bus_effect_enabled>` **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx, :ref:`bool<class_bool>` enabled **)** |
  63. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  64. | void | :ref:`set_bus_layout<class_AudioServer_set_bus_layout>` **(** :ref:`AudioBusLayout<class_audiobuslayout>` bus_layout **)** |
  65. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  66. | void | :ref:`set_bus_mute<class_AudioServer_set_bus_mute>` **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable **)** |
  67. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  68. | void | :ref:`set_bus_name<class_AudioServer_set_bus_name>` **(** :ref:`int<class_int>` bus_idx, :ref:`String<class_string>` name **)** |
  69. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  70. | void | :ref:`set_bus_send<class_AudioServer_set_bus_send>` **(** :ref:`int<class_int>` bus_idx, :ref:`String<class_string>` send **)** |
  71. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  72. | void | :ref:`set_bus_solo<class_AudioServer_set_bus_solo>` **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable **)** |
  73. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  74. | void | :ref:`set_bus_volume_db<class_AudioServer_set_bus_volume_db>` **(** :ref:`int<class_int>` bus_idx, :ref:`float<class_float>` volume_db **)** |
  75. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  76. | void | :ref:`swap_bus_effects<class_AudioServer_swap_bus_effects>` **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx, :ref:`int<class_int>` by_effect_idx **)** |
  77. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  78. | void | :ref:`unlock<class_AudioServer_unlock>` **(** **)** |
  79. +----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  80. Signals
  81. -------
  82. - **bus_layout_changed** **(** **)**
  83. Description
  84. -----------
  85. 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.
  86. Member Function Description
  87. ---------------------------
  88. .. _class_AudioServer_add_bus:
  89. - void **add_bus** **(** :ref:`int<class_int>` at_pos=-1 **)**
  90. .. _class_AudioServer_add_bus_effect:
  91. - void **add_bus_effect** **(** :ref:`int<class_int>` bus_idx, :ref:`AudioEffect<class_audioeffect>` effect, :ref:`int<class_int>` arg2=-1 **)**
  92. .. _class_AudioServer_generate_bus_layout:
  93. - :ref:`AudioBusLayout<class_audiobuslayout>` **generate_bus_layout** **(** **)** const
  94. .. _class_AudioServer_get_bus_count:
  95. - :ref:`int<class_int>` **get_bus_count** **(** **)** const
  96. .. _class_AudioServer_get_bus_effect:
  97. - :ref:`AudioEffect<class_audioeffect>` **get_bus_effect** **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx **)**
  98. .. _class_AudioServer_get_bus_effect_count:
  99. - void **get_bus_effect_count** **(** :ref:`int<class_int>` bus_idx, :ref:`Object<class_object>` arg1, :ref:`int<class_int>` arg2 **)**
  100. .. _class_AudioServer_get_bus_index:
  101. - :ref:`int<class_int>` **get_bus_index** **(** :ref:`String<class_string>` bus_name **)** const
  102. .. _class_AudioServer_get_bus_name:
  103. - :ref:`String<class_string>` **get_bus_name** **(** :ref:`int<class_int>` bus_idx **)** const
  104. .. _class_AudioServer_get_bus_peak_volume_left_db:
  105. - :ref:`float<class_float>` **get_bus_peak_volume_left_db** **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` channel **)** const
  106. .. _class_AudioServer_get_bus_peak_volume_right_db:
  107. - :ref:`float<class_float>` **get_bus_peak_volume_right_db** **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` channel **)** const
  108. .. _class_AudioServer_get_bus_send:
  109. - :ref:`String<class_string>` **get_bus_send** **(** :ref:`int<class_int>` bus_idx **)** const
  110. .. _class_AudioServer_get_bus_volume_db:
  111. - :ref:`float<class_float>` **get_bus_volume_db** **(** :ref:`int<class_int>` bus_idx **)** const
  112. .. _class_AudioServer_get_mix_rate:
  113. - :ref:`float<class_float>` **get_mix_rate** **(** **)** const
  114. .. _class_AudioServer_get_speaker_mode:
  115. - :ref:`int<class_int>` **get_speaker_mode** **(** **)** const
  116. .. _class_AudioServer_is_bus_bypassing_effects:
  117. - :ref:`bool<class_bool>` **is_bus_bypassing_effects** **(** :ref:`int<class_int>` bus_idx **)** const
  118. .. _class_AudioServer_is_bus_effect_enabled:
  119. - :ref:`bool<class_bool>` **is_bus_effect_enabled** **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx **)** const
  120. .. _class_AudioServer_is_bus_mute:
  121. - :ref:`bool<class_bool>` **is_bus_mute** **(** :ref:`int<class_int>` bus_idx **)** const
  122. .. _class_AudioServer_is_bus_solo:
  123. - :ref:`bool<class_bool>` **is_bus_solo** **(** :ref:`int<class_int>` bus_idx **)** const
  124. .. _class_AudioServer_lock:
  125. - void **lock** **(** **)**
  126. .. _class_AudioServer_move_bus:
  127. - void **move_bus** **(** :ref:`int<class_int>` index, :ref:`int<class_int>` to_index **)**
  128. .. _class_AudioServer_remove_bus:
  129. - void **remove_bus** **(** :ref:`int<class_int>` index **)**
  130. .. _class_AudioServer_remove_bus_effect:
  131. - void **remove_bus_effect** **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx **)**
  132. .. _class_AudioServer_set_bus_bypass_effects:
  133. - void **set_bus_bypass_effects** **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable **)**
  134. .. _class_AudioServer_set_bus_count:
  135. - void **set_bus_count** **(** :ref:`int<class_int>` amount **)**
  136. .. _class_AudioServer_set_bus_effect_enabled:
  137. - void **set_bus_effect_enabled** **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx, :ref:`bool<class_bool>` enabled **)**
  138. .. _class_AudioServer_set_bus_layout:
  139. - void **set_bus_layout** **(** :ref:`AudioBusLayout<class_audiobuslayout>` bus_layout **)**
  140. .. _class_AudioServer_set_bus_mute:
  141. - void **set_bus_mute** **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable **)**
  142. .. _class_AudioServer_set_bus_name:
  143. - void **set_bus_name** **(** :ref:`int<class_int>` bus_idx, :ref:`String<class_string>` name **)**
  144. .. _class_AudioServer_set_bus_send:
  145. - void **set_bus_send** **(** :ref:`int<class_int>` bus_idx, :ref:`String<class_string>` send **)**
  146. .. _class_AudioServer_set_bus_solo:
  147. - void **set_bus_solo** **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable **)**
  148. .. _class_AudioServer_set_bus_volume_db:
  149. - void **set_bus_volume_db** **(** :ref:`int<class_int>` bus_idx, :ref:`float<class_float>` volume_db **)**
  150. .. _class_AudioServer_swap_bus_effects:
  151. - void **swap_bus_effects** **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx, :ref:`int<class_int>` by_effect_idx **)**
  152. .. _class_AudioServer_unlock:
  153. - void **unlock** **(** **)**