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

相机设置，格式比较易用。

描述

控制相机的特定属性，如自动曝光、景深、以及曝光覆盖。

当在 WorldEnvironment 中使用时，它提供了曝光、自动曝光、以及景深的默认设置，这些设置将由所有没有自己的 CameraAttributes 的相机使用，包括编辑器相机。当在 Camera3D 中使用时，它将覆盖 WorldEnvironment 中设置的任何 CameraAttributes。当在 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+ 和移动渲染方式，不支持兼容模式。

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。当为负数时，使用基于物理的缩放，因此景深效果将在 dof_blur_far_distance 处从 0 开始缩放，并且随着对象远离该 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+ 和移动渲染方式，不支持兼容模式。

float dof_blur_near_transition = 1.0 🔗

void set_dof_blur_near_transition(value: float)
float get_dof_blur_near_transition()

当为正数时，距离超过该值且截止到 dof_blur_near_distance 时，模糊效果将从 0 缩放到 dof_blur_amount。当为负数时，使用基于物理的缩放，因此景深效果将在 dof_blur_near_distance 处从 0 开始缩放，并且随着对象靠近该 Camera3D，将以物理上准确的方式增加该效果。