[page:Object3D] →

# [name]

Livello di Dettaglio - mostra mesh con più o meno geometria in base alla distanza dalla telecamera.
Ogni livello è associato ad un oggetto, e il rendering può essere commutato tra di loro alle distanze specificate. In genere creeresti, per esempio, tre mesh, una per il lontano (dettaglio basse), una per la gamma media (medio dettaglio) e una per i primi piani (alto dettaglio).

## Codice di Esempio

`const lod = new THREE.LOD(); // Crea sfere con 3 livelli di dettaglio e crea nuovi livelli LOD per loro for( let i = 0; i < 3; i++ ) { const geometry = new THREE.IcosahedronGeometry( 10, 3 - i ); const mesh = new THREE.Mesh( geometry, material ); lod.addLevel( mesh, i * 75 ); } scene.add( lod );`

## Esempi

[example:webgl_lod webgl / lod ]

## Costruttore

### [name]( )

Crea un nuovo [name].

## Proprietà

Vedi la classe base [page:Object3D] per le proprietà comuni.

### [property:Boolean autoUpdate]

Indica se l'oggetto LOD viene aggiornato automaticamente dal renderer per frame o no. Se impostato a false, devi chiamare da solo [page:LOD.update]() nel ciclo di rendering. Il valore predefinito è true.

### [property:Boolean isLOD]

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

### [property:Array levels]

Un array di oggetti [page:Object level].
Ogni livello è un oggetto con due proprietà:
[page:Object3D object] - L'[page:Object3D] da visualizzare a questo livello.
[page:Float distance] - La distanza alla quale visualizzare questo livello di dettaglio.
[page:Float hysteresis] - Soglia utilizzata per evitare il flickering ai confini del LOD, come frazione della distanza.

## Metodi

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

### [method:this addLevel]( [param:Object3D object], [param:Float distance], [param:Float hysteresis] )

[page:Object3D object] - L'[page:Object3D] da visualizzare a questo livello.
[page:Float distance] - La distanza alla quale visualizzare questo livello di dettaglio.
[page:Float hysteresis] - Soglia utilizzata per evitare il flickering ai confini del LOD, come frazione della distanza. Il valore predefinito è 0.0.
Aggiunge una mesh che sarà visualizzata ad una certa distanza e maggiore. In genere, maggiore è la distanza, minore è il dettaglio sulla mesh.

### [method:LOD clone]()

Restituisce un clone di questo oggetto LOD e degli oggetti specifici della distanza ad esso associati.

### [method:Integer getCurrentLevel]()

Ottiene il livello LOD attivo attualmente. Come indice dell'array dei livelli.

### [method:Object3D getObjectForDistance]( [param:Float distance] )

Ottiene un riferimento al primo [page:Object3D] (mesh) che è maggiore della [page:Float distance].

### [method:undefined raycast]( [param:Raycaster raycaster], [param:Array intersects] )

Ottiene le intersezioni tra un [page:Ray] lanciato a questo LOD. [page:Raycaster.intersectObject] chiamerà questo metodo.

### [method:Object toJSON]( meta )

Crea una struttura JSON con i dettagli di questo oggetto LOD.

### [method:undefined update]( [param:Camera camera] )

Imposta la visibilità di ogni [page:Object3D oggetto] del [page:levels livello] in base alla distanza dalla [page:Camera telecamera].

## Source

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