Files
godot-docs-l10n/classes/zh_Hans/class_visualshadernodeparameter.rst
Rémi Verschelde c3f2364c10 Sync classref with 4.6 branch
Lots of translations invalidated (fuzzied) as we just synced Weblate.
2025-12-19 16:39:51 +01:00

157 lines
6.9 KiB
ReStructuredText

:github_url: hide
.. _class_VisualShaderNodeParameter:
VisualShaderNodeParameter
=========================
**继承:** :ref:`VisualShaderNode<class_VisualShaderNode>` **<** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
**派生:** :ref:`VisualShaderNodeBooleanParameter<class_VisualShaderNodeBooleanParameter>`, :ref:`VisualShaderNodeColorParameter<class_VisualShaderNodeColorParameter>`, :ref:`VisualShaderNodeFloatParameter<class_VisualShaderNodeFloatParameter>`, :ref:`VisualShaderNodeIntParameter<class_VisualShaderNodeIntParameter>`, :ref:`VisualShaderNodeTextureParameter<class_VisualShaderNodeTextureParameter>`, :ref:`VisualShaderNodeTransformParameter<class_VisualShaderNodeTransformParameter>`, :ref:`VisualShaderNodeUIntParameter<class_VisualShaderNodeUIntParameter>`, :ref:`VisualShaderNodeVec2Parameter<class_VisualShaderNodeVec2Parameter>`, :ref:`VisualShaderNodeVec3Parameter<class_VisualShaderNodeVec3Parameter>`, :ref:`VisualShaderNodeVec4Parameter<class_VisualShaderNodeVec4Parameter>`
可视化着色器图中,参数的基础类型。
.. rst-class:: classref-introduction-group
描述
----
参数代表着色器中的一个变量,是由外部设置的,即从 :ref:`ShaderMaterial<class_ShaderMaterial>` 中设置。参数在 :ref:`ShaderMaterial<class_ShaderMaterial>` 中以属性的形式暴露,可以从检查器或脚本中分配。
.. rst-class:: classref-reftable-group
属性
----
.. table::
:widths: auto
+------------------------------------------------------------+--------------------------------------------------------------------------------+--------+
| :ref:`int<class_int>` | :ref:`instance_index<class_VisualShaderNodeParameter_property_instance_index>` | ``0`` |
+------------------------------------------------------------+--------------------------------------------------------------------------------+--------+
| :ref:`String<class_String>` | :ref:`parameter_name<class_VisualShaderNodeParameter_property_parameter_name>` | ``""`` |
+------------------------------------------------------------+--------------------------------------------------------------------------------+--------+
| :ref:`Qualifier<enum_VisualShaderNodeParameter_Qualifier>` | :ref:`qualifier<class_VisualShaderNodeParameter_property_qualifier>` | ``0`` |
+------------------------------------------------------------+--------------------------------------------------------------------------------+--------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
枚举
----
.. _enum_VisualShaderNodeParameter_Qualifier:
.. rst-class:: classref-enumeration
enum **Qualifier**: :ref:`🔗<enum_VisualShaderNodeParameter_Qualifier>`
.. _class_VisualShaderNodeParameter_constant_QUAL_NONE:
.. rst-class:: classref-enumeration-constant
:ref:`Qualifier<enum_VisualShaderNodeParameter_Qualifier>` **QUAL_NONE** = ``0``
该参数绑定至使用此着色器的 :ref:`ShaderMaterial<class_ShaderMaterial>`\ 。
.. _class_VisualShaderNodeParameter_constant_QUAL_GLOBAL:
.. rst-class:: classref-enumeration-constant
:ref:`Qualifier<enum_VisualShaderNodeParameter_Qualifier>` **QUAL_GLOBAL** = ``1``
该参数使用“项目设置”中定义的全局值。
.. _class_VisualShaderNodeParameter_constant_QUAL_INSTANCE:
.. rst-class:: classref-enumeration-constant
:ref:`Qualifier<enum_VisualShaderNodeParameter_Qualifier>` **QUAL_INSTANCE** = ``2``
该参数绑定至节点,该节点附加了使用此着色器的 :ref:`ShaderMaterial<class_ShaderMaterial>`\ 。
.. _class_VisualShaderNodeParameter_constant_QUAL_INSTANCE_INDEX:
.. rst-class:: classref-enumeration-constant
:ref:`Qualifier<enum_VisualShaderNodeParameter_Qualifier>` **QUAL_INSTANCE_INDEX** = ``3``
The parameter will be tied to the node with attached :ref:`ShaderMaterial<class_ShaderMaterial>` using this shader. Enables setting a :ref:`instance_index<class_VisualShaderNodeParameter_property_instance_index>` property.
.. _class_VisualShaderNodeParameter_constant_QUAL_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`Qualifier<enum_VisualShaderNodeParameter_Qualifier>` **QUAL_MAX** = ``4``
代表 :ref:`Qualifier<enum_VisualShaderNodeParameter_Qualifier>` 枚举的大小。
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
属性说明
--------
.. _class_VisualShaderNodeParameter_property_instance_index:
.. rst-class:: classref-property
:ref:`int<class_int>` **instance_index** = ``0`` :ref:`🔗<class_VisualShaderNodeParameter_property_instance_index>`
.. rst-class:: classref-property-setget
- |void| **set_instance_index**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_instance_index**\ (\ )
The index within 0-15 range, which is used to avoid clashes when shader used on multiple materials.
.. rst-class:: classref-item-separator
----
.. _class_VisualShaderNodeParameter_property_parameter_name:
.. rst-class:: classref-property
:ref:`String<class_String>` **parameter_name** = ``""`` :ref:`🔗<class_VisualShaderNodeParameter_property_parameter_name>`
.. rst-class:: classref-property-setget
- |void| **set_parameter_name**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_parameter_name**\ (\ )
参数的名称,该参数可以通过该名称作为 :ref:`ShaderMaterial<class_ShaderMaterial>` 的属性访问。
.. rst-class:: classref-item-separator
----
.. _class_VisualShaderNodeParameter_property_qualifier:
.. rst-class:: classref-property
:ref:`Qualifier<enum_VisualShaderNodeParameter_Qualifier>` **qualifier** = ``0`` :ref:`🔗<class_VisualShaderNodeParameter_property_qualifier>`
.. rst-class:: classref-property-setget
- |void| **set_qualifier**\ (\ value\: :ref:`Qualifier<enum_VisualShaderNodeParameter_Qualifier>`\ )
- :ref:`Qualifier<enum_VisualShaderNodeParameter_Qualifier>` **get_qualifier**\ (\ )
定义该参数的作用域。
.. |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 (无返回值。)`