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.

Посібники

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

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

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.