class_audioeffectchorus.rst 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207
  1. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  2. .. DO NOT EDIT THIS FILE, but the AudioEffectChorus.xml source instead.
  3. .. The source is found in doc/classes or modules/<name>/doc_classes.
  4. .. _class_AudioEffectChorus:
  5. AudioEffectChorus
  6. =================
  7. **Inherits:** :ref:`AudioEffect<class_audioeffect>` **<** :ref:`Resource<class_resource>` **<** :ref:`Reference<class_reference>` **<** :ref:`Object<class_object>`
  8. **Category:** Core
  9. Brief Description
  10. -----------------
  11. Adds a chorus audio effect.
  12. Member Functions
  13. ----------------
  14. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  15. | :ref:`float<class_float>` | :ref:`get_dry<class_AudioEffectChorus_get_dry>` **(** **)** const |
  16. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  17. | :ref:`int<class_int>` | :ref:`get_voice_count<class_AudioEffectChorus_get_voice_count>` **(** **)** const |
  18. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  19. | :ref:`float<class_float>` | :ref:`get_voice_cutoff_hz<class_AudioEffectChorus_get_voice_cutoff_hz>` **(** :ref:`int<class_int>` voice_idx **)** const |
  20. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  21. | :ref:`float<class_float>` | :ref:`get_voice_delay_ms<class_AudioEffectChorus_get_voice_delay_ms>` **(** :ref:`int<class_int>` voice_idx **)** const |
  22. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  23. | :ref:`float<class_float>` | :ref:`get_voice_depth_ms<class_AudioEffectChorus_get_voice_depth_ms>` **(** :ref:`int<class_int>` voice_idx **)** const |
  24. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  25. | :ref:`float<class_float>` | :ref:`get_voice_level_db<class_AudioEffectChorus_get_voice_level_db>` **(** :ref:`int<class_int>` voice_idx **)** const |
  26. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  27. | :ref:`float<class_float>` | :ref:`get_voice_pan<class_AudioEffectChorus_get_voice_pan>` **(** :ref:`int<class_int>` voice_idx **)** const |
  28. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  29. | :ref:`float<class_float>` | :ref:`get_voice_rate_hz<class_AudioEffectChorus_get_voice_rate_hz>` **(** :ref:`int<class_int>` voice_idx **)** const |
  30. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  31. | :ref:`float<class_float>` | :ref:`get_wet<class_AudioEffectChorus_get_wet>` **(** **)** const |
  32. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  33. | void | :ref:`set_dry<class_AudioEffectChorus_set_dry>` **(** :ref:`float<class_float>` amount **)** |
  34. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  35. | void | :ref:`set_voice_count<class_AudioEffectChorus_set_voice_count>` **(** :ref:`int<class_int>` voices **)** |
  36. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  37. | void | :ref:`set_voice_cutoff_hz<class_AudioEffectChorus_set_voice_cutoff_hz>` **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` cutoff_hz **)** |
  38. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  39. | void | :ref:`set_voice_delay_ms<class_AudioEffectChorus_set_voice_delay_ms>` **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` delay_ms **)** |
  40. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  41. | void | :ref:`set_voice_depth_ms<class_AudioEffectChorus_set_voice_depth_ms>` **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` depth_ms **)** |
  42. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  43. | void | :ref:`set_voice_level_db<class_AudioEffectChorus_set_voice_level_db>` **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` level_db **)** |
  44. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  45. | void | :ref:`set_voice_pan<class_AudioEffectChorus_set_voice_pan>` **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` pan **)** |
  46. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  47. | void | :ref:`set_voice_rate_hz<class_AudioEffectChorus_set_voice_rate_hz>` **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` rate_hz **)** |
  48. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  49. | void | :ref:`set_wet<class_AudioEffectChorus_set_wet>` **(** :ref:`float<class_float>` amount **)** |
  50. +----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  51. Member Variables
  52. ----------------
  53. - :ref:`float<class_float>` **dry** - The effect's raw signal.
  54. - :ref:`float<class_float>` **voice/1/cutoff_hz** - The voice's cutoff frequency.
  55. - :ref:`float<class_float>` **voice/1/delay_ms** - The voice's signal delay.
  56. - :ref:`float<class_float>` **voice/1/depth_ms** - The voice filter's depth.
  57. - :ref:`float<class_float>` **voice/1/level_db** - The voice's volume.
  58. - :ref:`float<class_float>` **voice/1/pan** - The voice's pan level.
  59. - :ref:`float<class_float>` **voice/1/rate_hz** - The voice's filter rate.
  60. - :ref:`float<class_float>` **voice/2/cutoff_hz** - The voice's cutoff frequency.
  61. - :ref:`float<class_float>` **voice/2/delay_ms** - The voice's signal delay.
  62. - :ref:`float<class_float>` **voice/2/depth_ms** - The voice filter's depth.
  63. - :ref:`float<class_float>` **voice/2/level_db** - The voice's volume.
  64. - :ref:`float<class_float>` **voice/2/pan** - The voice's pan level.
  65. - :ref:`float<class_float>` **voice/2/rate_hz** - The voice's filter rate.
  66. - :ref:`float<class_float>` **voice/3/cutoff_hz** - The voice's cutoff frequency.
  67. - :ref:`float<class_float>` **voice/3/delay_ms** - The voice's signal delay.
  68. - :ref:`float<class_float>` **voice/3/depth_ms** - The voice filter's depth.
  69. - :ref:`float<class_float>` **voice/3/level_db** - The voice's volume.
  70. - :ref:`float<class_float>` **voice/3/pan** - The voice's pan level.
  71. - :ref:`float<class_float>` **voice/3/rate_hz** - The voice's filter rate.
  72. - :ref:`float<class_float>` **voice/4/cutoff_hz** - The voice's cutoff frequency.
  73. - :ref:`float<class_float>` **voice/4/delay_ms** - The voice's signal delay.
  74. - :ref:`float<class_float>` **voice/4/depth_ms** - The voice filter's depth.
  75. - :ref:`float<class_float>` **voice/4/level_db** - The voice's volume.
  76. - :ref:`float<class_float>` **voice/4/pan** - The voice's pan level.
  77. - :ref:`float<class_float>` **voice/4/rate_hz** - The voice's filter rate.
  78. - :ref:`int<class_int>` **voice_count** - The amount of voices in the effect.
  79. - :ref:`float<class_float>` **wet** - The effect's processed signal.
  80. Description
  81. -----------
  82. Adds a chorus audio effect. The effect applies a filter with voices to duplicate the audio source and manipulate it through the filter.
  83. Member Function Description
  84. ---------------------------
  85. .. _class_AudioEffectChorus_get_dry:
  86. - :ref:`float<class_float>` **get_dry** **(** **)** const
  87. Returns the set dry ratio.
  88. .. _class_AudioEffectChorus_get_voice_count:
  89. - :ref:`int<class_int>` **get_voice_count** **(** **)** const
  90. Returns the set voice count.
  91. .. _class_AudioEffectChorus_get_voice_cutoff_hz:
  92. - :ref:`float<class_float>` **get_voice_cutoff_hz** **(** :ref:`int<class_int>` voice_idx **)** const
  93. Returns the voice's set cutoff frequency.
  94. .. _class_AudioEffectChorus_get_voice_delay_ms:
  95. - :ref:`float<class_float>` **get_voice_delay_ms** **(** :ref:`int<class_int>` voice_idx **)** const
  96. Returns the voice's set delay.
  97. .. _class_AudioEffectChorus_get_voice_depth_ms:
  98. - :ref:`float<class_float>` **get_voice_depth_ms** **(** :ref:`int<class_int>` voice_idx **)** const
  99. Returns the voice's set filter depth.
  100. .. _class_AudioEffectChorus_get_voice_level_db:
  101. - :ref:`float<class_float>` **get_voice_level_db** **(** :ref:`int<class_int>` voice_idx **)** const
  102. Returns the voice's set maximum volume.
  103. .. _class_AudioEffectChorus_get_voice_pan:
  104. - :ref:`float<class_float>` **get_voice_pan** **(** :ref:`int<class_int>` voice_idx **)** const
  105. Returns the voice's set pan.
  106. .. _class_AudioEffectChorus_get_voice_rate_hz:
  107. - :ref:`float<class_float>` **get_voice_rate_hz** **(** :ref:`int<class_int>` voice_idx **)** const
  108. Returns the voice filter's set rate in cycles.
  109. .. _class_AudioEffectChorus_get_wet:
  110. - :ref:`float<class_float>` **get_wet** **(** **)** const
  111. Returns the set applied wetness of the effect.
  112. .. _class_AudioEffectChorus_set_dry:
  113. - void **set_dry** **(** :ref:`float<class_float>` amount **)**
  114. Returns the set applied dryness of the effect.
  115. .. _class_AudioEffectChorus_set_voice_count:
  116. - void **set_voice_count** **(** :ref:`int<class_int>` voices **)**
  117. Set the number of voices in the effect's filter.
  118. .. _class_AudioEffectChorus_set_voice_cutoff_hz:
  119. - void **set_voice_cutoff_hz** **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` cutoff_hz **)**
  120. Set the cutoff frequency of the voice. The maximum frequency the voice may affect.
  121. .. _class_AudioEffectChorus_set_voice_delay_ms:
  122. - void **set_voice_delay_ms** **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` delay_ms **)**
  123. Set the delay of the voice's signal.
  124. .. _class_AudioEffectChorus_set_voice_depth_ms:
  125. - void **set_voice_depth_ms** **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` depth_ms **)**
  126. Set the filter depth of the voice's signal.
  127. .. _class_AudioEffectChorus_set_voice_level_db:
  128. - void **set_voice_level_db** **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` level_db **)**
  129. Set the volume level of the voice.
  130. .. _class_AudioEffectChorus_set_voice_pan:
  131. - void **set_voice_pan** **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` pan **)**
  132. Set the pan level of the voice.
  133. .. _class_AudioEffectChorus_set_voice_rate_hz:
  134. - void **set_voice_rate_hz** **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` rate_hz **)**
  135. Set the voice filter's rate.
  136. .. _class_AudioEffectChorus_set_wet:
  137. - void **set_wet** **(** :ref:`float<class_float>` amount **)**
  138. Set the amount of effect.