mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
615 lines
33 KiB
ReStructuredText
615 lines
33 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_SpriteBase3D:
|
||
|
||
SpriteBase3D
|
||
============
|
||
|
||
**Успадковує:** :ref:`GeometryInstance3D<class_GeometryInstance3D>` **<** :ref:`VisualInstance3D<class_VisualInstance3D>` **<** :ref:`Node3D<class_Node3D>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
|
||
|
||
**Успадковано від:** :ref:`AnimatedSprite3D<class_AnimatedSprite3D>`, :ref:`Sprite3D<class_Sprite3D>`
|
||
|
||
2D спрайт вузол в 3D середовищі.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Опис
|
||
--------
|
||
|
||
Вузлом, який відображає інформацію про текстуру 2D в середовищі 3D. Дивись також :ref:`Sprite3D<class_Sprite3D>`, де визначено багато інших властивостей.
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Властивості
|
||
----------------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`float<class_float>` | :ref:`alpha_antialiasing_edge<class_SpriteBase3D_property_alpha_antialiasing_edge>` | ``0.0`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`AlphaAntiAliasing<enum_BaseMaterial3D_AlphaAntiAliasing>` | :ref:`alpha_antialiasing_mode<class_SpriteBase3D_property_alpha_antialiasing_mode>` | ``0`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` | :ref:`alpha_cut<class_SpriteBase3D_property_alpha_cut>` | ``0`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`float<class_float>` | :ref:`alpha_hash_scale<class_SpriteBase3D_property_alpha_hash_scale>` | ``1.0`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`float<class_float>` | :ref:`alpha_scissor_threshold<class_SpriteBase3D_property_alpha_scissor_threshold>` | ``0.5`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`Axis<enum_Vector3_Axis>` | :ref:`axis<class_SpriteBase3D_property_axis>` | ``2`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`BillboardMode<enum_BaseMaterial3D_BillboardMode>` | :ref:`billboard<class_SpriteBase3D_property_billboard>` | ``0`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`bool<class_bool>` | :ref:`centered<class_SpriteBase3D_property_centered>` | ``true`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`bool<class_bool>` | :ref:`double_sided<class_SpriteBase3D_property_double_sided>` | ``true`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`bool<class_bool>` | :ref:`fixed_size<class_SpriteBase3D_property_fixed_size>` | ``false`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`bool<class_bool>` | :ref:`flip_h<class_SpriteBase3D_property_flip_h>` | ``false`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`bool<class_bool>` | :ref:`flip_v<class_SpriteBase3D_property_flip_v>` | ``false`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`Color<class_Color>` | :ref:`modulate<class_SpriteBase3D_property_modulate>` | ``Color(1, 1, 1, 1)`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`bool<class_bool>` | :ref:`no_depth_test<class_SpriteBase3D_property_no_depth_test>` | ``false`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`Vector2<class_Vector2>` | :ref:`offset<class_SpriteBase3D_property_offset>` | ``Vector2(0, 0)`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`float<class_float>` | :ref:`pixel_size<class_SpriteBase3D_property_pixel_size>` | ``0.01`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`int<class_int>` | :ref:`render_priority<class_SpriteBase3D_property_render_priority>` | ``0`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`bool<class_bool>` | :ref:`shaded<class_SpriteBase3D_property_shaded>` | ``false`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`TextureFilter<enum_BaseMaterial3D_TextureFilter>` | :ref:`texture_filter<class_SpriteBase3D_property_texture_filter>` | ``3`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
| :ref:`bool<class_bool>` | :ref:`transparent<class_SpriteBase3D_property_transparent>` | ``true`` |
|
||
+-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Методи
|
||
------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+-----------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| :ref:`TriangleMesh<class_TriangleMesh>` | :ref:`generate_triangle_mesh<class_SpriteBase3D_method_generate_triangle_mesh>`\ (\ ) |const| |
|
||
+-----------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| :ref:`bool<class_bool>` | :ref:`get_draw_flag<class_SpriteBase3D_method_get_draw_flag>`\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`\ ) |const| |
|
||
+-----------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| :ref:`Rect2<class_Rect2>` | :ref:`get_item_rect<class_SpriteBase3D_method_get_item_rect>`\ (\ ) |const| |
|
||
+-----------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| |void| | :ref:`set_draw_flag<class_SpriteBase3D_method_set_draw_flag>`\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`, enabled\: :ref:`bool<class_bool>`\ ) |
|
||
+-----------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Переліки
|
||
----------------
|
||
|
||
.. _enum_SpriteBase3D_DrawFlags:
|
||
|
||
.. rst-class:: classref-enumeration
|
||
|
||
enum **DrawFlags**: :ref:`🔗<enum_SpriteBase3D_DrawFlags>`
|
||
|
||
.. _class_SpriteBase3D_constant_FLAG_TRANSPARENT:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` **FLAG_TRANSPARENT** = ``0``
|
||
|
||
Якщо встановити, фактура прозорість і непрозорість використовуються для того, щоб зробити ці частини невидимого спрайту.
|
||
|
||
.. _class_SpriteBase3D_constant_FLAG_SHADED:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` **FLAG_SHADED** = ``1``
|
||
|
||
Якщо встановити, вогні в середовищі впливають на спрайт.
|
||
|
||
.. _class_SpriteBase3D_constant_FLAG_DOUBLE_SIDED:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` **FLAG_DOUBLE_SIDED** = ``2``
|
||
|
||
Якщо встановити, то текстуру можна побачити з спини. Якщо ні, то текстура невидима при її пошуку ззаду.
|
||
|
||
.. _class_SpriteBase3D_constant_FLAG_DISABLE_DEPTH_TEST:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` **FLAG_DISABLE_DEPTH_TEST** = ``3``
|
||
|
||
Вимкнено глибинний тест, тому цей об'єкт намальовується на вершині всіх інших. Однак об'єкти, що намальовані після нього в порядку фіксування, можуть закривати його.
|
||
|
||
.. _class_SpriteBase3D_constant_FLAG_FIXED_SIZE:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` **FLAG_FIXED_SIZE** = ``4``
|
||
|
||
Етикетка масштабується глибиною, щоб він завжди виглядав на екрані.
|
||
|
||
.. _class_SpriteBase3D_constant_FLAG_MAX:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` **FLAG_MAX** = ``5``
|
||
|
||
Представляємо розмір :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` enum.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _enum_SpriteBase3D_AlphaCutMode:
|
||
|
||
.. rst-class:: classref-enumeration
|
||
|
||
enum **AlphaCutMode**: :ref:`🔗<enum_SpriteBase3D_AlphaCutMode>`
|
||
|
||
.. _class_SpriteBase3D_constant_ALPHA_CUT_DISABLED:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` **ALPHA_CUT_DISABLED** = ``0``
|
||
|
||
Цей режим виконує стандартну альфа-змішування. Це може відображати непрозорі зони, але проблеми, які відповідають прозорості, можуть бути видимими, коли багато прозорих матеріалів перекриття.
|
||
|
||
.. _class_SpriteBase3D_constant_ALPHA_CUT_DISCARD:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` **ALPHA_CUT_DISCARD** = ``1``
|
||
|
||
Цей режим дозволяє лише повністю прозорі або повністю непрозорі пікселі. Чіткі краї будуть видимими, якщо не ввімкнено певну форму згладжування екранного простору (див. :ref:`ProjectSettings.rendering/anti_aliasing/quality/screen_space_aa<class_ProjectSettings_property_rendering/anti_aliasing/quality/screen_space_aa>`). З іншого боку, цей режим не страждає від проблем сортування прозорості, коли кілька прозорих матеріалів перекриваються. Цей режим також відомий як *альфа-тестування* або *1-бітна прозорість*.
|
||
|
||
.. _class_SpriteBase3D_constant_ALPHA_CUT_OPAQUE_PREPASS:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` **ALPHA_CUT_OPAQUE_PREPASS** = ``2``
|
||
|
||
Цей режим малює повністю опалювальні пікселів на глибину проходу. Це повільніше, ніж :ref:`ALPHA_CUT_DISABLED<class_SpriteBase3D_constant_ALPHA_CUT_DISABLED>` або :ref:`ALPHA_CUT_DISCARD<class_SpriteBase3D_constant_ALPHA_CUT_DISCARD>`, але це дозволяє відображати непрозорі ділянки і гладкі краї при використанні належного сортування.
|
||
|
||
.. _class_SpriteBase3D_constant_ALPHA_CUT_HASH:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` **ALPHA_CUT_HASH** = ``3``
|
||
|
||
Цей режим відбиває всі значення нижче просторово-детермінаційного порогу, решта залишиться непрозорим.
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описи властивостей
|
||
------------------------------------
|
||
|
||
.. _class_SpriteBase3D_property_alpha_antialiasing_edge:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **alpha_antialiasing_edge** = ``0.0`` :ref:`🔗<class_SpriteBase3D_property_alpha_antialiasing_edge>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_alpha_antialiasing_edge**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_alpha_antialiasing_edge**\ (\ )
|
||
|
||
Порогове значення, при якому згладжування буде застосовано до альфа-каналу.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_alpha_antialiasing_mode:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`AlphaAntiAliasing<enum_BaseMaterial3D_AlphaAntiAliasing>` **alpha_antialiasing_mode** = ``0`` :ref:`🔗<class_SpriteBase3D_property_alpha_antialiasing_mode>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_alpha_antialiasing**\ (\ value\: :ref:`AlphaAntiAliasing<enum_BaseMaterial3D_AlphaAntiAliasing>`\ )
|
||
- :ref:`AlphaAntiAliasing<enum_BaseMaterial3D_AlphaAntiAliasing>` **get_alpha_antialiasing**\ (\ )
|
||
|
||
Тип альфа-згладжування, який слід застосувати.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_alpha_cut:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` **alpha_cut** = ``0`` :ref:`🔗<class_SpriteBase3D_property_alpha_cut>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_alpha_cut_mode**\ (\ value\: :ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>`\ )
|
||
- :ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` **get_alpha_cut_mode**\ (\ )
|
||
|
||
Режим альфа-вирізання, який буде використано для спрайта.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_alpha_hash_scale:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **alpha_hash_scale** = ``1.0`` :ref:`🔗<class_SpriteBase3D_property_alpha_hash_scale>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_alpha_hash_scale**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_alpha_hash_scale**\ (\ )
|
||
|
||
Шкала хешування для Alpha Hash. Рекомендовані значення від ``0`` до ``2``.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_alpha_scissor_threshold:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **alpha_scissor_threshold** = ``0.5`` :ref:`🔗<class_SpriteBase3D_property_alpha_scissor_threshold>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_alpha_scissor_threshold**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_alpha_scissor_threshold**\ (\ )
|
||
|
||
Пороги, в яких аспор альфа буде відхиляти значення.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_axis:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Axis<enum_Vector3_Axis>` **axis** = ``2`` :ref:`🔗<class_SpriteBase3D_property_axis>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_axis**\ (\ value\: :ref:`Axis<enum_Vector3_Axis>`\ )
|
||
- :ref:`Axis<enum_Vector3_Axis>` **get_axis**\ (\ )
|
||
|
||
Напрямок, в якому передня частинами текстури.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_billboard:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`BillboardMode<enum_BaseMaterial3D_BillboardMode>` **billboard** = ``0`` :ref:`🔗<class_SpriteBase3D_property_billboard>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_billboard_mode**\ (\ value\: :ref:`BillboardMode<enum_BaseMaterial3D_BillboardMode>`\ )
|
||
- :ref:`BillboardMode<enum_BaseMaterial3D_BillboardMode>` **get_billboard_mode**\ (\ )
|
||
|
||
Режим рекламного щита, який використовуватиметься для спрайта.
|
||
|
||
\ **Примітка:** Коли рекламні щити ввімкнено, і матеріал також відкидає тіні, рекламні щити будуть спрямовані **до** камери в сцені під час рендерингу тіней. У сценах з кількома камерами неможливо визначити бажану тінь, і це призведе до невизначеної поведінки. Див. `GitHub Pull Request #72638 <https://github.com/godotengine/godot/pull/72638>`__ для отримання детальної інформації.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_centered:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **centered** = ``true`` :ref:`🔗<class_SpriteBase3D_property_centered>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_centered**\ (\ value\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **is_centered**\ (\ )
|
||
|
||
Якщо ``true``, текстура буде відцентрована.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_double_sided:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **double_sided** = ``true`` :ref:`🔗<class_SpriteBase3D_property_double_sided>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`, enabled\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`\ ) |const|
|
||
|
||
Якщо ``true``, то текстура можна побачити з спини, якщо ``false``, це невидимий при пошуку ззаду.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_fixed_size:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **fixed_size** = ``false`` :ref:`🔗<class_SpriteBase3D_property_fixed_size>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`, enabled\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`\ ) |const|
|
||
|
||
Якщо значення ``true``, текстура відтворюється з однаковим розміром незалежно від відстані. Розмір текстури на екрані такий самий, як якби камера знаходилася на відстані ``1.0`` одиниць від початку координат текстури, незалежно від фактичної відстані від камери. Поле зору :ref:`Camera3D<class_Camera3D>` (або :ref:`Camera3D.size<class_Camera3D_property_size>` в ортогональному/усіченому режимі) все ще впливає на розмір, з яким малюється спрайт.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_flip_h:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **flip_h** = ``false`` :ref:`🔗<class_SpriteBase3D_property_flip_h>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_flip_h**\ (\ value\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **is_flipped_h**\ (\ )
|
||
|
||
Якщо ``true``, текстура віддзеркалюється горизонтально.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_flip_v:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **flip_v** = ``false`` :ref:`🔗<class_SpriteBase3D_property_flip_v>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_flip_v**\ (\ value\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **is_flipped_v**\ (\ )
|
||
|
||
Якщо ``true``, текстура віддзеркалюється вертикально.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_modulate:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Color<class_Color>` **modulate** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_SpriteBase3D_property_modulate>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_modulate**\ (\ value\: :ref:`Color<class_Color>`\ )
|
||
- :ref:`Color<class_Color>` **get_modulate**\ (\ )
|
||
|
||
Значення кольору, яке використовується для *множення* кольорів текстури. Може використовуватися для створення настрою забарвлення або імітації кольору навколишнього освітлення.
|
||
|
||
\ **Примітка:** На відміну від :ref:`CanvasItem.modulate<class_CanvasItem_property_modulate>` для 2D, кольори зі значеннями вище ``1.0`` (надмірно яскравий) не підтримуються.
|
||
|
||
\ **Примітка:** Якщо :ref:`GeometryInstance3D.material_override<class_GeometryInstance3D_property_material_override>` визначено на **SpriteBase3D**, перевизначення матеріалу має бути налаштоване таким чином, щоб враховувати кольори вершин для альбедо. В іншому випадку колір, визначений у :ref:`modulate<class_SpriteBase3D_property_modulate>`, буде ігноруватися. Для :ref:`BaseMaterial3D<class_BaseMaterial3D>`, :ref:`BaseMaterial3D.vertex_color_use_as_albedo<class_BaseMaterial3D_property_vertex_color_use_as_albedo>` має бути ``true``. Для :ref:`ShaderMaterial<class_ShaderMaterial>`, ``ALBEDO *= COLOR.rgb;`` має бути вставлено у функцію ``fragment()`` шейдера.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_no_depth_test:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **no_depth_test** = ``false`` :ref:`🔗<class_SpriteBase3D_property_no_depth_test>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`, enabled\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`\ ) |const|
|
||
|
||
Якщо ``true``, тестування глибини вимкнено, а об’єкт буде намальовано в порядку візуалізації.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_offset:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Vector2<class_Vector2>` **offset** = ``Vector2(0, 0)`` :ref:`🔗<class_SpriteBase3D_property_offset>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_offset**\ (\ value\: :ref:`Vector2<class_Vector2>`\ )
|
||
- :ref:`Vector2<class_Vector2>` **get_offset**\ (\ )
|
||
|
||
Зсув малювання текстури.
|
||
|
||
\ **Примітка:** Коли ви збільшуєте :ref:`offset<class_SpriteBase3D_property_offset>`.y у Sprite3D, спрайт рухається вгору у світовому просторі (тобто +Y — це вгору).
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_pixel_size:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **pixel_size** = ``0.01`` :ref:`🔗<class_SpriteBase3D_property_pixel_size>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_pixel_size**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_pixel_size**\ (\ )
|
||
|
||
Розмір однієї ширинипікселя на спрайт, щоб масштабувати її в 3D.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_render_priority:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`int<class_int>` **render_priority** = ``0`` :ref:`🔗<class_SpriteBase3D_property_render_priority>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_render_priority**\ (\ value\: :ref:`int<class_int>`\ )
|
||
- :ref:`int<class_int>` **get_render_priority**\ (\ )
|
||
|
||
Встановлює пріоритет рендерингу для спрайта. Більші пріоритетні об'єкти будуть відсортовані перед нижніми пріоритетними об'єктами.
|
||
|
||
\ **Примітка:** Це тільки стосується, якщо :ref:`alpha_cut<class_SpriteBase3D_property_alpha_cut>` встановлюється на :ref:`ALPHA_CUT_DISABLED<class_SpriteBase3D_constant_ALPHA_CUT_DISABLED>` (за замовчуванням значення).
|
||
|
||
\ **Примітка:** Це стосується сортування прозорих об'єктів. Це не вплине на те, що прозорі предмети сортуються відносно непрозорих об'єктів. Це тому, що об'єкти не відсортовані, при цьому прозорі об'єкти відсортовані від спини до фронту (до пріоритету).
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_shaded:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **shaded** = ``false`` :ref:`🔗<class_SpriteBase3D_property_shaded>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`, enabled\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`\ ) |const|
|
||
|
||
Якщо ``true``, то :ref:`Light3D<class_Light3D>` в :ref:`Environment<class_Environment>` має вплив на спрайт.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_texture_filter:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`TextureFilter<enum_BaseMaterial3D_TextureFilter>` **texture_filter** = ``3`` :ref:`🔗<class_SpriteBase3D_property_texture_filter>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_texture_filter**\ (\ value\: :ref:`TextureFilter<enum_BaseMaterial3D_TextureFilter>`\ )
|
||
- :ref:`TextureFilter<enum_BaseMaterial3D_TextureFilter>` **get_texture_filter**\ (\ )
|
||
|
||
Прапорці фільтра для текстури.
|
||
|
||
\ **Примітка:** Лінійна фільтрація може спричиняти артефакти по краях, які особливо помітні на непрозорих текстурах. Щоб запобігти цьому, використовуйте текстури з прозорими або ідентичними кольорами по краях.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_property_transparent:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **transparent** = ``true`` :ref:`🔗<class_SpriteBase3D_property_transparent>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`, enabled\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`\ ) |const|
|
||
|
||
Якщо ``true``, прозорість текстури та непрозорість використовуються для того, щоб зробити ці частини невидимого спрайта.
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описи методів
|
||
--------------------------
|
||
|
||
.. _class_SpriteBase3D_method_generate_triangle_mesh:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`TriangleMesh<class_TriangleMesh>` **generate_triangle_mesh**\ (\ ) |const| :ref:`🔗<class_SpriteBase3D_method_generate_triangle_mesh>`
|
||
|
||
Повертає :ref:`TriangleMesh<class_TriangleMesh>` з вершинами спрайта, що відповідають його поточній конфігурації (наприклад, його :ref:`axis<class_SpriteBase3D_property_axis>` та :ref:`pixel_size<class_SpriteBase3D_property_pixel_size>`).
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_method_get_draw_flag:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`bool<class_bool>` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`\ ) |const| :ref:`🔗<class_SpriteBase3D_method_get_draw_flag>`
|
||
|
||
Повертає значення вказаного прапора.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_method_get_item_rect:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`Rect2<class_Rect2>` **get_item_rect**\ (\ ) |const| :ref:`🔗<class_SpriteBase3D_method_get_item_rect>`
|
||
|
||
Повертає прямокутник, що представляє цей спрайт.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_SpriteBase3D_method_set_draw_flag:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
|void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_SpriteBase3D_method_set_draw_flag>`
|
||
|
||
Якщо ``true``, вказаний прапорець буде ввімкнено.
|
||
|
||
.. |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 (Значення не повертається.)`
|