CameraAttributes

继承： Resource < RefCounted < Object

派生： CameraAttributesPhysical, CameraAttributesPractical

Parent class for camera settings.

描述

Controls camera-specific attributes such as depth of field and exposure override.

When used in a WorldEnvironment it provides default settings for exposure, auto-exposure, and depth of field that will be used by all cameras without their own CameraAttributes, including the editor camera. When used in a Camera3D it will override any CameraAttributes set in the WorldEnvironment. When used in VoxelGI or LightmapGI, only the exposure settings will be used.

See also Environment for general 3D environment settings.

This is a pure virtual class that is inherited by CameraAttributesPhysical and CameraAttributesPractical.

属性
boolauto_exposure_enabled
floatauto_exposure_scale
floatauto_exposure_speed
floatexposure_multiplier
floatexposure_sensitivity

属性说明

bool auto_exposure_enabled = false

  • void set_auto_exposure_enabled ( value: bool )
  • bool is_auto_exposure_enabled ( )

If true, enables the tonemapping auto exposure mode of the scene renderer. If true, the renderer will automatically determine the exposure setting to adapt to the scene's illumination and the observed light.

float auto_exposure_scale = 0.4

  • void set_auto_exposure_scale ( value: float )
  • float get_auto_exposure_scale ( )

The scale of the auto exposure effect. Affects the intensity of auto exposure.

float auto_exposure_speed = 0.5

  • void set_auto_exposure_speed ( value: float )
  • float get_auto_exposure_speed ( )

The speed of the auto exposure effect. Affects the time needed for the camera to perform auto exposure.

float exposure_multiplier = 1.0

  • void set_exposure_multiplier ( value: float )
  • float get_exposure_multiplier ( )

Multiplier for the exposure amount. A higher value results in a brighter image.

float exposure_sensitivity = 100.0

  • void set_exposure_sensitivity ( value: float )
  • float get_exposure_sensitivity ( )

Sensitivity of camera sensors, measured in ISO. A higher sensitivity results in a brighter image. Only available when ProjectSettings.rendering/lights_and_shadows/use_physical_light_units is enabled. When auto_exposure_enabled this can be used as a method of exposure compensation, doubling the value will increase the exposure value (measured in EV100) by 1 stop.

1

本方法通常需要用户覆盖才能生效。

2

本方法无副作用，不会修改该实例的任何成员变量。

3

本方法除了能接受在此处描述的参数外，还能够继续接受任意数量的参数。

4

本方法用于构造某个类型。

5

调用本方法无需实例，可直接使用类名进行调用。

6

本方法描述的是使用本类型作为左操作数的有效运算符。

7

这个值是由下列位标志构成位掩码的整数。

8

无返回值。