Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

CameraAttributesPractical

Успадковує: CameraAttributes < Resource < RefCounted < Object

Налаштування камери в зручному форматі.

Опис

Controls camera-specific attributes such as auto-exposure, depth of field, and exposure override.

When used in a WorldEnvironment it provides default settings for exposure, auto-exposure, and depth of field that will be used by all cameras without their own CameraAttributes, including the editor camera. When used in a Camera3D it will override any CameraAttributes set in the WorldEnvironment. When used in VoxelGI or LightmapGI, only the exposure settings will be used.

Note: Depth of field blur is only supported in the Forward+ and Mobile rendering methods, not Compatibility.

Note: Auto-exposure is only supported in the Forward+ rendering method, not Mobile or Compatibility.

Властивості

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.