class_audioeffecteq.rst 3.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
  1. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  2. .. DO NOT EDIT THIS FILE, but the AudioEffectEQ.xml source instead.
  3. .. The source is found in doc/classes or modules/<name>/doc_classes.
  4. .. _class_AudioEffectEQ:
  5. AudioEffectEQ
  6. =============
  7. **Inherits:** :ref:`AudioEffect<class_audioeffect>` **<** :ref:`Resource<class_resource>` **<** :ref:`Reference<class_reference>` **<** :ref:`Object<class_object>`
  8. **Inherited By:** :ref:`AudioEffectEQ6<class_audioeffecteq6>`, :ref:`AudioEffectEQ21<class_audioeffecteq21>`, :ref:`AudioEffectEQ10<class_audioeffecteq10>`
  9. **Category:** Core
  10. Brief Description
  11. -----------------
  12. Base class for audio equalizers. Gives you control over frequencies.
  13. Use it to create a custom equalizer if :ref:`AudioEffectEQ6<class_audioeffecteq6>`, :ref:`AudioEffectEQ10<class_audioeffecteq10>` or :ref:`AudioEffectEQ21<class_audioeffecteq21>` don't fit your needs.
  14. Member Functions
  15. ----------------
  16. +----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  17. | :ref:`int<class_int>` | :ref:`get_band_count<class_AudioEffectEQ_get_band_count>` **(** **)** const |
  18. +----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  19. | :ref:`float<class_float>` | :ref:`get_band_gain_db<class_AudioEffectEQ_get_band_gain_db>` **(** :ref:`int<class_int>` band_idx **)** const |
  20. +----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  21. | void | :ref:`set_band_gain_db<class_AudioEffectEQ_set_band_gain_db>` **(** :ref:`int<class_int>` band_idx, :ref:`float<class_float>` volume_db **)** |
  22. +----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  23. Description
  24. -----------
  25. AudioEffectEQ gives you control over frequencies. Use it to compensate for existing deficiencies in audio. AudioEffectEQ are very useful on the Master Bus to completely master a mix and give it character. They are also very useful when a game is run on a mobile device, to adjust the mix to that kind of speakers (it can be added but disabled when headphones are plugged).
  26. Member Function Description
  27. ---------------------------
  28. .. _class_AudioEffectEQ_get_band_count:
  29. - :ref:`int<class_int>` **get_band_count** **(** **)** const
  30. Returns the number of bands of the equalizer.
  31. .. _class_AudioEffectEQ_get_band_gain_db:
  32. - :ref:`float<class_float>` **get_band_gain_db** **(** :ref:`int<class_int>` band_idx **)** const
  33. Returns the band's gain at the specified index, in dB.
  34. .. _class_AudioEffectEQ_set_band_gain_db:
  35. - void **set_band_gain_db** **(** :ref:`int<class_int>` band_idx, :ref:`float<class_float>` volume_db **)**
  36. Sets band's gain at the specified index, in dB.