Files
godot-docs-l10n/classes/zh_CN/class_audioeffectlimiter.rst
Rémi Verschelde 9581bc9bb3 Sync class reference translations with upstream 4.x
Still only zh_CN for now.
zh_TW is near 100% complete, but it has hundreds of validation errors
which need to be fixed first.
2023-11-21 16:13:45 +01:00

133 lines
4.8 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:github_url: hide
.. DO NOT EDIT THIS FILE!!!
.. Generated automatically from Godot engine sources.
.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectLimiter.xml.
.. _class_AudioEffectLimiter:
AudioEffectLimiter
==================
**继承:** :ref:`AudioEffect<class_AudioEffect>` **<** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
为音频总线添加一个软剪辑限制器音频效果。
.. rst-class:: classref-introduction-group
描述
----
限制器类似于压缩器,但灵活性较差,并且设计为不允许声音超过给定的 dB 阈值。始终建议在主总线中添加一个以减少削波的影响。
软削波开始将峰值降低到略低于阈值水平,并随着输入水平的增加而逐渐增强其效果,从而永不超过阈值。
.. rst-class:: classref-introduction-group
教程
----
- :doc:`音频总线 <../tutorials/audio/audio_buses>`
.. rst-class:: classref-reftable-group
属性
----
.. table::
:widths: auto
+---------------------------+---------------------------------------------------------------------------+----------+
| :ref:`float<class_float>` | :ref:`ceiling_db<class_AudioEffectLimiter_property_ceiling_db>` | ``-0.1`` |
+---------------------------+---------------------------------------------------------------------------+----------+
| :ref:`float<class_float>` | :ref:`soft_clip_db<class_AudioEffectLimiter_property_soft_clip_db>` | ``2.0`` |
+---------------------------+---------------------------------------------------------------------------+----------+
| :ref:`float<class_float>` | :ref:`soft_clip_ratio<class_AudioEffectLimiter_property_soft_clip_ratio>` | ``10.0`` |
+---------------------------+---------------------------------------------------------------------------+----------+
| :ref:`float<class_float>` | :ref:`threshold_db<class_AudioEffectLimiter_property_threshold_db>` | ``0.0`` |
+---------------------------+---------------------------------------------------------------------------+----------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
属性说明
--------
.. _class_AudioEffectLimiter_property_ceiling_db:
.. rst-class:: classref-property
:ref:`float<class_float>` **ceiling_db** = ``-0.1``
.. rst-class:: classref-property-setget
- void **set_ceiling_db** **(** :ref:`float<class_float>` value **)**
- :ref:`float<class_float>` **get_ceiling_db** **(** **)**
波形的最大允许值,单位是分贝。数值范围从 -20 到 -0.1。
.. rst-class:: classref-item-separator
----
.. _class_AudioEffectLimiter_property_soft_clip_db:
.. rst-class:: classref-property
:ref:`float<class_float>` **soft_clip_db** = ``2.0``
.. rst-class:: classref-property-setget
- void **set_soft_clip_db** **(** :ref:`float<class_float>` value **)**
- :ref:`float<class_float>` **get_soft_clip_db** **(** **)**
将增益应用于被限制的波,以分贝为单位。取值范围是 0 到 6。
.. rst-class:: classref-item-separator
----
.. _class_AudioEffectLimiter_property_soft_clip_ratio:
.. rst-class:: classref-property
:ref:`float<class_float>` **soft_clip_ratio** = ``10.0``
.. rst-class:: classref-property-setget
- void **set_soft_clip_ratio** **(** :ref:`float<class_float>` value **)**
- :ref:`float<class_float>` **get_soft_clip_ratio** **(** **)**
.. container:: contribute
目前没有这个属性的描述。请帮我们\ :ref:`贡献一个 <doc_updating_the_class_reference>`\
.. rst-class:: classref-item-separator
----
.. _class_AudioEffectLimiter_property_threshold_db:
.. rst-class:: classref-property
:ref:`float<class_float>` **threshold_db** = ``0.0``
.. rst-class:: classref-property-setget
- void **set_threshold_db** **(** :ref:`float<class_float>` value **)**
- :ref:`float<class_float>` **get_threshold_db** **(** **)**
限制器开始生效的阈值,以分贝为单位。值的范围可以从 -30 到 0。
.. |virtual| replace:: :abbr:`virtual (本方法通常需要用户覆盖才能生效。)`
.. |const| replace:: :abbr:`const (本方法没有副作用。不会修改该实例的任何成员变量。)`
.. |vararg| replace:: :abbr:`vararg (本方法除了在此处描述的参数外,还能够继续接受任意数量的参数。)`
.. |constructor| replace:: :abbr:`constructor (本方法用于构造某个类型。)`
.. |static| replace:: :abbr:`static (调用本方法无需实例,所以可以直接使用类名调用。)`
.. |operator| replace:: :abbr:`operator (本方法描述的是使用本类型作为左操作数的有效操作符。)`
.. |bitfield| replace:: :abbr:`BitField (这个值是由下列标志构成的位掩码整数。)`