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

# [name]

Le sonde luminose sono un metodo alternativo di aggiungere luce in una scena 3D. Diversamente dalle classiche sorgenti di luce (ad esempio, direzionali, puntiformi o luci spot), le sonde luminose non emettono luce. Invece memorizzano informazioni sulla luce che passa attraverso lo spazio 3D. Durante il rendering, la luce che colpisce un oggetto 3D viene approssimata utilizzando i dati della sonda di luce.

Le sonde luminose vengono solitamente create da mappe ambientali (di radianza). La classe [page:LightProbeGenerator] può essere utilizzata per create le sonde luminose dalle istanze di [page:CubeTexture] o [page:WebGLCubeRenderTarget]. Tuttavia, i dati di stima della luce potrebbero essere forniti in altre forme, ad es. di WebXR. Ciò consente il rendering di realtà aumentata che reagiscono all'illuminazione del mondo reale.

L'attuale implementazione della sonda in three.js supporta le cosidette sonde a luce diffusa. Questo tipo di sonda luminosa è funzionalmente equivalente a una mappa ambientale di irradianza.

## Esempi

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

## Costruttore

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

[page:SphericalHarmonics3 sh] - (opzionale) Un'istanza di [page:SphericalHarmonics3].
[page:Float intensity] - (opzionale) Il valore numerico dell'intensità della sonda luminosa. Il valore predefinito è 1.
Crea una nuova [name].

## Proprietà

Vedi la classe base [page:Light Light] per le proprietà comuni. La proprietà [page:Light.color color] al momento non è valutata e quindi non ha alcun effetto.

### [property:Boolean isLightProbe]

Flag di sola lettura per verificare se l'oggetto dato è del tipo [name].

### [property:SphericalHarmonics3 sh]

Una sonda luminosa utilizza le armoniche sferiche per codificare le informazioni sull'illuminazione.

## Metodi

Vedi la classe base [page:Light Light] per i metodi comuni.

## Source

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