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...

CameraAttributesPhysical

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

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

Опис

CameraAttributesPhysical використовується для налаштування параметрів візуалізації на основі налаштувань фізично-орієнтованої камери. Він відповідає за експозицію, автоекспозицію та глибину різкості.

При використанні в WorldEnvironment він надає стандартні налаштування експозиції, автоекспозиції та глибини різкості, які будуть застосовуватися до всіх камер, що не мають власних CameraAttributes, включаючи камеру редактора. При використанні в Camera3D він замінить будь-які CameraAttributes, встановлені в WorldEnvironment, а також замінить властивості Camera3D Camera3D.far, Camera3D.near, Camera3D.fov та Camera3D.keep_aspect. При використанні в VoxelGI або LightmapGI будуть використовуватися лише налаштування експозиції.

Налаштування за замовчуванням призначені для використання у зовнішньому середовищі; поради щодо налаштувань для використання у приміщенні можна знайти в документації до кожного налаштування.

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

Примітка: Автоекспозиція підтримується лише в методі рендерингу Forward+, а не в Mobile або Compatibility.

Посібники

Блоки фізичного освітлення та камери

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

float	auto_exposure_max_exposure_value	`10.0`
float	auto_exposure_min_exposure_value	`-8.0`
float	exposure_aperture	`16.0`
float	exposure_shutter_speed	`100.0`
float	frustum_far	`4000.0`
float	frustum_focal_length	`35.0`
float	frustum_focus_distance	`10.0`
float	frustum_near	`0.05`

Методи

float

get_fov() const

Описи властивостей

float auto_exposure_max_exposure_value = 10.0 🔗

void set_auto_exposure_max_exposure_value(value: float)
float get_auto_exposure_max_exposure_value()

Максимальна яскравість (у EV100), яка використовується під час розрахунку автоматичної експозиції. Під час обчислення середньої яскравості сцени значення кольорів будуть обмежені принаймні до цього значення. Це обмежує автоматичну експозицію від експозиції нижче певної яскравості, що призводить до точки відсікання, де сцена залишатиметься яскравою.

float auto_exposure_min_exposure_value = -8.0 🔗

void set_auto_exposure_min_exposure_value(value: float)
float get_auto_exposure_min_exposure_value()

Мінімальна яскравість (у EV100), яка використовується під час розрахунку автоматичної експозиції. Під час обчислення середньої яскравості сцени значення кольорів будуть обмежені принаймні до цього значення. Це обмежує автоматичну експозицію від експозиції вище певної яскравості, що призводить до точки зрізу, де сцена залишатиметься темною.

float exposure_aperture = 16.0 🔗

void set_aperture(value: float)
float get_aperture()

Розмір діафрагми камери, виміряний у діафрагмах. Діафрагма — це безрозмірне співвідношення між фокусною відстанню камери та діаметром діафрагми. Значення високої діафрагми призведе до меншої діафрагми, що призводить до тьмянішого зображення та чіткішого фокусування. Низька діафрагма створює широку діафрагму, яка пропускає більше світла, що призводить до яскравішого та менш сфокусованого зображення. Значення за замовчуванням підходить для зовнішнього освітлення вдень (тобто для використання за замовчуванням DirectionalLight3D), для внутрішнього освітлення більш прийнятним є значення від 2 до 4.

Доступно, лише якщо ввімкнено ProjectSettings.rendering/lights_and_shadows/use_physical_light_units.

float exposure_shutter_speed = 100.0 🔗

void set_shutter_speed(value: float)
float get_shutter_speed()

Час для відкриття та закриття затвора, оцінюється як 1 / shutter_speed секунди. Більше значення пропускатиме менше світла (що призводить до темнішого зображення), тоді як нижче значення пропускатиме більше світла (що призводить до більш яскравого зображення).

Доступно, лише якщо ввімкнено ProjectSettings.rendering/lights_and_shadows/use_physical_light_units.

float frustum_far = 4000.0 🔗

void set_far(value: float)
float get_far()

Значення заміни для Camera3D.far. Використовується внутрішньо під час обчислення глибини різкості. Якщо приєднати до Camera3D як його Camera3D.attributes, він замінить властивість Camera3D.far.

float frustum_focal_length = 35.0 🔗

void set_focal_length(value: float)
float get_focal_length()

Відстань між об’єктивом камери та діафрагмою камери, вимірюється в міліметрах. Керує полем зору та глибиною різкості. Більша фокусна відстань призведе до меншого поля зору та меншої глибини різкості, тобто менше об’єктів буде у фокусі. Менша фокусна відстань призведе до ширшого поля зору та більшої глибини різкості, тобто більше об’єктів буде у фокусі. Якщо прикріпити до Camera3D як його Camera3D.attributes, він замінить властивості Camera3D.fov і Camera3D.keep_aspect.

float frustum_focus_distance = 10.0 🔗

void set_focus_distance(value: float)
float get_focus_distance()

Відстань від камери об'єкта, який буде у фокусі, вимірюється в метрах. Внутрішньо це буде закріплено, щоб бути принаймні на 1 міліметр більше, ніж frustum_focal_length.

float frustum_near = 0.05 🔗

void set_near(value: float)
float get_near()

Перевизначає значення для Camera3D.near. Використовується внутрішньо під час обчислення глибини різкості. Якщо приєднати до Camera3D як його Camera3D.attributes, він замінить властивість Camera3D.near.

Описи методів

float get_fov() const 🔗

Повертає вертикальне поле зору, яке відповідає frustum_focal_length. Це значення обчислюється внутрішньо щоразу, коли змінюється frustum_focal_length.