CameraAttributesPractical

继承： CameraAttributes < Resource < RefCounted < Object

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

描述

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

当在 WorldEnvironment 中使用时，它提供了曝光、自动曝光、以及景深的默认设置，这些设置将由所有没有自己的 CameraAttributes 的相机使用，包括编辑器相机。当在 Camera3D 中使用时，它将覆盖 WorldEnvironment 中设置的任何 CameraAttributes。当在 VoxelGI 或 LightmapGI 中使用时，只会使用曝光设置。

属性

属性说明

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，将以物理上准确的方式增加该效果。