Files
godot-docs-l10n/classes/zh_Hans/class_renderscenebuffersconfiguration.rst

233 lines
12 KiB
ReStructuredText

:github_url: hide
.. _class_RenderSceneBuffersConfiguration:
RenderSceneBuffersConfiguration
===============================
**继承:** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
用于设置 :ref:`RenderSceneBuffers<class_RenderSceneBuffers>` 对象的配置对象。
.. rst-class:: classref-introduction-group
描述
----
该配置对象由渲染引擎在视口更改时创建和填充,并用于(重新)配置 :ref:`RenderSceneBuffers<class_RenderSceneBuffers>` 对象。
.. rst-class:: classref-reftable-group
属性
----
.. table::
:widths: auto
+----------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+--------------------+
| :ref:`ViewportAnisotropicFiltering<enum_RenderingServer_ViewportAnisotropicFiltering>` | :ref:`anisotropic_filtering_level<class_RenderSceneBuffersConfiguration_property_anisotropic_filtering_level>` | ``2`` |
+----------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+--------------------+
| :ref:`float<class_float>` | :ref:`fsr_sharpness<class_RenderSceneBuffersConfiguration_property_fsr_sharpness>` | ``0.0`` |
+----------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+--------------------+
| :ref:`Vector2i<class_Vector2i>` | :ref:`internal_size<class_RenderSceneBuffersConfiguration_property_internal_size>` | ``Vector2i(0, 0)`` |
+----------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+--------------------+
| :ref:`ViewportMSAA<enum_RenderingServer_ViewportMSAA>` | :ref:`msaa_3d<class_RenderSceneBuffersConfiguration_property_msaa_3d>` | ``0`` |
+----------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+--------------------+
| :ref:`RID<class_RID>` | :ref:`render_target<class_RenderSceneBuffersConfiguration_property_render_target>` | ``RID()`` |
+----------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+--------------------+
| :ref:`ViewportScaling3DMode<enum_RenderingServer_ViewportScaling3DMode>` | :ref:`scaling_3d_mode<class_RenderSceneBuffersConfiguration_property_scaling_3d_mode>` | ``255`` |
+----------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+--------------------+
| :ref:`ViewportScreenSpaceAA<enum_RenderingServer_ViewportScreenSpaceAA>` | :ref:`screen_space_aa<class_RenderSceneBuffersConfiguration_property_screen_space_aa>` | ``0`` |
+----------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+--------------------+
| :ref:`Vector2i<class_Vector2i>` | :ref:`target_size<class_RenderSceneBuffersConfiguration_property_target_size>` | ``Vector2i(0, 0)`` |
+----------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+--------------------+
| :ref:`float<class_float>` | :ref:`texture_mipmap_bias<class_RenderSceneBuffersConfiguration_property_texture_mipmap_bias>` | ``0.0`` |
+----------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+--------------------+
| :ref:`int<class_int>` | :ref:`view_count<class_RenderSceneBuffersConfiguration_property_view_count>` | ``1`` |
+----------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+--------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
属性说明
--------
.. _class_RenderSceneBuffersConfiguration_property_anisotropic_filtering_level:
.. rst-class:: classref-property
:ref:`ViewportAnisotropicFiltering<enum_RenderingServer_ViewportAnisotropicFiltering>` **anisotropic_filtering_level** = ``2`` :ref:`🔗<class_RenderSceneBuffersConfiguration_property_anisotropic_filtering_level>`
.. rst-class:: classref-property-setget
- |void| **set_anisotropic_filtering_level**\ (\ value\: :ref:`ViewportAnisotropicFiltering<enum_RenderingServer_ViewportAnisotropicFiltering>`\ )
- :ref:`ViewportAnisotropicFiltering<enum_RenderingServer_ViewportAnisotropicFiltering>` **get_anisotropic_filtering_level**\ (\ )
各向异性过滤的级别。
.. rst-class:: classref-item-separator
----
.. _class_RenderSceneBuffersConfiguration_property_fsr_sharpness:
.. rst-class:: classref-property
:ref:`float<class_float>` **fsr_sharpness** = ``0.0`` :ref:`🔗<class_RenderSceneBuffersConfiguration_property_fsr_sharpness>`
.. rst-class:: classref-property-setget
- |void| **set_fsr_sharpness**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_fsr_sharpness**\ (\ )
如果使用 FSR 放大,则 FSR 锐度适用。
.. rst-class:: classref-item-separator
----
.. _class_RenderSceneBuffersConfiguration_property_internal_size:
.. rst-class:: classref-property
:ref:`Vector2i<class_Vector2i>` **internal_size** = ``Vector2i(0, 0)`` :ref:`🔗<class_RenderSceneBuffersConfiguration_property_internal_size>`
.. rst-class:: classref-property-setget
- |void| **set_internal_size**\ (\ value\: :ref:`Vector2i<class_Vector2i>`\ )
- :ref:`Vector2i<class_Vector2i>` **get_internal_size**\ (\ )
用于渲染的 3D 渲染缓冲区的大小。
.. rst-class:: classref-item-separator
----
.. _class_RenderSceneBuffersConfiguration_property_msaa_3d:
.. rst-class:: classref-property
:ref:`ViewportMSAA<enum_RenderingServer_ViewportMSAA>` **msaa_3d** = ``0`` :ref:`🔗<class_RenderSceneBuffersConfiguration_property_msaa_3d>`
.. rst-class:: classref-property-setget
- |void| **set_msaa_3d**\ (\ value\: :ref:`ViewportMSAA<enum_RenderingServer_ViewportMSAA>`\ )
- :ref:`ViewportMSAA<enum_RenderingServer_ViewportMSAA>` **get_msaa_3d**\ (\ )
用于 3D 渲染的 MSAA 模式。
.. rst-class:: classref-item-separator
----
.. _class_RenderSceneBuffersConfiguration_property_render_target:
.. rst-class:: classref-property
:ref:`RID<class_RID>` **render_target** = ``RID()`` :ref:`🔗<class_RenderSceneBuffersConfiguration_property_render_target>`
.. rst-class:: classref-property-setget
- |void| **set_render_target**\ (\ value\: :ref:`RID<class_RID>`\ )
- :ref:`RID<class_RID>` **get_render_target**\ (\ )
与这些缓冲区关联的渲染目标。
.. rst-class:: classref-item-separator
----
.. _class_RenderSceneBuffersConfiguration_property_scaling_3d_mode:
.. rst-class:: classref-property
:ref:`ViewportScaling3DMode<enum_RenderingServer_ViewportScaling3DMode>` **scaling_3d_mode** = ``255`` :ref:`🔗<class_RenderSceneBuffersConfiguration_property_scaling_3d_mode>`
.. rst-class:: classref-property-setget
- |void| **set_scaling_3d_mode**\ (\ value\: :ref:`ViewportScaling3DMode<enum_RenderingServer_ViewportScaling3DMode>`\ )
- :ref:`ViewportScaling3DMode<enum_RenderingServer_ViewportScaling3DMode>` **get_scaling_3d_mode**\ (\ )
如果 :ref:`internal_size<class_RenderSceneBuffersConfiguration_property_internal_size>`:ref:`target_size<class_RenderSceneBuffersConfiguration_property_target_size>` 不相等,则将使用所请求的缩放模式进行放大/缩小。
.. rst-class:: classref-item-separator
----
.. _class_RenderSceneBuffersConfiguration_property_screen_space_aa:
.. rst-class:: classref-property
:ref:`ViewportScreenSpaceAA<enum_RenderingServer_ViewportScreenSpaceAA>` **screen_space_aa** = ``0`` :ref:`🔗<class_RenderSceneBuffersConfiguration_property_screen_space_aa>`
.. rst-class:: classref-property-setget
- |void| **set_screen_space_aa**\ (\ value\: :ref:`ViewportScreenSpaceAA<enum_RenderingServer_ViewportScreenSpaceAA>`\ )
- :ref:`ViewportScreenSpaceAA<enum_RenderingServer_ViewportScreenSpaceAA>` **get_screen_space_aa**\ (\ )
请求在后期处理中应用的屏幕空间抗锯齿。
.. rst-class:: classref-item-separator
----
.. _class_RenderSceneBuffersConfiguration_property_target_size:
.. rst-class:: classref-property
:ref:`Vector2i<class_Vector2i>` **target_size** = ``Vector2i(0, 0)`` :ref:`🔗<class_RenderSceneBuffersConfiguration_property_target_size>`
.. rst-class:: classref-property-setget
- |void| **set_target_size**\ (\ value\: :ref:`Vector2i<class_Vector2i>`\ )
- :ref:`Vector2i<class_Vector2i>` **get_target_size**\ (\ )
使用缩放时的目标(放大)大小。
.. rst-class:: classref-item-separator
----
.. _class_RenderSceneBuffersConfiguration_property_texture_mipmap_bias:
.. rst-class:: classref-property
:ref:`float<class_float>` **texture_mipmap_bias** = ``0.0`` :ref:`🔗<class_RenderSceneBuffersConfiguration_property_texture_mipmap_bias>`
.. rst-class:: classref-property-setget
- |void| **set_texture_mipmap_bias**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_texture_mipmap_bias**\ (\ )
应用于 mipmap 的偏置。
.. rst-class:: classref-item-separator
----
.. _class_RenderSceneBuffersConfiguration_property_view_count:
.. rst-class:: classref-property
:ref:`int<class_int>` **view_count** = ``1`` :ref:`🔗<class_RenderSceneBuffersConfiguration_property_view_count>`
.. rst-class:: classref-property-setget
- |void| **set_view_count**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_view_count**\ (\ )
渲染的视图数。
.. |virtual| replace:: :abbr:`virtual (本方法通常需要用户覆盖才能生效。)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (本方法无副作用,不会修改该实例的任何成员变量。)`
.. |vararg| replace:: :abbr:`vararg (本方法除了能接受在此处描述的参数外,还能够继续接受任意数量的参数。)`
.. |constructor| replace:: :abbr:`constructor (本方法用于构造某个类型。)`
.. |static| replace:: :abbr:`static (调用本方法无需实例,可直接使用类名进行调用。)`
.. |operator| replace:: :abbr:`operator (本方法描述的是使用本类型作为左操作数的有效运算符。)`
.. |bitfield| replace:: :abbr:`BitField (这个值是由下列位标志构成位掩码的整数。)`
.. |void| replace:: :abbr:`void (无返回值。)`