[page:Object3D] → [page:Light] →

# 光照探针[name]

光照探针是一种在3D场景中添加光源的另一种方法。与经典光源（平行光、点光、聚光）不同， 光照探针不发光。相反，光照探针存储着有关穿过3D空间的光线的信息。 渲染过程中，通过使用来自光照探针的数据，来逼近打到3D物体上的光线。

光照探针通常从（辐射）环境贴图中创建。[page:LightProbeGenerator] 类可以用于从 [page:CubeTexture] 或 [page:WebGLCubeRenderTarget] 的实例来创建光照探针。 但是，光照估算数据同样可以以其他形式提供，例如，通过WebXR。 这使得增强现实内容的渲染能够对现实世界的照明做出反应。

目前在 Three.js 中的探测实现支持所谓的漫射光探测。 这种类型的光照探针在功能上等效于辐照环境贴图。

## 例子

[example:webgl_lightprobe WebGL / light probe ]
[example:webgl_lightprobe_cubecamera WebGL / light probe / cube camera ]

## 构造函数

### [name]( [param:SphericalHarmonics3 sh], [param:Float intensity] )

[page:SphericalHarmonics3 sh] -（可选）一个 [page:SphericalHarmonics3] 的实例。
[page:Float intensity] -（可选）光照探针强度的数值。默认值为 1。
创建一个新的 [name] 。

## 属性

公共属性请查看基类 [page:Light Light]。 [page:Light.color color] 属性当前未做评估，因此不生效。

### [property:Boolean isLightProbe]

只读，用于检查对象的类型是否为 [name]。

### [property:SphericalHarmonics3 sh]

光照探针使用球面谐波（spherical harmonic）来编码光照信息。

## 方法

公共方法请查看基类 [page:Light Light]。

## 源码

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]