CameraAttributesPractical

Наследует: CameraAttributes < Resource < RefCounted < Object

Настройки камеры в удобном формате.

Описание

Управляет атрибутами камеры, такими как автоэкспозиция, глубина резкости и переопределение экспозиции.

При использовании в WorldEnvironment он предоставляет настройки по умолчанию для экспозиции, автоэкспозиции и глубины резкости, которые будут использоваться всеми камерами без их собственных CameraAttributes, включая камеру редактора. При использовании в Camera3D он переопределяет любые CameraAttributes, установленные в WorldEnvironment. При использовании в VoxelGI или LightmapGI будут использоваться только настройки экспозиции.

Свойства

float

auto_exposure_max_sensitivity

800.0

float

auto_exposure_min_sensitivity

0.0

float

dof_blur_amount

0.1

float

dof_blur_far_distance

10.0

bool

dof_blur_far_enabled

false

float

dof_blur_far_transition

5.0

float

dof_blur_near_distance

2.0

bool

dof_blur_near_enabled

false

float

dof_blur_near_transition

1.0


Описания свойств

float auto_exposure_max_sensitivity = 800.0 🔗

  • void set_auto_exposure_max_sensitivity(value: float)

  • float get_auto_exposure_max_sensitivity()

Максимальная чувствительность (в ISO), используемая при расчете автоэкспозиции. При расчете средней яркости сцены цветовые значения будут ограничены по крайней мере этим значением. Это ограничивает автоэкспозицию от экспонирования ниже определенной яркости, что приводит к точке отсечения, в которой сцена останется яркой.


float auto_exposure_min_sensitivity = 0.0 🔗

  • void set_auto_exposure_min_sensitivity(value: float)

  • float get_auto_exposure_min_sensitivity()

Минимальная чувствительность (в ISO), используемая при расчете автоэкспозиции. При расчете средней яркости сцены цветовые значения будут ограничены по крайней мере этим значением. Это ограничивает автоэкспозицию от экспонирования выше определенной яркости, что приводит к точке отсечения, в которой сцена останется темной.


float dof_blur_amount = 0.1 🔗

  • void set_dof_blur_amount(value: float)

  • float get_dof_blur_amount()

Устанавливает максимальное количество размытия. При использовании физически обоснованных значений размытия будет действовать как множитель. Высокие значения приводят к увеличению количества размытия, но могут быть намного более затратными для расчета. Лучше всего поддерживать это значение как можно ниже для данного стиля искусства.


float dof_blur_far_distance = 10.0 🔗

  • void set_dof_blur_far_distance(value: float)

  • float get_dof_blur_far_distance()

Объекты, находящиеся дальше от Camera3D на эту величину, будут размыты эффектом глубины резкости. Измеряется в метрах.


bool dof_blur_far_enabled = false 🔗

  • void set_dof_blur_far_enabled(value: bool)

  • bool is_dof_blur_far_enabled()

Включает размытие глубины резкости для объектов, находящихся дальше, чем dof_blur_far_distance. Сила размытия контролируется dof_blur_amount и модулируется dof_blur_far_transition.

Примечание: Размытие глубины резкости поддерживается только в методах рендеринга Forward+ и Mobile, но не Compatibility.

Примечание: Размытие глубины резкости не поддерживается на окнах просмотра с прозрачным фоном (где Viewport.transparent_bg имеет значение true).


float dof_blur_far_transition = 5.0 🔗

  • void set_dof_blur_far_transition(value: float)

  • float get_dof_blur_far_transition()

При положительном значении расстояние, на котором (начиная с dof_blur_far_distance) эффект размытия будет масштабироваться от 0 до dof_blur_amount. При отрицательном значении используется физически обоснованное масштабирование, поэтому эффект глубины резкости будет масштабироваться от 0 при dof_blur_far_distance и будет увеличиваться физически точным образом по мере удаления объектов от Camera3D.


float dof_blur_near_distance = 2.0 🔗

  • void set_dof_blur_near_distance(value: float)

  • float get_dof_blur_near_distance()

Объекты, расположенные ближе к Camera3D на эту величину, будут размыты эффектом глубины резкости. Измеряется в метрах.


bool dof_blur_near_enabled = false 🔗

  • void set_dof_blur_near_enabled(value: bool)

  • bool is_dof_blur_near_enabled()

Включает размытие глубины резкости для объектов ближе, чем dof_blur_near_distance. Сила размытия контролируется dof_blur_amount и модулируется dof_blur_near_transition.

Примечание: Размытие глубины резкости поддерживается только в методах рендеринга Forward+ и Mobile, но не Compatibility.

Примечание: Размытие глубины резкости не поддерживается на окнах просмотра с прозрачным фоном (где Viewport.transparent_bg имеет значение true).


float dof_blur_near_transition = 1.0 🔗

  • void set_dof_blur_near_transition(value: float)

  • float get_dof_blur_near_transition()

При положительном значении расстояние, на котором эффект размытия будет масштабироваться от 0 до dof_blur_amount, заканчиваясь на dof_blur_near_distance. При отрицательном значении используется физически обоснованное масштабирование, поэтому эффект глубины резкости будет масштабироваться от 0 до dof_blur_near_distance и будет увеличиваться физически точным образом по мере приближения объектов к Camera3D.