CameraAttributesPractical

继承： CameraAttributes < Resource < RefCounted < Object

以易于使用的格式进行摄像机设置。

描述

控制摄像机特定的属性，例如自动曝光、景深和曝光覆盖。

在WorldEnvironment中使用时，它提供曝光、自动曝光和景深的默认设置，所有摄像机都将使用这些设置，而没有自己的CameraAttributes，包括编辑器摄像机。在Camera中使用时，它将覆盖WorldEnvironment中设置的任何CameraAttributes。在VoxelGI或Lightmass中使用时，将仅使用曝光设置。

属性

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()

计算自动曝光时使用的最大灵敏度（在国际标准化组织中）。当计算场景平均亮度时，颜色值将被限制在至少这个值。这限制了自动曝光低于一定亮度，导致场景保持明亮的截止点。

---

float auto_exposure_min_sensitivity = 0.0 🔗

• void set_auto_exposure_min_sensitivity(value: float)

• float get_auto_exposure_min_sensitivity()

计算自动曝光时使用的最小灵敏度（在国际标准化组织中）。当计算场景平均亮度时，颜色值将被限制在至少这个值。这限制了自动曝光高于一定亮度，导致场景保持黑暗的截止点。

---

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()

距离Camera更远的物体将被景深效果模糊。以米为单位测量。

---

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渲染方法中支持景深模糊，不支持兼容性。

---

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缩放，并且随着物体离Camera越来越远，将以物理精确的方式增加。

---

float dof_blur_near_distance = 2.0 🔗

• void set_dof_blur_near_distance(value: float)

• float get_dof_blur_near_distance()

离Camera近这个量的物体将被景深效果模糊。以米为单位测量。

---

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渲染方法中支持景深模糊，不支持兼容性。

---

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结束。当为负时，使用基于物理的缩放，因此景深效果将在dof_blur_near_distance从0缩放，并随着物体靠近Camera而以物理精确的方式增加。