class_audioeffectpitchshift.rst 3.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108
  1. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  2. .. DO NOT EDIT THIS FILE, but the AudioEffectPitchShift.xml source instead.
  3. .. The source is found in doc/classes or modules/<name>/doc_classes.
  4. .. _class_AudioEffectPitchShift:
  5. AudioEffectPitchShift
  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 pitch-shifting audio effect to an Audio bus.
  12. Raises or lowers the pitch of original sound.
  13. Properties
  14. ----------
  15. +------------------------------------------------------+------------------------------------------------------------------------+-----+
  16. | :ref:`FFT_Size<enum_AudioEffectPitchShift_FFT_Size>` | :ref:`fft_size<class_AudioEffectPitchShift_property_fft_size>` | 3 |
  17. +------------------------------------------------------+------------------------------------------------------------------------+-----+
  18. | :ref:`int<class_int>` | :ref:`oversampling<class_AudioEffectPitchShift_property_oversampling>` | 4 |
  19. +------------------------------------------------------+------------------------------------------------------------------------+-----+
  20. | :ref:`float<class_float>` | :ref:`pitch_scale<class_AudioEffectPitchShift_property_pitch_scale>` | 1.0 |
  21. +------------------------------------------------------+------------------------------------------------------------------------+-----+
  22. Enumerations
  23. ------------
  24. .. _enum_AudioEffectPitchShift_FFT_Size:
  25. .. _class_AudioEffectPitchShift_constant_FFT_SIZE_256:
  26. .. _class_AudioEffectPitchShift_constant_FFT_SIZE_512:
  27. .. _class_AudioEffectPitchShift_constant_FFT_SIZE_1024:
  28. .. _class_AudioEffectPitchShift_constant_FFT_SIZE_2048:
  29. .. _class_AudioEffectPitchShift_constant_FFT_SIZE_4096:
  30. .. _class_AudioEffectPitchShift_constant_FFT_SIZE_MAX:
  31. enum **FFT_Size**:
  32. - **FFT_SIZE_256** = **0**
  33. - **FFT_SIZE_512** = **1**
  34. - **FFT_SIZE_1024** = **2**
  35. - **FFT_SIZE_2048** = **3**
  36. - **FFT_SIZE_4096** = **4**
  37. - **FFT_SIZE_MAX** = **5** --- Represents the size of the :ref:`FFT_Size<enum_AudioEffectPitchShift_FFT_Size>` enum.
  38. Description
  39. -----------
  40. Allows modulation of pitch independently of tempo. All frequencies can be increased/decreased with minimal effect on transients.
  41. Property Descriptions
  42. ---------------------
  43. .. _class_AudioEffectPitchShift_property_fft_size:
  44. - :ref:`FFT_Size<enum_AudioEffectPitchShift_FFT_Size>` **fft_size**
  45. +-----------+---------------------+
  46. | *Default* | 3 |
  47. +-----------+---------------------+
  48. | *Setter* | set_fft_size(value) |
  49. +-----------+---------------------+
  50. | *Getter* | get_fft_size() |
  51. +-----------+---------------------+
  52. .. _class_AudioEffectPitchShift_property_oversampling:
  53. - :ref:`int<class_int>` **oversampling**
  54. +-----------+-------------------------+
  55. | *Default* | 4 |
  56. +-----------+-------------------------+
  57. | *Setter* | set_oversampling(value) |
  58. +-----------+-------------------------+
  59. | *Getter* | get_oversampling() |
  60. +-----------+-------------------------+
  61. .. _class_AudioEffectPitchShift_property_pitch_scale:
  62. - :ref:`float<class_float>` **pitch_scale**
  63. +-----------+------------------------+
  64. | *Default* | 1.0 |
  65. +-----------+------------------------+
  66. | *Setter* | set_pitch_scale(value) |
  67. +-----------+------------------------+
  68. | *Getter* | get_pitch_scale() |
  69. +-----------+------------------------+
  70. Pitch value. Can range from 0 (-1 octave) to 16 (+16 octaves).