:github_url: hide .. meta:: :keywords: text .. _class_Label3D: Label3D ======= **繼承：** :ref:`GeometryInstance3D` **<** :ref:`VisualInstance3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` 用於在 3D 空間顯示純文字的節點。 .. rst-class:: classref-introduction-group 說明 ---- 用於在 3D 空間顯示純文字的節點。通過調整該節點的各種屬性，可以配置文字外觀、是否面朝相機等功能。 .. rst-class:: classref-introduction-group 教學 ---- - :doc:`3D 文字 <../tutorials/3d/3d_text>` .. rst-class:: classref-reftable-group 屬性 ---- .. table:: :widths: auto +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`alpha_antialiasing_edge` | ``0.0`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`AlphaAntiAliasing` | :ref:`alpha_antialiasing_mode` | ``0`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`AlphaCutMode` | :ref:`alpha_cut` | ``0`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`alpha_hash_scale` | ``1.0`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`alpha_scissor_threshold` | ``0.5`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`AutowrapMode` | :ref:`autowrap_mode` | ``0`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | |bitfield|\[:ref:`LineBreakFlag`\] | :ref:`autowrap_trim_flags` | ``192`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`BillboardMode` | :ref:`billboard` | ``0`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`ShadowCastingSetting` | cast_shadow | ``0`` (overrides :ref:`GeometryInstance3D`) | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`double_sided` | ``true`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`fixed_size` | ``false`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`Font` | :ref:`font` | | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`font_size` | ``32`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`GIMode` | gi_mode | ``0`` (overrides :ref:`GeometryInstance3D`) | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`HorizontalAlignment` | :ref:`horizontal_alignment` | ``1`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | |bitfield|\[:ref:`JustificationFlag`\] | :ref:`justification_flags` | ``163`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`language` | ``""`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`line_spacing` | ``0.0`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`modulate` | ``Color(1, 1, 1, 1)`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`no_depth_test` | ``false`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`offset` | ``Vector2(0, 0)`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`outline_modulate` | ``Color(0, 0, 0, 1)`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`outline_render_priority` | ``-1`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`outline_size` | ``12`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`pixel_size` | ``0.005`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`render_priority` | ``0`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`shaded` | ``false`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`StructuredTextParser` | :ref:`structured_text_bidi_override` | ``0`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`Array` | :ref:`structured_text_bidi_override_options` | ``[]`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`text` | ``""`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`Direction` | :ref:`text_direction` | ``0`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`TextureFilter` | :ref:`texture_filter` | ``3`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`uppercase` | ``false`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`VerticalAlignment` | :ref:`vertical_alignment` | ``1`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`width` | ``500.0`` | +---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group 方法 ---- .. table:: :widths: auto +-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`TriangleMesh` | :ref:`generate_triangle_mesh`\ (\ ) |const| | +-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`get_draw_flag`\ (\ flag\: :ref:`DrawFlags`\ ) |const| | +-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_draw_flag`\ (\ flag\: :ref:`DrawFlags`, enabled\: :ref:`bool`\ ) | +-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group 列舉 ---- .. _enum_Label3D_DrawFlags: .. rst-class:: classref-enumeration enum **DrawFlags**: :ref:`🔗` .. _class_Label3D_constant_FLAG_SHADED: .. rst-class:: classref-enumeration-constant :ref:`DrawFlags` **FLAG_SHADED** = ``0`` 如果打開，環境中的燈光會影響該標籤。 .. _class_Label3D_constant_FLAG_DOUBLE_SIDED: .. rst-class:: classref-enumeration-constant :ref:`DrawFlags` **FLAG_DOUBLE_SIDED** = ``1`` 如果打開，從後面也可以看到文字。如果不打開，從後面看該文字是不可見的。 .. _class_Label3D_constant_FLAG_DISABLE_DEPTH_TEST: .. rst-class:: classref-enumeration-constant :ref:`DrawFlags` **FLAG_DISABLE_DEPTH_TEST** = ``2`` 禁用深度測試，所以這個物件被畫在所有其他物件的上面。但是，在繪製順序中，在它之後繪製的物件可能會覆蓋它。 .. _class_Label3D_constant_FLAG_FIXED_SIZE: .. rst-class:: classref-enumeration-constant :ref:`DrawFlags` **FLAG_FIXED_SIZE** = ``3`` 標籤會根據深度進行縮放，從而在螢幕上始終以相同的大小顯示。 .. _class_Label3D_constant_FLAG_MAX: .. rst-class:: classref-enumeration-constant :ref:`DrawFlags` **FLAG_MAX** = ``4`` 代表 :ref:`DrawFlags` 列舉的大小。 .. rst-class:: classref-item-separator ---- .. _enum_Label3D_AlphaCutMode: .. rst-class:: classref-enumeration enum **AlphaCutMode**: :ref:`🔗` .. _class_Label3D_constant_ALPHA_CUT_DISABLED: .. rst-class:: classref-enumeration-constant :ref:`AlphaCutMode` **ALPHA_CUT_DISABLED** = ``0`` 該模式會執行標準的 Alpha 混合。它可以顯示半透明區域，但當多個透明材質重疊時，可能會出現透明度排序問題。\ :ref:`GeometryInstance3D.cast_shadow` 在使用該透明模式時無效；\ **Label3D** 永遠不會投射陰影。 .. _class_Label3D_constant_ALPHA_CUT_DISCARD: .. rst-class:: classref-enumeration-constant :ref:`AlphaCutMode` **ALPHA_CUT_DISCARD** = ``1`` 該模式僅允許完全透明、或完全不透明的圖元。除非啟用了某種形式的螢幕空間抗鋸齒（請參閱 :ref:`ProjectSettings.rendering/anti_aliasing/quality/screen_space_aa`\ ），否則會看到粗糙的邊緣。該模式也被稱為 *Alpha 測試* 或 *1 位透明度*\ 。 \ **注意：**\ 該模式可能會出現抗鋸齒字形和輪廓問題，請嘗試調整 :ref:`alpha_scissor_threshold` 或使用 MSDF 字形。 \ **注意：**\ 當使用具有重疊字形的文字（例如草書）時，該模式可能會在正文和輪廓之間，出現透明度排序問題。 .. _class_Label3D_constant_ALPHA_CUT_OPAQUE_PREPASS: .. rst-class:: classref-enumeration-constant :ref:`AlphaCutMode` **ALPHA_CUT_OPAQUE_PREPASS** = ``2`` 這個模式會在深度預處理時繪製完全不透明的圖元。比 :ref:`ALPHA_CUT_DISABLED` 或 :ref:`ALPHA_CUT_DISCARD` 要慢，但能夠對半透明區域和平滑邊緣進行正確的排序。 \ **注意：**\ 文字中存在重疊的字形時（例如手寫體），這個模式可能會造成主文字和輪廓的透明度排序問題。 .. _class_Label3D_constant_ALPHA_CUT_HASH: .. rst-class:: classref-enumeration-constant :ref:`AlphaCutMode` **ALPHA_CUT_HASH** = ``3`` 該模式繪製時會截斷所有低於空間確定性閾值的值，其餘值將保持不透明。 .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group 屬性說明 -------- .. _class_Label3D_property_alpha_antialiasing_edge: .. rst-class:: classref-property :ref:`float` **alpha_antialiasing_edge** = ``0.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_alpha_antialiasing_edge**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_alpha_antialiasing_edge**\ (\ ) 在 Alpha 通道上套用抗鋸齒的臨界值。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_alpha_antialiasing_mode: .. rst-class:: classref-property :ref:`AlphaAntiAliasing` **alpha_antialiasing_mode** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_alpha_antialiasing**\ (\ value\: :ref:`AlphaAntiAliasing`\ ) - :ref:`AlphaAntiAliasing` **get_alpha_antialiasing**\ (\ ) 要套用的 Alpha 抗鋸齒類型。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_alpha_cut: .. rst-class:: classref-property :ref:`AlphaCutMode` **alpha_cut** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_alpha_cut_mode**\ (\ value\: :ref:`AlphaCutMode`\ ) - :ref:`AlphaCutMode` **get_alpha_cut_mode**\ (\ ) The alpha cutting mode to use for the sprite. .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_alpha_hash_scale: .. rst-class:: classref-property :ref:`float` **alpha_hash_scale** = ``1.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_alpha_hash_scale**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_alpha_hash_scale**\ (\ ) Alpha Hash 的雜湊比例，建議值介於 ``0`` 與 ``2`` 之間。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_alpha_scissor_threshold: .. rst-class:: classref-property :ref:`float` **alpha_scissor_threshold** = ``0.5`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_alpha_scissor_threshold**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_alpha_scissor_threshold**\ (\ ) Alpha 裁剪丟棄數值的閾值。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_autowrap_mode: .. rst-class:: classref-property :ref:`AutowrapMode` **autowrap_mode** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_autowrap_mode**\ (\ value\: :ref:`AutowrapMode`\ ) - :ref:`AutowrapMode` **get_autowrap_mode**\ (\ ) If set to something other than :ref:`TextServer.AUTOWRAP_OFF`, the text gets wrapped inside the node's bounding rectangle. If you resize the node, it will change its height automatically to show all the text. .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_autowrap_trim_flags: .. rst-class:: classref-property |bitfield|\[:ref:`LineBreakFlag`\] **autowrap_trim_flags** = ``192`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_autowrap_trim_flags**\ (\ value\: |bitfield|\[:ref:`LineBreakFlag`\]\ ) - |bitfield|\[:ref:`LineBreakFlag`\] **get_autowrap_trim_flags**\ (\ ) Autowrap space trimming flags. See :ref:`TextServer.BREAK_TRIM_START_EDGE_SPACES` and :ref:`TextServer.BREAK_TRIM_END_EDGE_SPACES` for more info. .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_billboard: .. rst-class:: classref-property :ref:`BillboardMode` **billboard** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_billboard_mode**\ (\ value\: :ref:`BillboardMode`\ ) - :ref:`BillboardMode` **get_billboard_mode**\ (\ ) The billboard mode to use for the label. .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_double_sided: .. rst-class:: classref-property :ref:`bool` **double_sided** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags`, enabled\: :ref:`bool`\ ) - :ref:`bool` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags`\ ) |const| 如果為 ``true``\ ，則從後面也可以看到文字，如果為 ``false``\ ，則從後面看它是不可見的。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_fixed_size: .. rst-class:: classref-property :ref:`bool` **fixed_size** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags`, enabled\: :ref:`bool`\ ) - :ref:`bool` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags`\ ) |const| If ``true``, the label is rendered at the same size regardless of distance. The label's size on screen is the same as if the camera was ``1.0`` units away from the label's origin, regardless of the actual distance from the camera. The :ref:`Camera3D`'s field of view (or :ref:`Camera3D.size` when in orthogonal/frustum mode) still affects the size the label is drawn at. .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_font: .. rst-class:: classref-property :ref:`Font` **font** :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_font**\ (\ value\: :ref:`Font`\ ) - :ref:`Font` **get_font**\ (\ ) 用於顯示文字的字形配置。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_font_size: .. rst-class:: classref-property :ref:`int` **font_size** = ``32`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_font_size**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_font_size**\ (\ ) **Label3D** 文字的字形大小。為了讓字形在近距離時看起來更細膩，可增加 :ref:`font_size`\ ，同時減小 :ref:`pixel_size`\ 。 較大的字形大小需要更多時間來算繪新字元，這可能會導致在遊戲過程中卡頓。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_horizontal_alignment: .. rst-class:: classref-property :ref:`HorizontalAlignment` **horizontal_alignment** = ``1`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_horizontal_alignment**\ (\ value\: :ref:`HorizontalAlignment`\ ) - :ref:`HorizontalAlignment` **get_horizontal_alignment**\ (\ ) Controls the text's horizontal alignment. Supports left, center, right, and fill (also known as justify). .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_justification_flags: .. rst-class:: classref-property |bitfield|\[:ref:`JustificationFlag`\] **justification_flags** = ``163`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_justification_flags**\ (\ value\: |bitfield|\[:ref:`JustificationFlag`\]\ ) - |bitfield|\[:ref:`JustificationFlag`\] **get_justification_flags**\ (\ ) Line fill alignment rules. .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_language: .. rst-class:: classref-property :ref:`String` **language** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead. .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_line_spacing: .. rst-class:: classref-property :ref:`float` **line_spacing** = ``0.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_line_spacing**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_line_spacing**\ (\ ) Additional vertical spacing between lines (in pixels), spacing is added to line descent. This value can be negative. .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_modulate: .. rst-class:: classref-property :ref:`Color` **modulate** = ``Color(1, 1, 1, 1)`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_modulate**\ (\ value\: :ref:`Color`\ ) - :ref:`Color` **get_modulate**\ (\ ) 該 **Label3D** 的文字顏色 :ref:`Color`\ 。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_no_depth_test: .. rst-class:: classref-property :ref:`bool` **no_depth_test** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags`, enabled\: :ref:`bool`\ ) - :ref:`bool` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags`\ ) |const| 若設為 ``true``\ ，將停用深度測試，物件依繪製順序顯示。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_offset: .. rst-class:: classref-property :ref:`Vector2` **offset** = ``Vector2(0, 0)`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_offset**\ (\ value\: :ref:`Vector2`\ ) - :ref:`Vector2` **get_offset**\ (\ ) 文字繪製偏移（單位為圖元）。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_outline_modulate: .. rst-class:: classref-property :ref:`Color` **outline_modulate** = ``Color(0, 0, 0, 1)`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_outline_modulate**\ (\ value\: :ref:`Color`\ ) - :ref:`Color` **get_outline_modulate**\ (\ ) 文字輪廓的色調。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_outline_render_priority: .. rst-class:: classref-property :ref:`int` **outline_render_priority** = ``-1`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_outline_render_priority**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_outline_render_priority**\ (\ ) 設定文字輪廓的算繪優先順序。優先順序高的物體將被排序在優先順序低的物體前面。 \ **注意：**\ 僅在 :ref:`alpha_cut` 為 :ref:`ALPHA_CUT_DISABLED`\ （預設值）時適用。 \ **注意：**\ 僅適用於透明物體的排序。這不會影響透明物體相對於不透明物體的排序方式。這是因為不透明物件不被排序，而透明物件則從後往前排序（取決於優先順序）。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_outline_size: .. rst-class:: classref-property :ref:`int` **outline_size** = ``12`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_outline_size**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_outline_size**\ (\ ) 文字輪廓大小。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_pixel_size: .. rst-class:: classref-property :ref:`float` **pixel_size** = ``0.005`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_pixel_size**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_pixel_size**\ (\ ) 標籤中一個圖元寬度對應縮放至的 3D 大小。要讓字形在較近距離時也能夠看到細節，請在減小 :ref:`pixel_size` 的同時增大 :ref:`font_size`\ 。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_render_priority: .. rst-class:: classref-property :ref:`int` **render_priority** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_render_priority**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_render_priority**\ (\ ) 設定文字的算繪優先順序。優先順序高的物體將被排序在優先順序低的物體前面。 \ **注意：**\ 僅在 :ref:`alpha_cut` 為 :ref:`ALPHA_CUT_DISABLED`\ （預設值）時適用。 \ **注意：**\ 僅適用於透明物體的排序。這不會影響透明物體相對於不透明物體的排序方式。這是因為不透明物件不被排序，而透明物件則從後往前排序（取決於優先順序）。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_shaded: .. rst-class:: classref-property :ref:`bool` **shaded** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags`, enabled\: :ref:`bool`\ ) - :ref:`bool` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags`\ ) |const| 如果為 ``true``\ ，則 :ref:`Environment` 中的 :ref:`Light3D` 會影響該標籤。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_structured_text_bidi_override: .. rst-class:: classref-property :ref:`StructuredTextParser` **structured_text_bidi_override** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_structured_text_bidi_override**\ (\ value\: :ref:`StructuredTextParser`\ ) - :ref:`StructuredTextParser` **get_structured_text_bidi_override**\ (\ ) 為結構化文字設定 BiDi 演算法覆蓋。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_structured_text_bidi_override_options: .. rst-class:: classref-property :ref:`Array` **structured_text_bidi_override_options** = ``[]`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_structured_text_bidi_override_options**\ (\ value\: :ref:`Array`\ ) - :ref:`Array` **get_structured_text_bidi_override_options**\ (\ ) 設定 BiDi 覆蓋的附加選項。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_text: .. rst-class:: classref-property :ref:`String` **text** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_text**\ (\ ) 要在螢幕上顯示的文字。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_text_direction: .. rst-class:: classref-property :ref:`Direction` **text_direction** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text_direction**\ (\ value\: :ref:`Direction`\ ) - :ref:`Direction` **get_text_direction**\ (\ ) 基礎文字書寫方向。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_texture_filter: .. rst-class:: classref-property :ref:`TextureFilter` **texture_filter** = ``3`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_texture_filter**\ (\ value\: :ref:`TextureFilter`\ ) - :ref:`TextureFilter` **get_texture_filter**\ (\ ) Filter flags for the texture. .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_uppercase: .. rst-class:: classref-property :ref:`bool` **uppercase** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_uppercase**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_uppercase**\ (\ ) 如果為 ``true``\ ，所有文字都將顯示為大寫。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_vertical_alignment: .. rst-class:: classref-property :ref:`VerticalAlignment` **vertical_alignment** = ``1`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_vertical_alignment**\ (\ value\: :ref:`VerticalAlignment`\ ) - :ref:`VerticalAlignment` **get_vertical_alignment**\ (\ ) Controls the text's vertical alignment. Supports top, center, and bottom. .. rst-class:: classref-item-separator ---- .. _class_Label3D_property_width: .. rst-class:: classref-property :ref:`float` **width** = ``500.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_width**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_width**\ (\ ) 文字寬度（單位為圖元），用於自動換行和填充對齊。 .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group 方法說明 -------- .. _class_Label3D_method_generate_triangle_mesh: .. rst-class:: classref-method :ref:`TriangleMesh` **generate_triangle_mesh**\ (\ ) |const| :ref:`🔗` 返回使用該標籤的頂點組成的 :ref:`TriangleMesh`\ ，遵循目前的配置（例如 :ref:`pixel_size`\ ）。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_method_get_draw_flag: .. rst-class:: classref-method :ref:`bool` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags`\ ) |const| :ref:`🔗` 返回指定旗標的值。 .. rst-class:: classref-item-separator ---- .. _class_Label3D_method_set_draw_flag: .. rst-class:: classref-method |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags`, enabled\: :ref:`bool`\ ) :ref:`🔗` If ``true``, the specified ``flag`` will be enabled. .. |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 (無回傳值。)`