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

Sets the maximum amount of blur. When using physically-based blur amounts, will instead act as a multiplier. High values lead to an increased amount of blurriness, but can be much more expensive to calculate. It is best to keep this as low as possible for a given art style.

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

Enables depth of field blur for objects further than dof_blur_far_distance. Strength of blur is controlled by dof_blur_amount and modulated by dof_blur_far_transition.

Note: Depth of field blur is only supported in the Forward+ and Mobile rendering methods, not Compatibility.

Note: Depth of field blur is not supported on viewports that have a transparent background (where Viewport.transparent_bg is true).

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+ 和 Mobile 渲染方法中受支持，不支援相容模式。

注意： 景深模糊在具有透明背景的視口（Viewport.transparent_bg 為 true）上不受支援。

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，將以物理上準確的方式增加該效果。