mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-04 10:09:56 +03:00
163 lines
11 KiB
ReStructuredText
163 lines
11 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_ParallaxBackground:
|
||
|
||
ParallaxBackground
|
||
==================
|
||
|
||
**Устарело:** Use the :ref:`Parallax2D<class_Parallax2D>` node instead.
|
||
|
||
**Наследует:** :ref:`CanvasLayer<class_CanvasLayer>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
|
||
|
||
Узел, используемый для создания параллаксного прокручиваемого фона.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Описание
|
||
----------------
|
||
|
||
ParallaxBackground использует один или несколько дочерних узлов :ref:`ParallaxLayer<class_ParallaxLayer>` для создания эффекта параллакса. Каждый :ref:`ParallaxLayer<class_ParallaxLayer>` может двигаться с разной скоростью с помощью :ref:`ParallaxLayer.motion_offset<class_ParallaxLayer_property_motion_offset>`. Это создает иллюзию глубины в 2D-игре. Если не используется с :ref:`Camera2D<class_Camera2D>`, необходимо вручную рассчитать :ref:`scroll_offset<class_ParallaxBackground_property_scroll_offset>`.
|
||
|
||
\ **Примечание:** Каждый **ParallaxBackground** рисуется на одном определенном :ref:`Viewport<class_Viewport>` и не может совместно использоваться несколькими :ref:`Viewport<class_Viewport>`, см. :ref:`CanvasLayer.custom_viewport<class_CanvasLayer_property_custom_viewport>`. При использовании нескольких :ref:`Viewport<class_Viewport>`, например, в игре с разделенным экраном, необходимо создать отдельный **ParallaxBackground** для каждого :ref:`Viewport<class_Viewport>`, на котором вы хотите его нарисовать.
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Свойства
|
||
----------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+-------------------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
|
||
| :ref:`int<class_int>` | layer | ``-100`` (overrides :ref:`CanvasLayer<class_CanvasLayer_property_layer>`) |
|
||
+-------------------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
|
||
| :ref:`Vector2<class_Vector2>` | :ref:`scroll_base_offset<class_ParallaxBackground_property_scroll_base_offset>` | ``Vector2(0, 0)`` |
|
||
+-------------------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
|
||
| :ref:`Vector2<class_Vector2>` | :ref:`scroll_base_scale<class_ParallaxBackground_property_scroll_base_scale>` | ``Vector2(1, 1)`` |
|
||
+-------------------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
|
||
| :ref:`bool<class_bool>` | :ref:`scroll_ignore_camera_zoom<class_ParallaxBackground_property_scroll_ignore_camera_zoom>` | ``false`` |
|
||
+-------------------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
|
||
| :ref:`Vector2<class_Vector2>` | :ref:`scroll_limit_begin<class_ParallaxBackground_property_scroll_limit_begin>` | ``Vector2(0, 0)`` |
|
||
+-------------------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
|
||
| :ref:`Vector2<class_Vector2>` | :ref:`scroll_limit_end<class_ParallaxBackground_property_scroll_limit_end>` | ``Vector2(0, 0)`` |
|
||
+-------------------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
|
||
| :ref:`Vector2<class_Vector2>` | :ref:`scroll_offset<class_ParallaxBackground_property_scroll_offset>` | ``Vector2(0, 0)`` |
|
||
+-------------------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описания свойств
|
||
--------------------------------
|
||
|
||
.. _class_ParallaxBackground_property_scroll_base_offset:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Vector2<class_Vector2>` **scroll_base_offset** = ``Vector2(0, 0)`` :ref:`🔗<class_ParallaxBackground_property_scroll_base_offset>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_scroll_base_offset**\ (\ value\: :ref:`Vector2<class_Vector2>`\ )
|
||
- :ref:`Vector2<class_Vector2>` **get_scroll_base_offset**\ (\ )
|
||
|
||
Смещение базовой позиции для всех дочерних элементов :ref:`ParallaxLayer<class_ParallaxLayer>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ParallaxBackground_property_scroll_base_scale:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Vector2<class_Vector2>` **scroll_base_scale** = ``Vector2(1, 1)`` :ref:`🔗<class_ParallaxBackground_property_scroll_base_scale>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_scroll_base_scale**\ (\ value\: :ref:`Vector2<class_Vector2>`\ )
|
||
- :ref:`Vector2<class_Vector2>` **get_scroll_base_scale**\ (\ )
|
||
|
||
Базовый масштаб движения для всех дочерних элементов :ref:`ParallaxLayer<class_ParallaxLayer>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ParallaxBackground_property_scroll_ignore_camera_zoom:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **scroll_ignore_camera_zoom** = ``false`` :ref:`🔗<class_ParallaxBackground_property_scroll_ignore_camera_zoom>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_ignore_camera_zoom**\ (\ value\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **is_ignore_camera_zoom**\ (\ )
|
||
|
||
Если ``true``, элементы в дочернем элементе :ref:`ParallaxLayer<class_ParallaxLayer>` не подвержены влиянию уровня масштабирования камеры.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ParallaxBackground_property_scroll_limit_begin:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Vector2<class_Vector2>` **scroll_limit_begin** = ``Vector2(0, 0)`` :ref:`🔗<class_ParallaxBackground_property_scroll_limit_begin>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_limit_begin**\ (\ value\: :ref:`Vector2<class_Vector2>`\ )
|
||
- :ref:`Vector2<class_Vector2>` **get_limit_begin**\ (\ )
|
||
|
||
Верхний левый предел для начала прокрутки. Если камера находится за пределами этого предела, фон перестанет прокручиваться. Для работы должно быть ниже :ref:`scroll_limit_end<class_ParallaxBackground_property_scroll_limit_end>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ParallaxBackground_property_scroll_limit_end:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Vector2<class_Vector2>` **scroll_limit_end** = ``Vector2(0, 0)`` :ref:`🔗<class_ParallaxBackground_property_scroll_limit_end>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_limit_end**\ (\ value\: :ref:`Vector2<class_Vector2>`\ )
|
||
- :ref:`Vector2<class_Vector2>` **get_limit_end**\ (\ )
|
||
|
||
Нижний правый предел прокрутки до конца. Если камера находится за пределами этого предела, фон перестанет прокручиваться. Для работы должно быть больше :ref:`scroll_limit_begin<class_ParallaxBackground_property_scroll_limit_begin>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ParallaxBackground_property_scroll_offset:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Vector2<class_Vector2>` **scroll_offset** = ``Vector2(0, 0)`` :ref:`🔗<class_ParallaxBackground_property_scroll_offset>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_scroll_offset**\ (\ value\: :ref:`Vector2<class_Vector2>`\ )
|
||
- :ref:`Vector2<class_Vector2>` **get_scroll_offset**\ (\ )
|
||
|
||
Значение прокрутки ParallaxBackground. Рассчитывается автоматически при использовании :ref:`Camera2D<class_Camera2D>`, но может использоваться для ручного управления прокруткой при отсутствии камеры.
|
||
|
||
.. |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 (Нет возвращаемого значения.)`
|