跳转至

GIProbe

继承

VisualInstance

简要描述

实时全局照明（GI）探针。

描述

GIProbe用于为场景提供高质量的实时间接光。它们可以预先计算发光对象的效果以及静态几何图形的效果，以实时模拟复杂光的行为。 GIProbe必须先烘焙才能使用，但是一旦烘焙，动态物体就会从它们那里接收光。 此外，灯光可以是完全动态的，也可以是烘烤的。

在场景中使用GIProbe可能会很昂贵，可以在ProjectSettings中调整参数[成员ProjectSettings.rendering/quality/voxel_cone_tracing/high_quality]降低探针的质量，以换取更好的性能。

成员

类型 属性名 默认值
float bias 1.5
bool compress false
GIProbeData data
int dynamic_range 4
float energy 1.0
Vector3 extents Vector3( 10, 10, 10 )
bool interior false
float normal_bias 0.0
float propagation 0.7
int subdiv 1

方法

返回值类型 方法名称
void bake(from_node: Node = null, create_visual_debug: bool = false)
void debug_bake()
##枚举
enum Subdiv:
- SUBDIV_64 = 0

使用64个细分。这是最低质量设置，但最快。 如果可以，请使用它，尤其是在低端硬件上使用它。

  • SUBDIV_128 = 1

使用128个细分。这是默认的质量设置。

  • SUBDIV_256 = 2

使用256个细分。

  • SUBDIV_512 = 3

使用512个细分。但最慢的设置。 在低端硬件上，这可能会导致GPU停止运行。

  • SUBDIV_MAX = 4

表示Subdiv枚举的大小。

常量

成员说明

  • float bias
Default 1.5
setter set_bias(value)
getter get_bias
  • bool compress
Default false
setter set_compress(value)
getter is_compressed
  • GIProbeData data
setter set_probe_data(value)
getter get_probe_data
  • int dynamic_range
Default 4
setter set_dynamic_range(value)
getter get_dynamic_range
  • float energy
Default 1.0
setter set_energy(value)
getter get_energy
  • Vector3 extents
Default Vector3( 10, 10, 10 )
setter set_extents(value)
getter get_extents
  • bool interior
Default false
setter set_interior(value)
getter is_interior
  • float normal_bias
Default 0.0
setter set_normal_bias(value)
getter get_normal_bias
  • float propagation
Default 0.7
setter set_propagation(value)
getter get_propagation
  • int subdiv
Default 1
setter set_subdiv(value)
getter get_subdiv

方法说明

  • bake bake(from_node: Node = null, create_visual_debug: bool = false)

从标记为GeometryInstance.use_in_baked_light的所有GeometryInstance和标记为Light.BAKE_INDIRECT或Light.BAKE_ALL的Light烘焙效果。 如果create_visual_debug为true，则在烘烤光后，将生成一个MultiMesh，该MultiMesh包含一个代表每个实体单元的立方体，每个立方体都以该单元的反射率颜色着色。 这可用于可视化GIProbe的数据并调试可能发生的任何问题。

  • debug_bake debug_bake()

调用bake时启用create_visual_debug。