mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
241 lines
17 KiB
ReStructuredText
241 lines
17 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_CameraAttributesPhysical:
|
||
|
||
CameraAttributesPhysical
|
||
========================
|
||
|
||
**Наследует:** :ref:`CameraAttributes<class_CameraAttributes>` **<** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
||
|
||
Настройки камеры на основе физики.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Описание
|
||
----------------
|
||
|
||
**CameraAttributesPhysical** используется для установки параметров рендеринга на основе физических настроек камеры. Он отвечает за экспозицию, автоэкспозицию и глубину резкости.
|
||
|
||
При использовании в :ref:`WorldEnvironment<class_WorldEnvironment>` он предоставляет настройки по умолчанию для экспозиции, автоэкспозиции и глубины резкости, которые будут использоваться всеми камерами без их собственных :ref:`CameraAttributes<class_CameraAttributes>`, включая камеру редактора. При использовании в :ref:`Camera3D<class_Camera3D>` он переопределит любые :ref:`CameraAttributes<class_CameraAttributes>`, установленные в :ref:`WorldEnvironment<class_WorldEnvironment>`, и переопределит свойства :ref:`Camera3D<class_Camera3D>` :ref:`Camera3D.far<class_Camera3D_property_far>`, :ref:`Camera3D.near<class_Camera3D_property_near>`, :ref:`Camera3D.fov<class_Camera3D_property_fov>` и :ref:`Camera3D.keep_aspect<class_Camera3D_property_keep_aspect>`. При использовании в :ref:`VoxelGI<class_VoxelGI>` или :ref:`LightmapGI<class_LightmapGI>` будут использоваться только настройки экспозиции.
|
||
|
||
Настройки по умолчанию предназначены для использования на открытом воздухе, советы по настройкам для использования в помещении можно найти в документации к каждому параметру.
|
||
|
||
\ **Примечание:** Размытие глубины резкости поддерживается только в методах рендеринга Forward+ и Mobile, а не Compatibility.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Обучающие материалы
|
||
--------------------------------------
|
||
|
||
- :doc:`Физические световые и камерные блоки <../tutorials/3d/physical_light_and_camera_units>`
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Свойства
|
||
----------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+---------------------------+-------------------------------------------------------------------------------------------------------------------+------------+
|
||
| :ref:`float<class_float>` | :ref:`auto_exposure_max_exposure_value<class_CameraAttributesPhysical_property_auto_exposure_max_exposure_value>` | ``10.0`` |
|
||
+---------------------------+-------------------------------------------------------------------------------------------------------------------+------------+
|
||
| :ref:`float<class_float>` | :ref:`auto_exposure_min_exposure_value<class_CameraAttributesPhysical_property_auto_exposure_min_exposure_value>` | ``-8.0`` |
|
||
+---------------------------+-------------------------------------------------------------------------------------------------------------------+------------+
|
||
| :ref:`float<class_float>` | :ref:`exposure_aperture<class_CameraAttributesPhysical_property_exposure_aperture>` | ``16.0`` |
|
||
+---------------------------+-------------------------------------------------------------------------------------------------------------------+------------+
|
||
| :ref:`float<class_float>` | :ref:`exposure_shutter_speed<class_CameraAttributesPhysical_property_exposure_shutter_speed>` | ``100.0`` |
|
||
+---------------------------+-------------------------------------------------------------------------------------------------------------------+------------+
|
||
| :ref:`float<class_float>` | :ref:`frustum_far<class_CameraAttributesPhysical_property_frustum_far>` | ``4000.0`` |
|
||
+---------------------------+-------------------------------------------------------------------------------------------------------------------+------------+
|
||
| :ref:`float<class_float>` | :ref:`frustum_focal_length<class_CameraAttributesPhysical_property_frustum_focal_length>` | ``35.0`` |
|
||
+---------------------------+-------------------------------------------------------------------------------------------------------------------+------------+
|
||
| :ref:`float<class_float>` | :ref:`frustum_focus_distance<class_CameraAttributesPhysical_property_frustum_focus_distance>` | ``10.0`` |
|
||
+---------------------------+-------------------------------------------------------------------------------------------------------------------+------------+
|
||
| :ref:`float<class_float>` | :ref:`frustum_near<class_CameraAttributesPhysical_property_frustum_near>` | ``0.05`` |
|
||
+---------------------------+-------------------------------------------------------------------------------------------------------------------+------------+
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Методы
|
||
------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+---------------------------+-----------------------------------------------------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`get_fov<class_CameraAttributesPhysical_method_get_fov>`\ (\ ) |const| |
|
||
+---------------------------+-----------------------------------------------------------------------------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описания свойств
|
||
--------------------------------
|
||
|
||
.. _class_CameraAttributesPhysical_property_auto_exposure_max_exposure_value:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **auto_exposure_max_exposure_value** = ``10.0`` :ref:`🔗<class_CameraAttributesPhysical_property_auto_exposure_max_exposure_value>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_auto_exposure_max_exposure_value**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_auto_exposure_max_exposure_value**\ (\ )
|
||
|
||
Максимальная яркость (в EV100), используемая при расчете автоэкспозиции. При расчете средней яркости сцены цветовые значения будут ограничены по крайней мере этим значением. Это ограничивает автоэкспозицию от экспонирования ниже определенной яркости, что приводит к точке отсечения, в которой сцена останется яркой.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_CameraAttributesPhysical_property_auto_exposure_min_exposure_value:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **auto_exposure_min_exposure_value** = ``-8.0`` :ref:`🔗<class_CameraAttributesPhysical_property_auto_exposure_min_exposure_value>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_auto_exposure_min_exposure_value**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_auto_exposure_min_exposure_value**\ (\ )
|
||
|
||
Минимальная яркость (в EV100), используемая при расчете автоэкспозиции. При расчете средней яркости сцены цветовые значения будут ограничены по крайней мере этим значением. Это ограничивает автоэкспозицию от экспонирования выше определенной яркости, что приводит к точке отсечения, в которой сцена останется темной.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_CameraAttributesPhysical_property_exposure_aperture:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **exposure_aperture** = ``16.0`` :ref:`🔗<class_CameraAttributesPhysical_property_exposure_aperture>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_aperture**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_aperture**\ (\ )
|
||
|
||
Размер апертуры камеры, измеряемый в f-ступенях. F-ступень — это безразмерное отношение фокусного расстояния камеры к диаметру апертуры. Высокая настройка апертуры приведет к меньшей апертуре, что приведет к более тусклому изображению и более четкому фокусу. Низкая настройка апертуры приведет к широкой апертуре, которая пропускает больше света, что приведет к более яркому, менее сфокусированному изображению. Значение по умолчанию подходит для наружного освещения в дневное время (т. е. для использования с :ref:`DirectionalLight3D<class_DirectionalLight3D>` по умолчанию), для внутреннего освещения более подходящим является значение от 2 до 4.
|
||
|
||
Доступно только при включенном :ref:`ProjectSettings.rendering/lights_and_shadows/use_physical_light_units<class_ProjectSettings_property_rendering/lights_and_shadows/use_physical_light_units>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_CameraAttributesPhysical_property_exposure_shutter_speed:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **exposure_shutter_speed** = ``100.0`` :ref:`🔗<class_CameraAttributesPhysical_property_exposure_shutter_speed>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_shutter_speed**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_shutter_speed**\ (\ )
|
||
|
||
Время открытия и закрытия затвора, оцениваемое как ``1 / shutter_speed`` секунд. Более высокое значение допускает меньше света (что приводит к более темному изображению), а более низкое значение допускает больше света (что приводит к более яркому изображению).
|
||
|
||
Доступно только при включенном :ref:`ProjectSettings.rendering/lights_and_shadows/use_physical_light_units<class_ProjectSettings_property_rendering/lights_and_shadows/use_physical_light_units>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_CameraAttributesPhysical_property_frustum_far:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **frustum_far** = ``4000.0`` :ref:`🔗<class_CameraAttributesPhysical_property_frustum_far>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_far**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_far**\ (\ )
|
||
|
||
Переопределить значение для :ref:`Camera3D.far<class_Camera3D_property_far>`. Используется внутренне при расчете глубины резкости. При присоединении к :ref:`Camera3D<class_Camera3D>` в качестве его :ref:`Camera3D.attributes<class_Camera3D_property_attributes>` переопределит свойство :ref:`Camera3D.far<class_Camera3D_property_far>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_CameraAttributesPhysical_property_frustum_focal_length:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **frustum_focal_length** = ``35.0`` :ref:`🔗<class_CameraAttributesPhysical_property_frustum_focal_length>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_focal_length**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_focal_length**\ (\ )
|
||
|
||
Расстояние между объективом камеры и апертурой камеры, измеряется в миллиметрах. Управляет полем зрения и глубиной резкости. Большее фокусное расстояние приведет к меньшему полю зрения и меньшей глубине резкости, что означает, что меньше объектов будет в фокусе. Меньшее фокусное расстояние приведет к более широкому полю зрения и большей глубине резкости, что означает, что больше объектов будет в фокусе. При присоединении к :ref:`Camera3D<class_Camera3D>` в качестве его :ref:`Camera3D.attributes<class_Camera3D_property_attributes>` он переопределит свойство :ref:`Camera3D.fov<class_Camera3D_property_fov>` и свойство :ref:`Camera3D.keep_aspect<class_Camera3D_property_keep_aspect>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_CameraAttributesPhysical_property_frustum_focus_distance:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **frustum_focus_distance** = ``10.0`` :ref:`🔗<class_CameraAttributesPhysical_property_frustum_focus_distance>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_focus_distance**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_focus_distance**\ (\ )
|
||
|
||
Расстояние от камеры до объекта, который будет в фокусе, измеряется в метрах. Внутренне это будет ограничено как минимум на 1 миллиметр больше, чем :ref:`frustum_focal_length<class_CameraAttributesPhysical_property_frustum_focal_length>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_CameraAttributesPhysical_property_frustum_near:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **frustum_near** = ``0.05`` :ref:`🔗<class_CameraAttributesPhysical_property_frustum_near>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_near**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_near**\ (\ )
|
||
|
||
Переопределяет значение для :ref:`Camera3D.near<class_Camera3D_property_near>`. Используется внутренне при расчете глубины резкости. При присоединении к :ref:`Camera3D<class_Camera3D>` в качестве его :ref:`Camera3D.attributes<class_Camera3D_property_attributes>` переопределяет свойство :ref:`Camera3D.near<class_Camera3D_property_near>`.
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описания метода
|
||
------------------------------
|
||
|
||
.. _class_CameraAttributesPhysical_method_get_fov:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`float<class_float>` **get_fov**\ (\ ) |const| :ref:`🔗<class_CameraAttributesPhysical_method_get_fov>`
|
||
|
||
Возвращает вертикальное поле зрения, которое соответствует :ref:`frustum_focal_length<class_CameraAttributesPhysical_property_frustum_focal_length>`. Это значение вычисляется внутренне всякий раз, когда изменяется :ref:`frustum_focal_length<class_CameraAttributesPhysical_property_frustum_focal_length>`.
|
||
|
||
.. |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 (Нет возвращаемого значения.)`
|