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

428 lines
26 KiB
ReStructuredText
Raw Permalink 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
.. _class_ResourceImporterScene:
ResourceImporterScene
=====================
**继承:** :ref:`ResourceImporter<class_ResourceImporter>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
导入 glTF、FBX、COLLADA 或 Blender 3D 场景。
.. rst-class:: classref-introduction-group
描述
----
另请参见 :ref:`ResourceImporterOBJ<class_ResourceImporterOBJ>`\ ,它被用于可作为独立的 :ref:`Mesh<class_Mesh>` 或场景导入的 OBJ 模型。
\ **高级导入设置** 对话框中提供了其他选项(例如将单个网格或材质提取到文件)。可以通过双击文件系统停靠面板中的 3D 场景或通过选择文件系统停靠面板中的 3D 场景,转至导入停靠面板并选择\ **高级**\ 来访问该对话框。
\ **注意:**\ **ResourceImporterScene** *未*\ 被用于 :ref:`PackedScene<class_PackedScene>`\ ,例如 ``.tscn````.scn`` 文件 。
.. rst-class:: classref-introduction-group
教程
----
- :doc:`导入 3D 场景 <../tutorials/assets_pipeline/importing_3d_scenes/index>`
.. rst-class:: classref-reftable-group
属性
----
.. table::
:widths: auto
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`Dictionary<class_Dictionary>` | :ref:`_subresources<class_ResourceImporterScene_property__subresources>` | ``{}`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`float<class_float>` | :ref:`animation/fps<class_ResourceImporterScene_property_animation/fps>` | ``30`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`bool<class_bool>` | :ref:`animation/import<class_ResourceImporterScene_property_animation/import>` | ``true`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`bool<class_bool>` | :ref:`animation/import_rest_as_RESET<class_ResourceImporterScene_property_animation/import_rest_as_RESET>` | ``false`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`bool<class_bool>` | :ref:`animation/remove_immutable_tracks<class_ResourceImporterScene_property_animation/remove_immutable_tracks>` | ``true`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`bool<class_bool>` | :ref:`animation/trimming<class_ResourceImporterScene_property_animation/trimming>` | ``false`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`String<class_String>` | :ref:`import_script/path<class_ResourceImporterScene_property_import_script/path>` | ``""`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`int<class_int>` | :ref:`materials/extract<class_ResourceImporterScene_property_materials/extract>` | ``0`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`int<class_int>` | :ref:`materials/extract_format<class_ResourceImporterScene_property_materials/extract_format>` | ``0`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`String<class_String>` | :ref:`materials/extract_path<class_ResourceImporterScene_property_materials/extract_path>` | ``""`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`bool<class_bool>` | :ref:`meshes/create_shadow_meshes<class_ResourceImporterScene_property_meshes/create_shadow_meshes>` | ``true`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`bool<class_bool>` | :ref:`meshes/ensure_tangents<class_ResourceImporterScene_property_meshes/ensure_tangents>` | ``true`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`bool<class_bool>` | :ref:`meshes/force_disable_compression<class_ResourceImporterScene_property_meshes/force_disable_compression>` | ``false`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`bool<class_bool>` | :ref:`meshes/generate_lods<class_ResourceImporterScene_property_meshes/generate_lods>` | ``true`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`int<class_int>` | :ref:`meshes/light_baking<class_ResourceImporterScene_property_meshes/light_baking>` | ``1`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`float<class_float>` | :ref:`meshes/lightmap_texel_size<class_ResourceImporterScene_property_meshes/lightmap_texel_size>` | ``0.2`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`bool<class_bool>` | :ref:`nodes/apply_root_scale<class_ResourceImporterScene_property_nodes/apply_root_scale>` | ``true`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`bool<class_bool>` | :ref:`nodes/import_as_skeleton_bones<class_ResourceImporterScene_property_nodes/import_as_skeleton_bones>` | ``false`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`String<class_String>` | :ref:`nodes/root_name<class_ResourceImporterScene_property_nodes/root_name>` | ``""`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`float<class_float>` | :ref:`nodes/root_scale<class_ResourceImporterScene_property_nodes/root_scale>` | ``1.0`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`Script<class_Script>` | :ref:`nodes/root_script<class_ResourceImporterScene_property_nodes/root_script>` | ``null`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`String<class_String>` | :ref:`nodes/root_type<class_ResourceImporterScene_property_nodes/root_type>` | ``""`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`bool<class_bool>` | :ref:`nodes/use_name_suffixes<class_ResourceImporterScene_property_nodes/use_name_suffixes>` | ``true`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`bool<class_bool>` | :ref:`nodes/use_node_type_suffixes<class_ResourceImporterScene_property_nodes/use_node_type_suffixes>` | ``true`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
| :ref:`bool<class_bool>` | :ref:`skins/use_named_skins<class_ResourceImporterScene_property_skins/use_named_skins>` | ``true`` |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------+-----------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
属性说明
--------
.. _class_ResourceImporterScene_property__subresources:
.. rst-class:: classref-property
:ref:`Dictionary<class_Dictionary>` **_subresources** = ``{}`` :ref:`🔗<class_ResourceImporterScene_property__subresources>`
包含场景子资源的属性。这是一个内部选项,在导入停靠面板中不可见。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_animation/fps:
.. rst-class:: classref-property
:ref:`float<class_float>` **animation/fps** = ``30`` :ref:`🔗<class_ResourceImporterScene_property_animation/fps>`
用于通过线性插值将动画曲线烘焙为一系列点的每秒帧数。建议配置该值以匹配你在 3D 建模软件中用作基线的值。较高的值会导致更精确的快速运动变化的动画,但代价是文件大小和内存占用更大。由于插值,超过 30 FPS 通常不会有太大好处(因为动画在更高的渲染帧速率下仍然会显得平滑)。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_animation/import:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **animation/import** = ``true`` :ref:`🔗<class_ResourceImporterScene_property_animation/import>`
如果为 ``true``\ ,则从 3D 场景导入动画。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_animation/import_rest_as_RESET:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **animation/import_rest_as_RESET** = ``false`` :ref:`🔗<class_ResourceImporterScene_property_animation/import_rest_as_RESET>`
如果为 ``true``\ ,则添加一个名为 ``RESET``:ref:`Animation<class_Animation>`\ ,其中包含来自 :ref:`Skeleton3D<class_Skeleton3D>` 节点的 :ref:`Skeleton3D.get_bone_rest()<class_Skeleton3D_method_get_bone_rest>`\ 。这对于提取参考姿势中的动画很有用。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_animation/remove_immutable_tracks:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **animation/remove_immutable_tracks** = ``true`` :ref:`🔗<class_ResourceImporterScene_property_animation/remove_immutable_tracks>`
如果为 ``true``\ ,则移除仅包含默认值的动画轨道。这可以减少某些 3D 场景的输出文件大小和内存占用,具体取决于其动画轨道的内容。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_animation/trimming:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **animation/trimming** = ``false`` :ref:`🔗<class_ResourceImporterScene_property_animation/trimming>`
如果为 ``true``\ ,如果没有关键帧更改,则修剪动画的开头和结尾。这可以减少某些 3D 场景的输出文件大小和内存占用,具体取决于其动画轨道的内容。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_import_script/path:
.. rst-class:: classref-property
:ref:`String<class_String>` **import_script/path** = ``""`` :ref:`🔗<class_ResourceImporterScene_property_import_script/path>`
导入脚本的路径,该脚本可以在导入过程完成后运行代码以进行自定义处理。有关详细信息,请参阅 `使用导入脚本进行自动化 <../tutorials/assets_pipeline/importing_3d_scenes/import_configuration.html#using-import-scripts-for-automation>`__\ 。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_materials/extract:
.. rst-class:: classref-property
:ref:`int<class_int>` **materials/extract** = ``0`` :ref:`🔗<class_ResourceImporterScene_property_materials/extract>`
材质提取模式。
- ``0 (Keep Internal)``\ ,不提取材质。
- ``1 (Extract Once)``\ ,提取一次材质,后续导入时重用。
- ``2 (Extract and Overwrite)``\ ,每次导入都提取并覆盖材质。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_materials/extract_format:
.. rst-class:: classref-property
:ref:`int<class_int>` **materials/extract_format** = ``0`` :ref:`🔗<class_ResourceImporterScene_property_materials/extract_format>`
提取材质的文件格式。
- ``0 (Text)``\ ,文本文件格式(\ ``*.tres``\ )。
- ``1 (Binary)``\ ,二进制文件格式(\ ``*.res``\ )。
- ``2 (Material)``\ ,二进制文件格式(\ ``*.material``\ )。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_materials/extract_path:
.. rst-class:: classref-property
:ref:`String<class_String>` **materials/extract_path** = ``""`` :ref:`🔗<class_ResourceImporterScene_property_materials/extract_path>`
提取材质的保存路径。留空时使用源场景路径。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_meshes/create_shadow_meshes:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **meshes/create_shadow_meshes** = ``true`` :ref:`🔗<class_ResourceImporterScene_property_meshes/create_shadow_meshes>`
如果为 ``true``\ ,则在导入时启用阴影网格体的生成。这可以通过在可能的情况下将顶点焊接在一起来优化阴影渲染,且不会降低质量。这反过来又减少了渲染阴影所需的内存带宽。阴影网格生成当前不支持使用比源网格更低的细节级别(但阴影渲染将在相关时使用 LOD
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_meshes/ensure_tangents:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **meshes/ensure_tangents** = ``true`` :ref:`🔗<class_ResourceImporterScene_property_meshes/ensure_tangents>`
如果为 ``true``\ ,如果输入网格没有切线数据,则使用 `Mikktspace <http://www.mikktspace.com/>`__ 生成顶点切线。如果可能,建议让 3D 建模软件在导出时生成切线,而不是依赖于该选项。正确显示法线和高度贴图,以及任何需要切线的材质/着色器功能都需要切线。
如果你不需要那些需要切线的材质特性,则禁用该功能可以减少输出文件大小,并在源 3D 文件不包含切线的情况下加快导入速度。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_meshes/force_disable_compression:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **meshes/force_disable_compression** = ``false`` :ref:`🔗<class_ResourceImporterScene_property_meshes/force_disable_compression>`
如果为 ``true``\ ,则不会使用网格压缩。如果你在网格法线或 UV 中发现块状伪影,或者如果你的网格在每个方向都大于几千米,请考虑启用。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_meshes/generate_lods:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **meshes/generate_lods** = ``true`` :ref:`🔗<class_ResourceImporterScene_property_meshes/generate_lods>`
如果为 ``true``\ ,则生成网格的较低细节变体,这些变体将显示在远处以提高渲染性能。并非所有网格体都受益于 LOD特别是如果它们从未从远处渲染。禁用该功能可以减少输出文件大小并加快导入速度。有关详细信息请参阅 `网格细节级别LOD <../tutorials/3d/mesh_lod.html#doc-mesh-lod>`__\ 。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_meshes/light_baking:
.. rst-class:: classref-property
:ref:`int<class_int>` **meshes/light_baking** = ``1`` :ref:`🔗<class_ResourceImporterScene_property_meshes/light_baking>`
在 3D 场景中配置网格体的 :ref:`GeometryInstance3D.gi_mode<class_GeometryInstance3D_property_gi_mode>`\ 。如果被设置为\ **静态光照贴图**\ ,则将网格体的 GI 模式设置为静态并在导入时生成 UV2 以进行 :ref:`LightmapGI<class_LightmapGI>` 烘焙。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_meshes/lightmap_texel_size:
.. rst-class:: classref-property
:ref:`float<class_float>` **meshes/lightmap_texel_size** = ``0.2`` :ref:`🔗<class_ResourceImporterScene_property_meshes/lightmap_texel_size>`
控制烘焙光照贴图上每个纹素的大小。较小的值会产生更精确的光照贴图,但代价是更大的光照贴图大小和更长的烘焙时间。
\ **注意:**\ 仅当 :ref:`meshes/light_baking<class_ResourceImporterScene_property_meshes/light_baking>` 被设置为\ **静态光照贴图**\ 时有效。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_nodes/apply_root_scale:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **nodes/apply_root_scale** = ``true`` :ref:`🔗<class_ResourceImporterScene_property_nodes/apply_root_scale>`
如果为 ``true``\ \ :ref:`nodes/root_scale<class_ResourceImporterScene_property_nodes/root_scale>` 将被应用于后代节点、网格、动画、骨骼等。这意味着,如果你稍后在导入的场景中添加子节点,它将不会被缩放。如果为 ``false``\ \ :ref:`nodes/root_scale<class_ResourceImporterScene_property_nodes/root_scale>` 将乘以该根节点的缩放。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_nodes/import_as_skeleton_bones:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **nodes/import_as_skeleton_bones** = ``false`` :ref:`🔗<class_ResourceImporterScene_property_nodes/import_as_skeleton_bones>`
将导入场景中的所有节点视为单个 :ref:`Skeleton3D<class_Skeleton3D>` 中的骨骼。可用于保证导入的动画以骨架骨骼而不是节点为目标。也可用于在 :ref:`BoneMap<class_BoneMap>` 中分配 ``"Root"`` 骨骼。有关详细信息,请参阅 :doc:`重定向 3D 骨架 <../tutorials/assets_pipeline/retargeting_3d_skeletons>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_nodes/root_name:
.. rst-class:: classref-property
:ref:`String<class_String>` **nodes/root_name** = ``""`` :ref:`🔗<class_ResourceImporterScene_property_nodes/root_name>`
覆盖根节点名称。如果为空,则根节点将使用场景指定的内容;如果场景未指定根名称,则根节点将使用该文件名。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_nodes/root_scale:
.. rst-class:: classref-property
:ref:`float<class_float>` **nodes/root_scale** = ``1.0`` :ref:`🔗<class_ResourceImporterScene_property_nodes/root_scale>`
用于场景根的均一缩放。默认值 ``1.0`` 不会执行任何重新缩放。有关如何应用该缩放的详细信息,请参阅 :ref:`nodes/apply_root_scale<class_ResourceImporterScene_property_nodes/apply_root_scale>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_nodes/root_script:
.. rst-class:: classref-property
:ref:`Script<class_Script>` **nodes/root_script** = ``null`` :ref:`🔗<class_ResourceImporterScene_property_nodes/root_script>`
如果设为有效的脚本,则会将该脚本附加到导入后的场景的根节点上。如果根节点的类型与脚本不兼容,则会将根节点替换为与脚本兼容的类型。也可以对场景中的其他非网格节点使用该设置,为他们附加脚本。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_nodes/root_type:
.. rst-class:: classref-property
:ref:`String<class_String>` **nodes/root_type** = ``""`` :ref:`🔗<class_ResourceImporterScene_property_nodes/root_type>`
覆盖该根节点类型。如果为空,则根节点将使用场景指定的内容,如果场景未指定根类型,则根节点将使用 :ref:`Node3D<class_Node3D>`\ 。建议使用继承自 :ref:`Node3D<class_Node3D>` 的节点类型。否则,你将无法直接在 3D 编辑器中定位节点。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_nodes/use_name_suffixes:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **nodes/use_name_suffixes** = ``true`` :ref:`🔗<class_ResourceImporterScene_property_nodes/use_name_suffixes>`
如果为 ``true``\ ,则会使用导入的节点、资源等对象的名称后缀来确定类型和属性,例如 ``-noimp`` 可以跳过节点和动画的导入、\ ``-alpha`` 可以启用材质的 Alpha 透明、\ ``-vcol`` 可以启用材质的顶点颜色。禁用该选项会让编辑器导入的文件更接近原始文件,更类似于在运行时导入文件。详见\ :doc:`《使用名称后缀自定义节点类型》 <../tutorials/assets_pipeline/importing_3d_scenes/node_type_customization>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_nodes/use_node_type_suffixes:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **nodes/use_node_type_suffixes** = ``true`` :ref:`🔗<class_ResourceImporterScene_property_nodes/use_node_type_suffixes>`
如果为 ``true``\ ,则会使用节点名称的后缀来确定节点类型,例如 ``-col`` 表示碰撞形状。仅在 :ref:`nodes/use_name_suffixes<class_ResourceImporterScene_property_nodes/use_name_suffixes>```true`` 时使用。禁用该选项会让编辑器导入的文件更接近原始文件,更类似于在运行时导入文件。详见\ :doc:`《使用名称后缀自定义节点类型》 <../tutorials/assets_pipeline/importing_3d_scenes/node_type_customization>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_ResourceImporterScene_property_skins/use_named_skins:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **skins/use_named_skins** = ``true`` :ref:`🔗<class_ResourceImporterScene_property_skins/use_named_skins>`
如果勾选,则为动画使用命名的 :ref:`Skin<class_Skin>`\ 。\ :ref:`MeshInstance3D<class_MeshInstance3D>` 节点包含 3 个相关属性:指向 :ref:`Skeleton3D<class_Skeleton3D>` 节点的骨架 :ref:`NodePath<class_NodePath>`\ (通常为 ``..``\ )、网格、蒙皮:
- :ref:`Skeleton3D<class_Skeleton3D>` 节点包含骨骼列表,其中包含名称、姿势和休息、名称和父骨骼。
- 网格是显示网格所需的所有原始顶点数据。就网格而言,它知道如何对顶点进行权重绘制,并使用通常从 3D 建模软件导入的某些内部编号。
- 蒙皮包含将该网格绑定到该 Skeleton3D 上所必需的信息。对于 3D 建模软件选择的每一个内部骨骼 ID它都包含两件事。首先是一个名为绑定姿势矩阵、逆绑定矩阵或简称为 IBM 的矩阵。其次,该 :ref:`Skin<class_Skin>` 包含每个骨骼的名称(如果 :ref:`skins/use_named_skins<class_ResourceImporterScene_property_skins/use_named_skins>```true``\ ),或者骨骼在 :ref:`Skeleton3D<class_Skeleton3D>` 列表中的索引(如果 :ref:`skins/use_named_skins<class_ResourceImporterScene_property_skins/use_named_skins>```false``\ )。
总之,这些信息足以告诉 Godot 如何使用 :ref:`Skeleton3D<class_Skeleton3D>` 节点中的骨骼姿势来渲染每个 :ref:`MeshInstance3D<class_MeshInstance3D>` 的网格。请注意,每个 :ref:`MeshInstance3D<class_MeshInstance3D>` 可以共享绑定,这在从 Blender 导出的模型中很常见;或者每个 :ref:`MeshInstance3D<class_MeshInstance3D>` 可以使用单独的 :ref:`Skin<class_Skin>` 对象,这在从其他工具(例如 Maya导出的模型中很常见。
.. |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 (无返回值。)`