From 72f207d265d2751d507bd28b7796e53b083c98cc Mon Sep 17 00:00:00 2001 From: Angela Busato Date: Sat, 13 Aug 2022 16:05:17 +0200 Subject: [PATCH 01/12] feat: add Audio italian version --- docs/api/it/audio/Audio.html | 267 +++++++++++++++++++++++++ docs/api/it/audio/AudioAnalyser.html | 98 +++++++++ docs/api/it/audio/AudioContext.html | 43 ++++ docs/api/it/audio/AudioListener.html | 123 ++++++++++++ docs/api/it/audio/PositionalAudio.html | 138 +++++++++++++ docs/list.json | 12 +- 6 files changed, 678 insertions(+), 3 deletions(-) create mode 100644 docs/api/it/audio/Audio.html create mode 100644 docs/api/it/audio/AudioAnalyser.html create mode 100644 docs/api/it/audio/AudioContext.html create mode 100644 docs/api/it/audio/AudioListener.html create mode 100644 docs/api/it/audio/PositionalAudio.html diff --git a/docs/api/it/audio/Audio.html b/docs/api/it/audio/Audio.html new file mode 100644 index 00000000000000..883ad06d819b66 --- /dev/null +++ b/docs/api/it/audio/Audio.html @@ -0,0 +1,267 @@ + + + + + + + + + + [page:Object3D] → + +

[name]

+ +

+ Crea un oggetto audio non posizionale (globale).

+ + Utilizza le [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API API Web Audio]. +

+ +

Codice di Esempio

+ + + // crea un AudioListener e aggiungilo alla camera + const listener = new THREE.AudioListener(); + camera.add( listener ); + + // crea una sorgente audio globale + const sound = new THREE.Audio( listener ); + + // carica un suono e impostalo come buffer dell'oggetto audio + const audioLoader = new THREE.AudioLoader(); + audioLoader.load( 'sounds/ambient.ogg', function( buffer ) { + sound.setBuffer( buffer ); + sound.setLoop( true ); + sound.setVolume( 0.5 ); + sound.play(); + }); + + +

Esempi

+ +

+ [example:webaudio_sandbox webaudio / sandbox ]
+ [example:webaudio_visualizer webaudio / visualizer ] +

+ +

Costruttore

+ + +

[name]( [param:AudioListener listener] )

+

+ listener — (obbligatorio) istanza [page:AudioListener AudioListener]. +

+ + +

Proprietà

+ +

[property:Boolean autoplay]

+

Indica se avviare la riproduzione automaticamente. Il valore predefinito è `false`.

+ +

[property:AudioContext context]

+

L'[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext] del [page:AudioListener listener] passato nel costruttore.

+ +

[property:Number detune]

+

Modifica l'intonazione, misurata in centesimi. +/- 100 è un semitono. +/- 1200 è un'ottava. Il valore predefinito è `0`.

+ +

[property:Array filters]

+

+ Rappresenta un'array di [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioNode AudioNode]. Può essere usato per applicare una varietà di + filtri low-order per creare effetti sonori più complessi. In molti casi, l'array contiene istanze di + [link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNode]. I filtri sono impostati tramite + [page:Audio.setFilter] o [page:Audio.setFilters]. +

+ +

[property:GainNode gain]

+

+ Un [link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode] creato usando + [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain](). +

+ +

[property:Boolean hasPlaybackControl]

+

+ Indica se la riproduzione può essere controllata usando i metodi [page:Audio.play play](), + [page:Audio.pause pause]() etc. Il valore di default è `true`. +

+ +

[property:Boolean isPlaying]

+

Indica se l'audio è attualmente in riproduzione.

+ +

[property:AudioListener listener]

+

Un riferimento all'oggetto listener di questo audio.

+ +

[property:Number playbackRate]

+

Velocità di riproduzione. Il valore predefinito è `1`.

+ +

[property:Number offset]

+

+ Un offset al momento in cui deve iniziare la riproduzione all'interno del buffer audio. + È uguale al parametro audio di [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). + Il valore predefinito è `0`. +

+ +

[property:Number duration]

+

+ Sovrascrive la durata dell'audio. È uguale al parametro `duration` di + [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). + Il valore predefinito è `undefined` per riprodurre l'intero buffer. +

+ +

[property:String source]

+

+ Un [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode AudioBufferSourceNode] creato + usando [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createBufferSource AudioContext.createBufferSource](). +

+ +

[property:String sourceType]

+

Il tipo di sorgente audio. Il valore predefinito è la stringa 'empty'.

+ +

[property:String type]

+

Stringa che denota il tipo, impostato ad 'Audio'.

+ + +

Metodi

+ +

[method:this connect]()

+

+ Permette di collegarsi all'[page:Audio.source]. Questo metodo viene utilizzato internamente + durante l'inizializzazione e durante l'impostazione/eliminazione dei filtri. +

+ +

[method:this disconnect]()

+

+ Permette di scollegarsi dall'[page:Audio.source]. Questo metodo viene utilizzato internamente + durante l'impostazione/eliminazione dei filtri. +

+ +

[method:Float getDetune]()

+

+ Restituisce il detuning dell'oscillazione in centesimi. +

+ +

[method:BiquadFilterNode getFilter]()

+

+ Restituisce il primo elemento dell'array [page:Audio.filters filters]. +

+ +

[method:Array getFilters]()

+

+ Restituisce l'array [page:Audio.filters filters]. +

+ +

[method:Boolean getLoop]()

+

+ Restituisce il valore di [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] + (se la riproduzione deve essere ripetuta). +

+ +

[method:GainNode getOutput]()

+

+ Restituisce il [page:Audio.gain gainNode]. +

+ +

[method:Float getPlaybackRate]()

+

+ Restituisce il valore di [page:Audio.playbackRate playbackRate]. +

+ +

[method:Float getVolume]( value )

+

+ Restituisce il volume corrente. +

+ +

[method:this play]( delay )

+

+ Se [page:Audio.hasPlaybackControl hasPlaybackControl] è impostato a true, inizia la riproduzione. +

+ +

[method:this pause]()

+

+ Se [page:Audio.hasPlaybackControl hasPlaybackControl] è impostato a true, mette in pausa la riproduzione. +

+ +

[method:undefined onEnded]()

+

+ Viene chiamato automaticamente quando la riproduzione termina. +

+ +

[method:this setBuffer]( audioBuffer )

+

+ Imposta la [page:Audio.source sorgente] su audioBuffer, e imposta il [page:Audio.sourceType sourceType] a 'buffer'.
+ Se la riproduzione è in [page:Audio.autoplay autoplay], avvia anche la riproduzione. +

+ +

[method:this setDetune]( [param:Float value] )

+

+ Definisce il detuning dell'oscillazione in centesimi. +

+ +

[method:this setFilter]( filter )

+

+ Applica un singolo filtro all'audio. +

+ +

[method:this setFilters]( [param:Array value] )

+

+ value - array di filtri.
+ Applica un array di filtri all'audio. +

+ +

[method:this setLoop]( [param:Boolean value] )

+

+ Imposta [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] a `value` + (se la riproduzione deve andare in loop). +

+ +

[method:this setLoopStart]( [param:Float value] )

+

+ Imposta [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loopStart source.loopStart] a `value`. +

+ +

[method:this setLoopEnd]( [param:Float value] )

+

+ Imposta [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loopEnd source.loopEnd] a `value`. +

+ +

[method:this setMediaElementSource]( mediaElement )

+

+ Applica l'oggetto passato come parametro, di tipo [link:https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement HTMLMediaElement], + come sorgente di questo audio.
+ Inoltre imposta [page:Audio.hasPlaybackControl hasPlaybackControl] a false. +

+ +

[method:this setMediaStreamSource]( mediaStream )

+

+ Applica l'oggetto passato come parametro, di tipo [link:https://developer.mozilla.org/en-US/docs/Web/API/MediaStream MediaStream], + come sorgente di questo audio.
+ Inoltre imposta [page:Audio.hasPlaybackControl hasPlaybackControl] a false. +

+ +

[method:this setNodeSource]( audioNode )

+

+ Imposta la [page:Audio.source sorgente] dell'audioBuffer, e imposta [page:Audio.sourceType sourceType] a 'audioNode'.
+ Inoltre imposta [page:Audio.hasPlaybackControl hasPlaybackControl] a false. +

+ +

[method:this setPlaybackRate]( [param:Float value] )

+

+ Se [page:Audio.hasPlaybackControl hasPlaybackControl] è abilitato, imposta il [page:Audio.playbackRate playbackRate] a `value`. +

+ +

[method:this setVolume]( [param:Float value] )

+

+ Imposta il volume. +

+ +

[method:this stop]()

+

+ Se [page:Audio.hasPlaybackControl hasPlaybackControl] è abilitato, ferma la riproduzione. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/audio/AudioAnalyser.html b/docs/api/it/audio/AudioAnalyser.html new file mode 100644 index 00000000000000..908c0b0e799e36 --- /dev/null +++ b/docs/api/it/audio/AudioAnalyser.html @@ -0,0 +1,98 @@ + + + + + + + + + +

[name]

+ +

+ Crea un oggetto AudioAnalyser, che utilizza un [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode] + per analizzare l'audio.

+ + Utilizza le [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API API Web Audio]. +

+ +

Codice di Esempio

+ + + // crea un AudioListener e aggiungilo alla camera + const listener = new THREE.AudioListener(); + camera.add( listener ); + + // crea una sorgente Audio + const sound = new THREE.Audio( listener ); + + // carica un suono e impostalo come buffer dell'oggetto Audio + const audioLoader = new THREE.AudioLoader(); + audioLoader.load( 'sounds/ambient.ogg', function( buffer ) { + sound.setBuffer( buffer ); + sound.setLoop(true); + sound.setVolume(0.5); + sound.play(); + }); + + // crea un AudioAnalyser, passando il suono e la fftSize desiderata + const analyser = new THREE.AudioAnalyser( sound, 32 ); + + // ottieni la frequenza media del suono + const data = analyser.getAverageFrequency(); + + +

Esempi

+ +

+ [example:webaudio_sandbox webaudio / sandbox ]
+ [example:webaudio_visualizer webaudio / visualizer ] +

+ +

Costruttore

+ + +

[name]( audio, [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize fftSize] )

+

+ Crea un nuovo [page:AudioAnalyser AudioAnalyser]. +

+ + +

Proprietà

+ +

[property:AnalyserNode analyser]

+

Un [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode] usato per analizzare l'audio.

+ +

[property:Integer fftSize]

+

+ Una potenza di due, non nulla, fino a 2048, che rappresenta la dimensione della FFT (Fast Fourier Transform) da utilizzare per determinare + il dominio della frequenza. Vedi [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize questa pagina] per maggiori dettagli. +

+ +

[property:Uint8Array data]

+

+ Un Uint8Array con dimensione determinata da [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/frequencyBinCount analyser.frequencyBinCount], + usata per contenere i dati di analisi. +

+ + +

Metodi

+ + +

[method:Uint8Array getFrequencyData]()

+

+ Utilizza il metodo [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/getByteFrequencyData getByteFrequencyData] delle API Web Audio. +

+ +

[method:Number getAverageFrequency]()

+

+ Ottieni la media della frequenza restituita dal metodo [page:AudioAnalyser.getFrequencyData getFrequencyData]. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/audio/AudioContext.html b/docs/api/it/audio/AudioContext.html new file mode 100644 index 00000000000000..8aafbdee21b1a9 --- /dev/null +++ b/docs/api/it/audio/AudioContext.html @@ -0,0 +1,43 @@ + + + + + + + + + + +

[name]

+ +

+ Contiene i metodi per impostare un [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext].

+ + Usato internamente dalle classi [page:AudioListener AudioListener] e [page:AudioLoader AudioLoader].

+ + Utilizza le [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API API Web Audio]. +

+ + + +

Metodi

+ +

[method:AudioContext getContext]()

+

+ Restituisce il valore della variabile `context` nell'ambito esterno, se definito, + altrimenti lo imposta in un nuovo [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext]. +

+ +

[method:AudioContext setContext]( [param:AudioContext value] )

+

+ Imposta la varibile `context` nell'ambito esterno su `value`. +

+ + +

Source

+ +

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

+ + diff --git a/docs/api/it/audio/AudioListener.html b/docs/api/it/audio/AudioListener.html new file mode 100644 index 00000000000000..04edb204bec0d2 --- /dev/null +++ b/docs/api/it/audio/AudioListener.html @@ -0,0 +1,123 @@ + + + + + + + + + + [page:Object3D] → + +

[name]

+ +

+ L'[name] rappresenta un [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioListener listener] virtuale di tutti + gli effetti audio posizionli e non posizionali nella scena.
+ Un'applicazione three.js di solito crea una singola istanza di [name]. È un parametro obbligatorio nel costruttore di + entità audio come [page:Audio Audio] e [page:PositionalAudio PositionalAudio].
+ In molti casi, l'oggetto listener è un figlio della camera. Quindi la trasformazione 3D della camera rappresenta + la trasformazione 3D del listener. +

+ +

Codice di Esempio

+ + + // crea un AudioListener e aggiungilo alla camera + const listener = new THREE.AudioListener(); + camera.add( listener ); + + // crea una sorgente audio globale + const sound = new THREE.Audio( listener ); + + // carica un suono e impostalo come buffer dell'oggetto Audio + const audioLoader = new THREE.AudioLoader(); + audioLoader.load( 'sounds/ambient.ogg', function( buffer ) { + sound.setBuffer( buffer ); + sound.setLoop(true); + sound.setVolume(0.5); + sound.play(); + }); + + +

Esempi

+ +

+ [example:webaudio_sandbox webaudio / sandbox ]
+ [example:webaudio_timing webaudio / timing ]
+ [example:webaudio_visualizer webaudio / visualizer ] +

+ +

Costruttore

+ + +

[name]( )

+

+ Crea un nuovo AudioListener. +

+ + +

Proprietà

+ +

[property:AudioContext context]

+

+ L'[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext] del [page:AudioListener listener] passato nel costruttore. +

+ +

[property:GainNode gain]

+

+ Un [link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode] creato + usando [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain](). +

+ +

[property:AudioNode filter]

+

Il valore predefinito è `null`.

+ +

[property:Number timeDelta]

+

+ Valore delta temporale delle entità audio. Usato nel contesto di + [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioParam/linearRampToValueAtTime AudioParam.linearRampToValueAtTimeDefault](). + Il valore di default è `0`. +

+ +

Metodi

+ + +

[method:GainNode getInput]()

+

+ Restituisce il [page:AudioListener.gain gainNode]. +

+ +

[method:this removeFilter]()

+

+ Imposta la proprietà [page:AudioListener.filter filter] a `null`. +

+ +

[method:AudioNode getFilter]()

+

+ Restituisce il valore della proprietà [page:AudioListener.filter filter]. +

+ +

[method:this setFilter]( [param:AudioNode value] )

+

+ Imposta la proprietà [page:AudioListener.filter filter] a `value`. +

+ +

[method:Float getMasterVolume]()

+

+ Restituisce il volume. +

+ +

[method:this setMasterVolume]( [param:Number value] )

+

+ Imposta il volume. +

+ + +

Source

+ +

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

+ + diff --git a/docs/api/it/audio/PositionalAudio.html b/docs/api/it/audio/PositionalAudio.html new file mode 100644 index 00000000000000..0839f488eba8a6 --- /dev/null +++ b/docs/api/it/audio/PositionalAudio.html @@ -0,0 +1,138 @@ + + + + + + + + + + [page:Object3D] → [page:Audio] → + +

[name]

+ +

+ Crea un oggetto audio posizionale.

+ + Utilizza le [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API API Web Audio]. +

+ +

Codice di Esempio

+ + + // crea un AudioListener e lo aggiunge alla camera + const listener = new THREE.AudioListener(); + camera.add( listener ); + + // crea l'oggetto PositionalAudio (passandogli il listener) + const sound = new THREE.PositionalAudio( listener ); + + // carica un suono e lo imposta come buffer dell'oggetto PositionalAudio + const audioLoader = new THREE.AudioLoader(); + audioLoader.load( 'sounds/song.ogg', function( buffer ) { + sound.setBuffer( buffer ); + sound.setRefDistance( 20 ); + sound.play(); + }); + + // crea un oggetto da cui riprodurre il suono + const sphere = new THREE.SphereGeometry( 20, 32, 16 ); + const material = new THREE.MeshPhongMaterial( { color: 0xff2200 } ); + const mesh = new THREE.Mesh( sphere, material ); + scene.add( mesh ); + + // infine aggiunge il suono alla mesh + mesh.add( sound ); + + +

Esempi

+ +

+ [example:webaudio_orientation webaudio / orientation ]
+ [example:webaudio_sandbox webaudio / sandbox ]
+ [example:webaudio_timing webaudio / timing ] +

+ +

Costruttore

+ +

[name]( [param:AudioListener listener] )

+

+ listener — (obbligatorio) istanza di [page:AudioListener AudioListener]. +

+ + +

Proprietà

+ +

+ Vedi la classe [page:Audio Audio] per le proprietà ereditate. +

+ +

[property:PannerNode panner]

+

+ Il [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode PannerNode] di PositionalAudio. +

+ + +

Metodi

+ +

+ Vedi la classe [page:Audio Audio] per i metodi ereditati. +

+ +

[method:PannerNode getOutput]()

+

+ Restituisce il [page:PositionalAudio.panner panner]. +

+ +

[method:Float getRefDistance]()

+

+ Restisuice il valore di [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/refDistance panner.refDistance]. +

+ +

[method:this setRefDistance]( [param:Float value] )

+

+ Imposta il valore di [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/refDistance panner.refDistance]. +

+ +

[method:Float getRolloffFactor]()

+

+ Restisuice il valore di [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/rolloffFactor panner.rolloffFactor]. +

+ +

[method:this setRolloffFactor]( [param:Float value] )

+

+ Imposta il valore di [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/rolloffFactor panner.rolloffFactor]. +

+ +

[method:String getDistanceModel]()

+

+ Restisuice il valore di [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/distanceModel panner.distanceModel]. +

+ +

[method:this setDistanceModel]( [param:String value] )

+

+ Imposta il valore di [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/distanceModel panner.distanceModel]. +

+ +

[method:Float getMaxDistance]()

+

+ Restisuice il valore di [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/maxDistance panner.maxDistance]. +

+ +

[method:this setMaxDistance]( [param:Float value] )

+

+ Imposta il valore di [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/maxDistance panner.maxDistance]. +

+ +

[method:this setDirectionalCone]( [param:Float coneInnerAngle], [param:Float coneOuterAngle], [param:Float coneOuterGain] )

+

+ Questo metodo può essere usato per trasformare un suono omnidirezionale in un [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode suono direzionale]. +

+ +

Source

+ +

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

+ + diff --git a/docs/list.json b/docs/list.json index a660cdc1254d43..4ecafa9791c0bf 100644 --- a/docs/list.json +++ b/docs/list.json @@ -1166,10 +1166,16 @@ "QuaternionKeyframeTrack": "api/it/animation/tracks/QuaternionKeyframeTrack", "StringKeyframeTrack": "api/it/animation/tracks/StringKeyframeTrack", "VectorKeyframeTrack": "api/it/animation/tracks/VectorKeyframeTrack" - } - - } + }, + "Audio": { + "Audio": "api/it/audio/Audio", + "AudioAnalyser": "api/it/audio/AudioAnalyser", + "AudioContext": "api/it/audio/AudioContext", + "AudioListener": "api/it/audio/AudioListener", + "PositionalAudio": "api/it/audio/PositionalAudio" + } + } }, "pt-br": { From 84643687c10f6d8307f35b5e862b29c03a1c5e40 Mon Sep 17 00:00:00 2001 From: Angela Busato Date: Thu, 18 Aug 2022 12:39:33 +0200 Subject: [PATCH 02/12] feat: add Cameras italian version --- docs/api/it/cameras/ArrayCamera.html | 55 +++++ docs/api/it/cameras/Camera.html | 86 ++++++++ docs/api/it/cameras/CubeCamera.html | 88 ++++++++ docs/api/it/cameras/OrthographicCamera.html | 146 +++++++++++++ docs/api/it/cameras/PerspectiveCamera.html | 214 ++++++++++++++++++++ docs/api/it/cameras/StereoCamera.html | 64 ++++++ docs/list.json | 11 +- 7 files changed, 663 insertions(+), 1 deletion(-) create mode 100644 docs/api/it/cameras/ArrayCamera.html create mode 100644 docs/api/it/cameras/Camera.html create mode 100644 docs/api/it/cameras/CubeCamera.html create mode 100644 docs/api/it/cameras/OrthographicCamera.html create mode 100644 docs/api/it/cameras/PerspectiveCamera.html create mode 100644 docs/api/it/cameras/StereoCamera.html diff --git a/docs/api/it/cameras/ArrayCamera.html b/docs/api/it/cameras/ArrayCamera.html new file mode 100644 index 00000000000000..8d8af654e99964 --- /dev/null +++ b/docs/api/it/cameras/ArrayCamera.html @@ -0,0 +1,55 @@ + + + + + + + + + + [page:Object3D] → [page:Camera] → [page:PerspectiveCamera] → + +

[name]

+ +

+ [name] può essere usato per renderizzare in modo efficiente una scena con un set predefinito di telecamere. + Questo è un aspetto importante delle prestazioni per il rendering delle scene VR.
+ Un'istanza di [name] ha sempre un array di telecamere secondarie. È obbligatorio definire per ogni telecamera secondaria la + proprietà `viewport` la quale determina la parte della finestra (viewport) che viene renderizzata con questa telecamera. +

+ +

Esempi

+ +

[example:webgl_camera_array camera / array ]

+ +

Costruttore

+ +

[name]( [param:Array array] )

+

+ Un array di telecamere. +

+ + +

Proprietà

+

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

+ +

[property:Array cameras]

+

+ Un array di telecamere. +

+ +

[property:Boolean isArrayCamera]

+

+ Flag di sola lettura per verificare se un dato oggetto è di tipo [name]. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/cameras/Camera.html b/docs/api/it/cameras/Camera.html new file mode 100644 index 00000000000000..47a912e245b75f --- /dev/null +++ b/docs/api/it/cameras/Camera.html @@ -0,0 +1,86 @@ + + + + + + + + + + [page:Object3D] → + +

[name]

+ +

+ Classe base astratta per telecamere. Questa classe dovrebbe essere sempre ereditata quando costruisci una nuova telecamera. +

+ + +

Costruttore

+ + +

[name]()

+

+ Crea una nuova [name]. Si noti che questa classe non intende essere chiamata direttamente; + invece, probabilmente vuoi utilizzare una [page:PerspectiveCamera] o una [page:OrthographicCamera]. +

+ + +

Proprietà

+

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

+ +

[property:Boolean isCamera]

+

+ Flag di sola lettura per verificare se un dato oggetto è di tipo [name]. +

+ +

[property:Layers layers]

+

+ I [page:Layers layers] di cui la telecamera è parte. Questa è una proprietà ereditata da + [page:Object3D].

+ + Gli oggetti devono condividere almeno un layer con la telecamera per essere visualizzati + quando il viewport della telecamera viene renderizzato. +

+ +

[property:Matrix4 matrixWorldInverse]

+

+ Questo è l'inverso di matrixWorld. MatrixWorld contiene la Matrix che contiene + la trasformazione del mondo della telecamera. +

+ +

[property:Matrix4 projectionMatrix]

+

Questa è la matrice che contiene la proiezione (projection).

+ +

[property:Matrix4 projectionMatrixInverse]

+

L'inverso di projectionMatrix.

+ + +

Metodi

+

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

+ +

[method:Camera clone]( )

+

+ Restituisce una nuova telecamera con le stesse proprietà di questa. +

+ +

[method:this copy]( [param:Camera source], [param:Boolean recursive] )

+

+ Copia le proprietà della telecamera source in questa. +

+ +

[method:Vector3 getWorldDirection]( [param:Vector3 target] )

+

+ [page:Vector3 target] — il risultato sarà copiato in questo Vector3.

+ + Restituisce un [page:Vector3] che rappresenta la direzione dello spazio del world in + cui la telecamera sta guardando. (Nota: Una telecamera guarda verso il basso sul suo asse z locale, negativo).

+

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/cameras/CubeCamera.html b/docs/api/it/cameras/CubeCamera.html new file mode 100644 index 00000000000000..02cda37cbcd50c --- /dev/null +++ b/docs/api/it/cameras/CubeCamera.html @@ -0,0 +1,88 @@ + + + + + + + + + + [page:Object3D] → + +

[name]

+ +

Crea 6 telecamere che eseguono il rendering su un [page:WebGLCubeRenderTarget].

+ +

Codice di Esempio

+ + + // Crea una destinazione di rendering del cubo + const cubeRenderTarget = new THREE.WebGLCubeRenderTarget( 128, { generateMipmaps: true, minFilter: THREE.LinearMipmapLinearFilter } ); + + // Crea una cube camera + const cubeCamera = new THREE.CubeCamera( 1, 100000, cubeRenderTarget ); + scene.add( cubeCamera ); + + // Crea una macchina + const chromeMaterial = new THREE.MeshLambertMaterial( { color: 0xffffff, envMap: cubeRenderTarget.texture } ); + const car = new THREE.Mesh( carGeometry, chromeMaterial ); + scene.add( car ); + + // Aggiorna il cube di destinazione del rendering + car.visible = false; + cubeCamera.position.copy( car.position ); + cubeCamera.update( renderer, scene ); + + // Renderizza la scena + car.visible = true; + renderer.render( scene, camera ); + + +

Esempi

+ +

+ [example:webgl_materials_cubemap_dynamic materials / cubemap / dynamic ] +

+ +

Costruttore

+ + +

[name]( [param:Number near], [param:Number far], [param:WebGLCubeRenderTarget renderTarget] )

+

+ near - La distanza vicina (near) di ritaglio.
+ far - La distanza lontana (far) di ritaglio.
+ renderTarget - La destinazione di rendering del target cube. +

+ +

+ Costruisce una CubeCamera che contiene 6 [page:PerspectiveCamera PerspectiveCamera] che eseguono + il rendering su un [page:WebGLCubeRenderTarget]. +

+ +

Proprietà

+

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

+ +

[property:WebGLCubeRenderTarget renderTarget]

+

+ La destinazione di rendering del target cube. +

+ +

Metodi

+

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

+ +

[method:undefined update]( [param:WebGLRenderer renderer], [param:Scene scene] )

+

+ renderer - L'attuale renderer WebGL
+ scene - La scena attuale +

+

+ Chiama questo metodo per aggiornare il [page:CubeCamera.renderTarget renderTarget]. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/cameras/OrthographicCamera.html b/docs/api/it/cameras/OrthographicCamera.html new file mode 100644 index 00000000000000..c57542a7b7e104 --- /dev/null +++ b/docs/api/it/cameras/OrthographicCamera.html @@ -0,0 +1,146 @@ + + + + + + + + + + [page:Object3D] → [page:Camera] → + +

[name]

+ +

+ Telecamera che utilizza la [link:https://en.wikipedia.org/wiki/Orthographic_projection proiezione ortografica].

+ + In questa modalità di proiezione, la dimensione di un oggetto nell'immagine visualizzata rimane costante indipendentemente + dalla sua distanza dalla telecamera.

+ + Questa telecamera, tra le altre cose, può essere utile per il rendering di scene 2D ed elementi della UI. +

+ +

Codice di Esempio

+ + + const camera = new THREE.OrthographicCamera( width / - 2, width / 2, height / 2, height / - 2, 1, 1000 ); + scene.add( camera ); + + +

Esempi

+ +

+ [example:webgl_camera camera ]
+ [example:webgl_interactive_cubes_ortho interactive / cubes / ortho ]
+ [example:webgl_materials_cubemap_dynamic materials / cubemap / dynamic ]
+ [example:webgl_postprocessing_advanced postprocessing / advanced ]
+ [example:webgl_postprocessing_dof2 postprocessing / dof2 ]
+ [example:webgl_postprocessing_godrays postprocessing / godrays ]
+ [example:webgl_rtt rtt ]
+ [example:webgl_shaders_tonemapping shaders / tonemapping ]
+ [example:webgl_shadowmap shadowmap ] +

+ +

Costruttore

+ + +

[name]( [param:Number left], [param:Number right], [param:Number top], [param:Number bottom], [param:Number near], [param:Number far] )

+

+ left — Piano sinistro del frustum della telecamera.
+ right — Piano destro del frustum della telecamera.
+ top — Piano superiore del frustum della telecamera.
+ bottom — Piano inferiore del frustum della telecamera.
+ near — Piano near del frustum della telecamera.
+ far — Piano far del frustum della telecamera.

+ + Queste proprietà insieme definiscono il [link:https://en.wikipedia.org/wiki/Viewing_frustum frustum visivo] della telecamera. +

+ + +

Proprietà

+

+ Vedi la classe base [page:Camera] per le proprietà comuni.
+ Si noti che dopo aver apportato modifiche alla maggior parte di queste proprietà + sarà necessario chiamare il metodo [page:OrthographicCamera.updateProjectionMatrix .updateProjectionMatrix] + affinché le modifiche abbiano effetto. +

+ +

[property:Float bottom]

+

Piano inferiore del frustum della telecamera.

+ +

[property:Float far]

+

+ Piano far del frustum della telecamera. Il valore predefinito è `2000`.

+ + Deve essere maggiore del valore corrente del piano [page:.near near]. +

+ +

[property:Boolean isOrthographicCamera]

+

+ Flag di sola lettura per verificare se un dato oggetto è di tipo [name]. +

+ +

[property:Float left]

+

Piano sinistro del frustum della telecamera.

+ +

[property:Float near]

+

+ Piano near del frustum della telecamera. Il valore predefinito è `0.1`.

+ + L'intervallo valido è tra `0` e il valore corrente del piano [page:.far far]. + Si noti che, diversamente dalla [page:PerspectiveCamera], `0` è un valore valido + per il piano near della OrthographicCamera. +

+ +

[property:Float right]

+

Piano destro del frustum della telecamera.

+ +

[property:Float top]

+

Piano superiore del frustum della telecamera.

+ +

[property:Object view]

+

Impostato da [page:OrthographicCamera.setViewOffset setViewOffset]. Il valore predefinito è `null`.

+ +

[property:number zoom]

+

Ottiene o imposta il fattore zoom della telecamera. Il valore predefinito è `1`.

+ +

Metodi

+

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

+ +

[method:undefined setViewOffset]( [param:Float fullWidth], [param:Float fullHeight], [param:Float x], [param:Float y], [param:Float width], [param:Float height] )

+

+ fullWidth — Larghezza totale dell'impostazione multiview
+ fullHeight — Altezza totale dell'impostazione multiview
+ x — Offset orizzontale della telecamera secondaria
+ y — Offset verticale della telecamera secondaria
+ width — Larghezza della telecamera secondaria
+ height — Altezza della telecamera secondaria

+ + Imposta un offset in un [link:https://en.wikipedia.org/wiki/Viewing_frustum frustum visivo] più ampio. + È utile per le configurazioni multi-window o multi-monitor/multi-machine. + Per un esempio di utilizzo, consultare [page:PerspectiveCamera.setViewOffset PerspectiveCamera]. +

+ +

[method:undefined clearViewOffset]()

+

+ Rimuove qualsiasi offset impostato dal metodo .setViewOffset. +

+ +

[method:undefined updateProjectionMatrix]()

+

+ Aggiorna la matrice di proiezione della telecamera. Deve essere chiamato dopo ogni modifica dei parametri. +

+ +

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

+

+ meta -- oggetto contenente metadati come texture o immagini nei discendenti degli oggetti.
+ Converte la fotocamera nel [link:https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4 formato JSON Object/Scene] di three.js. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/cameras/PerspectiveCamera.html b/docs/api/it/cameras/PerspectiveCamera.html new file mode 100644 index 00000000000000..fa241221f11fe2 --- /dev/null +++ b/docs/api/it/cameras/PerspectiveCamera.html @@ -0,0 +1,214 @@ + + + + + + + + + + [page:Object3D] → [page:Camera] → + +

[name]

+ +

+ Telecamera che utilizza la [link:https://en.wikipedia.org/wiki/Perspective_(graphical) proiezione prospettica].

+ + Questa modalità di proiezione è progettata per imitare il modo in cui l'occhio umano vede. È la proiezione + più comunemente utilizzata per il rendering di una scena 3D. +

+ +

Codice di Esempio

+ + + const camera = new THREE.PerspectiveCamera( 45, width / height, 1, 1000 ); + scene.add( camera ); + + +

Esempi

+ +

+ [example:webgl_animation_skinning_blending animation / skinning / blending ]
+ [example:webgl_animation_skinning_morph animation / skinning / morph ]
+ [example:webgl_effects_stereo effects / stereo ]
+ [example:webgl_interactive_cubes interactive / cubes ]
+ [example:webgl_loader_collada_skinning loader / collada / skinning ] +

+ +

Costruttore

+ +

[name]( [param:Number fov], [param:Number aspect], [param:Number near], [param:Number far] )

+

+ fov — Campo visivo verticale del frustum della telecamera.
+ aspect — Aspect ratio del frustum della telecamera.
+ near — Piano near del frustum della telecamera.
+ far — Piano far del frustum della telecamera.

+ + Queste proprietà insieme definiscono il [link:https://en.wikipedia.org/wiki/Viewing_frustum frustum visivo] della telecamera. +

+ + +

Proprietà

+

+ Vedi la classe base [page:Camera] per le proprietà comuni.
+ Si noti che dopo aver apportato modifiche alla maggior parte di queste proprietà + sarà necessario chiamare il metodo [page:PerspectiveCamera.updateProjectionMatrix .updateProjectionMatrix] + affinché le modifiche abbiano effetto. +

+ +

[property:Float aspect]

+

+ Aspect ratio del frustum della telecamera, di solito calcolato con la larghezza del canvas / l'altezza del canvas. + Il valore predefinito è `1` (canvas quadrato). +

+ +

[property:Float far]

+

+ Piano far del frustum della telecamera. Il valore predefinito è `2000`.

+ + Deve essere maggiore del valore corrente del piano [page:.near near]. +

+ +

[property:Float filmGauge]

+

+ Dimensioni della pellicola utilizzata per l'asse maggiore. Il valore predefinito è 35 (millimetri). + Questo parametro non influenza la matrice di proiezione a meno che .filmOffset non sia impostato su un valore diverso da zero. +

+ +

[property:Float filmOffset]

+

Offset orizzontale decentrato nella stessa unità di `.filmGauge`. Il valore predefinito è `0`.

+ +

[property:Float focus]

+

+ Distanza dell'oggetto utilizzata per la stereoscopia e gli effetti di profondità di campo. + Questo parametro non influenza la matrice di proiezione a meno che non venga utilizzata una [page:StereoCamera]. + Il valore predefinito è `10`. +

+ +

[property:Float fov]

+

Campo visivo verticale del frustum della telecamera, dal basso all'alto della vista, in gradi. Il valore predefinito è `50`.

+ +

[property:Boolean isPerspectiveCamera]

+

+ Flag di sola lettura che verifica se la telecamera è di tipo [name]. +

+ + +

[property:Float near]

+

+ Piano near del frustum della telecamera. Il valore predefinito è `0.1`.

+ + L'intervallo valido è tra `0` e il valore corrente del piano [page:.far far]. + Si noti che, diversamente dalla [page:OrthographicCamera], `0` non è un valore valido + per il piano near della PerspectiveCamera. +

+ +

[property:Object view]

+

+ Specifica la window del frustum o null. + Questo valore viene impostato utilizzando il metodo [page:PerspectiveCamera.setViewOffset .setViewOffset] + e cancellato utilizzando il metodo [page:PerspectiveCamera.clearViewOffset .clearViewOffset]. +

+ +

[property:number zoom]

+

Ottiene o imposta il fattore zoom della telecamera. Il valore predefinito è `1`.

+ + +

Metodi

+

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

+ +

[method:undefined clearViewOffset]()

+

Rimuove qualsiasi offset impostato dal metodo [page:PerspectiveCamera.setViewOffset .setViewOffset].

+ +

[method:Float getEffectiveFOV]()

+

Restituisce l'angolo verticale del campo visivo corrente in gradi considerando .zoom.

+ +

[method:Float getFilmHeight]()

+

+ Restituisce l'altezza dell'immagine sulla pellicola. Se .aspect è minore o uguale a uno + (formato verticale), il risultato è uguale a .filmGauge. +

+ +

[method:Float getFilmWidth]()

+

+ Restituisce la larghezza dell'immagine sulla pellicola. Se .aspect è maggiore o uguale ad uno (formato orizzontale), + il risultato è uguale a .filmGauge. +

+ +

[method:Float getFocalLength]()

+

Restituisce la lunghezza focale del .fov corrente rispetto a .filmGauge.

+ +

[method:undefined setFocalLength]( [param:Float focalLength] )

+

+ Imposta il valore FOV in base alla lunghezza focale rispetto al [page:PerspectiveCamera.filmGauge .filmGauge] corrente.

+ + Per impostazione predefinita, la lunghezza focale è specificata per una telecamera da 35mm (full frame). +

+ +

[method:undefined setViewOffset]( [param:Float fullWidth], [param:Float fullHeight], [param:Float x], [param:Float y], [param:Float width], [param:Float height] )

+

+ fullWidth — larghezza totale dell'impostazione multiview
+ fullHeight — altezza totale dell'impostazione multiview
+ x — offset orizzontale della telecamera secondaria
+ y — offset verticale della telecamera secondaria
+ width — larghezza della telecamera secondaria
+ height — altezza della telecamera secondaria

+

+ +

+ Imposta un offset in un frustum più ampio. È utile per le configurazioni multi-window o multi-monitor/multi-machine. +

+ +

+ Per esempio, se si dispone di 3x2 monitor e ogni monitor è un 1920x1080 e i monitor sono disposti in una griglia come questa:
+ + 

++---+---+---+
+| A | B | C |
++---+---+---+
+| D | E | F |
++---+---+---+
+
+ + allora per ogni monitor il metodo verrebbe chiamato in questo modo:
+ + const w = 1920; +const h = 1080; +const fullWidth = w * 3; +const fullHeight = h * 2; + +// A +camera.setViewOffset( fullWidth, fullHeight, w * 0, h * 0, w, h ); +// B +camera.setViewOffset( fullWidth, fullHeight, w * 1, h * 0, w, h ); +// C +camera.setViewOffset( fullWidth, fullHeight, w * 2, h * 0, w, h ); +// D +camera.setViewOffset( fullWidth, fullHeight, w * 0, h * 1, w, h ); +// E +camera.setViewOffset( fullWidth, fullHeight, w * 1, h * 1, w, h ); +// F +camera.setViewOffset( fullWidth, fullHeight, w * 2, h * 1, w, h ); + + + Si noti che non c'è motivo per cui i monitor debbano essere della stessa dimensione o in una griglia. +

+ +

[method:undefined updateProjectionMatrix]()

+

+ Aggiorna la matrice di proiezione della telecamera. Deve essere chiamato dopo ogni modifica dei parametri. +

+ +

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

+

+ meta -- oggetto contenente metadati come texture o immagini nei discendenti degli oggetti.
+ Converte la fotocamera nel [link:https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4 formato JSON Object/Scene] di three.js. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/cameras/StereoCamera.html b/docs/api/it/cameras/StereoCamera.html new file mode 100644 index 00000000000000..08675101a1b98b --- /dev/null +++ b/docs/api/it/cameras/StereoCamera.html @@ -0,0 +1,64 @@ + + + + + + + + + + +

[name]

+ +

+ Doppia telecamera [page:PerspectiveCamera PerspectiveCamera] utilizzata per effetti come + [link:https://en.wikipedia.org/wiki/Anaglyph_3D 3D Anaglyph] o [link:https://en.wikipedia.org/wiki/parallax_barrier Parallax Barrier]. +

+ +

Esempi

+ +

+ [example:webgl_effects_anaglyph effects / anaglyph ]
+ [example:webgl_effects_parallaxbarrier effects / parallaxbarrier ]
+ [example:webgl_effects_stereo effects / stereo ] +

+ +

Costruttore

+ +

[name]( )

+ +

Proprietà

+ +

[property:Float aspect]

+

Il valore predefinito è `1`.

+ +

[property:Float eyeSep]

+

Il valore predefinito è `0.064`.

+ +

[property:PerspectiveCamera cameraL]

+

+ Telecamera sinistra. È aggiunta al [page:Layers layer 1] - + anche gli oggetti che devono essere renderizzati dalla telecamera di sinistra devono + essere aggiunti a questo layer. +

+ +

[property:PerspectiveCamera cameraR]

+

+ Telecamera destra. È aggiunta al [page:Layers layer 2] - + anche gli oggetti che devono essere renderizzati dalla telecamera di destra devono + essere aggiunti a questo layer. + +

Metodi

+ +

[method:undefined update]( [param:PerspectiveCamera camera] )

+

+ Aggiorna le telecamere Stereo in base alla telecamera passata come parametro. +

+ +

Source

+ +

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

+ + diff --git a/docs/list.json b/docs/list.json index 4ecafa9791c0bf..442d63e30f16f6 100644 --- a/docs/list.json +++ b/docs/list.json @@ -1174,7 +1174,16 @@ "AudioContext": "api/it/audio/AudioContext", "AudioListener": "api/it/audio/AudioListener", "PositionalAudio": "api/it/audio/PositionalAudio" - } + }, + + "Telecamere": { + "ArrayCamera": "api/it/cameras/ArrayCamera", + "Camera": "api/it/cameras/Camera", + "CubeCamera": "api/it/cameras/CubeCamera", + "OrthographicCamera": "api/it/cameras/OrthographicCamera", + "PerspectiveCamera": "api/it/cameras/PerspectiveCamera", + "StereoCamera": "api/it/cameras/StereoCamera" + } } }, "pt-br": { From a6ac42b8032c2a2cdeaed8e73e17781ec5b7d763 Mon Sep 17 00:00:00 2001 From: Angela Busato Date: Mon, 22 Aug 2022 12:04:12 +0200 Subject: [PATCH 03/12] fix: remove error letter --- docs/api/en/constants/Core.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/en/constants/Core.html b/docs/api/en/constants/Core.html index 5cf0c97ce88308..a2e74b73091bc8 100644 --- a/docs/api/en/constants/Core.html +++ b/docs/api/en/constants/Core.html @@ -40,7 +40,7 @@

Color Spaces

linear transfer functions. Linear-sRGB is the working color space in three.js, used throughout most of the rendering process. RGB components found in three.js materials and shaders are in the Linear-sRGB color space. - D

+

For further background and usage, see Color management. From 6ae5d657da46be29db16794edadecf93eeb6b89e Mon Sep 17 00:00:00 2001 From: Angela Busato Date: Mon, 22 Aug 2022 12:05:09 +0200 Subject: [PATCH 04/12] feat: add Constants italian version --- docs/api/it/constants/Animation.html | 46 ++ .../it/constants/BufferAttributeUsage.html | 53 ++ docs/api/it/constants/Core.html | 80 +++ .../it/constants/CustomBlendingEquations.html | 66 +++ docs/api/it/constants/Materials.html | 159 +++++ docs/api/it/constants/Renderer.html | 72 +++ docs/api/it/constants/Textures.html | 561 ++++++++++++++++++ docs/list.json | 10 + 8 files changed, 1047 insertions(+) create mode 100644 docs/api/it/constants/Animation.html create mode 100644 docs/api/it/constants/BufferAttributeUsage.html create mode 100644 docs/api/it/constants/Core.html create mode 100644 docs/api/it/constants/CustomBlendingEquations.html create mode 100644 docs/api/it/constants/Materials.html create mode 100644 docs/api/it/constants/Renderer.html create mode 100644 docs/api/it/constants/Textures.html diff --git a/docs/api/it/constants/Animation.html b/docs/api/it/constants/Animation.html new file mode 100644 index 00000000000000..72471849748ce5 --- /dev/null +++ b/docs/api/it/constants/Animation.html @@ -0,0 +1,46 @@ + + + + + + + + + +

Costanti di Animazione

+ +

Modalità Loop

+ + +THREE.LoopOnce +THREE.LoopRepeat +THREE.LoopPingPong + + +

Modalità di Interpolazione

+ +THREE.InterpolateDiscrete +THREE.InterpolateLinear +THREE.InterpolateSmooth + + +

Modalità Ending

+ +THREE.ZeroCurvatureEnding +THREE.ZeroSlopeEnding +THREE.WrapAroundEnding + + +

Modalità di Animation Blend

+ +THREE.NormalAnimationBlendMode +THREE.AdditiveAnimationBlendMode + + +

Source

+ +

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

+ + diff --git a/docs/api/it/constants/BufferAttributeUsage.html b/docs/api/it/constants/BufferAttributeUsage.html new file mode 100644 index 00000000000000..54974effba443e --- /dev/null +++ b/docs/api/it/constants/BufferAttributeUsage.html @@ -0,0 +1,53 @@ + + + + + + + + + +

Costanti di utilizzo degli attributi del buffer

+ +

+ Le costanti di utilizzo possono essere utilizzate per fornire un suggerimento all'API su come verrà utilizzato l'attributo + del buffer della geometria per ottimizzare le prestazioni. +

+ +

Codice di Esempio

+ + + const geometry = new THREE.BufferGeometry(); + const positionAttribute = new THREE.BufferAttribute( array, 3 , false ); + positionAttribute.setUsage( THREE.DynamicDrawUsage ); + geometry.setAttribute( 'position', positionAttribute ); + + +

Esempi

+

[example:webgl_buffergeometry_drawrange materials / buffergeometry / drawrange ]

+ +

Utilizzo della Geometria

+ + THREE.StaticDrawUsage + THREE.DynamicDrawUsage + THREE.StreamDrawUsage + + THREE.StaticReadUsage + THREE.DynamicReadUsage + THREE.StreamReadUsage + + THREE.StaticCopyUsage + THREE.DynamicCopyUsage + THREE.StreamCopyUsage + + + Per informazioni più dettagliate su ciascuna di queste costanti consultare + [link:https://www.khronos.org/opengl/wiki/Buffer_Object#Buffer_Object_Usage questa documentazione di OpenGL]. + +

Source

+ +

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

+ + diff --git a/docs/api/it/constants/Core.html b/docs/api/it/constants/Core.html new file mode 100644 index 00000000000000..41e9da8d67930b --- /dev/null +++ b/docs/api/it/constants/Core.html @@ -0,0 +1,80 @@ + + + + + + + + + +

Costanti del Core

+ +

Numero di Revisione

+ + +THREE.REVISION + + +
+ L'attuale [link:https://github.com/mrdoob/three.js/releases numero di revisione] di three.js. +
+ +

Spazi Colore

+ +THREE.NoColorSpace +THREE.SRGBColorSpace +THREE.LinearSRGBColorSpace + +

+ [page:NoColorSpace] non definisce uno spazio colore specifico. +

+

+ [page:SRGBColorSpace] (“sRGB”) si riferisce allo spazio colore definito dal Rec. 709 + primari, punto di bianco D65 e funzioni di trasferimento sRGB non lineare. sRGB è lo spazio + colore predefinito nei CSS, e si trova spesso nelle palette dei colori e nei selettori di colore. + I colori espressi in esadecimale o in notazione CSS sono tipicamente nello spazio colore sRGB. +

+ +

+ [page:LinearSRGBColorSpace] (“Linear-sRGB”) si riferisce allo spazio colore sRGB (sopra) con + funzioni di trasferimento lineare. Linear-sRGB è lo spazio colore di lavoro in three.js, utilizzato + durante la maggior parte del processo di rendering. I componenti RGB presenti nei materiali, negli + shader in three.js si trovano nello spazio colore Linear-sRGB. +

+ +

+ Per ulteriori informazioni sul background e sull'utilizzo, consultare Gestione del colore. +

+ +

Pulsanti del Mouse

+ +THREE.MOUSE.LEFT +THREE.MOUSE.MIDDLE +THREE.MOUSE.RIGHT +THREE.MOUSE.ROTATE +THREE.MOUSE.DOLLY +THREE.MOUSE.PAN + +

+ Le costanti LEFT e ROTATE hanno lo stesso valore di base. + Le costanti MIDDLE e DOLLY hanno lo stesso valore di base. + Le costanti RIGHT e PAN hanno lo stesso valore di base. +

+ +

Azioni Touch

+ +THREE.TOUCH.ROTATE +THREE.TOUCH.PAN +THREE.TOUCH.DOLLY_PAN +THREE.TOUCH.DOLLY_ROTATE + + +

Source

+ +

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

+ + + + diff --git a/docs/api/it/constants/CustomBlendingEquations.html b/docs/api/it/constants/CustomBlendingEquations.html new file mode 100644 index 00000000000000..1d4eac7b6c338f --- /dev/null +++ b/docs/api/it/constants/CustomBlendingEquations.html @@ -0,0 +1,66 @@ + + + + + + + + + +

Costanti di equazioni di blending personalizzate

+ +

+ Funzionano con tutti i tipi di materiale. Impostare prima la modalità blending del materiale + su THREE.CustomBlending, poi impostare l'equazione di blending desiderata, il fattore sorgente + (Source Factor) e quello di destinazione (Destination Factor). +

+ +

Codice di Esempio

+ + + const material = new THREE.MeshBasicMaterial( {color: 0x00ff00} ); + material.blending = THREE.CustomBlending; + material.blendEquation = THREE.AddEquation; //default + material.blendSrc = THREE.SrcAlphaFactor; //default + material.blendDst = THREE.OneMinusSrcAlphaFactor; //default + + +

Esempi

+

[example:webgl_materials_blending_custom materials / blending / custom ]

+ +

Equazioni di Blending

+ + THREE.AddEquation + THREE.SubtractEquation + THREE.ReverseSubtractEquation + THREE.MinEquation + THREE.MaxEquation + + +

Fattori di Origine (Source Factors)

+ + THREE.ZeroFactor + THREE.OneFactor + THREE.SrcColorFactor + THREE.OneMinusSrcColorFactor + THREE.SrcAlphaFactor + THREE.OneMinusSrcAlphaFactor + THREE.DstAlphaFactor + THREE.OneMinusDstAlphaFactor + THREE.DstColorFactor + THREE.OneMinusDstColorFactor + THREE.SrcAlphaSaturateFactor + + +

Fattori di Destinazione (Destination Factors)

+

+ Tutti questi fattori di origine sono validi come fattori di destinazione ad eccezione di THREE.SrcAlphaSaturateFactor +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/constants/Materials.html b/docs/api/it/constants/Materials.html new file mode 100644 index 00000000000000..61133718e03214 --- /dev/null +++ b/docs/api/it/constants/Materials.html @@ -0,0 +1,159 @@ + + + + + + + + + +

Costanti dei Materiali

+ +

+ Queste costanti definiscono proprietà comuni per tutti i tipi di materiali, + ad eccezione di Texture Combine Operations che si applicano + solo ai materiali [page:MeshBasicMaterial.combine MeshBasicMaterial], + [page:MeshLambertMaterial.combine MeshLambertMaterial] e [page:MeshPhongMaterial.combine MeshPhongMaterial].
+

+ + +

Lato (Side)

+ + THREE.FrontSide + THREE.BackSide + THREE.DoubleSide + +

+ Definisce quale lato delle facce sarà visualizzato - frontale, retro o entrambi. + Il valore predefinito è [page:Constant FrontSide]. +

+ +

Modalità Blending

+ + THREE.NoBlending + THREE.NormalBlending + THREE.AdditiveBlending + THREE.SubtractiveBlending + THREE.MultiplyBlending + THREE.CustomBlending + + + +

+ Controllano le equazioni di blending di origine e di destinazione per RGB e Alpha del materiale, inviate a WebGLRenderer + per l'uso da parte di WebGL.
+ [page:Constant NormalBlending] è l'impostazione predefinita.
+ Si noti che [page:Constant CustomBlending] deve essere impostato per utilizzare le equazioni di blending personalizzate.
+ Vedi l'esempio [example:webgl_materials_blending materials / blending].
+

+ +

Modalità Depth

+ + THREE.NeverDepth + THREE.AlwaysDepth + THREE.EqualDepth + THREE.LessDepth + THREE.LessEqualDepth + THREE.GreaterEqualDepth + THREE.GreaterDepth + THREE.NotEqualDepth + +

+ La funzione di profondità (depth) utilizza il materiale per confrontare la Z-depth dei pixel in arrivo + con il valore del buffer della Z-depth. Se il risultato del confronto è vero, il pixel viene disegnato. + [page:Materials NeverDepth] non tornerà mai vero.
+ [page:Materials AlwaysDepth] tornerà sempre vero.
+ [page:Materials EqualDepth] tornerà vero se lo Z-depth dei pixel in ingresso è uguale all'attuale buffer Z-depth.
+ [page:Materials LessDepth] tornerà vero se lo Z-depth dei pixel in ingresso è minore dell'attuale buffer Z-depth.
+ [page:Materials LessEqualDepth] è il valore predefinito e ritornerà vero se lo Z-depth dei pixel in ingresso è minore o uguale dell'attuale buffer Z-depth.
+ [page:Materials GreaterEqualDepth] tornerà vero se lo Z-depth dei pixel in ingresso è maggiore o uguale dell'attuale buffer Z-depth.
+ [page:Materials GreaterDepth] tornerà vero se lo Z-depth dei pixel in ingresso è maggiore dell'attuale buffer Z-depth.
+ [page:Materials NotEqualDepth]tornerà vero se lo Z-depth dei pixel in ingresso è maggiore non è uguale all'attuale buffer Z-depth.
+

+ +

Texture Combine Operations

+ + THREE.MultiplyOperation + THREE.MixOperation + THREE.AddOperation + +

+ Definiscono come il risultato del colore della supercificie viene combinato con la mappa ambientale (se presente), + per i materiali [page:MeshBasicMaterial.combine MeshBasicMaterial], [page:MeshLambertMaterial.combine MeshLambertMaterial] + e [page:MeshPhongMaterial.combine MeshPhongMaterial].
+ [page:Constant MultiplyOperation] è l'impostazione predefinita e moltiplica la mappa di colore dell'ambiente con il colore della superficie.
+ [page:Constant MixOperation] utilizza la riflettività per miscelare i due colori.
+ [page:Constant AddOperation] aggiunge i due colori. +

+ +

Funzioni di Stencil

+ + THREE.NeverStencilFunc + THREE.LessStencilFunc + THREE.EqualStencilFunc + THREE.LessEqualStencilFunc + THREE.GreaterStencilFunc + THREE.NotEqualStencilFunc + THREE.GreaterEqualStencilFunc + THREE.AlwaysStencilFunc + +

+ Quale funzione di stencil utilizza il meteriale per determinare se eseguire o meno un'operazione di stencil.
+ [page:Materials NeverStencilFunc] non tornerà mai vero.
+ [page:Materials LessStencilFunc] tornerà vero se il valore di riferimento dello stencil è inferiore al valore dello stencil corrente.
+ [page:Materials EqualStencilFunc] tornerà vero se il valore di riferimento dello stencil è ugale al valore dello stencil corrente.
+ [page:Materials LessEqualStencilFunc] tornerà vero se il valore di riferimento dello stencil è minore o uguale al valore dello stencil corrente.
+ [page:Materials GreaterStencilFunc] tornerà vero se il valore di riferimento dello stencil è maggiore al valore dello stencil corrente.
+ [page:Materials NotEqualStencilFunc] tornerà vero se il valore di riferimento dello stencil non è uguale al valore dello stencil corrente.
+ [page:Materials GreaterEqualStencilFunc] tornerà vero se il valore di riferimento dello stencil è maggiore o uguale al valore dello stencil corrente.
+ [page:Materials AlwaysStencilFunc] tornerà sempre vero.
+

+ +

Operazioni di Stencil

+ + THREE.ZeroStencilOp + THREE.KeepStencilOp + THREE.ReplaceStencilOp + THREE.IncrementStencilOp + THREE.DecrementStencilOp + THREE.IncrementWrapStencilOp + THREE.DecrementWrapStencilOp + THREE.InvertStencilOp + +

+ Quale operazione di stencil eseguirà il materiale sul pixel del buffer di stencil se la funzione stencil fornita passa.
+ [page:Materials ZeroStencilOp] imposterà il valore dello stencil a 0.
+ [page:Materials KeepStencilOp] non cambierà il valore corrente dello stencil.
+ [page:Materials ReplaceStencilOp] sostituirà il valore dello stencil con il valore di riferimento dello stencil specificato.
+ [page:Materials IncrementStencilOp] incrementerà il valore corrente dello stencil di `1`.
+ [page:Materials DecrementStencilOp] decrementerà il valore corrente dello stencil di `1`.
+ [page:Materials IncrementWrapStencilOp] incrementerà il valore corrente dello stencil di `1`. Se il valore aumenta oltre 255, verrà impostato su `0`.
+ [page:Materials DecrementWrapStencilOp] incrementerà il valore corrente dello stencil di `1`. Se il valore diminusice al di sotto di `0` verrà impostato a `255`.
+ [page:Materials InvertStencilOp] eseguirà un'inversione di bit del valore dello stencil corrente.
+

+ +

Tipo Normal map

+ + THREE.TangentSpaceNormalMap + THREE.ObjectSpaceNormalMap + +

+ Definisce il tipo di mappa normale. + Per TangentSpaceNormalMap, le informazioni sono relative alla superficie sottostante. + Per ObjectSpaceNormalMap, le informazioni sono relative all'oggetto sottostante. + Il valore di default è [page:Constant TangentSpaceNormalMap]. +

+ +

GLSL Version

+ + THREE.GLSL1 + THREE.GLSL3 + + +

Source

+ +

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

+ + diff --git a/docs/api/it/constants/Renderer.html b/docs/api/it/constants/Renderer.html new file mode 100644 index 00000000000000..4a10d4391cad85 --- /dev/null +++ b/docs/api/it/constants/Renderer.html @@ -0,0 +1,72 @@ + + + + + + + + + +

Costanti WebGLRenderer

+ +

Modalità Cull Face

+ + THREE.CullFaceNone + THREE.CullFaceBack + THREE.CullFaceFront + THREE.CullFaceFrontBack + +

+ [page:constant CullFaceNone] disabilita il face culling.
+ [page:constant CullFaceBack] elimina le facce posteriori (predefinito).
+ [page:constant CullFaceFront] elimina le facce anteriori.
+ [page:constant CullFaceFrontBack] elimina entrambe le facce posteriori e anteriori. +

+ +

Tipi Shadow

+ + THREE.BasicShadowMap + THREE.PCFShadowMap + THREE.PCFSoftShadowMap + THREE.VSMShadowMap + +

+ Definiscono la proprietà [page:WebGLRenderer.shadowMap.type shadowMap.type] di WebGLRenderer.

+ + [page:constant BasicShadowMap] fornisce mappe shadow non filtrate - la più veloce, ma con qualità minore.
+ [page:constant PCFShadowMap] filtra le mappe shadow utilizzando l'algoritmo Percentage-Closer Filtering (PFC) (predefinito).
+ [page:constant PCFSoftShadowMap] filtra le mappe shadow utilizzando l'algoritmo Percentage-Closer Filtering (PFC) + con migliori soft shadow soprattutto quando si utilizzano mappe shadow a bassa risoluzione.
+ [page:constant VSMShadowMap] filtra le mappe shadow utilizzando l'algoritmo Variance Shadow Map (VSM). Quando si utilizza VSMShadowMap, + anche tutti i ricevitori shadow proiettano shadow.
+

+ +

Mappatura dei Toni

+ + THREE.NoToneMapping + THREE.LinearToneMapping + THREE.ReinhardToneMapping + THREE.CineonToneMapping + THREE.ACESFilmicToneMapping + THREE.CustomToneMapping + +

+ Definiscono la proprietà [page:WebGLRenderer.toneMapping toneMapping] di WebGLRenderer. + Viene utilizzato per approssimare l'aspetto della gamma dinamica (HDR) sul medio della + gamma dinamica bassa del monitor di un computer o dello schermo di un dispositivo mobile. +

+

+ THREE.LinearToneMapping, THREE.ReinhardToneMapping, THREE.CineonToneMapping e THREE.ACESFilmicToneMapping sono implementazioni + integrate della mappatura dei toni. + THREE.CustomToneMapping prevede un'implementazione personalizzata modificando il codice GLSL dello shader di frammenti del materiale. + Vedi l'esempio [example:webgl_tonemapping WebGL / tonemapping]. +

+ + +

Source

+ +

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

+ + diff --git a/docs/api/it/constants/Textures.html b/docs/api/it/constants/Textures.html new file mode 100644 index 00000000000000..092d89d9a5840c --- /dev/null +++ b/docs/api/it/constants/Textures.html @@ -0,0 +1,561 @@ + + + + + + + + + +

Constanti delle Texture

+ +

Modalità Mapping

+ + THREE.UVMapping + THREE.CubeReflectionMapping + THREE.CubeRefractionMapping + THREE.EquirectangularReflectionMapping + THREE.EquirectangularRefractionMapping + THREE.CubeUVReflectionMapping + + +

+ Definiscono la modalità di mapping della texture.
+ [page:Constant UVMapping] è la costante predefinita, e mappa la texture usando le coordinate UV della mesh.

+ + Il resto definisce i tipi di mappatura dell'ambiente.

+ + [page:Constant CubeReflectionMapping] e [page:Constant CubeRefractionMapping] sono da utilizzare con una [page:CubeTexture CubeTexture], + la quale è composta da sei texture, una per ciascuna faccia del cubo. + [page:Constant CubeReflectionMapping] è la predefinita per una [page:CubeTexture CubeTexture].

+ + [page:Constant EquirectangularReflectionMapping] e [page:Constant EquirectangularRefractionMapping] + sono da utilizzare con una equirectangular environment map. Anche chiamata lat-long map, una texture equirectangular + rappresenta una vista a 360 gradi lungo la linea centrale orizzontale e una vista a 180 lungo l'asse verticale, con i bordi + superiore e inferiore dell'immagine corrispondenti ai poli nord e sud di una sfera mappata.

+ + Vedi l'esempio [example:webgl_materials_envmaps materials / envmaps]. +

+ + +

Modalità Wrapping

+ + THREE.RepeatWrapping + THREE.ClampToEdgeWrapping + THREE.MirroredRepeatWrapping + +

+ Definiscono le proprietà [page:Texture.wrapS wrapS] e [page:Texture.wrapT wrapT] della texture, le quali + definiscono il wrapping orizzontale e verticale della texture.

+ + Con [page:constant RepeatWrapping] la texture sarà semplicemente ripetuta all'infinito.

+ + [page:constant ClampToEdgeWrapping] è la costante predefinita. + L'ultimo pixel della texture si estende fino al bordo della mesh.

+ + Con [page:constant MirroredRepeatWrapping] la texture sarà ripetuta all'infinito, rispecchiando ad ogni ripetizione. +

+ +

Filtri di Ingradimento

+ + THREE.NearestFilter + THREE.LinearFilter + + +

+ Da usare con la proprietà [page:Texture.magFilter magFilter] della texture, + definiscono la funzione di ingrandimento della texture da usare quando il pixel + da texturizzare mappa un'area inferiore o uguale a un elemento della texture (texel).

+ + [page:constant NearestFilter] restituisce il valore dell'elemento della texture che è più vicino + (nella distanza di Manhattan) alle coordinate della texture specificate.

+ + [page:constant LinearFilter] è l'impostazione predefinita e restituisce la media pesata dei quattro elementi della texture + più vicini alle coordinate della texture specificate e può includere elementi wrappati o ripetuti da altre parti della texture, + a seconda dei valori di [page:Texture.wrapS wrapS] e [page:Texture.wrapT wrapT], e dall'esatta mappatura. +

+ +

Filtri di Minificazione

+ + THREE.NearestFilter + THREE.NearestMipmapNearestFilter + THREE.NearestMipmapLinearFilter + THREE.LinearFilter + THREE.LinearMipmapNearestFilter + THREE.LinearMipmapLinearFilter + + +

+ Da usare con la proprietà [page:Texture.minFilter minFilter] della texture, + definiscono la funzione di minificazione della texture che viene usata ogni volta che il + pixel da texturizzare mappa un'area superiore di un elemento della texture (texel).

+ + Oltre a [page:constant NearestFilter] e [page:constant LinearFilter], + le seguenti quattro funzioni possono essere usate per la minificazione:

+ + [page:constant NearestMipmapNearestFilter] sceglie il mipmap che più si avvicina alle dimensioni del pixel da texturizzare + e utilizza il criterio [page:constant NearestFilter] (il texel più vicino al centro del pixel) per produrre + un valore di texture.

+ + [page:constant NearestMipmapLinearFilter] sceglie i due mipmap che più si avvicinano alle dimensioni del pixel da texturizzare + e utilizza il criterio [page:constant NearestFilter] per produrre un valore di texture per ogni mipmap. Il valore della texture finale + è una media pesata di questi due valori.

+ + [page:constant LinearMipmapNearestFilter] sceglie il mipmap che più si avvicina alle dimensioni del pixel da texturizzare + e utilizza il criterio [page:constant LinearFilter] ( una media pesata dei quattro texels che più si avvicinano al centro del pixel) per produrre + un valore di texture.

+ + [page:constant LinearMipmapLinearFilter] è l'impostazione predefinita e sceglie i due mipmap che più si avvicinano alle dimensioni del pixel da texturizzare + e utilizza il criterio [page:constant LinearFilter] per produrre un valore di texture per ogni mipmap. Il valore della texture finale è una + media pesata di questi due valori.

+ + Vedi l'esempio [example:webgl_materials_texture_filters materials / texture / filters] +

+ +

Tipi

+ + THREE.UnsignedByteType + THREE.ByteType + THREE.ShortType + THREE.UnsignedShortType + THREE.IntType + THREE.UnsignedIntType + THREE.FloatType + THREE.HalfFloatType + THREE.UnsignedShort4444Type + THREE.UnsignedShort5551Type + THREE.UnsignedInt248Type + +

+ Da usare con la proprietà [page:Texture.type type] della texture, la quale deve corrispondere al formato corretto. Vedi sotto per i dettagli.

+ + [page:constant UnsignedByteType] è l'impostazione predefinita. +

+ +

Formati

+ + THREE.AlphaFormat + THREE.RedFormat + THREE.RedIntegerFormat + THREE.RGFormat + THREE.RGIntegerFormat + THREE.RGBAFormat + THREE.RGBAIntegerFormat + THREE.LuminanceFormat + THREE.LuminanceAlphaFormat + THREE.DepthFormat + THREE.DepthStencilFormat + +

+ Da usare con la proprietà [page:Texture.format format] della texture, + definiscono come gli elementi di una texture 2d, o `texel`, vengono letti dagli shader.

+ + [page:constant AlphaFormat] elimina i componenti rosso, verde e blu e legge solo il componente alfa.

+ + [page:constant RedFormat] elimina i componenti verde e blu e legge solo il componente rosso.

+ + [page:constant RedIntegerFormat] elimina i componenti verde e blu e legge solo il componente rosso. + I texel sono letti come interi invece che come floating point. + (può essere utilizzato solo in un contesto di rendering WebGL 2).

+ + [page:constant RGFormat] elimina i componenti alfa e blu e legge i componenti rosso e verde. + (può essere utilizzato solo in un contesto di rendering WebGL 2).

+ + [page:constant RGIntegerFormat] elimina i componenti alfa e blu e legge i componenti rosso e verde. + I texel sono letti come numeri interi invece che come floating point. + (può essere utilizzato solo in un contesto di rendering WebGL 2).

+ + [page:constant RGBAFormat] è l'impostazione predefinita e legge i componenti rosso, verde, blu e alfa.

+ + [page:constant RGBAIntegerFormat] è l'impostazione di default e legge i componenti rosso, verde, blu e alfa. + I texel sono letti come numeri interi invece che come floating point. + (può essere utilizzato solo in un contesto di rendering WebGL 2).

+ + [page:constant LuminanceFormat] legge ogni elemento come un singolo componente di luminanza. + Questo viene quindi convertito in floating point, fissato all'intervallo [0,1], e quindi assemblato + in un elemento RGBA posizionando il valore di luminanza nei canali rosso, verde e blu, e allegando + 1.0 al canale alfa.

+ + [page:constant LuminanceAlphaFormat] legge ogni elemento come un doppio luminanza/alfa. Lo stesso processo si verifica + come per [page:constant LuminanceFormat], tranne per il fatto che il canale alfa può avere valori diversi da `1.0`.

+ + [page:constant DepthFormat] legge ogni elemento come un singolo valore depth, lo converte in floating point e si blocca + nell'intervallo [0,1]. Questa è l'impostazione predefinita per [page:DepthTexture DepthTexture].

+ + [page:constant DepthStencilFormat] legge ogni elemento come una coppia di valori depth e stencil. + Il componente depth della coppia viene interpretato come in [page:constant DepthFormat]. + Il componente stencil viene interpretato in base al formato interno depth + stencil.

+ + Si noti che la texture deve avere impostato il [page:Texture.type tipo] corretto, come descritto sopra. + Vedi [link:https://developer.mozilla.org/en/docs/Web/API/WebGLRenderingContext/texImage2D WebGLRenderingContext.texImage2D] + per maggiori dettagli. +

+ +

Formati Texture Compressi DDS / ST3C

+ + THREE.RGB_S3TC_DXT1_Format + THREE.RGBA_S3TC_DXT1_Format + THREE.RGBA_S3TC_DXT3_Format + THREE.RGBA_S3TC_DXT5_Format + +

+ Da usare con la prorietà [page:Texture.format formato] della [page:CompressedTexture CompressedTexture], + questi richiedono il supporto per l'estensione + [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_s3tc/ WEBGL_compressed_texture_s3tc].

+ + Questi sono quattro formati [link:https://en.wikipedia.org/wiki/S3_Texture_Compression S3TC] disponibili tramite questa estensione. Questi sono:
+ + [page:constant RGB_S3TC_DXT1_Format]: Un'immagine compressa DXT1 in un formato immagine RGB.
+ [page:constant RGBA_S3TC_DXT1_Format]: Un'immagine compressa DXT1 in un formato immagine RGBA con un semplice valore alfa on/off.
+ [page:constant RGBA_S3TC_DXT3_Format]: Un'immagine compressa DXT3 in un formato immagine RGBA. Comparato con una texture 32-bit, offre una compressione 4:1.
+ [page:constant RGBA_S3TC_DXT5_Format]: Un'immagine compressa DXT5 in un formato immagine RGBA. Anche questa costante permette una compressione 4:1, + ma differisce dalla compressione DXT3 nel modo in cui viene eseguita la compressione alfa.
+

+ +

Formati Texture Compressi PVRTC

+ + THREE.RGB_PVRTC_4BPPV1_Format + THREE.RGB_PVRTC_2BPPV1_Format + THREE.RGBA_PVRTC_4BPPV1_Format + THREE.RGBA_PVRTC_2BPPV1_Format + +

+ Da usare con la prorietà del [page:Texture.format formato] della [page:CompressedTexture CompressedTexture], + questi richiedono il supporto per l'estensione + [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_pvrtc/ WEBGL_compressed_texture_pvrtc].
+ + PVRTC è in genere disponibile solo su dispositivi mobili con chipset PowerVR, che sono principalmente dispositivi Apple.

+ + Questi sono quattro formati [link:https://en.wikipedia.org/wiki/PVRTC PVRTC] disponibili tramite questa estensione. Questi sono:
+ + [page:constant RGB_PVRTC_4BPPV1_Format]: compressione RGB in modalità 4-bit. un blocco per ogni pixel 4×4.
+ [page:constant RGB_PVRTC_2BPPV1_Format]: compressione RGB in modalità 2-bit. un blocco per ogni pixel 8×4.
+ [page:constant RGBA_PVRTC_4BPPV1_Format]: compressione RGBA in modalità 4-bit. un blocco per ogni pixel 4×4.
+ [page:constant RGBA_PVRTC_2BPPV1_Format]: compressione RGBA in modalità 2-bit. un blocco per ogni pixel 8×4.
+

+ +

Formati Texture Compressi ETC

+ + THREE.RGB_ETC1_Format + THREE.RGB_ETC2_Format + THREE.RGBA_ETC2_EAC_Format + +

+ Da usare con la prorietà del [page:Texture.format formato] della [page:CompressedTexture CompressedTexture], + questi richiedono il supporto per le estensioni + [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_etc1/ WEBGL_compressed_texture_etc1] (ETC1) o + [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_etc/ WEBGL_compressed_texture_etc] + (ETC2).

+

+ +

Formati Texture Compressi ASTC

+ + THREE.RGBA_ASTC_4x4_Format + THREE.RGBA_ASTC_5x4_Format + THREE.RGBA_ASTC_5x5_Format + THREE.RGBA_ASTC_6x5_Format + THREE.RGBA_ASTC_6x6_Format + THREE.RGBA_ASTC_8x5_Format + THREE.RGBA_ASTC_8x6_Format + THREE.RGBA_ASTC_8x8_Format + THREE.RGBA_ASTC_10x5_Format + THREE.RGBA_ASTC_10x6_Format + THREE.RGBA_ASTC_10x8_Format + THREE.RGBA_ASTC_10x10_Format + THREE.RGBA_ASTC_12x10_Format + THREE.RGBA_ASTC_12x12_Format + +

+ Da usare con la prorietà del [page:Texture.format formato] della [page:CompressedTexture CompressedTexture], + questi richiedono il supporto per l'estensione + [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_astc/ WEBGL_compressed_texture_astc].
+

+ +

Formato Texture Compresso BPTCt

+ + THREE.RGBA_BPTC_Format + +

+ Da usare con la prorietà del [page:Texture.format formato] della [page:CompressedTexture CompressedTexture], + questi richiedono il supporto per l'estensione + [link:https://www.khronos.org/registry/webgl/extensions/EXT_texture_compression_bptc/ EXT_texture_compression_bptc].
+

+ +

Formati Interni

+ + 'ALPHA' + 'RGB' + 'RGBA' + 'LUMINANCE' + 'LUMINANCE_ALPHA' + 'RED_INTEGER' + 'R8' + 'R8_SNORM' + 'R8I' + 'R8UI' + 'R16I' + 'R16UI' + 'R16F' + 'R32I' + 'R32UI' + 'R32F' + 'RG8' + 'RG8_SNORM' + 'RG8I' + 'RG8UI' + 'RG16I' + 'RG16UI' + 'RG16F' + 'RG32I' + 'RG32UI' + 'RG32F' + 'RGB565' + 'RGB8' + 'RGB8_SNORM' + 'RGB8I' + 'RGB8UI' + 'RGB16I' + 'RGB16UI' + 'RGB16F' + 'RGB32I' + 'RGB32UI' + 'RGB32F' + 'RGB9_E5' + 'SRGB8' + 'R11F_G11F_B10F' + 'RGBA4' + 'RGBA8' + 'RGBA8_SNORM' + 'RGBA8I' + 'RGBA8UI' + 'RGBA16I' + 'RGBA16UI' + 'RGBA16F' + 'RGBA32I' + 'RGBA32UI' + 'RGBA32F' + 'RGB5_A1' + 'RGB10_A2' + 'RGB10_A2UI' + 'SRGB8_ALPHA8' + 'DEPTH_COMPONENT16' + 'DEPTH_COMPONENT24' + 'DEPTH_COMPONENT32F' + 'DEPTH24_STENCIL8' + 'DEPTH32F_STENCIL8' + + +

+ Attenzione: la modifica di un formato interno di una texture avrà effetto solo + quando si utilizza un contesto di rendering WebGL 2.

+ + Da usare con la proprietà [page:Texture.internalFormat internalFormat] della texture, + definiscono come gli elementi della texture, o `toxel`, sono memorizzati nella GPU.

+ + [page:constant R8] memorizza il componente rosso su 8 bit.

+ + [page:constant R8_SNORM] memorizza il componente rosso su 8 bit. Il componenete viene archiviato come normalizzato.

+ + [page:constant R8I] memorizza il componente rosso su 8 bit. Il componenete viene archiviato come un intero.

+ + [page:constant R8UI] memorizza il componente rosso su 8 bit. Il componenete viene archiviato come un intero senza segno.

+ + [page:constant R16I] memorizza il componente rosso su 16 bit. Il componenete viene archiviato come un intero.

+ + [page:constant R16UI] memorizza il componente rosso su 16 bit. Il componenete viene archiviato come un intero senza segno.

+ + [page:constant R16F] memorizza il componente rosso su 16 bit. Il componenete viene archiviato come un floating point.

+ + [page:constant R32I] memorizza il componente rosso su 32 bit. Il componenete viene archiviato come un intero.

+ + [page:constant R32UI] memorizza il componente rosso su 32 bit.Il componenete viene archiviato come un intero senza segno.

+ + [page:constant R32F] memorizza il componente rosso su 32 bit. Il componenete viene archiviato come un floating point.

+ + [page:constant RG8] memorizza i componenti rosso e verde su 8 bit ciascuno.

+ + [page:constant RG8_SNORM] memorizza i componenti rosso e verde su 8 bit ciascuno. + Ogni componente viene archiviato come normalizzato. +

+ + [page:constant RG8I] memorizza i componenti rosso e verde su 8 bit ciascuno. + Ogni componente viene archiviato come un intero. +

+ + [page:constant RG8UI] memorizza i componenti rosso e verde su 8 bit ciascuno. + Ogni componente viene archiviato come un intero senza segno. +

+ + [page:constant RG16I] memorizza i componenti rosso e verde su 16 bit ciascuno. + Ogni componente viene archiviato come un intero. +

+ + [page:constant RG16UI] memorizza i componenti rosso e verde su 16 bit ciascuno. + Ogni componente viene archiviato come un intero senza segno. +

+ + [page:constant RG16F] memorizza i componenti rosso e verde su 16 bit ciascuno. + Ogni componente viene archiviato come un floating point. +

+ + [page:constant RG32I] memorizza i componenti rosso e verde su 32 bit ciascuno. + Ogni componente viene archiviato come un intero. +

+ + [page:constant RG32UI] memorizza i componenti rosso e verde su 32 bit ciascuno. + Ogni componente viene archiviato come un intero senza segno. +

+ + [page:constant RG32F] memorizza i componenti rosso e verde su 32 bit ciascuno. + Ogni componente viene archiviato come un floating point. +

+ + [page:constant RGB8] memorizza i componenti rosso, verde e blu su 8 bit ciascuno. +

+ + [page:constant RGB8_SNORM] memorizza i componenti rosso, verde e blu su 8 bit ciascuno. + Ogni componente viene archiviato come normalizzato. +

+ + [page:constant RGB8I] memorizza i componenti rosso, verde e blu su 8 bit ciascuno. + Ogni componente viene archiviato come un intero. +

+ + [page:constant RGB8UI] memorizza i componenti rosso, verde e blu su 8 bit ciascuno. + Ogni componente viene archiviato come un intero senza segno. +

+ + [page:constant RGB16I] memorizza i componenti rosso, verde e blu su 16 bit ciascuno. + Ogni componente viene archiviato come un intero. +

+ + [page:constant RGB16UI] memorizza i componenti rosso, verde e blu su 16 bit ciascuno. + Ogni componente viene archiviato come un intero senza segno. +

+ + [page:constant RGB16F] memorizza i componenti rosso, verde e blu su 16 bit ciascuno. + Ogni componente viene archiviato come un floating point +

+ + [page:constant RGB32I] memorizza i componenti rosso, verde e blu su 32 bit ciascuno. + Ogni componente viene archiviato come un intero. +

+ + [page:constant RGB32UI] memorizza i componenti rosso, verde e blu su 32 bit ciascuno. + Ogni componente viene archiviato come un intero senza segno. +

+ + [page:constant RGB32F] memorizza i componenti rosso, verde e blu su 32 bit ciascuno. + Ogni componente viene archiviato come un floating point +

+ + [page:constant R11F_G11F_B10F] memorizza i componenti rosso, verde e blu rispettivamente 11 bit, 11 bit, e 10bit. + Ogni componente viene archiviato come un floating point. +

+ + [page:constant RGB565] memorizza i componenti rosso, verde e blu rispettivamente su 5 bit, 6 bit, e 5 bit.

+ + [page:constant RGB9_E5] memorizza i componenti rosso, verde e blu su 9 bit ciascuno.

+ + [page:constant RGBA8] memorizza i componenti rosso, verde, blu e alfa su 8 bit ciascuno.

+ + [page:constant RGBA8_SNORM] memorizza i componenti rosso, verde, blu e alfa su 8 bit ciascuno. + Ogni componente viene archiviato come normalizzato. +

+ + [page:constant RGBA8I] memorizza i componenti rosso, verde, blu e alfa su 8 bit ciascuno. + Ogni componente viene archiviato come un intero. +

+ + [page:constant RGBA8UI] memorizza i componenti rosso, verde, blu e alfa su 8 bit ciascuno. + Ogni componente viene archiviato come un intero senza segno. +

+ + [page:constant RGBA16I] memorizza i componenti rosso, verde, blu e alfa su 16 bit ciascuno. + Ogni componente viene archiviato come un intero. +

+ + [page:constant RGBA16UI] memorizza i componenti rosso, verde, blu e alfa su 16 bit ciascuno. + Ogni componente viene archiviato come un intero senza segno. +

+ + [page:constant RGBA16F] memorizza i componenti rosso, verde, blu e alfa su 16 bit ciascuno. + Ogni componente viene archiviato come un floating point. +

+ + [page:constant RGBA32I] memorizza i componenti rosso, verde, blu e alfa su 32 bit ciascuno. + Ogni componente viene archiviato come un intero. +

+ + [page:constant RGBA32UI] memorizza i componenti rosso, verde, blu e alfa su 32 bit ciascuno. + Ogni componente viene archiviato come un intero senza segno. +

+ + [page:constant RGBA32F] memorizza i componenti rosso, verde, blu e alfa su 32 bit ciascuno. + Ogni componente viene archiviato come un floating point. +

+ + [page:constant RGB5_A1] memorizza i componenti rosso, verde, blu e alfa rispettivamente su 5 bit, 5 bit, 5 bit e 1 bit.

+ + [page:constant RGB10_A2] memorizza i componenti rosso, verde, blu e alfa rispettivamente su 10 bit, 10 bit, 10 bit e 2 bit.

+ + [page:constant RGB10_A2UI] memorizza i componenti rosso, verde, blu e alfa rispettivamente su 10 bit, 10 bit, 10 bit e 2 bit. + Ogni componente viene archiviato come un intero senza segno. +

+ + [page:constant SRGB8] memorizza i componenti rosso, verde e blu su 8 bit ciascuno.

+ + [page:constant SRGB8_ALPHA8] memorizza i componenti rosso, verde, blu e alfa su 8 bit ciascuno.

+ + [page:constant DEPTH_COMPONENT16] memorizza il componente depth su 16 bit.

+ + [page:constant DEPTH_COMPONENT24] memorizza il componente depth su 24 bit.

+ + [page:constant DEPTH_COMPONENT32F] memorizza il componente depth su 32 bit. Il componente viene archiviato come un floating point.

+ + [page:constant DEPTH24_STENCIL8] memorizza i componenti depth e stencil rispettivamente su 24 bit e 8 bit. + Il componente stencil viene archiviato come un intero senza segno. +

+ + [page:constant DEPTH32F_STENCIL8] memorizza i componenti depth e stencil rispettivamente su 32 bit e 8 bit. + Il componente depth viene archiviato come un floating point, il componente stencil viene archiviato come un intero senza segno. +

+ + Si noti che la texture deve avere impostato il corretto [page:Texture.type tipo], + come anche il [page:Texture.format formato] corretto. + + Vedi [link:https://developer.mozilla.org/en/docs/Web/API/WebGLRenderingContext/texImage2D WebGLRenderingContext.texImage2D], e + [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGL2RenderingContext/texImage3D WebGL2RenderingContext.texImage3D], + per maggiori informazioni relativamente alle possibili combinazioni del [page:Texture.format formato], dell'[page:Texture.internalFormat internalFormat], + e del [page:Texture.type tipo].

+ + Per informazioni più approfondite sui formati interni, puoi anche fare riferimento direttamente alla + [link:https://www.khronos.org/registry/webgl/specs/latest/2.0/ Specifica WebGL2] e alla + [link:https://www.khronos.org/registry/OpenGL/specs/es/3.0/es_spec_3.0.pdf Specifica OpenGL ES 3.0]. +

+ +

Encoding

+ + THREE.LinearEncoding + THREE.sRGBEncoding + THREE.BasicDepthPacking + THREE.RGBADepthPacking + +

+ Da usare con la proprietà [page:Texture.encoding encoding] della Texture.

+ + Se il tipo di encoding viene modificato dopo che la texture è già stata utilizzata dal materiale, + sarà necessario impostare il valore [page:Material.needsUpdate Material.needsUpdate] a `true` per fare in modo + che il materiale venga ricompilato.

+ + [page:constant LinearEncoding] è l'impostazione predefinita. + Valori diversi da questo sono validi solo per la mappa di un materiale, envMap ed emissiveMap. +

+ +

Source

+ +

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

+ + diff --git a/docs/list.json b/docs/list.json index 442d63e30f16f6..a4bfdc8db2108b 100644 --- a/docs/list.json +++ b/docs/list.json @@ -1183,6 +1183,16 @@ "OrthographicCamera": "api/it/cameras/OrthographicCamera", "PerspectiveCamera": "api/it/cameras/PerspectiveCamera", "StereoCamera": "api/it/cameras/StereoCamera" + }, + + "Costanti": { + "Animazione": "api/it/constants/Animation", + "Core": "api/it/constants/Core", + "CustomBlendingEquation": "api/it/constants/CustomBlendingEquations", + "BufferAttributeUsage": "api/it/constants/BufferAttributeUsage", + "Materiali": "api/it/constants/Materials", + "Renderer": "api/it/constants/Renderer", + "Texture": "api/it/constants/Textures" } } }, From fd4172c1c76fd9a32355fef1428235fa143f81ed Mon Sep 17 00:00:00 2001 From: Angela Busato Date: Fri, 26 Aug 2022 17:17:18 +0200 Subject: [PATCH 05/12] feat: add Core italian version --- docs/api/en/core/InterleavedBuffer.html | 2 +- docs/api/it/core/BufferAttribute.html | 236 +++++++++ docs/api/it/core/BufferGeometry.html | 319 +++++++++++ docs/api/it/core/Clock.html | 82 +++ docs/api/it/core/EventDispatcher.html | 97 ++++ docs/api/it/core/GLBufferAttribute.html | 115 ++++ .../api/it/core/InstancedBufferAttribute.html | 43 ++ docs/api/it/core/InstancedBufferGeometry.html | 48 ++ .../it/core/InstancedInterleavedBuffer.html | 44 ++ docs/api/it/core/InterleavedBuffer.html | 116 ++++ .../it/core/InterleavedBufferAttribute.html | 125 +++++ docs/api/it/core/Layers.html | 105 ++++ docs/api/it/core/Object3D.html | 500 ++++++++++++++++++ docs/api/it/core/Raycaster.html | 217 ++++++++ docs/api/it/core/Uniform.html | 274 ++++++++++ .../BufferAttributeTypes.html | 65 +++ docs/list.json | 21 + 17 files changed, 2408 insertions(+), 1 deletion(-) create mode 100644 docs/api/it/core/BufferAttribute.html create mode 100644 docs/api/it/core/BufferGeometry.html create mode 100644 docs/api/it/core/Clock.html create mode 100644 docs/api/it/core/EventDispatcher.html create mode 100644 docs/api/it/core/GLBufferAttribute.html create mode 100644 docs/api/it/core/InstancedBufferAttribute.html create mode 100644 docs/api/it/core/InstancedBufferGeometry.html create mode 100644 docs/api/it/core/InstancedInterleavedBuffer.html create mode 100644 docs/api/it/core/InterleavedBuffer.html create mode 100644 docs/api/it/core/InterleavedBufferAttribute.html create mode 100644 docs/api/it/core/Layers.html create mode 100644 docs/api/it/core/Object3D.html create mode 100644 docs/api/it/core/Raycaster.html create mode 100644 docs/api/it/core/Uniform.html create mode 100644 docs/api/it/core/bufferAttributeTypes/BufferAttributeTypes.html diff --git a/docs/api/en/core/InterleavedBuffer.html b/docs/api/en/core/InterleavedBuffer.html index 3f20313cf537b0..4f9fb0b0137f1d 100644 --- a/docs/api/en/core/InterleavedBuffer.html +++ b/docs/api/en/core/InterleavedBuffer.html @@ -84,7 +84,7 @@

[method:this copyAt]( [param:Integer index1], [param:InterleavedBuffer attri

[method:this set]( [param:TypedArray value], [param:Integer offset] )

value - The source (typed) array.
- offset - The offset into the target array at which to begin writing values from the source array. Default is .

+ offset - The offset into the target array at which to begin writing values from the source array. Default is `0`.

Stores multiple values in the buffer, reading input values from a specified array.

diff --git a/docs/api/it/core/BufferAttribute.html b/docs/api/it/core/BufferAttribute.html new file mode 100644 index 00000000000000..b9e44a7ee18827 --- /dev/null +++ b/docs/api/it/core/BufferAttribute.html @@ -0,0 +1,236 @@ + + + + + + + + + +

[name]

+ +

+ Questa classe memorizza i dati per un attributo (come le posizioni dei vertici, gli indici delle facce, le normali, + i colori, le coordinate UV e alcuni attributi personalizzati) associato ad una [page:BufferGeometry], + che consente un passaggio più efficiente dei dati alla GPU. Consulta questa pagina per i dettagli ed un esempo di + utilizzo. Quando si lavora con dati di tipo vettoriale, i metodi helper .fromBufferAttribute( attribute, index ) + sulle classi [page:Vector2.fromBufferAttribute Vector2], + [page:Vector3.fromBufferAttribute Vector3], + [page:Vector4.fromBufferAttribute Vector4] e [page:Color.fromBufferAttribute Color] possono essere utili. +

+ +

Costruttore

+

[name]( [param:TypedArray array], [param:Integer itemSize], [param:Boolean normalized] )

+

+ [page:TypedArray array] -- Deve essere un [link:https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/TypedArray TypedArray]. + Utilizzato per istanziare il buffer.
+ Questo array dovrebbe avere gli elementi itemSize * numVertices + dove numVertices è il numero di vertici della [page:BufferGeometry BufferGeometry] associata.

+ + [page:Integer itemSize] -- il numero di valori dell'array che deve essere associato ad un particolare vertice. + Per esempio, se questo atttibuto memorizza un vettore a 3 componenti (come posizione, normale o colore), + itemSize dovrebbe essere 3.

+ + [page:Boolean normalized] -- (opzionale) Si applica solo ai dati interi. Indica il modo in cui i dati sottostanti + del buffer si adattano ai valori del codice GLSL. Ad esempio, se l'[page:TypedArray array] è un'istanza di UInt16Array, + e [page:Boolean normalized] è a true, i valori `0 - +65535` nei dati dell'array saranno mappati su 0.0f - +1.0f nell'attributo GLSL. + Un Int16Array (con segno) sarà mappato da -32768 - +32767 a -1.0f - +1.0f. Se [page:Boolean normalized] è a false, i valori + verranno convertiti in float non modificati, p.e. 32767 diventa 32767.0f. +

+ +

Proprietà

+ +

[property:TypedArray array]

+

+ L'[page:TypedArray array] contente i dati memorizzati nel buffer. +

+ +

[property:Integer count]

+

+ Memorizza la lunghezza dell'[page:BufferAttribute.array array] divisa per [page:BufferAttribute.itemSize itemSize].

+ + Se il buffer memorizza un vettore a 3 componenti (come una posizione, una normale o un colore), + questo conterà il numero dei vettori memorizzati. +

+ +

[property:Boolean isBufferAttribute]

+

+ Flag di sola lettura per verificare se un dato oggetto è di tipo [name]. +

+ +

[property:Integer itemSize]

+

+ La lunghezza dei vettori che vengono memorizzati nell'[page:BufferAttribute.array array]. +

+ +

[property:String name]

+

+ Un nome opzionale per questa istanza dell'attributo. Il valore predefinito è una stringa vuota. +

+ +

[property:Boolean needsUpdate]

+

+ Flag che indica che questo attributo è stato modificato e deve essere rinviato alla GPU. + Impostalo a true quando modifichi il valore dell'array.

+ + Impostando questa proprietà a true incrementa, inoltre, la [page:BufferAttribute.version versione]. +

+ +

[property:Boolean normalized]

+

+ Indica il modo in cui i dati sottostanti del buffer si adattano ai valori del codice shader GLSL. + Vedi il costruttore sopra per i dettagli. +

+ +

[property:Function onUploadCallback]

+

+ Una funzione di callback che viene eseguita dopo che il Renderer ha trasferito i dati dell'array dell'attributo + alla GPU. +

+ +

[property:Object updateRange]

+

Oggetto contenente:
+ [page:Integer offset]: Il valore predefinito è `0`. Posizione da cui inizia l'aggiornamento.
+ [page:Integer count]: Il valore predefinito è `-1`, il che significa non utilizzare intervalli di aggiornamento.

+ + Può essere utilizzato solo per aggiornare alcuni componenti dei vettori memorizzati (per esempio, solo + il componente relativo al colore). +

+ +

[property:Usage usage]

+

+ Definisce il modello di utilizzo previsto per l'archivio dati a fini di ottimizzazione. Corrisponde al paramentro `usage` + di [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/bufferData WebGLRenderingContext.bufferData](). + Il valore predefinito è [page:BufferAttributeUsage StaticDrawUsage]. Vedi le [page:BufferAttributeUsage costanti] di utilizzo + per tutti i valori possibili.

+ + Nota: Dopo l'utilizzo iniziale di un buffer, il suo utilizzo non può essere modificato. Invece, istanziane uno nuovo e imposta + l'utilizzo desiderato prima del rendering successivo. +

+ +

[property:Integer version]

+

+ Un numero di versione, incrementato ogni volta che la proprietà [page:BufferAttribute.needsUpdate needsUpdate] viene impostata a true. +

+ +

Metodi

+ +

[method:this applyMatrix3]( [param:Matrix3 m] )

+

+ Applica la matrice [page:Matrix3 m] ad ogni elemento Vector3 di questo BufferAttribute. +

+ +

[method:this applyMatrix4]( [param:Matrix4 m] )

+

+ Applica la matrice [page:Matrix4 m] ad ogni elemento Vector3 di questo BufferAttribute. +

+ +

[method:this applyNormalMatrix]( [param:Matrix3 m] )

+

+ Applica la matrice normale [page:Matrix3 m] ad ogni elemento Vector3 di questo BufferAttribute. +

+ +

[method:this transformDirection]( [param:Matrix4 m] )

+

+ Applica la matrice [page:Matrix4 m] ad ogni elemento Vector3 di questo BufferAttribute, interpretando gli elementi come vettori direzionali. +

+ +

[method:BufferAttribute clone]()

+

Restituisce una copia di questo bufferAttribute.

+ +

[method:this copy]( [param:BufferAttribute bufferAttribute] )

+

Copia un altro BufferAttribute in questo BufferAttribute.

+ +

[method:this copyArray]( array )

+

+ Copia l'array fornito qui (il quale può essere un normale array o un array tipizzato) + nell'[page:BufferAttribute.array array].

+ + Vedi [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/set TypedArray.set] + per le note sui requisiti se si copia un TypedArray. +

+ +

[method:this copyAt] ( [param:Integer index1], [param:BufferAttribute bufferAttribute], [param:Integer index2] )

+

Copia un vettore da bufferAttribute[index2] a [page:BufferAttribute.array array][index1].

+ +

[method:this copyColorsArray]( [param:Array colors] )

+

Copia un array che rappresenta i valori dei colori RGB nell'[page:BufferAttribute.array array].

+ +

[method:this copyVector2sArray]( [param:Array vectors] )

+

Copia un array che rappresenta [page:Vector2]s nell'[page:BufferAttribute.array array].

+ +

[method:this copyVector3sArray]( [param:Array vectors] )

+

Copia un array che rappresenta [page:Vector3]s nell'[page:BufferAttribute.array array].

+ +

[method:this copyVector4sArray]( [param:Array vectors] )

+

Copia un array che rappresenta [page:Vector4]s nell'[page:BufferAttribute.array array].

+ +

[method:Number getX]( [param:Integer index] )

+

Restituisce il componente x del vettore in corrispondenza dell'indice specificato.

+ +

[method:Number getY]( [param:Integer index] )

+

Restituisce il componente y del vettore in corrispondenza dell'indice specificato.

+ +

[method:Number getZ]( [param:Integer index] )

+

Restituisce il componente z del vettore in corrispondenza dell'indice specificato.

+ +

[method:Number getW]( [param:Integer index] )

+

Restituisce il componente w del vettore in corrispondenza dell'indice specificato.

+ +

[method:this onUpload]( [param:Function callback] )

+

+ Imposta il valore della proprietà onUploadCallback.

+ Nel [example:webgl_buffergeometry WebGL / Buffergeometry] questo metodo viene utilizzato per + liberare memoria dopo che il buffer è stato trasferito alla GPU. +

+ +

[method:this set] ( [param:Array value], [param:Integer offset] )

+

+ value -- un [page:Array] o [page:TypedArray] dal quale copiare i valori.
+ offset -- (opzionale) indice dell'[page:BufferAttribute.array array] da cui iniziare la copia.

+ + Chiama [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/set TypedArray.set]( [page:Array value], [page:Integer offset] ) + sull'[page:BufferAttribute.array array].

+ + In particolare, si veda questa pagina per i requisiti sul [page:Array value] + che deve essere un [page:TypedArray]. +

+ +

[method:this setUsage] ( [param:Usage value] )

+

+ Imposta [page:BufferAttribute.usage usage] a value. Vedi le [page:BufferAttributeUsage costanti] di utilizzo per tutti i possibili valori di input.

+ + Nota: Dopo l'utilizzo iniziale di un buffer, il suo utilizzo non può cambiare. Invece, istanziane uno nuovo e + imposta l'utilizzo desiderato prima del rendering successivo. +

+ +

[method:this setX]( [param:Integer index], [param:Float x] )

+

Imposta il componente x del vettore in corrispondenza dell'indice specificato.

+ +

[method:this setY]( [param:Integer index], [param:Float y] )

+

Imposta il componente y del vettore in corrispondenza dell'indice specificato.

+ +

[method:this setZ]( [param:Integer index], [param:Float z] )

+

Imposta il componente z del vettore in corrispondenza dell'indice specificato.

+ +

[method:this setW]( [param:Integer index], [param:Float w] )

+

Imposta il componente w del vettore in corrispondenza dell'indice specificato.

+ +

[method:this setXY]( [param:Integer index], [param:Float x], [param:Float y] )

+

Imposta i componenti x e y del vettore in corrispondenza dell'indice specificato.

+ +

[method:this setXYZ]( [param:Integer index], [param:Float x], [param:Float y], [param:Float z] )

+

Imposta i componenti x, y e z del vettore in corrispondenza dell'indice specificato.

+ +

[method:this setXYZW]( [param:Integer index], [param:Float x], [param:Float y], [param:Float z], [param:Float w] )

+

Imposta i componenti x, y, z e w del vettore in corrispondenza dell'indice specificato.

+ + + +

Source

+ +

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

+ + diff --git a/docs/api/it/core/BufferGeometry.html b/docs/api/it/core/BufferGeometry.html new file mode 100644 index 00000000000000..afbff71ae75de7 --- /dev/null +++ b/docs/api/it/core/BufferGeometry.html @@ -0,0 +1,319 @@ + + + + + + + + + +

[name]

+ +

+ Una rappresentazione della geometria di mesh, di linee o di punti. Include posizioni di vertici, indici della faccia, + normali, colori, coordinate UV, e attributi personalizzati all'interno dei buffer, riducendo il costo del passaggio + di tutti questi dati alla GPU. +

+

+ Per leggere e modificare dati negli attributi della BufferGeometry, vedi la documentazione di [page:BufferAttribute]. +

+ +

Codice di Esempio

+ + const geometry = new THREE.BufferGeometry(); + // crea una semplice figura quadrata. Duplichiamo i vertici top left e bottom right + // perché ogni vertice ha bisogno di apparire una volta per triangolo. + const vertices = new Float32Array( [ + -1.0, -1.0, 1.0, + 1.0, -1.0, 1.0, + 1.0, 1.0, 1.0, + + 1.0, 1.0, 1.0, + -1.0, 1.0, 1.0, + -1.0, -1.0, 1.0 + ] ); + + // itemSize = 3 perché ci osno 3 valori (componenti) per vertice + geometry.setAttribute( 'position', new THREE.BufferAttribute( vertices, 3 ) ); + const material = new THREE.MeshBasicMaterial( { color: 0xff0000 } ); + const mesh = new THREE.Mesh( geometry, material ); + + +

Esempi

+

+ [example:webgl_buffergeometry Mesh with non-indexed faces]
+ [example:webgl_buffergeometry_indexed Mesh with indexed faces]
+ [example:webgl_buffergeometry_lines Lines]
+ [example:webgl_buffergeometry_lines_indexed Indexed Lines]
+ [example:webgl_buffergeometry_custom_attributes_particles Particles]
+ [example:webgl_buffergeometry_rawshader Raw Shaders] +

+ +

Costruttore

+ + +

[name]()

+
+ Crea un nuovo [name]. Inoltre imposta alcune proprietà al valore predefinito. +
+ + +

Proprietà

+ +

[property:Object attributes]

+

+ Questo hashmap ha come id il nome dell'attributo da impostare e come valore il [page:BufferAttribute buffer] su cui impostarlo. + Piuttosto che accedere a questa proprietà direttamente, usa [page:.setAttribute] e [page:.getAttribute] per accedere agli attributi + della geometria. +

+ +

[property:Box3 boundingBox]

+

+ Bounding box per la bufferGeometry, che può essere calcolato con + [page:.computeBoundingBox](). Il valore predefinito è `null`. +

+ +

[property:Sphere boundingSphere]

+

+ Bounding sphere per la bufferGeometry, che può essere calcolato con + [page:.computeBoundingSphere](). Il valore predefinito è `null`. +

+ +

[property:Object drawRange]

+

+ Determina la parte della geometria da visualizzare. Non dovrebbe essere impostato + direttamente, usa invece [page:.setDrawRange]. Il valore predefinito è + + { start: 0, count: Infinity } + + Per la BufferGeometry non indicizzata, count è il numero di vertici da visualizzare. + Per la BufferGeometry indicizzata, count è il numero di indici da visualizzare. +

+ +

[property:Array groups]

+

+ Divide la geometria in gruppi, ognuno dei quali verrà renderizzato in una chimata draw WebGL separata. + Ci permette che un array di materiali venga usato con una geometria.

+ + Ogni gruppo è un oggetto della forma: + { start: Integer, count: Integer, materialIndex: Integer } + dove start specifica il primo elemento nella chiamata draw - il primo vertice per la geometria non + indicizzata, altrimenti il primo indice del triangolo. Count specifica quanti vertici (o indici) sono + inclusi, e materialIndex specifica l'indice dell'array del materiale da utilizzare.

+ + Usa [page:.addGroup] per aggiungere gruppi, piuttosto che modificare questo array direttamente.

+ + Ogni vertice e indice deve appartenere esattamente ad un gruppo - i gruppi non devono condividere vertici o + indici, e non devono lasciare vertici o indici inutilizzati. +

+ + + + + +

[property:Integer id]

+

Numero univoco per questa istanza della bufferGeometry.

+ +

[property:BufferAttribute index]

+

+ Consente di riutilizzare i vertici su più triangoli; viene chiamato "indexed triangles". + Ogni triangolo è associato con gli indici di tre vertici. Questo attributo quindi memorizza + l'indice di ogni vertice per ogni faccia del triangolo. + + Se questo attributo non è impostato, il [page:WebGLRenderer renderer] assume che ogni 3 posizioni contigue + rappresentano un singolo triangolo. + + Il valore predefinito è `null`. +

+ +

[property:Boolean isBufferGeometry]

+

+ Flag di sola lettura per verificare se un dato oggetto è di tipo [name]. +

+ +

[property:Object morphAttributes]

+

+ Hashmap di BufferAttribute contenente i dettagli dei target morph delle geometrie.
+ Nota: Una volta che la geometria è stata renderizzata, i dati dell'attributo morph non possono essere modificati. + Dovrai chiamare [page:.dispose](), e creare una nuova istanza della [name]. +

+ +

[property:Boolean morphTargetsRelative]

+

+ Usato per controllare il comportamento del target morph: quando è impostato a true, i dati del target morph vengono + trattati come offset relativi, anziché come posizioni/normali assoluti. + + L'impostazione predefinita è `false`. +

+ +

[property:String name]

+

+ Nome opzionale per questa istanza di bufferGeometry. Il valore predefinito è una stringa vuota. +

+ +

[property:Object userData]

+

+ Un oggetto che può essere utilizzato per memorizzare i dati relativi alla BufferGeometry. + Non dovrebbe contenere i riferimenti alle funzioni poiché queste non verranno clonate. +

+ +

[property:String uuid]

+

+ [link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID] di questa istanza. + Viene assegnato automaticamente e non deve essere modificato. +

+ +

Metodi

+ +

[page:EventDispatcher EventDispatcher] i metodi sono disponibili in questa classe.

+ +

[method:undefined addGroup]( [param:Integer start], [param:Integer count], [param:Integer materialIndex] )

+

+ Aggiunge un gruppo a questa geometria; vedi la proprietà [page:BufferGeometry.groups groups] + per maggiori dettagli. +

+ +

[method:this applyMatrix4]( [param:Matrix4 matrix] )

+

Applica la matrice di trasformazione alla geometria.

+ +

[method:this applyQuaternion]( [param:Quaternion quaternion] )

+

Applica la rotazione rappresentata dal quaternione alla geometria.

+ +

[method:this center] ()

+

Centra la geometria basandosi sul bounding box.

+ +

[method:undefined clearGroups]( )

+

Cancella tutti i gruppi.

+ +

[method:BufferGeometry clone]()

+

Crea un clone di questa BufferGeometry.

+ +

[method:undefined computeBoundingBox]()

+

+ Calcola il bounding box della geometria, aggiornando l'attributo [page:.boundingBox].
+ I Bounding box non sono calcolati per impostazione predefinita. Devono essere calcolati esplicitamente, + altrimenti sono `null`. +

+ +

[method:undefined computeBoundingSphere]()

+

+ Calcola il bounding sphere della geometria, aggiornando l'attributo [page:.boundingSphere].
+ I Bounding sphere non sono calcolati per impostazione predefinita. Devono essere calcolati esplicitamente, + altrimenti sono `null`. +

+ +

[method:undefined computeTangents]()

+

+ Calcola e aggiunge un attributo tangent a questa geometria.
+ Il calcolo è supportato solo per geometrie indicizzate e se la posizione, la normale e gli attributi uv sono definiti. + Quando si usa una mappa normale dello spazio tangente, meglio usare l'algoritmo MikkTSpace fornito da [page:BufferGeometryUtils.computeMikkTSpaceTangents]. +

+ +

[method:undefined computeVertexNormals]()

+

Calcola la normale dei vertici calcolando la media delle normali delle facce.

+ +

[method:this copy]( [param:BufferGeometry bufferGeometry] )

+

Copia un'altra BufferGeometry in questa BufferGeometry.

+ +

[method:BufferAttribute deleteAttribute]( [param:String name] )

+

Cancella l'[page:BufferAttribute attributo] con il nome specificato.

+ +

[method:undefined dispose]()

+

+ Elimina l'oggetto dalla memoria.
+ È necessario chiamarlo quando si desidera rimuovere BufferGeometry mentre l'applicazione è in esecuzione. +

+ +

[method:BufferAttribute getAttribute]( [param:String name] )

+

Restituisce l'[page:BufferAttribute attributo] con il nome specificato.

+ +

[method:BufferAttribute getIndex] ()

+

Restituisce il buffer di [page:.index].

+ +

[method:Boolean hasAttribute]( [param:String name] )

+

Restituisce `true` se l'attributo con il nome specificato esiste.

+ +

[method:this lookAt] ( [param:Vector3 vector] )

+

+ vector - Un vettore world da guardare.

+ + Ruota la geometria in modo che sia rivolta verso un punto dello spazio. In genere, questa operazione viene + eseguita una sola volta e non durante un ciclo. + Usare [page:Object3D.lookAt] per l'uso tipico della mesh in tempo reale. +

+ +

[method:undefined normalizeNormals]()

+

+ Ogni vettore normale, in una geometria, deve avere magnitudine 1. + Ciò correggerà l'illuminazione sulle superfici geometriche. +

+ +

[method:this rotateX] ( [param:Float radians] )

+

+ Ruota la geometria attorno all'asse X. In genere, questa operazione viene eseguita una sola volta e non durante un ciclo. + Usare [page:Object3D.rotation] per la tipica rotazione della mesh in tempo reale. +

+ +

[method:this rotateY] ( [param:Float radians] )

+

+ Ruota la geometria attorno all'asse Y. In genere, questa operazione viene eseguita una sola volta e non durante un ciclo. + Usare [page:Object3D.rotation] per la tipica rotazione della mesh in tempo reale. +

+ +

[method:this rotateZ] ( [param:Float radians] )

+

+ Ruota la geometria attorno all'asse Z. In genere, questa operazione viene eseguita una sola volta e non durante un ciclo. + Usare [page:Object3D.rotation] per la tipica rotazione della mesh in tempo reale. +

+ +

[method:this scale] ( [param:Float x], [param:Float y], [param:Float z] )

+

+ Scala i dati della geometria. In genere, questa operazione viene eseguita una sola volta e non durante un ciclo. + Usare [page:Object3D.scale] per il tipico ridimensionamento della mesh in tempo reale. +

+ +

[method:this setAttribute]( [param:String name], [param:BufferAttribute attribute] )

+

+ Imposta un attributo per questa geometria. Utilizzare questo metodo piuttosto che la proprietà attributes, + perché viene mantenuta una hashmap interna di .attributes per accelerare l'iterazione sugli attributi. +

+ +

[method:undefined setDrawRange] ( [param:Integer start], [param:Integer count] )

+

+ Imposta la proprietà [page:.drawRange]. Per BufferGeometry non indicizzate, count è il numero di vertici da visualizzare. + Per BufferGeometry indicizzate, count è il numero di indici da visualizzare. +

+ +

[method:this setFromPoints] ( [param:Array points] )

+

Imposta gli attributi per questa BufferGeometry da un array di punti.

+ +

[method:this setIndex] ( [param:BufferAttribute index] )

+

Imposta il buffer [page:.index].

+ +

[method:Object toJSON]()

+

Converte la buffer geometry al formato three.js [link:https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4 JSON Object/Scene].

+ +

[method:BufferGeometry toNonIndexed]()

+

Restituisce una versione non indicizzata di una BufferGeometry indicizzata.

+ +

[method:this translate] ( [param:Float x], [param:Float y], [param:Float z] )

+

+ Trasla la geometria. In genere, questa operazione viene eseguita una sola volta e non durante un ciclo. + Usare [page:Object3D.position] per la tipica traslazione della mesh in tempo reale. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/core/Clock.html b/docs/api/it/core/Clock.html new file mode 100644 index 00000000000000..3d3aec55a15501 --- /dev/null +++ b/docs/api/it/core/Clock.html @@ -0,0 +1,82 @@ + + + + + + + + + +

[name]

+ +

+ Oggetto per tenere traccia del tempo. Questa classe utilizza [link:https://developer.mozilla.org/en-US/docs/Web/API/Performance/now performance.now] + se disponibile, altrimenti utilizza il meno accurato [link:https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Date/now Date.now]. +

+ +

Costruttore

+ +

[name]( [param:Boolean autoStart] )

+

+ autoStart — (opzionale) indica se avviare automaticamente l'orologio quando .getDelta() viene chiamato per la prima volta. L'impostazione predefinita è `true`. +

+ +

Proprietà

+ +

[property:Boolean autoStart]

+

+ Se impostato, avvia l'orologio automaticamente quando [page:.getDelta]() viene chiamato per la prima volta. Il valore predefinito è `true`. +

+ +

[property:Float startTime]

+

+ Contiene il tempo al quale è stato chiamato l'ultima volta il metodo [page:Clock.start start] dell'orologio. Il valore predefinito è `0`. +

+ +

[property:Float oldTime]

+

+ Contiene il tempo in cui i metodi [page:Clock.start start], [page:.getElapsedTime]() o [page:.getDelta]() dell'orologio sono stati chiamati per l'ultima volta. + Il valore predefinito è `0`. +

+ +

[property:Float elapsedTime]

+

+ Tiene traccia del tempo totale di esecuzione dell'orologio. Il valore predefinito è `0`. +

+ +

[property:Boolean running]

+

+ Indica se l'orologio è in esecuzione o meno. Il valore predefinito è `false`. +

+ +

Metodi

+ +

[method:undefined start]()

+

+ Avvia l'orologio. Inoltre imposta [page:.startTime] e [page:.oldTime] sull'ora corrente, imposta [page:.elapsedTime] a `0` e [page:.running] a `true`. +

+ +

[method:undefined stop]()

+

+ Ferma l'orologio e imposta [page:Clock.oldTime oldTime] sull'ora corrente. +

+ +

[method:Float getElapsedTime]()

+

+ Ottiene i secondi trascorsi da quando l'orologio è stato avviato e imposta [page:.oldTime] sull'ora corrente.
+ Se [page:.autoStart] è `true` e l'orologio non è in esecuzione, avvia anche l'orologio. +

+ +

[method:Float getDelta]()

+

+ Ottiene i secondi trascorsi dall'ora in cui è stato impostato [page:.oldTime] e imposta [page:.oldTime] sull'ora corrente.
+ Se [page:.autoStart] è `true` e l'orologio non è in esecuzione, avvia anche l'orologio. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/core/EventDispatcher.html b/docs/api/it/core/EventDispatcher.html new file mode 100644 index 00000000000000..a02b85be31e267 --- /dev/null +++ b/docs/api/it/core/EventDispatcher.html @@ -0,0 +1,97 @@ + + + + + + + + + +

[name]

+ +

+ Eventi JavaScript per oggetti personalizzati.
+ [link:https://github.com/mrdoob/eventdispatcher.js EventDispatcher on GitHub] +

+ +

Codice di Esempio

+ + + // Aggiungere eventi ad un oggetto custom + + class Car extends EventDispatcher { + + start() { + + this.dispatchEvent( { type: 'start', message: 'vroom vroom!' } ); + + } + + }; + + // Usare gli eventi con l'oggetto custom + + const car = new Car(); + + car.addEventListener( 'start', function ( event ) { + + alert( event.message ); + + } ); + + car.start(); + + +

Costruttore

+ +

[name]()

+

+ Crea un oggetto EventDispatcher. +

+ + +

Metodi

+ +

[method:undefined addEventListener]( [param:String type], [param:Function listener] )

+

+ type - Il tipo di evento da ascoltare.
+ listener - La funzione che viene chiamata quando viene generato l'evento. +

+

+ Aggiunge un listener ad un tipo di evento. +

+ +

[method:Boolean hasEventListener]( [param:String type], [param:Function listener] )

+

+ type - Il tipo di evento da ascoltare.
+ listener - La funzione che viene chiamata quando viene generato l'evento. +

+

+ Verifica se il listener è aggiunto ad un tipo di evento. +

+ +

[method:undefined removeEventListener]( [param:String type], [param:Function listener] )

+

+ type - Il tipo di listener che viene rimosso.
+ listener - La funzione listener che viene rimossa. +

+

+ Rimuove un listener da un tipo di evento. +

+ +

[method:undefined dispatchEvent]( [param:Object event] )

+

+ event - L'evento che viene lanciato. +

+

+ Lancia un tipo di evento. +

+ + +

Source

+ +

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

+ + diff --git a/docs/api/it/core/GLBufferAttribute.html b/docs/api/it/core/GLBufferAttribute.html new file mode 100644 index 00000000000000..31ab9aae12b144 --- /dev/null +++ b/docs/api/it/core/GLBufferAttribute.html @@ -0,0 +1,115 @@ + + + + + + + + + +

[name]

+ +

+ Questa classe di attributi del buffer non costruisce un VBO. Invece, + utilizza qualsiasi VBO che gli viene passato nel costruttore e può essere + successivamente alterato tramite la proprietà `buffer`.

+ È necessario passare parametri aggiuntivi insieme a VBO. I quali sono: + il contesto GL, il tipo di dati GL, il numero di componenti per vertice, + il numero di byte per componente, e il numero di vertici.

+ Il caso d'uso più comune per questa classe è quando un qualche tipo di + calcolo GPGPU interferisce o addirittura produce i VBO in questione. +

+ +

Costruttore

+

[name]( [param:WebGLBuffer buffer], [param:GLenum type], [param:Integer itemSize], [param:Integer elementSize], [param:Integer count] )

+

+ `buffer` — Deve essere un WebGLBuffer. +
+ `type` — Uno dei Tipi di dati WebGL. +
+ `itemSize` — Il numero dei valori dell'array che devono essere associati con un particolare vertice. Ad esempio, + se questo attributo memorizza un vettore a 3 componenti (come una posizione, una normale, un colore), allora itemSize dovrebbe essere 3. +
+ `elementSize` — 1, 2 o 4. La dimensione corrispondente (in byte) per il parametro "type" passato. +

    +
  • gl.FLOAT: 4
    • +
  • gl.UNSIGNED_SHORT: 2
    • +
  • gl.SHORT: 2
    • +
  • gl.UNSIGNED_INT: 4
    • +
  • gl.INT: 4
    • +
  • gl.BYTE: 1
    • +
  • gl.UNSIGNED_BYTE: 1
    • +
+ `count` — Il numero previsto di vertici in VBO. +

+ +

Proprietà

+ +

[property:WebGLBuffer buffer]

+

+ L'istanza corrente di WebGLBuffer. +

+ +

[property:Integer count]

+

+ Il numero previsto di vertici in VBO. +

+ +

[property:Integer itemSize]

+

+ Quanti valori compongono ogni elemento (vertice). +

+ +

[property:Integer elementSize]

+

+ Memorizza la dimensione corrispondente in byte per il valore della proprietà del `type` corrente. +

+

+ Vedi sopra (costruttore) per un elenco di dimensioni di type conosciute. +

+ +

[property:GLenum type]

+

+ Un WebGL Data Type + che descrive i contenuti VBO. +

+

+ Imposta questa proprietà insieme a `elementSize`. Il modo consigliato è + di usare il metodo `setType`. +

+ +

[property:Boolean isGLBufferAttribute]

+

+ Solo lettura. Sempre `true`. +

+ +

Metodi

+ +

[method:this setBuffer]( buffer )

+

Imposta la proprietà `buffer`.

+ +

[method:this setType]( type, elementSize )

+

Imposta entrambe le proprietà `type` e `elementSize`.

+ +

[method:this setItemSize]( itemSize )

+

Imposta la proprietà `itemSize`.

+ +

[method:this setCount]( count )

+

Imposta la proprietà `count`.

+ +

[property:Integer version]

+

+ Un numero di versione, incrementato ogni volta che la proprietà needsUpdate è impostata a true. +

+ +

[property:Boolean needsUpdate]

+

+ Il valore predefinito è `false`. Impostando questo metodo a true incrementa la [page:GLBufferAttribute.version versione]. +

+ +

Source

+

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

+ + diff --git a/docs/api/it/core/InstancedBufferAttribute.html b/docs/api/it/core/InstancedBufferAttribute.html new file mode 100644 index 00000000000000..a260e610d23250 --- /dev/null +++ b/docs/api/it/core/InstancedBufferAttribute.html @@ -0,0 +1,43 @@ + + + + + + + + + + [page:BufferAttribute] → + +

[name]

+ +

+ Una versione istanziata di [page:BufferAttribute]. +

+ +

Costruttore

+

[name]( [param:TypedArray array], [param:Integer itemSize], [param:Boolean normalized], [param:Number meshPerAttribute] )

+

+

+ +

Proprietà

+

Vedi [page:BufferAttribute] per le prorietà ereditate.

+ +

[property:Number meshPerAttribute]

+

+ Definisce la frequenza con cui un valore di questo attributo del buffer deve essere ripetuto. + Un valore di uno significa che ogni valore dell'attributo istanziato è usato per una singola istanza. + Un valore di due significa che ogni valore è utilizzato per due istanze consecutive (e così via). + Il valore predefinito è `1`. +

+ +

Metodi

+

Vedi [page:BufferAttribute] per i metodi ereditati.

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/core/InstancedBufferGeometry.html b/docs/api/it/core/InstancedBufferGeometry.html new file mode 100644 index 00000000000000..c8a64285a9f5a5 --- /dev/null +++ b/docs/api/it/core/InstancedBufferGeometry.html @@ -0,0 +1,48 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

+ Una versione istanziata di [page:BufferGeometry]. +

+ +

Costruttore

+

[name]( )

+

+

+ +

Properties

+

Vedi [page:BufferGeometry] per le prorietà ereditate.

+ +

[property:Number instanceCount]

+

+ Il valore predefinito è `Infinity`. +

+ +

[property:Boolean isInstancedBufferGeometry]

+

+ Flag di sola lettura per verificare se un dato oggetto è di tipo [name]. +

+ +

Metodi

+

Vedi [page:BufferGeometry] per i metodi ereditati.

+ +

[method:this copy]( [param:InstancedBufferGeometry source] )

+

Copia l'oggetto [name] specificato in questa istanza.

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/core/InstancedInterleavedBuffer.html b/docs/api/it/core/InstancedInterleavedBuffer.html new file mode 100644 index 00000000000000..2fbab00c79a990 --- /dev/null +++ b/docs/api/it/core/InstancedInterleavedBuffer.html @@ -0,0 +1,44 @@ + + + + + + + + + + [page:InterleavedBuffer] → + +

[name]

+ +

+ Una versione istanziata di [page:InterleavedBuffer]. +

+ +

Costruttore

+

[name]( [param:TypedArray array], [param:Integer itemSize], [param:Number meshPerAttribute] )

+

+

+ +

Proprietà

+

+ Vedi [page:InterleavedBuffer] per le prorietà ereditate. +

+ +

[property:Number meshPerAttribute]

+

+ Il valore predefinito è `1`. +

+ +

Metodi

+

+ Vedi [page:InterleavedBuffer] per i metodi ereditati. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/core/InterleavedBuffer.html b/docs/api/it/core/InterleavedBuffer.html new file mode 100644 index 00000000000000..0985f458868b16 --- /dev/null +++ b/docs/api/it/core/InterleavedBuffer.html @@ -0,0 +1,116 @@ + + + + + + + + + +

[name]

+ +

+ "Interleaved" significa che più attributi, possibilmente di tipo differente, (ad esempio, posizione, normale, uv, colore) + sono impacchettati in un unico array buffer. +

+ Qui trovi un'introduzione agli array interleaved: [link:https://blog.tojicode.com/2011/05/interleaved-array-basics.html Interleaved array basics] +

+ +

Esempi

+ +

[example:webgl_buffergeometry_points_interleaved webgl / buffergeometry / points / interleaved]

+ +

Costruttore

+

[name]( [param:TypedArray array], [param:Integer stride] )

+

+ [page:TypedArray array] -- Un array tipizzato con un buffer condiviso. Memorizza i dati della geometria.
+ [page:Integer stride] -- Il numero di elementi typed-array per vertice. +

+ +

Proprietà

+ +

[property:Array array]

+

+ Un array tipizzato con un buffer condiviso. Memorizza i dati della geometria. +

+ +

[property:Integer stride]

+

+ Il numero di elementi typed-array per vertice. +

+ +

[property:Integer count]

+

+ Fornisce il numero totale di elementi in un array. +

+ +

[property:Object updateRange]

+

+ Oggetto contente offset e count.
+ - [page:Number offset]: Il valore predefinito è `0`.
+ - [page:Number count]: Il valore predefinito è `-1`.
+

+ +

[property:String uuid]

+

+ [link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID] di questa istanza. Viene automaticamente assegnato, non deve essere modificato. +

+ +

[property:Integer version]

+

+ Un numero di versione, incrementato ogni volta che la proprietà needsUpdate è impostata a true. +

+ +

[property:Boolean needsUpdate]

+

+ Il valore predefinito è `false`.Impostando questo valore a true incrementa la [page:InterleavedBuffer.version versione]. +

+ +

[property:Usage usage]

+

+ Definisce il modello di utilizzo previsto dell'archivio dati a fini di ottimizzazione. Corrisponde al parametro di utilizzo di + [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/bufferData WebGLRenderingContext.bufferData](). +

+ +

Metodi

+ +

[method:this copy]( [param:InterleavedBuffer source] )

+

+ Copia un altro [name] in questo [name]. +

+ +

[method:this copyAt]( [param:Integer index1], [param:InterleavedBuffer attribute], [param:Integer index2] )

+

Copia i dati da `attribute[index2]` a [page:InterleavedBuffer.array array][index1].

+ +

[method:this set]( [param:TypedArray value], [param:Integer offset] )

+

+ value - L'array (tipizzato) di origine.
+ offset - L'offset nell'array di destinazione in corrrispondenza del quale iniziare a scrivere i valori dall'array di origine. L'impostazione predefinita è `0`.

+ + Memorizza più valori nel buffer, leggendo valori di input dall'array specificato. +

+ +

[method:InterleavedBuffer clone]( [param:Object data] )

+

+ data - Questo oggetto contiene buffer di array condivisi necessari per clonare correttamente le geometrie con attributi interleaved.

+ + Crea un clone di questo [name]. +

+ +

[method:this setUsage] ( [param:Usage value] )

+

Imposta [page:InterleavedBuffer.usage usage] a value.

+ +

[method:Object toJSON]( [param:Object data] )

+

+ data - Questo oggetto contiene buffer di array condivisi necessari per serializzare correttamente le geometrie con attributi interleaved.

+ + Serializza questo [name]. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/core/InterleavedBufferAttribute.html b/docs/api/it/core/InterleavedBufferAttribute.html new file mode 100644 index 00000000000000..94b9d580b76f9c --- /dev/null +++ b/docs/api/it/core/InterleavedBufferAttribute.html @@ -0,0 +1,125 @@ + + + + + + + + + + +

[name]

+ +

+ +

+ +

Costruttore

+

[name]( [param:InterleavedBuffer interleavedBuffer], [param:Integer itemSize], [param:Integer offset], [param:Boolean normalized] )

+

+

+ +

Proprietà

+ +

[property:InterleavedBuffer data]

+

+ L'istanza [page:InterleavedBuffer InterleavedBuffer] passata nel costruttore. +

+ +

[property:TypedArray array]

+

+ Il valore di [page:InterleavedBufferAttribute.data data].array. +

+ +

[property:Integer count]

+

+ Il valore di [page:InterleavedBufferAttribute.data data].count. + + Se il buffer memorizza un elemento a 3 componenti (come una posizione, una normale, o un colore), + allora questo conterà il numero di ogni elemento memorizzato. +

+ +

[property:Boolean isInterleavedBufferAttribute]

+

+ Flag di sola lettura per verificare se un dato oggetto è di tipo [name]. +

+ +

[property:Integer itemSize]

+

+ Quanti valori compongono ogni elemento (vertice). +

+ +

[property:String name]

+

+ Nome opzionale per questa istanza dell'attributo. Il valore di default è una stringa vuota. +

+ +

[property:Boolean needsUpdate]

+

+ Il valore predefinito è `false`. Impostando questa proprietà a `true` invierà di nuovo l'intero + buffer interleaved (non solo i dati dello specifico attributo) alla GPU. +

+ +

[property:Boolean normalized]

+

+ Il valore predefinito è `false`. +

+ +

[property:Integer offset]

+

+ L'offset nel buffer dell'array sottostante in cui inizia un elemento. +

+ +

Metodi

+ +

[method:this applyMatrix4]( [param:Matrix4 m] )

+

Applica la matrice [page:Matrix4 m] ad ogni elemento Vector3 di questo InterleavedBufferAttribute.

+ +

[method:this applyNormalMatrix]( [param:Matrix3 m] )

+

Applica la matrice [page:Matrix3 m] ad ogni elemento Vector3 di questo InterleavedBufferAttribute.

+ +

[method:this transformDirection]( [param:Matrix4 m] )

+

Applica la matrice [page:Matrix4 m] ad ogni elemento Vector3 di questo InterleavedBufferAttribute, interpretando gli elementi come vettori direzionali.

+ +

[method:Number getX]( [param:Integer index] )

+

Restituisce il componente x dell'elemento in corrispondenza dell'indice specificato.

+ +

[method:Number getY]( [param:Integer index] )

+

Restituisce il componente y dell'elemento in corrispondenza dell'indice specificato.

+ +

[method:Number getZ]( [param:Integer index] )

+

Restituisce il componente z dell'elemento in corrispondenza dell'indice specificato.

+ +

[method:Number getW]( [param:Integer index] )

+

Restituisce il componente w dell'elemento in corrispondenza dell'indice specificato.

+ +

[method:this setX]( [param:Integer index], [param:Float x] )

+

Imposta il componente x dell'elemento in corrispondenza dell'indice specificato.

+ +

[method:this setY]( [param:Integer index], [param:Float y] )

+

Imposta il componente y dell'elemento in corrispondenza dell'indice specificato.

+ +

[method:this setZ]( [param:Integer index], [param:Float z] )

+

Imposta il componente z dell'elemento in corrispondenza dell'indice specificato.

+ +

[method:this setW]( [param:Integer index], [param:Float w] )

+

Imposta il componente w dell'elemento in corrispondenza dell'indice specificato.

+ +

[method:this setXY]( [param:Integer index], [param:Float x], [param:Float y] )

+

Imposta i componenti x e y dell'elemento in corrispondenza dell'indice specificato.

+ +

[method:this setXYZ]( [param:Integer index], [param:Float x], [param:Float y], [param:Float z] )

+

Imposta i componenti x, y e z dell'elemento in corrispondenza dell'indice specificato.

+ +

[method:this setXYZW]( [param:Integer index], [param:Float x], [param:Float y], [param:Float z], [param:Float w] )

+

Imposta i componenti x, y, z e w dell'elemento in corrispondenza dell'indice specificato.

+ + + +

Source

+ +

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

+ + diff --git a/docs/api/it/core/Layers.html b/docs/api/it/core/Layers.html new file mode 100644 index 00000000000000..bcb501e6238515 --- /dev/null +++ b/docs/api/it/core/Layers.html @@ -0,0 +1,105 @@ + + + + + + + + + +

[name]

+ +

+ Un oggetto [page:Layers] assegna un [page:Object3D] a 1 o più di 32 layer numerati da `0` a `31` + - internamente i layer sono memorizzati come una [link:https://en.wikipedia.org/wiki/Mask_(computing) maschera di bit], + e, per impostazione predefinita, tutti gli Object3D sono membri del leyer 0.

+ + Può essere utilizzato per controllare la visibilità - un oggetto deve condividere un layer con una [page:Camera telecamera] per + essere visibile quando la vista della telecamera viene renderizzata.

+ + Tutte le classi che ereditano da [page:Object3D] hanno una proprietà [page:Object3D.layers] che è un'istanza della classe. +

+ +

Esempi

+ +

+ [example:webgl_layers WebGL / layers] +

+ +

Costruttore

+ + +

[name]()

+

+ Crea un nuovo oggetto Layers, con l'appartenenza inizialmente impostata al layer 0. +

+ +

Proprietà

+ +

[property:Integer mask]

+

+ Una maschera di bit che memorizza a quale dei 32 layer questo oggetto layer è attualmente membro. +

+ + +

Metodi

+ +

[method:undefined disable]( [param:Integer layer] )

+

+ layer - un intero da 0 a 31.

+ + Elimina l'appartenenza a questo `layer`. +

+ +

[method:undefined enable]( [param:Integer layer] )

+

+ layer - un intero da 0 a 31.

+ + Aggiunge l'appartenenza a questo `layer`. +

+ +

[method:undefined set]( [param:Integer layer] )

+

+ layer - un intero da 0 a 31.

+ + Imposta l'appartenza a `layer`, e rimuove l'appartenza a tutti gli altri layer. +

+ +

[method:Boolean test]( [param:Layers layers] )

+

+ layers - un oggetto Layers

+ + Restituisce true se questo e l'oggetto `layers` passato hanno al più un layer in comune. +

+ +

[method:Boolean isEnabled]( [param:Integer layer] )

+

+ layer - un intero da 0 a 31.

+ + Restituisce true se il dato layer è abilitato. +

+ +

[method:undefined toggle]( [param:Integer layer] )

+

+ layer - un intero da 0 a 31.

+ + Attiva/disattiva l'appartenenza al `layer`. +

+ +

[method:undefined enableAll]()

+

+ Aggiunge l'appartenza a tutti i layer. +

+ +

[method:undefined disableAll]()

+

+ Rimuove l'appartenenza da tutti i layer. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/core/Object3D.html b/docs/api/it/core/Object3D.html new file mode 100644 index 00000000000000..3328ffa593e4fc --- /dev/null +++ b/docs/api/it/core/Object3D.html @@ -0,0 +1,500 @@ + + + + + + + + + +

[name]

+ +

+ Questa è la classe base di molti oggetti in three.js e fornisce un insieme di proprietà e metodi + per manipolare gli oggetti 3D nello spazio.

+ + Si noti che questa classe può essere utilizzata per raggruppare gli oggetti tramite il metodo + [page:.add]( object ) il quale aggiunge l'oggetto come figlio, tuttavia è meglio usare [page:Group] per questo. +

+ + +

Costruttore

+ + +

[name]()

+

+ Il cotruttore non prende argomenti. +

+ + +

Proprietà

+ +

[property:AnimationClip animations]

+

Array con clip di animazione dell'oggetto.

+ +

[property:Boolean castShadow]

+

Se l'oggetto viene renderizzato nella mappa delle ombre. Il valore predefinito è `false`.

+ +

[property:Array children]

+

Array con i children dell'oggetto. Vedi [page:Group] per informazioni su come raggrupare manualmente gli oggetti.

+ +

[property:Material customDepthMaterial]

+

+ Materiale depth personalizzato da utilizzare durante il rendering della mappa di depth. Può essere utilizzato solo nel contesto delle mesh. + Quando si proietta un'ombra con [page:DirectionalLight] o [page:SpotLight], se si modificano le posizioni dei vertici nello shader dei vertici + è necessario specificare un customDepthMaterial per le shadow corrette. Il valore predefinito è `undefined`. +

+ +

[property:Material customDistanceMaterial]

+

+ Lo stesso di [page:.customDepthMaterial customDepthMaterial], ma viene utilizzato con [page:PointLight]. + Il valore predefinito è `undefined`. +

+ +

[property:Boolean frustumCulled]

+

+ Quando questo è impostato, controlla ogni fotogramma, se l'oggetto è nel frustrum della telecamera prima renderizzare l'oggetto. + Se è impostato a `false` l'oggetto viene renderizzato ad ogni fotogramma anche se non si trova nel frustrum della telecamera. + Il valore predefinito è `true`. +

+ +

[property:Integer id]

+

sola lettura – Numero univoco per questa istanza.

+ +

[property:Boolean isObject3D]

+

+ Flag di sola lettura per controllare se un dato oggetto è di tipo [name]. +

+ +

[property:Layers layers]

+

+ Il layer di appartenenza dell'oggetto. L'oggetto è visibile solo se ha al più un layer in comune + con la [page:Camera telecamera] utilizzata. Questa proprietà può anche essere utilizata per filtrare + gli oggetti non voluti nell'intersezione di test del reycasting quando si usa il [page:Raycaster]. +

+ +

[property:Matrix4 matrix]

+

La matrice di trasformazione locale.

+ +

[property:Boolean matrixAutoUpdate]

+

+ Quando viene settato calcola la matrice di posizione, (rotazione o quaternione) e + ridimensiona ogni fotogramma ed inoltre ricalcola la proprietà matrixWorld. L'impostazione predefinita è [page:Object3D.DefaultMatrixAutoUpdate] (true). +

+ +

[property:Matrix4 matrixWorld]

+

+ La trasformazione globale dell'oggetto. Se l'Object3D non ha un genitore, è identico al [page:.matrix] della trasformazione locale. +

+ +

[property:Boolean matrixWorldAutoUpdate]

+

+ Il valore predefinito è true. Se impostato, il renderer controlla ogni frame se l'oggetto e i suo figli + necessitano di aggiornare la matrice. + Quando non lo è, devi mantenere tu stesso tutte le matrici nell'oggetto e i suoi figli. +

+ +

[property:Boolean matrixWorldNeedsUpdate]

+

+ Quando viene settato calcola la matrixWorld in quel frame e reimposta questa proprietà a false. Il valore + predefinito è `false`. +

+ +

[property:Matrix4 modelViewMatrix]

+

Questo viene passato allo shader e utilizzato per calcolare la posizione dell'oggetto.

+ +

[property:String name]

+

Nome opzionale dell'oggetto (non è necessario che sia univoco). Il valore predefinito è una stringa vuota.

+ +

[property:Matrix3 normalMatrix]

+

+ Questo viene passato allo shader e utilizzato per calcolare l'illuminazione per l'oggetto. + È la trasposizione dell'inverso della sottomatrice 3x3 in alto a sinistra di modelViewMatrix di questo oggetto.

+ + Il motivo di questa matrice speciale è che il semplice utilizzo della matrice modelViewMatrix potrebbe causare una lunghezza non unitaria delle normali + (in caso di scalatura) o una direzione non perpendicolare (in caso di scalatura non uniforme).

+ + Dall'altra parte, la parte di traslazione della matrice modelViewMatrix non è rilevante per il calcolo delle normali. Quindi una Matrix3 è sufficiente. +

+ +

[property:Function onAfterRender]

+

+ Una callback opzionale che viene eseguita immediatamente dopo che un oggetto 3D è stato renderizzato. + Questa funzione è chiamata con i seguenti parametri: renderer, scene, camera, geometry, material, group. +

+

+ Si noti che questa funzione di callback viene eseguita per oggi 3D `renderizzabili` (renderable). Ovvero oggetti 3D che definiscono + il loro aspetto visivo con geometrie e materiali come istanze di [page:Mesh], [page:Line], [page:Points] o [page:Sprite]. + Invece, le istanze di [page:Object3D], [page:Group] o [page:Bone] non sono renderizzabili e quindi questa callback non viene eseguita su questi oggetti. +

+ +

[property:Function onBeforeRender]

+

+ Una callback opzionale che viene eseguita immediatamente prima che un oggetto 3D è stato renderizzato. + Questa funzione è chiamata con i seguenti parametri: renderer, scene, camera, geometry, material, group. +

+

+ Si noti che questa funzione di callback viene eseguita per oggi 3D `renderizzabili` (renderable). Ovvero oggetti 3D che definiscono + il loro aspetto visivo con geometrie e materiali come istanze di [page:Mesh], [page:Line], [page:Points] o [page:Sprite]. + Invece, le istanze di [page:Object3D], [page:Group] o [page:Bone] non sono renderizzabili e quindi questa callback non viene eseguita su questi oggetti. +

+ +

[property:Object3D parent]

+

Genitore dell'oggetto nel [link:https://en.wikipedia.org/wiki/Scene_graph grafo della scena]. Un oggetto può avere più + di un genitore.

+ +

[property:Vector3 position]

+

Un [page:Vector3] che rappresenta la posizione locale dell'oggetto. Il valore predefinito è `(0, 0, 0)`.

+ +

[property:Quaternion quaternion]

+

Rotazione locale dell'oggetto come un [page:Quaternion Quaternion].

+ +

[property:Boolean receiveShadow]

+

Se il materiale riceve ombre. Il valore predefinito è `false`.

+ +

[property:Number renderOrder]

+

+ Questo valore consente di sovrascrivere l'ordine di rendering predefinito degli oggetti del [link:https://en.wikipedia.org/wiki/Scene_graph grafico di scena] + sebbene gli oggetti opachi e trasparenti rimangano ordinati in modo indipendente. Quando questa proprietà viene impostata per un'istanza di [page:Group Group], + tutti gli oggetti discendenti saranno ordinati e renderizzati insieme. + L'ordinamento è dal più piccolo al più grande renderOrder. Il valore predefinito è `0`. +

+ +

[property:Euler rotation]

+

+ La rotazione locale dell'oggetto (vedi [link:https://en.wikipedia.org/wiki/Euler_angles gli angoli di Eulero]), in radianti. +

+ +

[property:Vector3 scale]

+

+ La scala locale dell'oggetto. Il valore predefinito è [page:Vector3]( 1, 1, 1 ). +

+ +

[property:Vector3 up]

+

+ Questa proprietà viene utilizzata dal metodo [page:.lookAt lookAt], per esempio, per determinare l'orientamento del risultato.
+ L'impostazione predefinita è [page:Object3D.DefaultUp] - che è, `( 0, 1, 0 )`. +

+ +

[property:Object userData]

+

+ Un oggetto che può essere utilizzato per memorizzare i dati personalizzati di un Object3D. + Non dovrebbe contenere riferimenti a funzioni poiché queste non verranno clonate. +

+ +

[property:String uuid]

+

+ [link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID] dell'istanza dell'oggetto. + Viene assegnato automaticamente, non dovrebbe essere modificato. +

+ +

[property:Boolean visible]

+

L'oggetto viene visualizzato se `true`. Il valore predefinito è `true`.

+ + + + +

Proprietà Statiche

+

+ Le proprietà statiche e i metodi sono definiti per classe piuttosto che per istanza della classe. + Questo significa che modificando [page:Object3D.DefaultUp] o [page:Object3D.DefaultMatrixAutoUpdate] + verranno modificati i valori di [page:.up up] e [page:.matrixAutoUpdate matrixAutoUpdate] per `ogni` + istanza di Object3D (o classi derivate) creata dopo che la modifica è stata fatta + (gli Object3D già creati non saranno interessati). +

+ +

[property:Vector3 DefaultUp]

+

+ La direzione predefinita di [page:.up up] per gli oggetti, utilizzata anche come posizione predefinita per [page:DirectionalLight], + [page:HemisphereLight] e [page:Spotlight] (che crea luci che brillano dall'alto verso il basso).
+ Impostare su ( 0, 1, 0 ) per impostazione predefinita. +

+ +

[property:Boolean DefaultMatrixAutoUpdate]

+

+ L'impostazione predefinita per [page:.matrixAutoUpdate matrixAutoUpdate] per Object3D appena creati.
+

+ + +

Metodi

+ +

I metodi [page:EventDispatcher EventDispatcher] sono disponibili in questa classe.

+ +

[method:this add]( [param:Object3D object], ... )

+

+ Aggiunge l'`object` come figlio di questo oggetto. È possibile aggiungere un numero arbitrario di oggetti. + Qualsiasi genitore corrente su un oggetto passato qui verrà rimosso, poiché un oggetto può avere al più un genitore.

+ + Vedi [page:Group] per avere informazioni per raggruppare manualmente gli oggetti. +

+ +

[method:undefined applyMatrix4]( [param:Matrix4 matrix] )

+

Applica la matrice di trasformazione all'oggetto e aggiorna la posizione, la rotazione e la scala dell'oggetto.

+ +

[method:this applyQuaternion]( [param:Quaternion quaternion] )

+

Applica la rotazione rappresentata dal quaternione dell'oggetto.

+ +

[method:this attach]( [param:Object3D object] )

+

+ Aggiunge l'`object` come figlio di questo oggetto, mantenendo la trasformazione world dell'oggetto.

+ Nota: Questo metodo non supporta i grafici della scena con nodi con scalatura non uniforme. +

+ +

[method:Object3D clone]( [param:Boolean recursive] )

+

+ recursive -- se true, anche i discendenti dell'oggetto vengono clonati. Il valore predefinito è true.

+ + Restituisce un clone di questo oggetto e opzionalmente tutti i discendenti. +

+ +

[method:this copy]( [param:Object3D object], [param:Boolean recursive] )

+

+ recursive -- se true, anche i discendenti dell'oggetto vengono copiati. Il valore predefinito è true.

+ + Copia l'oggetto passato in questo oggetto. + + Nota: Gli event listener e le callback definite dall'utente ([page:.onAfterRender] e [page:.onBeforeRender]) non vengono copiate. +

+ +

[method:Object3D getObjectById]( [param:Integer id] )

+

+ id -- Numero univoco dell'istanza dell'oggetto

+ + Cerca in un oggetto e nei suoi figli, partendo dall'oggetto stesso, e restituisce il primo con l'id corrispondente.
+ Si noti che gli id sono assegnati in ordine cronologico: 1, 2, 3, ..., incrementando di uno per ogni nuovo oggetto. +

+ +

[method:Object3D getObjectByName]( [param:String name] )

+

+ name -- Stringa da abbinare alla proprietà Object3D.name dei figli.

+ + Cerca in un oggetto e nei suoi figli, partendo dall'oggetto stesso, e restituisce il primo con il nome corrispondente.
+ Si noti che per molti oggetti il nome è una stringa vuota da impostazione predefinita. Dovrai impostarlo manualmente per + utilizzare questo metodo. +

+ +

[method:Object3D getObjectByProperty]( [param:String name], [param:Any value] )

+

+ name -- il nome della proprietà da cercare.
+ value -- il valore della proprietà data.

+ + Cerca in un oggetto e nei suoi figli, partendo dall'oggetto stesso, e restituisce il primo con la proprietà che corrisponde al valore passato. +

+ +

[method:Vector3 getWorldPosition]( [param:Vector3 target] )

+

+ [page:Vector3 target] — il risultato verrà copiato in questo Vector3.

+ + Restituisce un vettore che rappresenta la posizione dell'oggetto nello spazio world. +

+ +

[method:Quaternion getWorldQuaternion]( [param:Quaternion target] )

+

+ [page:Quaternion target] — il risultato sarà copiato in questo Quaternione.

+ + Restituisce un quaternione che rappreseta la rotazione dell'oggetto nello spazio world. +

+ +

[method:Vector3 getWorldScale]( [param:Vector3 target] )

+

+ [page:Vector3 target] — il risultato sarà copiato in questo Vector3.

+ + Restituisce un vettore dei fattori di scala applicati all'oggetto per ciascun asse nello spazio world. +

+ +

[method:Vector3 getWorldDirection]( [param:Vector3 target] )

+

+ [page:Vector3 target] — il risultato sarà copiato in questo Vector3.

+ + Restituisce un vettore che rappresenta la direzione dell'asse z positivo dell'oggetto nello spazio world. +

+ + +

[method:Vector3 localToWorld]( [param:Vector3 vector] )

+

+ vector - Un vettore che rappresenta la posizione nello spazio locale di questo oggetto.

+ + Converte il vettore dallo spazio locale dell'oggetto allo spazio world. +

+ +

[method:undefined lookAt]( [param:Vector3 vector] )
+ [method:undefined lookAt]( [param:Float x], [param:Float y], [param:Float z] )

+

+ vector - Un vettore che rappresenta la posizione nello spazio world.

+ Facoltativamente, le componenti [page:.x x], [page:.y y] e [page:.z z] della posizione nello spazio world.

+ + Ruota l'oggetto in modo che sia rivolto verso un punto nello spazio world.

+ + Questo metodo non supporta oggetti con genitore/i con scalabilità non uniforme. +

+ +

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

+

+ Metodo astratto (vuoto) per ottenere le intersezioni tra un raggio casted e questo oggetto. + Sottoclassi come [page:Mesh], [page:Line], e [page:Points] implementano questo metodo per + utilizzare il raycasting. +

+ +

[method:this remove]( [param:Object3D object], ... )

+

+ Rimuove `object` come figlio di questo oggetto. Può essere rimosso un numero arbitrario di oggetti. +

+ +

[method:this removeFromParent]()

+

+ Rimuove questo oggetto dal suo attuale genitore. +

+ +

[method:this clear]()

+

+ Rimuove tutti i figli dall'oggetto. +

+ +

[method:this rotateOnAxis]( [param:Vector3 axis], [param:Float angle] )

+

+ axis -- Un vettore normalizzato nello spazio dell'oggetto.
+ angle -- L'angolo in radianti.

+ + Ruota un oggetto lungo l'asse nello spazio dell'oggetto. Si presume che l'asse sia normalizzato. +

+ +

[method:this rotateOnWorldAxis]( [param:Vector3 axis], [param:Float angle] )

+

+ axis -- Un vettore normalizzato nello spazio world.
+ angle -- L'angolo in radianti.

+ + Ruota un oggetto lungo l'asse nello spazio world. Si presume che l'asse sia normalizzato. + Presuppone che nessun genitore sia ruotato. +

+ +

[method:this rotateX]( [param:Float rad] )

+

+ rad - l'angolo di rotazione in radianti.

+ + Ruota l'oggetto attorno all'asse x nello spazio locale. +

+ +

[method:this rotateY]( [param:Float rad] )

+

+ rad - l'angolo di rotazione in radianti.

+ + Ruota l'oggetto attorno all'asse y nello spazio locale. +

+ +

[method:this rotateZ]( [param:Float rad] )

+

+ rad - l'angolo di rotazione in radianti.

+ + Ruota l'oggetto attorno all'asse z nello spazio locale. +

+ +

[method:undefined setRotationFromAxisAngle]( [param:Vector3 axis], [param:Float angle] )

+

+ axis -- Un vettore normalizzato nello spazio dell'oggetto.
+ angle -- l'angolo in radianti

+ + Chiama [page:Quaternion.setFromAxisAngle setFromAxisAngle]( [page:Float axis], [page:Float angle] ) + sul [page:.quaternion quaternione]. +

+ +

[method:undefined setRotationFromEuler]( [param:Euler euler] )

+

+ euler -- L'angolo di Eulero che specifica la quantità di rotazione.
+ + Chiama [page:Quaternion.setRotationFromEuler setRotationFromEuler]( [page:Euler euler] ) + sul [page:.quaternion quaternione]. +

+ +

[method:undefined setRotationFromMatrix]( [param:Matrix4 m] )

+

+ m -- ruota il quaternione della componente rotazione della matrice.
+ + Chiama [page:Quaternion.setFromRotationMatrix setFromRotationMatrix]( [page:Matrix4 m] ) + sul [page:.quaternion quaternione].

+ + Si noti che questo presuppone che il 3x3 superiore di m è una matrice di rotazione pura (cioè non ridimnsionata). +

+ +

[method:undefined setRotationFromQuaternion]( [param:Quaternion q] )

+

+ q -- Quaternione normalizzato.

+ + Copia il quaternione passato nel [page:.quaternion quaternione]. +

+ +

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

+

+ meta -- oggetto contentene metadati come i materiali, le texture o le immagini per l'oggetto.
+ Converte l'oggetto al formato three.js [link:https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4 JSON Object/Scene]. +

+ +

[method:this translateOnAxis]( [param:Vector3 axis], [param:Float distance] )

+

+ axis -- Un vettore normalizzato nello spazio dell'oggetto.
+ distance -- La distanza da traslare.

+ + Trasla un oggetto in base alla distanza lungo un asse nello spazio dell'oggetto. Questo asse si presuppone sia normalizzato. +

+ +

[method:this translateX]( [param:Float distance] )

+

Trasla l'oggetto lungo l'asse x nello spazio dell'ogetto per unità di `distance`.

+ +

[method:this translateY]( [param:Float distance] )

+

Trasla l'oggetto lungo l'asse y nello spazio dell'ogetto per unità di `distance`.

+ +

[method:this translateZ]( [param:Float distance] )

+

Trasla l'oggetto lungo l'asse z nello spazio dell'ogetto per unità di `distance`.

+ +

[method:undefined traverse]( [param:Function callback] )

+

+ callback - Una funzione con primo argomento un oggetto Object3D.

+ + Esegue la callback su questo oggetto e tutti i discendenti.
+ Nota: È sconsigliato modificare il grafico della scena all'interno della callback. +

+ +

[method:undefined traverseVisible]( [param:Function callback] )

+

+ callback - Una funzione con primo argomento un oggetto Object3D.

+ + Simile a traverse, ma la callback viene eseguita solo su oggetti visibili. + I discendenti di oggetti invisibili non vengono attraversati.
+ Nota: È sconsigliato modificare il grafico della scena all'interno della callback. +

+ +

[method:undefined traverseAncestors]( [param:Function callback] )

+

+ callback - Una funzione con primo argomento un oggetto Object3D..

+ + Esegue la callback su tutti i predecessori.
+ Nota: È sconsigliato modificare il grafico della scena all'interno della callback. +

+ +

[method:undefined updateMatrix]()

+

Aggiorna la trasformazione locale.

+ +

[method:undefined updateMatrixWorld]( [param:Boolean force] )

+

Aggiorna la trasformazione globale di un oggetto e i suoi discendenti.

+ +

[method:undefined updateWorldMatrix]( [param:Boolean updateParents], [param:Boolean updateChildren] )

+

+ updateParents - aggiorna ricorsivamente la trasformazione globale dei predecessori.
+ updateChildren - aggiorna ricorsivamente la trasformazione globale dei discendenti.

+ + Aggiorna la trasformazione globale dell'oggetto. +

+ +

[method:Vector3 worldToLocal]( [param:Vector3 vector] )

+

+ vector - Un vettore che rappresenta una posizione nello spazio world.

+ + Converte il vettore dallo spazio world allo spazio locale di questo oggetto. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/core/Raycaster.html b/docs/api/it/core/Raycaster.html new file mode 100644 index 00000000000000..9097b5271fab50 --- /dev/null +++ b/docs/api/it/core/Raycaster.html @@ -0,0 +1,217 @@ + + + + + + + + + +

[name]

+ +

+ Questa classe è progettata per aiutare il [link:https://en.wikipedia.org/wiki/Ray_casting raycasting]. + Il raycasting viene utilizzato, tra le altre cose, per il mouse picking (per capire su quali oggetti dello spazio 3d si trova il mouse). +

+ +

Codice di Esempio

+ + const raycaster = new THREE.Raycaster(); + const pointer = new THREE.Vector2(); + + function onPointerMove( event ) { + + // calcolare la posizione del puntatore nelle coordinate del dispositivo normalizzate + // (-1 to +1) per entrambi i componenti + + pointer.x = ( event.clientX / window.innerWidth ) * 2 - 1; + pointer.y = - ( event.clientY / window.innerHeight ) * 2 + 1; + + } + + function render() { + + // aggiornare il raggio di picking con la telecamera e la posizione del puntatore + raycaster.setFromCamera( pointer, camera ); + + // calcolare gli oggetti intersecati dal raggio di picking + const intersects = raycaster.intersectObjects( scene.children ); + + for ( let i = 0; i < intersects.length; i ++ ) { + + intersects[ i ].object.material.color.set( 0xff0000 ); + + } + + renderer.render( scene, camera ); + + } + + window.addEventListener( 'pointermove', onPointerMove ); + + window.requestAnimationFrame(render); + + + +

Esempi

+ +

+ [example:webgl_interactive_cubes Raycasting to a Mesh]
+ [example:webgl_interactive_cubes_ortho Raycasting to a Mesh in using an OrthographicCamera]
+ [example:webgl_interactive_buffergeometry Raycasting to a Mesh with BufferGeometry]
+ [example:webgl_instancing_raycast Raycasting to a InstancedMesh]
+ [example:webgl_interactive_lines Raycasting to a Line]
+ [example:webgl_interactive_raycasting_points Raycasting to Points]
+ [example:webgl_geometry_terrain_raycast Terrain raycasting]
+ [example:webgl_interactive_voxelpainter Raycasting to paint voxels]
+ [example:webgl_raycaster_texture Raycast to a Texture] +

+ +

Costruttore

+ +

[name]( [param:Vector3 origin], [param:Vector3 direction], [param:Float near], [param:Float far] )

+

+ [page:Vector3 origin] — Il vettore di origine da cui viene proiettato il raggio.
+ [page:Vector3 direction] — Il vettore direzione che fornisce la direzione del raggio. Deve essere normalizzato.
+ [page:Float near] — Tutti i risultati restituiti sono più lontani che vicini. Near non può essere negativo. Il valore predefinito è 0.
+ [page:Float far] — Tutti i risultati ottenuti sono più vicini che lontani. Far non può essere minore di near. Il valore predefinito è Infinity. +

+

+ Crea un nuovo oggetto raycaster.
+

+ + +

Proprietà

+ +

[property:Float far]

+

+ Il fattore `far` del raycaster. Questo valore indica quali oggetti possono essere scartati in base alla distanza. + Questo valore non dovrebbe essere negativo e deve essere maggiore del valore della proprietà `near`. +

+ +

[property:Float near]

+

+ Il fattore `near` del raycaster. Questo valore indica quali oggetti possono essere scartati in base alla distanza. + Questo valore non dovrebbe essere negativo e deve essere minore del valore della proprietà `far`. +

+ +

[property:Camera camera]

+

+ La telecamera da utilizzare durante il raycast contro oggetti dipendenti dalla vista, come oggetti su cartelloni pubblicitari + come [page:Sprites]. Questo campo può essere settato manualmente o viene impostato quando si chiama il metodo "setFromCamera". + + L'impostazione predefinita è null. +

+ +

[property:Layers layers]

+

+ Utilizzato da [name] per ignorare selettivamente oggetti 3D durante l'esecuzione di test di intersezione. Il seguente codice di esempio + assicura che solo gli oggetti 3D sul layer `1` vengano rispettati dall'istanza di [name]. + + + raycaster.layers.set( 1 ); + object.layers.enable( 1 ); + + +

+ +

[property:Object params]

+

+ Un oggetto con le seguenti proprietà: + + +{ + Mesh: {}, + Line: { threshold: 1 }, + LOD: {}, + Points: { threshold: 1 }, + Sprite: {} +} + + + Dove threshold è la precisione del raycaster quando intercetta gli oggetti, in unità di world. +

+ +

[property:Ray ray]

+

Il [Page:Ray raggio] usato per il raycasting.

+ + +

Metodi

+ +

[method:undefined set]( [param:Vector3 origin], [param:Vector3 direction] )

+

+ [page:Vector3 origin] — Il vettore di origine da cui viene proiettato il raggio.
+ [page:Vector3 direction] — Il vettore di direzione normalizzato che fornisce la direzione al raggio. +

+

+ Aggiorna il raggio con una nuova origine e direzione. Si noti che questo metodo copia solamente i valori dagli argomenti. +

+ +

[method:undefined setFromCamera]( [param:Vector2 coords], [param:Camera camera] )

+

+ [page:Vector2 coords] — coordinate 2D del mouse, in coordinate normalizzate del dispositivo (NDC)---i componenti X e Y dovrebbero essere tra -1 e 1.
+ [page:Camera camera] — telecamera da cui dovrebbe provenire il raggio. +

+

+ Aggiorna il raggio con una nuova origine e direzione. +

+ +

[method:Array intersectObject]( [param:Object3D object], [param:Boolean recursive], [param:Array optionalTarget] )

+

+ [page:Object3D object] — L'oggetto da verificare per l'intersezione con il raggio.
+ [page:Boolean recursive] — Se true, controlla anche tutti i discendenti. Altrimenti controlla soltanto + l'intersezione con l'oggetto. Il valore predefinito è true.
+ [page:Array optionalTarget] — (opzionale) obiettivo per impostare il risultato. + Altrimenti viene istanziato un nuovo [page:Array]. Se impostato, è necessario cancellare questo array prima di ogni chiamata (ad esempio, array.length = 0;). +

+

+ Controlla tutte le intersezioni tra il raggio e l'oggetto con o senza i discendenti. + Le intersezioni sono restituite ordinate per distanza, le più vicine prima. Viene restituito un array di intersezioni... +

+ + [ { distance, point, face, faceIndex, object }, ... ] + +

+ [page:Float distance] – distanza tra l'origine del raggio e l'intersezione
+ [page:Vector3 point] – punto di intersezione, nelle coordinate world
+ [page:Object face] – faccia intersecata
+ [page:Integer faceIndex] – indice della faccia intersecata
+ [page:Object3D object] – l'oggetto intersecato
+ [page:Vector2 uv] - le coordinate U,V nel punto di intersezione
+ [page:Vector2 uv2] - Secondo insieme delle coordinate U,V nel punto di intersezione
+ [page:Integer instanceId] – Il numero di indice dell'istanza in cui il raggio interseca la InstancedMesh. +

+

+ `Raycaster` delega al metodo [page:Object3D.raycast raycast] dell'oggetto passato, + quando valuta se il raggio interseca l'oggetto o no. Ciò permette alle mesh di rispondere + in modo diverso al raycasting rispetto alle linee e alle nuvole di punti. +

+

+ *Nota* per le mesh, le facce devono essere puntate verso l'origine del [page:.ray raggio] per essere rilevate; + le intersezioni del raggio passato attraverso il retro della faccia non saranno rilevate. Per eseguire il raycast + su entrambe le facce dell'oggetto, ti consigliamo di impostare la proprietà [page:Material.side side] del [page:Mesh.material materiale] + a `THREE.DoubleSide`. +

+ +

[method:Array intersectObjects]( [param:Array objects], [param:Boolean recursive], [param:Array optionalTarget] )

+

+ [page:Array objects] — Gli oggetti da controllare per l'intersezione con il raggio.
+ [page:Boolean recursive] — Se true, controlla anche i discendenti degli oggetti. Altrimenti controlla soltanto + l'intersezione con gli oggetti. Il valore predefinito è true.
+ [page:Array optionalTarget] — (opzionale) obiettivo per impostare il risultato. + Altrimenti viene istanziato un nuovo [page:Array]. Se impostato, è necessario cancellare questo array prima di ogni chiamata (ad esempio, array.length = 0;). +

+

+ Controlla tutte le intersezioni tra il raggio e gli oggetti con o senza i discendenti. + Le intersezioni sono restituite ordinate per distanza, prima le più vicine. Le intersezioni + hanno la stessa forma di quelle restituite da [page:.intersectObject]. +

+ + +

Source

+ +

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

+ + diff --git a/docs/api/it/core/Uniform.html b/docs/api/it/core/Uniform.html new file mode 100644 index 00000000000000..997e0fd3f15412 --- /dev/null +++ b/docs/api/it/core/Uniform.html @@ -0,0 +1,274 @@ + + + + + + + + + +

[name]

+ +

Le uniform sono delle variabili GLSL globali. Vengono passate ai programmi shader. +

+ +

Codice di Esempio

+

+ Quando si dichiara una uniform di uno [page:ShaderMaterial], viene dichiarata per valore o per oggetto. +

+ + uniforms: { + time: { value: 1.0 }, + resolution: new Uniform( new Vector2() ) + }; + + +

Tipi Uniform

+ +

+ Ogni uniform deve avere una proprietà `value`. Il tipo di value deve corrispondere al tipo + della variabile uniform nel codice GLSL come specificato per i tipi primitivi GLSL nella tabella + sotto. Anche le strutture uniform e gli array sono supportati. Gli array GLSL di tipo primitivo + devono essere specificati come un array del corrispondente oggetto THREE o come un array flat + contenente i dati di tutti gli oggetti. In altre parole; le primitive GLSL negli array + non devono essere rappresentate dagli array. Questa regola non si applica in modo transitivo. + Un array di array `vec2`, ciascuno con una lunghezza di cinque vettori, deve essere un array di array, + di cinque oggetti [page:Vector2] o di dieci `numeri`. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Tipi Uniform
GLSL typeJavaScript type
int[page:Number]
uint (WebGL 2)[page:Number]
float[page:Number]
bool[page:Boolean]
bool[page:Number]
vec2[page:Vector2 THREE.Vector2]
vec2[page:Float32Array Float32Array] (*)
vec2[page:Array Array] (*)
vec3[page:Vector3 THREE.Vector3]
vec3[page:Color THREE.Color]
vec3[page:Float32Array Float32Array] (*)
vec3[page:Array Array] (*)
vec4[page:Vector4 THREE.Vector4]
vec4[page:Quaternion THREE.Quaternion]
vec4[page:Float32Array Float32Array] (*)
vec4[page:Array Array] (*)
mat2[page:Float32Array Float32Array] (*)
mat2[page:Array Array] (*)
mat3[page:Matrix3 THREE.Matrix3]
mat3[page:Float32Array Float32Array] (*)
mat3[page:Array Array] (*)
mat4[page:Matrix4 THREE.Matrix4]
mat4[page:Float32Array Float32Array] (*)
mat4[page:Array Array] (*)
ivec2, bvec2[page:Float32Array Float32Array] (*)
ivec2, bvec2[page:Array Array] (*)
ivec3, bvec3[page:Int32Array Int32Array] (*)
ivec3, bvec3[page:Array Array] (*)
ivec4, bvec4[page:Int32Array Int32Array] (*)
ivec4, bvec4[page:Array Array] (*)
sampler2D[page:Texture THREE.Texture]
samplerCube[page:CubeTexture THREE.CubeTexture]
+ +

+ (*) Lo stesso per un array (dimensione) (più interno) dello stesso tipo GLSL, contenente i componenti di tutti i vettori o le matrici nell'array. +

+ +

Uniform Strutturate

+ +

+ A volte vuoi organizzare le uniform come `structs` nel tuo codice shader. + È necessario utilizzare lo stile seguente in modo che three.js sia in grado di elaborare dati strutturati uniform. +

+ + uniforms = { + data: { + value: { + position: new Vector3(), + direction: new Vector3( 0, 0, 1 ) + } + } + }; + + Questa definizione può essere mappata con il seguente codice GLSL: + + struct Data { + vec3 position; + vec3 direction; + }; + + uniform Data data; + + +

Uniforms Strutturate con Array

+ +

+ È anche possibile gestire `structs` negli array. La sintassi per questo caso d'uso appare così: +

+ + const entry1 = { + position: new Vector3(), + direction: new Vector3( 0, 0, 1 ) + }; + const entry2 = { + position: new Vector3( 1, 1, 1 ), + direction: new Vector3( 0, 1, 0 ) + }; + + uniforms = { + data: { + value: [ entry1, entry2 ] + } + }; + + Questa definizione può essere mappata con il seguente codice GLSL: + + struct Data { + vec3 position; + vec3 direction; + }; + + uniform Data data[ 2 ]; + + +

Costruttore

+ +

[name]( [param:Object value] )

+

+ value -- Un oggetto contenente il valore per impostare la uniform. Il suo tipo deve essere uno dei tipi uniform descritti sopra. +

+ +

Proprietà

+ +

[property:Object value]

+

+ Il valore corrente della uniform. +

+ +

Metodi

+ +

[method:Uniform clone]()

+

+ Restituisce un clone della uniform.
+ Se il valore della proprietà uniform è un [page:Object] con un metodo clone(), viene utilizzato, altrimenti il valore è copiato per assegnazione. + I valori dell'array sono condivisi tra le [page:Uniform] clonate. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/core/bufferAttributeTypes/BufferAttributeTypes.html b/docs/api/it/core/bufferAttributeTypes/BufferAttributeTypes.html new file mode 100644 index 00000000000000..21be170adc4d61 --- /dev/null +++ b/docs/api/it/core/bufferAttributeTypes/BufferAttributeTypes.html @@ -0,0 +1,65 @@ + + + + + + + + + + [page:BufferAttribute] → + +

Tipi di BufferAttribute

+ +

+ Ci sono nove tipi di [page:BufferAttribute] disponibili in three.js. Questi corrispondono ai + [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray#Syntax Typed Array] JavaScript. +

+ + + THREE.Float64BufferAttribute + THREE.Float32BufferAttribute + THREE.Float16BufferAttribute + THREE.Uint32BufferAttribute + THREE.Int32BufferAttribute + THREE.Uint16BufferAttribute + THREE.Int16BufferAttribute + THREE.Uint8ClampedBufferAttribute + THREE.Uint8BufferAttribute + THREE.Int8BufferAttribute + + +

Costruttore

+ +

Tutti i precedenti sono chiamati allo stesso modo.

+ +

TypedBufferAttribute( [param:Array_or_Integer array], [param:Integer itemSize], [param:Boolean normalized] )

+

+ array -- può essere un array tipizzato o non tipizzato (normale) o una lunghezza intera. + Un valore dell'array sarà convertito nel Tipo specificato. + Se viene data una lunghezza sarà creato un nuovo TypedArray, inizializzato con tutti gli elementi impostati a zero.

+ + itemSize -- il numero di valori dell'array che dovrebbe essere associato ad un particolare vertice.

+ + normalized -- (opzionale) indica come i dati sottostanti nel buffer vengono mappati ai valori nel codice GLSL. +

+ +

Proprietà

+ +

+ Vedi [page:BufferAttribute] per le prorietà ereditate. +

+ +

Metodi

+ +

+ Vedi [page:BufferAttribute] per i metodi ereditati. +

+ +

Source

+ +

+ [link:https://github.com/mrdoob/three.js/blob/master/src/core/BufferAttribute.js src/core/BufferAttribute.js] +

+ + diff --git a/docs/list.json b/docs/list.json index 2436334b394f90..ee6d1a961f2375 100644 --- a/docs/list.json +++ b/docs/list.json @@ -1193,6 +1193,27 @@ "Materiali": "api/it/constants/Materials", "Renderer": "api/it/constants/Renderer", "Texture": "api/it/constants/Textures" + }, + + "Core": { + "BufferAttribute": "api/it/core/BufferAttribute", + "BufferGeometry": "api/it/core/BufferGeometry", + "Clock": "api/it/core/Clock", + "EventDispatcher": "api/it/core/EventDispatcher", + "GLBufferAttribute": "api/it/core/GLBufferAttribute", + "InstancedBufferAttribute": "api/it/core/InstancedBufferAttribute", + "InstancedBufferGeometry": "api/it/core/InstancedBufferGeometry", + "InstancedInterleavedBuffer": "api/it/core/InstancedInterleavedBuffer", + "InterleavedBuffer": "api/it/core/InterleavedBuffer", + "InterleavedBufferAttribute": "api/it/core/InterleavedBufferAttribute", + "Layers": "api/it/core/Layers", + "Object3D": "api/it/core/Object3D", + "Raycaster": "api/it/core/Raycaster", + "Uniform": "api/it/core/Uniform" + }, + + "Core / BufferAttributes": { + "BufferAttribute Types": "api/it/core/bufferAttributeTypes/BufferAttributeTypes" } } }, From 4da6a7820d2caaa6869fdae1e5a76a6e6a20a8bc Mon Sep 17 00:00:00 2001 From: Angela Busato Date: Tue, 30 Aug 2022 11:35:01 +0200 Subject: [PATCH 06/12] feat: add Extras italian version --- docs/api/it/extras/DataUtils.html | 38 +++++ docs/api/it/extras/Earcut.html | 34 ++++ docs/api/it/extras/ImageUtils.html | 38 +++++ docs/api/it/extras/PMREMGenerator.html | 111 +++++++++++++ docs/api/it/extras/ShapeUtils.html | 52 ++++++ docs/api/it/extras/core/Curve.html | 132 +++++++++++++++ docs/api/it/extras/core/CurvePath.html | 70 ++++++++ docs/api/it/extras/core/Interpolations.html | 48 ++++++ docs/api/it/extras/core/Path.html | 150 ++++++++++++++++++ docs/api/it/extras/core/Shape.html | 104 ++++++++++++ docs/api/it/extras/core/ShapePath.html | 99 ++++++++++++ docs/api/it/extras/curves/ArcCurve.html | 26 +++ .../it/extras/curves/CatmullRomCurve3.html | 80 ++++++++++ .../it/extras/curves/CubicBezierCurve.html | 75 +++++++++ .../it/extras/curves/CubicBezierCurve3.html | 76 +++++++++ docs/api/it/extras/curves/EllipseCurve.html | 91 +++++++++++ docs/api/it/extras/curves/LineCurve.html | 45 ++++++ docs/api/it/extras/curves/LineCurve3.html | 44 +++++ .../extras/curves/QuadraticBezierCurve.html | 70 ++++++++ .../extras/curves/QuadraticBezierCurve3.html | 71 +++++++++ docs/api/it/extras/curves/SplineCurve.html | 62 ++++++++ docs/list.json | 30 ++++ 22 files changed, 1546 insertions(+) create mode 100644 docs/api/it/extras/DataUtils.html create mode 100644 docs/api/it/extras/Earcut.html create mode 100644 docs/api/it/extras/ImageUtils.html create mode 100644 docs/api/it/extras/PMREMGenerator.html create mode 100644 docs/api/it/extras/ShapeUtils.html create mode 100644 docs/api/it/extras/core/Curve.html create mode 100644 docs/api/it/extras/core/CurvePath.html create mode 100644 docs/api/it/extras/core/Interpolations.html create mode 100644 docs/api/it/extras/core/Path.html create mode 100644 docs/api/it/extras/core/Shape.html create mode 100644 docs/api/it/extras/core/ShapePath.html create mode 100644 docs/api/it/extras/curves/ArcCurve.html create mode 100644 docs/api/it/extras/curves/CatmullRomCurve3.html create mode 100644 docs/api/it/extras/curves/CubicBezierCurve.html create mode 100644 docs/api/it/extras/curves/CubicBezierCurve3.html create mode 100644 docs/api/it/extras/curves/EllipseCurve.html create mode 100644 docs/api/it/extras/curves/LineCurve.html create mode 100644 docs/api/it/extras/curves/LineCurve3.html create mode 100644 docs/api/it/extras/curves/QuadraticBezierCurve.html create mode 100644 docs/api/it/extras/curves/QuadraticBezierCurve3.html create mode 100644 docs/api/it/extras/curves/SplineCurve.html diff --git a/docs/api/it/extras/DataUtils.html b/docs/api/it/extras/DataUtils.html new file mode 100644 index 00000000000000..b6c5b58e41c7a0 --- /dev/null +++ b/docs/api/it/extras/DataUtils.html @@ -0,0 +1,38 @@ + + + + + + + + + +

[name]

+ +

+ Una classe che contiene funzioni di utilità per i dati. +

+ +

Metodi

+ +

[method:Number toHalfFloat]( [param:Number val] )

+

+ val -- Un valore in virgola mobile a precisione singola.

+ + Restituisce un valore in virgola mobile a mezza precisione dal valore in virgola mobile a singola precisione passato. +

+ +

[method:Number fromHalfFloat]( [param:Number val] )

+

+ val -- Un valore in virgola mobile a mezza precisione.

+ + Restituisce un valore in virgola mobile a singola precisione dal valore in virgola mobile a mezza precisione passato. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/Earcut.html b/docs/api/it/extras/Earcut.html new file mode 100644 index 00000000000000..2268bd10be8605 --- /dev/null +++ b/docs/api/it/extras/Earcut.html @@ -0,0 +1,34 @@ + + + + + + + + + +

[name]

+ +

+ Un'implementazione dell'algoritmo di triangolazione dei poligoni earcut. Il codice è un porting di [link:https://github.com/mapbox/earcut mapbox/earcut]. +

+ +

Metodi

+ +

[method:Array triangulate]( data, holeIndices, dim )

+

+ data -- Un array flat di coordinate dei vertici.
+ holeIndices -- Un array di indici di hole, se presenti.
+ dim -- Il numero di coordinate per vertice nell'array di input.

+ + Triangola la definizione di forma data restituendo un array di triangoli. + Un triangolo è definito da tre numeri interi consecutivi che rappresentano gli indici dei vertici. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/ImageUtils.html b/docs/api/it/extras/ImageUtils.html new file mode 100644 index 00000000000000..cbe847f74dced5 --- /dev/null +++ b/docs/api/it/extras/ImageUtils.html @@ -0,0 +1,38 @@ + + + + + + + + + +

[name]

+ +

+ Una classe contente funzioni di utilità per le immagini. +

+ +

Metodi

+ +

[method:String getDataURL]( [param:HTMLCanvasElement image] | [param:HTMLImageElement image] | [param:ImageBitmap image] )

+

+ image -- L'oggetto immagine.

+ + Restituisce un URI di dati contenente una rappresentazione dell'immagine data. +

+ +

[method:Object sRGBToLinear]( [param:HTMLCanvasElement image] | [param:HTMLImageElement image] | [param:ImageBitmap image] )

+

+ image -- L'oggetto immagine.

+ + Converte i dati dell'immagine sRGB passata in uno spazio colore lineare. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/PMREMGenerator.html b/docs/api/it/extras/PMREMGenerator.html new file mode 100644 index 00000000000000..1d73d4e595fd67 --- /dev/null +++ b/docs/api/it/extras/PMREMGenerator.html @@ -0,0 +1,111 @@ + + + + + + + + + +

[name]

+ +

+ Questa classe genera un Prefiltered Mipmapped Radiance Environment Map (PMREM) da una texture di ambiente cubeMap. + Ciò consente di accedere rapidamente a diversi livelli di sfocatura (blur) in base alla rugosità (roughness) del materiale. + A differenza di una catena mipmap tradizionale, scende solo al livello LOD_MIN (sopra) e quindi crea 'mips' aggiuntivi + ancora più filtrati alla stessa risoluzione LOD_MIN, associati a livelli di rugosità più elevati. + In questo modo manteniamo la risoluzione per interpolare uniformemente l'illuminazione diffusa, limitando al contempo + il calcolo del campionamento.

+ + Nota: La rugosità minima di [page:MeshStandardMaterial] dipende dalla dimensione della texture fornita. + Se il tuo render è di piccole dimensioni o le parti lucide hanno molte curvature, potresti comunque + riuscire ad ottenere una texture di dimensioni inferiori. + + + + + + + + + + + + + + + + + + + + + + + + + +
texture sizeminimum roughness +
160.21
320.15
640.11
1280.076
2560.054
5120.038
10240.027
+

+ +

Costruttore

+ +

[name]( [param:WebGLRenderer renderer] )

+

+ Questo costruttore crea una nuova [name]. +

+ +

Metodi

+ +

[method:WebGLRenderTarget fromScene]( [param:Scene scene], [param:Number sigma], [param:Number near], [param:Number far] )

+

+ [page:Scene scene] - La scena data.
+ [page:Number sigma] - (opzionale) Specifica un raggio di blur in radianti da applicare alla scena prima della generazione PMREM. + Il valore predefinito è `0`.
+ [page:Number near] - (opzionale) Il valore del piano near. Il valore predefinito è `0.1`.
+ [page:Number far] - (opzionale) Il valore del piano far. Il valore predefinito è `100`.

+ + Genera un PMREM da una scena fornita, che può essere più veloce rispetto all'utilizzo di un'immagine se + la larghezza di banda della rete è bassa. I piani near e far opzionali garantiscono che la scena sia renderizzata completamente + (la cubeCamera è posizionata nell'origine). +

+ +

[method:WebGLRenderTarget fromEquirectangular]( [param:Texture equirectangular] )

+

+ [page:Texture equirectangular] - La texture equirettangolare.

+ + Genera una PMREM da una texture equirettangolare. +

+ +

[method:WebGLRenderTarget fromCubemap]( [param:CubeTexture cubemap] )

+

+ [page:CubeTexture cubemap] - La texture cubemap.

+ + Genera una PMREM da una texture cubemap. +

+ +

[method:undefined compileCubemapShader]()

+

+ Pre-compila lo shader cubemap. Puoi ottenere un avvio più rapido invocando questo metodo durante il recupero di rete della texture per una + maggiore concorrenza. +

+ +

[method:undefined compileEquirectangularShader]()

+

+ Pre-compila lo shader equirettangolare. Puoi ottenere un avvio più rapido invocando questo metodo durante il recupero di rete della texture per una + maggiore concorrenza. +

+ +

[method:undefined dispose]()

+

+ Elimina la memoria interna del PMREMGenerator. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/ShapeUtils.html b/docs/api/it/extras/ShapeUtils.html new file mode 100644 index 00000000000000..38d819c6e6072a --- /dev/null +++ b/docs/api/it/extras/ShapeUtils.html @@ -0,0 +1,52 @@ + + + + + + + + + +

[name]

+ +

+ Una classe contenente funzioni di utilità per le forme (shape).

+ + Si noti che queste sono tutte funzioni lineari quindi è necessario calcolare separatamente i componenti + x, y (e z, w se presenti) di un vettore. +

+ + +

Metodi

+ +

[method:Number area]( contour )

+

+ contour -- poligono 2D. Un array di THREE.Vector2().

+ + Calcola l'area di un poligono di contorno (2D). +

+ +

[method:Boolean isClockWise]( pts )

+

+ pts -- punti che definiscono un poligono 2D.

+ + Si noti che questa è una funzione lineare quindi è necessario calcolare separatamente i componenti + x,y di un poligono.

+ + Utilizzato internamente da [page:Path Path], + [page:ExtrudeGeometry ExtrudeGeometry] e [page:ShapeGeometry ShapeGeometry]. +

+ +

[method:Array triangulateShape]( contour, holes )

+

+ contour -- poligono 2D. Un array di [page:Vector2].
+ holes -- Un array che contiene array di [page:Vector2]. Ogni array rappresenta una singola definizione di hole.

+

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/core/Curve.html b/docs/api/it/extras/core/Curve.html new file mode 100644 index 00000000000000..96e4679ee87986 --- /dev/null +++ b/docs/api/it/extras/core/Curve.html @@ -0,0 +1,132 @@ + + + + + + + + + +

[name]

+ +

+ Una classe base astratta per la creazione di un oggetto [name] che contiene i metodi di interpolazione. + Per un array di [name] vedere [page:CurvePath]. +

+ +

Costruttore

+ + +

[name]()

+

+ Questo costruttore crea una nuova [name]. +

+ +

Proprietà

+ +

[property:Integer arcLengthDivisions]

+

+ Questo valore determina la quatità di divisioni quando vengono calcolate le lunghezze cumulative dei segmenti tramite [page:.getLengths]. + Per garantire la precisione quando vengono utilizzati metodi come [page:.getSpacedPoints], si consiglia di aumentare la proprietà + [page:.arcLengthDivisions] se la curva è molto grande. Il valore predefinito è 200. +

+ +

Metodi

+ +

[method:Vector getPoint]( [param:Float t], [param:Vector optionalTarget] )

+

+ [page:Float t] - Una posizione sulla curva. Deve essere compreso nell'intervallo [ 0, 1 ].
+ [page:Vector optionalTarget] — (opzionale) Se specificato, il risultato verrà copiato in questo vettore, + altrimenti verrà creato un nuovo vettore.

+ + Restituisce un vettore per una data posizione sulla curva. +

+ +

[method:Vector getPointAt]( [param:Float u], [param:Vector optionalTarget] )

+

+ [page:Float u] - Una posizione sulla curva in base alla lunghezza dell'arco. Deve essere compreso nell'intervallo [ 0, 1 ].
+ [page:Vector optionalTarget] — (opzionale) Se specificato, il risultato verrà copiato in questo vettore, + altrimenti verrà creato un nuovo vettore.

+ + Restituisce un vettore per una data posizione sulla curva in base alla lunghezza dell'arco. +

+ +

[method:Array getPoints]( [param:Integer divisions] )

+

+ divisions -- numero di pezzi in cui dividere la curva. Il valore predefinito è `5`.

+ + Restituisce un insieme di divisioni + 1 punto usando getPoint( t ). +

+ +

[method:Array getSpacedPoints]( [param:Integer divisions] )

+

+ divisions -- numero di pezzi in cui dividere la curva. Il valore predefinito è `5`.

+ + Restituisce un insieme di divisioni + 1 punto equispaziato usando getPointAt( u ). +

+ +

[method:Float getLength]()

+

Restituisce la lunghezza totale dell'arco della curva.

+ +

[method:Array getLengths]( [param:Integer divisions] )

+

Restituisce la lista delle lunghezze cumulative del segmento.

+ +

[method:undefined updateArcLengths]()

+

+ Aggiorna la cache della distanza cumulativa del segmento. Il metodo deve essere chiamato ogni volta + che i parametri della curva vengono modificati. Se una curva aggiornata fa parte di una curva composta come + [page:CurvePath], [page:.updateArcLengths]() deve essere chiamato anche sulla curva composta. +

+ +

[method:Float getUtoTmapping]( [param:Float u], [param:Float distance] )

+

+ Dato u nell'intervallo ( 0 .. 1 ), restituisce [page:Float t] anche nell'intervallo ( 0 .. 1 ). + u e t possono quindi essere utilizzati per fornire punti equidistanti dalle estremità della curva, utilizzando + [page:.getPoint]. +

+ +

[method:Vector getTangent]( [param:Float t], [param:Vector optionalTarget] )

+

+ [page:Float t] - Una posizione sulla curva. Deve essere compreso nell'intervallo [ 0, 1 ].
+ [page:Vector optionalTarget] — (opzionale) Se specificato, il risultato sarà copiato in questo vettore, + altrimenti sarà creato un nuovo vettore.

+ + Restituisce un vettore unitario tangente a t. Se la curva derivata non implementa la sua derivazione tangente, + per trovare la sua pendenza verranno utilizzati due punti distanti un piccolo delta, che sembrano fornire + un'approssimazione ragionevole. +

+ +

[method:Vector getTangentAt]( [param:Float u], [param:Vector optionalTarget] )

+

+ [page:Float u] - Una posizione sulla curva in base alla lunghezza dell'arco. Deve essere compreso nell'intervallo [ 0, 1 ].
+ [page:Vector optionalTarget] — (opzionale) Se specificato, il risultato sarà copiato in questo vettore, + altrimenti sarà creato un nuovo vettore.

+ + Restituisce la tangente in un punto equidistante dalle estremità della curva dal punto indicato + in [page:.getTangent]. +

+ +

[method:Object computeFrenetFrames]( [param:Integer segments], [param:Boolean closed] )

+

+ Genera i Frame Franet. Richiede una definizione della curva nello spazio 3D. Utilizzata nelle geometrie come [page:TubeGeometry] o [page:ExtrudeGeometry]. +

+ +

[method:Curve clone]()

+

Crea un clone di questa istanza.

+ +

[method:this copy]( [param:Curve source] )

+

Copia un altro oggetto [name] in questa istanza.

+ +

[method:Object toJSON]()

+

Restituisce un oggetto JSON rappresentazione di questa istanza.

+ +

[method:this fromJSON]( [param:Object json] )

+

Copia i dati dell'oggetto JSON dato in questa istanza.

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/core/CurvePath.html b/docs/api/it/extras/core/CurvePath.html new file mode 100644 index 00000000000000..0a8a011d3bc885 --- /dev/null +++ b/docs/api/it/extras/core/CurvePath.html @@ -0,0 +1,70 @@ + + + + + + + + + + [page:Curve] → + +

[name]

+ +

+ Una classe base atratta che estende [page:Curve]. Una CurvePath è semplicemente un array di curve collegate, + ma mantiene le API di una curva. +

+ +

Costruttore

+ +

[name]()

+

+ Il costruttore non prende parametri. +

+ +

Proprietà

+

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

+ +

[property:Array curves]

+

L'array di [page:Curve Curve].

+ +

[property:Boolean autoClose]

+

Se chiudere automaticamente o meno il percorso.

+ +

Metodi

+

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

+ +

[method:undefined add]( [param:Curve curve] )

+

Aggiunge una curva all'array [page:.curves].

+ +

[method:undefined closePath]()

+

Aggiunge una [page:LineCurve lineCurve] per chiudere il percorso.

+ +

[method:Array getCurveLengths]()

+

Ottieni l'elenco delle lunghezze delle curve cumulative nell'array [page:.curves].

+ +

[method:Array getPoints]( [param:Integer divisions] )

+

+ divisions -- il numero di pezzi in cui dividere la curva. Il valore predefinito è `12`.

+ + Restituisce un array di punti che rappresentano una sequenza di curve. Il paramentro `division` + definisce il numero di pezzi in cui è suddivisa ciascuna curva. Tuttavia, ai fini dell'ottimizzazione + e della qualità, la risoluzione di campionamento per ogni curva dipende dal suo tipo. Ad esempio, per una + [page:LineCurve], il numero restituito di punti è sempre solo 2. +

+ +

[method:Array getSpacedPoints]( [param:Integer divisions] )

+

+ divisions -- il numero di pezzi in cui dividere la curva. Il valore predefinito è `40`.

+ + Restituisce un insieme di divisioni + 1 punto equispaziato usando getPointAt( u ). +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/core/Interpolations.html b/docs/api/it/extras/core/Interpolations.html new file mode 100644 index 00000000000000..a58b4047436a93 --- /dev/null +++ b/docs/api/it/extras/core/Interpolations.html @@ -0,0 +1,48 @@ + + + + + + + + + +

[name]

+ +

+ Le [name] contengono funzioni spline e Bézier utilizzate internamente dalle classi di curve concrete. +

+ +

Metodi

+ +

[method:Float CatmullRom]( [param:Float t], [param:Float p0], [param:Float p1], [param:Float p2], [param:Float p3] )

+

+ t -- peso di interpolazione.
+ p0, p1, p2, p3 -- i punti che definiscono la curva spline.

+ + Usato internamente da [page:SplineCurve SplineCurve]. +

+ +

[method:Float QuadraticBezier]( [param:Float t], [param:Float p0], [param:Float p1], [param:Float p2] )

+

+ t -- peso di interpolazione.
+ p0, p1, p2 -- i punti di inizio, controllo e fine che definiscono la curva.

+ + Usato internamente da [page:QuadraticBezierCurve3 QuadraticBezierCurve3] e [page:QuadraticBezierCurve QuadraticBezierCurve]. +

+ +

[method:Float CubicBezier]( [param:Float t], [param:Float p0], [param:Float p1], [param:Float p2], [param:Float p3] )

+

+ t -- peso di interpolazione.
+ p0, p1, p2, p3 -- i punti di inizio, controllo (doppio) e fine che definiscono la curva.

+ + Usato internamente da [page:CubicBezierCurve3 CubicBezierCurve3] e [page:CubicBezierCurve CubicBezierCurve]. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/core/Path.html b/docs/api/it/extras/core/Path.html new file mode 100644 index 00000000000000..dbf4734b7a6480 --- /dev/null +++ b/docs/api/it/extras/core/Path.html @@ -0,0 +1,150 @@ + + + + + + + + + + [page:Curve] → [page:CurvePath] → + +

[name]

+ +

+ Una rappresentazione del percorso 2D. La classe mette a dispozione metodi per la + creazione di tracciati e contorni di forme 2D simili all'API Canvas 2D. +

+ +

Codice di Esempio

+ + + const path = new THREE.Path(); + + path.lineTo( 0, 0.8 ); + path.quadraticCurveTo( 0, 1, 0.2, 1 ); + path.lineTo( 1, 1 ); + + const points = path.getPoints(); + + const geometry = new THREE.BufferGeometry().setFromPoints( points ); + const material = new THREE.LineBasicMaterial( { color: 0xffffff } ); + + const line = new THREE.Line( geometry, material ); + scene.add( line ); + + + +

Costruttore

+ + +

[name]( [param:Array points] )

+

+ points -- (opzionale) array di [page:Vector2 Vector2].

+ + Crea un Path dai punti. Il primo punto definisce l'offset, quindi i punti successivi sono + aggiunti all'array [page:CurvePath.curves curves] come [page:LineCurve LineCurves].

+ + Se non ci sono punti specificati, viene creato un path vuoto e il [page:.currentPoint] viene impostato + nell'origine. +

+ + +

Proprietà

+

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

+ +

[property:Vector2 currentPoint]

+

L'offset corrente del path. Qualsiasi nuova [page:Curve] aggiunta inizierà da qui.

+ + +

Metodi

+

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

+ +

[method:this absarc]( [param:Float x], [param:Float y], [param:Float radius], [param:Float startAngle], [param:Float endAngle], [param:Boolean clockwise] )

+

+ x, y -- Il centro assoluto dell'arco.
+ radius -- Il raggio dell'arco.
+ startAngle -- L'angolo iniziale in radianti.
+ endAngle -- L'angolo finale in radianti.
+ clockwise -- Scorre l'arco in senso orario. Il valore predefinito è `false`.

+ + Aggiunge al path un'[page:EllipseCurve EllipseCurve] posizionata in modo assoluto. +

+ +

[method:this absellipse]( [param:Float x], [param:Float y], [param:Float xRadius], [param:Float yRadius], [param:Float startAngle], [param:Float endAngle], [param:Boolean clockwise], [param:Float rotation] )

+

+ x, y -- Il centro assoluto dell'ellisse.
+ xRadius -- Il raggio dell'ellisse nell'asse x.
+ yRadius -- Il raggio dell'ellisse nell'asse y.
+ startAngle -- L'angolo iniziale in radianti.
+ endAngle -- L'angolo finale in radianti.
+ clockwise -- Scorre l'ellisse in senso orario. Il valore predefinito è `false`.
+ rotation -- L'angolo di rotazione dell'ellisse in radianti, in senso antiorario dall'asse X. Opzionale, il valore predefinito è 0.

+ + Aggiunge al path un'[page:EllipseCurve EllipseCurve] posizionata in modo assoluto. +

+ +

[method:this arc]( [param:Float x], [param:Float y], [param:Float radius], [param:Float startAngle], [param:Float endAngle], [param:Boolean clockwise] )

+

+ x, y -- Il centro dell'arco offsettato dall'ultima chiamata.
+ radius -- Il raggio dell'arco.
+ startAngle -- L'angolo iniziale in radianti.
+ endAngle -- L'angolo finale in radianti.
+ clockwise -- Scorre l'arco in senso orario. Il valore predefinito è `false`.

+ + Aggiunge al path un'[page:EllipseCurve EllipseCurve] posizionata in modo relativo al [page:.currentPoint]. +

+ + +

[method:this bezierCurveTo]( [param:Float cp1X], [param:Float cp1Y], [param:Float cp2X], [param:Float cp2Y], [param:Float x], [param:Float y] )

+

+ Crea una curva bezier da [page:.currentPoint] con (cp1X, cp1Y) e (cp2X, cp2Y) come punti di controllo e aggiorna [page:.currentPoint] a x e y. +

+ +

[method:this ellipse]( [param:Float x], [param:Float y], [param:Float xRadius], [param:Float yRadius], [param:Float startAngle], [param:Float endAngle], [param:Boolean clockwise], [param:Float rotation] )

+

+ x, y -- Il centro dell'arco offsettato dall'ultima chiamata.
+ xRadius -- Il raggio dell'ellisse nell'asse x.
+ yRadius -- Il raggio dell'ellisse nell'asse y.
+ startAngle -- L'angolo iniziale in radianti.
+ endAngle -- L'angolo finale in radianti.
+ clockwise -- Scorre l'arco in senso orario. Il valore predefinito è `false`.

+ rotation -- L'angolo di rotazione dell'ellisse in radianti, in senso antiorario dall'asse X. Opzionale, il valore predefinito è 0.

+ + Aggiunge al path un'[page:EllipseCurve EllipseCurve] posizionata in modo relativo al [page:.currentPoint]. +

+ +

[method:this lineTo]( [param:Float x], [param:Float y] )

+

Collega una [page:LineCurve] da il [page:.currentPoint] a x, y sul percorso.

+ + +

[method:this moveTo]( [param:Float x], [param:Float y] )

+

Muove il [page:.currentPoint] a x, y.

+ + +

[method:this quadraticCurveTo]( [param:Float cpX], [param:Float cpY], [param:Float x], [param:Float y] )

+

+ Crea una curva quadratica da [page:.currentPoint] con cpX e cpY come punto di controllo e aggiorna [page:.currentPoint] a x e y. +

+ +

[method:this setFromPoints]( [param:Array vector2s] )

+

+ points -- array di [page:Vector2 Vector2].

+ + I punti vengono aggiunti all'array [page:CurvePath.curves curves] come [page:LineCurve LineCurves]. +

+ +

[method:this splineThru] ( [param:Array points] )

+

+ points - array di [page:Vector2 Vector2].

+ + Collega un nuovo [page:SplineCurve] al percorso. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/core/Shape.html b/docs/api/it/extras/core/Shape.html new file mode 100644 index 00000000000000..d8012570a65622 --- /dev/null +++ b/docs/api/it/extras/core/Shape.html @@ -0,0 +1,104 @@ + + + + + + + + + + [page:Curve] → [page:CurvePath] → [page:Path] → + +

[name]

+ +

+ Definisce un piano di forma 2D arbitrario usando percorsi con hole opzionali. Può essere usato con [page:ExtrudeGeometry], + [page:ShapeGeometry], per ottenere punti, o per ottenere facce triangolate. +

+ +

Codice di Esempio

+ + + const heartShape = new THREE.Shape(); + + heartShape.moveTo( 25, 25 ); + heartShape.bezierCurveTo( 25, 25, 20, 0, 0, 0 ); + heartShape.bezierCurveTo( - 30, 0, - 30, 35, - 30, 35 ); + heartShape.bezierCurveTo( - 30, 55, - 10, 77, 25, 95 ); + heartShape.bezierCurveTo( 60, 77, 80, 55, 80, 35 ); + heartShape.bezierCurveTo( 80, 35, 80, 0, 50, 0 ); + heartShape.bezierCurveTo( 35, 0, 25, 25, 25, 25 ); + + const extrudeSettings = { depth: 8, bevelEnabled: true, bevelSegments: 2, steps: 2, bevelSize: 1, bevelThickness: 1 }; + + const geometry = new THREE.ExtrudeGeometry( heartShape, extrudeSettings ); + + const mesh = new THREE.Mesh( geometry, new THREE.MeshPhongMaterial() ); + + +

Esempi

+ +

+ [example:webgl_geometry_shapes geometry / shapes ]
+ [example:webgl_geometry_extrude_shapes geometry / extrude / shapes ]
+ [example:webgl_geometry_extrude_shapes2 geometry / extrude / shapes2 ]
+

+ + +

Costruttore

+ + +

[name]( [param:Array points] )

+

+ points -- (opzionale) un array di [page:Vector2 Vector2].

+ + Crea una Shape dai punti. Il primo punto defisce l'offset, quindi i punti successivi vengono aggiunti + all'array [page:CurvePath.curves curves] come [page:LineCurve LineCurves].

+ + Se i punti non vengono specificati, viene creata una shape vuota e il [page:.currentPoint] viene impostato nell'origine. +

+ + +

Proprietà

+

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

+ +

[property:String uuid]

+

+ L'[link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID] di questa istanza. Viene assegnato + automaticamente, quindi non dovrebbe essere modificato. +

+ +

[property:Array holes]

+

Un array di [page:Path path] che definisce gli hole nella forma.

+ +

Metodi

+

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

+ +

[method:Array extractPoints]( [param:Integer divisions] )

+

+ divisions -- La finezza del risultato.

+ + Chiama [page:Curve.getPoints getPoints] sulla forma e l'array [page:.holes], e restituisce un oggetto della forma: + +{ + shape + holes +} + + dove shape e holes sono array di tipo [page:Vector2 Vector2]. +

+ +

[method:Array getPointsHoles]( [param:Integer divisions] )

+

+ divisions -- La finezza del risultato.

+ + Si Ottiene un array di [page:Vector2 Vector2] che rapprensenta gli hole nella forma. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/core/ShapePath.html b/docs/api/it/extras/core/ShapePath.html new file mode 100644 index 00000000000000..051a091da650e0 --- /dev/null +++ b/docs/api/it/extras/core/ShapePath.html @@ -0,0 +1,99 @@ + + + + + + + + + +

[name]

+ +

+ Questa classe viene utilizzata per convertire una serie di forme in un array di [page:Path], ad esempio una + forma SVG in un path (vedere l'esempio seguente). +

+ +

Esempi

+

+ [example:webgl_geometry_extrude_shapes2 geometry / extrude / shapes2] +

+ +

Costruttore

+ + +

[name]( )

+

+ Crea un nuovo ShapePath. Diversamente da un [page:Path], non vengono passati punti poiché lo ShapePath + è progettato per essere generato dopo la creazione. +

+ + +

Proprietà

+ +

[property:Array subPaths]

+

+ Un array di [page:Path]. +

+ +

[property:Array currentPath]

+

+ Il [page:Path] corrente che viene generato. +

+ +

[property:Color color]

+

Il [page:Color Colore] della shape, da impostazione predefinita impostato su bianco (0xffffff).

+ +

Metodi

+ +

[method:this moveTo]( [param:Float x], [param:Float y] )

+

+ Inizia un nuovo [page:Path] e chiama [page:Path.moveTo]( x, y ) su questo [page:Path]. + Punta anche [page:ShapePath.currentPath currentPath] a quel [page:Path]. +

+ +

[method:this lineTo]( [param:Float x], [param:Float y] )

+

+ Crea una linea dall'offset del [page:ShapePath.currentPath currentPath] + a X e Y e aggiorna l'offset di X e Y. +

+ +

[method:this quadraticCurveTo]( [param:Float cpX], [param:Float cpY], [param:Float x], [param:Float y] )

+

+ Crea una curva quadratica dall'offset del [page:ShapePath.currentPath currentPath] a x e y con cpX e cpY + come punto di controllo e aggiorna l'offset del [page:ShapePath.currentPath currentPath] di x e y. +

+ +

[method:this bezierCurveTo]( [param:Float cp1X], [param:Float cp1Y], [param:Float cp2X], [param:Float cp2Y], [param:Float x], [param:Float y] )

+

+ Crea una curva bazier dall'offset del [page:ShapePath.currentPath currentPath] a x e y con + cp1X, cp1Y e cp2X, cp2Y come punti di controllo e aggiorna l'offset del [page:ShapePath.currentPath currentPath] a x e y. +

+ +

[method:this splineThru] ( [param:Array points] )

+

points - Un array di [page:Vector2]

+

Collega una nuova [page:SplineCurve] al [page:ShapePath.currentPath currentPath].

+ + +

[method:Array toShapes]( [param:Boolean isCCW], [param:Boolean noHoles] )

+

+ isCCW -- Modifica la modalità di generazione degli hole e dei solidi
+ noHoles -- Se generare o meno gli hole +

+

+ Converte l'array [page:ShapePath.subPaths subPaths] in un array di Shape. Per impostazione predefinita + le forme solide sono definite in senso orario (CW) e i fori sono definiti in senso antiorario (CCW). + Se isCCW è impostato su true, le forme sono capovolte. Se il parametro noHoles è impostato su true, + tutti i percorsi sono impostati come forme solide e isCCW viene ignorato. +
+ +

+ + +

Source

+ +

+ [link:https://github.com/mrdoob/three.js/blob/master/src/extras/core/ShapePath.js src/extras/core/ShapePath.js] +

+ + diff --git a/docs/api/it/extras/curves/ArcCurve.html b/docs/api/it/extras/curves/ArcCurve.html new file mode 100644 index 00000000000000..01d3651a9af753 --- /dev/null +++ b/docs/api/it/extras/curves/ArcCurve.html @@ -0,0 +1,26 @@ + + + + + + + + + + [page:Curve] → [page:EllipseCurve] → + +

[name]

+ +

Alias per [page:EllipseCurve].

+ +

Properties

+

Vedi la classe [page:EllipseCurve] per le proprità comuni.

+ + +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/curves/CatmullRomCurve3.html b/docs/api/it/extras/curves/CatmullRomCurve3.html new file mode 100644 index 00000000000000..b3998e1144ac72 --- /dev/null +++ b/docs/api/it/extras/curves/CatmullRomCurve3.html @@ -0,0 +1,80 @@ + + + + + + + + + + [page:Curve] → + +

[name]

+ +

Crea una curva spline 3D smooth (uniforme) da una serie di punti utilizzando l'algoritmo + [link:https://en.wikipedia.org/wiki/Centripetal_Catmull-Rom_spline Catmull-Rom].

+ +

Codice di Esempio

+ + + // Crea un circuito ondulato chiuso + const curve = new THREE.CatmullRomCurve3( [ + new THREE.Vector3( -10, 0, 10 ), + new THREE.Vector3( -5, 5, 5 ), + new THREE.Vector3( 0, 0, 0 ), + new THREE.Vector3( 5, -5, 5 ), + new THREE.Vector3( 10, 0, 10 ) + ] ); + + const points = curve.getPoints( 50 ); + const geometry = new THREE.BufferGeometry().setFromPoints( points ); + + const material = new THREE.LineBasicMaterial( { color: 0xff0000 } ); + + // Crea l'oggetto finale da aggiungere alla scena + const curveObject = new THREE.Line( geometry, material ); + + +

Esempi

+ +

+ [example:webgl_geometry_extrude_splines WebGL / geometry / extrude / splines] +

+ +

Costruttore

+ +

[name]( [param:Array points], [param:Boolean closed], [param:String curveType], [param:Float tension] )

+

+ points – Un array di punti [page:Vector3]
+ closed – Se la curva è chiusa. Il valore predefinito è `false`.
+ curveType – Tipo di curva. Il valore predefinito è `centripetal`.
+ tension – Tensione della curva. Il valore predefinito è `0.5`. +

+ + +

Proprietà

+

Vedi la classe [page:Curve] per le proprità comuni.

+ +

[property:Array points]

+

L'array di punti [page:Vector3] che definisce la curva. Ha bisogno di almeno due entries.

+ +

[property:Boolean closed]

+

Quando questa proprietà viene impostata su true la curva ritornerà su se stessa.

+ +

[property:String curveType]

+

I valori possibili sono `centripetal`, `chordal` e `catmullrom`.

+ +

[property:Float tension]

+

Quando [page:.curveType] è `catmullrom`, definisce la tensione di catmullrom.

+ + +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/curves/CubicBezierCurve.html b/docs/api/it/extras/curves/CubicBezierCurve.html new file mode 100644 index 00000000000000..4e4d42c90c4459 --- /dev/null +++ b/docs/api/it/extras/curves/CubicBezierCurve.html @@ -0,0 +1,75 @@ + + + + + + + + + + [page:Curve] → + +

[name]

+ +

+ Crea una + curva di Bezier cubica 2D smooth, + definita da un punto di inizio, di fine e due punti di controllo. +

+ +

Codice di Esempio

+ + + const curve = new THREE.CubicBezierCurve( + new THREE.Vector2( -10, 0 ), + new THREE.Vector2( -5, 15 ), + new THREE.Vector2( 20, 15 ), + new THREE.Vector2( 10, 0 ) + ); + + const points = curve.getPoints( 50 ); + const geometry = new THREE.BufferGeometry().setFromPoints( points ); + + const material = new THREE.LineBasicMaterial( { color: 0xff0000 } ); + + // Crea l'oggetto finale da aggiungere alla scena + const curveObject = new THREE.Line( geometry, material ); + + +

Costruttore

+ + +

[name] ( [param:Vector2 v0], [param:Vector2 v1], [param:Vector2 v2], [param:Vector2 v3] )

+

+ [page:Vector2 v0] – Il punto di inizio.
+ [page:Vector2 v1] – Il primo punto di controllo.
+ [page:Vector2 v2] – Il secondo punto di controllo.
+ [page:Vector2 v3] – Il punto di fine. +

+ +

Proprietà

+

Vedi la classe [page:Curve] per le proprità comuni.

+ +

[property:Vector2 v0]

+

Il punto di inizio.

+ +

[property:Vector2 v1]

+

Il primo punto di controllo.

+ +

[property:Vector2 v2]

+

Il secondo punto di controllo.

+ +

[property:Vector2 v3]

+

Il punto di fine.

+ + +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/curves/CubicBezierCurve3.html b/docs/api/it/extras/curves/CubicBezierCurve3.html new file mode 100644 index 00000000000000..b54f331f0a53a0 --- /dev/null +++ b/docs/api/it/extras/curves/CubicBezierCurve3.html @@ -0,0 +1,76 @@ + + + + + + + + + + [page:Curve] → + +

[name]

+ +

+ Crea una + curva di Bezier cubica 3D smooth, + definita da un punto di inizio, di fine e due punti di controllo. +

+ +

Codice di Esempio

+ + + const curve = new THREE.CubicBezierCurve3( + new THREE.Vector3( -10, 0, 0 ), + new THREE.Vector3( -5, 15, 0 ), + new THREE.Vector3( 20, 15, 0 ), + new THREE.Vector3( 10, 0, 0 ) + ); + + const points = curve.getPoints( 50 ); + const geometry = new THREE.BufferGeometry().setFromPoints( points ); + + const material = new THREE.LineBasicMaterial( { color: 0xff0000 } ); + + // Crea l'oggetto finale da aggiungere alla scena + const curveObject = new THREE.Line( geometry, material ); + + + +

Costruttore

+ + +

[name]( [param:Vector3 v0], [param:Vector3 v1], [param:Vector3 v2], [param:Vector3 v3] )

+

+ [page:Vector3 v0] – Il punto di inizio.
+ [page:Vector3 v1] – Il primo punto di controllo.
+ [page:Vector3 v2] – Il secondo punto di controllo.
+ [page:Vector3 v3] – Il punto di fine. +

+ +

Proprietà

+

Vedi la classe [page:Curve] per le proprità comuni.

+ +

[property:Vector3 v0]

+

Il punto di inizio.

+ +

[property:Vector3 v1]

+

Il primo punto di controllo.

+ +

[property:Vector3 v2]

+

Il secondo punto di controllo.

+ +

[property:Vector3 v3]

+

Il punto di fine.

+ + +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/curves/EllipseCurve.html b/docs/api/it/extras/curves/EllipseCurve.html new file mode 100644 index 00000000000000..2dac41472cdee9 --- /dev/null +++ b/docs/api/it/extras/curves/EllipseCurve.html @@ -0,0 +1,91 @@ + + + + + + + + + + [page:Curve] → + +

[name]

+ +

+ Crea una curva 2D a forma di ellisse. Impostando [page:Number xRadius] + uguale a [page:Number yRadius] risulterà in un cerchio. +

+ +

Codice di Esempio

+ + + const curve = new THREE.EllipseCurve( + 0, 0, // ax, aY + 10, 10, // xRadius, yRadius + 0, 2 * Math.PI, // aStartAngle, aEndAngle + false, // aClockwise + 0 // aRotation + ); + + const points = curve.getPoints( 50 ); + const geometry = new THREE.BufferGeometry().setFromPoints( points ); + + const material = new THREE.LineBasicMaterial( { color: 0xff0000 } ); + + // Crea l'oggetto finale da aggiungere alla scena + const ellipse = new THREE.Line( geometry, material ); + + +

Costruttore

+ + +

[name]( [param:Float aX], [param:Float aY], [param:Float xRadius], [param:Float yRadius], [param:Radians aStartAngle], [param:Radians aEndAngle], [param:Boolean aClockwise], [param:Radians aRotation] )

+

+ [page:Float aX] – L'X centro dell'ellipse. Il valore predefinito è `0`.
+ [page:Float aY] – L'Y centro dell'ellipse. Il valore predefinito è `0`.
+ [page:Float xRadius] – Il raggio dell'ellisse nella direzione x. Il valore predefinito è `1`.
+ [page:Float yRadius] – Il raggio dell'ellisse nella direzione y. Il valore predefinito è `1`.
+ [page:Radians aStartAngle] – L'angolo iniziale della curva in radianti a partire dall'asse X positivo. Il valore predefinito è `0`.
+ [page:Radians aEndAngle] – L'angolo finale della curva in radianti a partire dall'asse X positivo. Il valore predefinito è `2 x Math.PI`.
+ [page:Boolean aClockwise] – Se l'ellisse è disegnata in senso orario. Il valore predefinito è `false`.
+ [page:Radians aRotation] – L'angolo di rotazione dell'ellisse in radianti, in senso antiorario dall'asse X positivo (opzionale). Il valore predefinito è `0`.

+

+ +

Proprietà

+

Vedi la classe [page:Curve] per le proprità comuni.

+ +

[property:Float aX]

+

Il centro X dell'ellisse.

+ +

[property:Float aY]

+

Il centro Y dell'ellisse.

+ +

[property:Radians xRadius]

+

Il raggio dell'ellisse nella direzione x.

+ +

[property:Radians yRadius]

+

Il raggio dell'ellisse nella direzione y.

+ +

[property:Float aStartAngle]

+

L'angolo iniziale della curva in radianti a partire dal lato centrale destro.

+ +

[property:Float aEndAngle]

+

L'angolo finale della curva in radianti a partire dal lato centrale destro.

+ +

[property:Boolean aClockwise]

+

Se l'ellisse è disegnata in senso orario.

+ +

[property:Float aRotation]

+

L'angolo di rotazione dell'ellisse in radianti, in senso antiorario dall'asse X positivo (opzionale). Il valore predefinito è `0`.

+ + +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/curves/LineCurve.html b/docs/api/it/extras/curves/LineCurve.html new file mode 100644 index 00000000000000..6c528542713fb9 --- /dev/null +++ b/docs/api/it/extras/curves/LineCurve.html @@ -0,0 +1,45 @@ + + + + + + + + + + [page:Curve] → + +

[name]

+ +

Una curva che rappresenta un segmento di linea 2D.

+ +

Costruttore

+ + +

[name]( [param:Vector2 v1], [param:Vector2 v2] )

+

+ [page:Vector2 v1] – Il punto di inizio.
+ [page:Vector2 v2] - Il punto di fine. +

+ + +

Proprietà

+

Vedi la classe [page:Curve] per le proprità comuni.

+ +

[property:Vector2 v1]

+

Il punto di inizio.

+ +

[property:Vector2 v2]

+

Il punto di fine.

+ +

Metodi

+

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

+ + +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/curves/LineCurve3.html b/docs/api/it/extras/curves/LineCurve3.html new file mode 100644 index 00000000000000..6fdeb818f947cf --- /dev/null +++ b/docs/api/it/extras/curves/LineCurve3.html @@ -0,0 +1,44 @@ + + + + + + + + + + [page:Curve] → + +

[name]

+ +

Una curva che rappresenta un segmento di linea 3D.

+ +

Costruttore

+ + +

[name]( [param:Vector3 v1], [param:Vector3 v2] )

+

+ [page:Vector3 v1] – Il punto di inizio.
+ [page:Vector3 v2] - Il punto di fine. +

+ + +

Proprietà

+

Vedi la classe [page:Curve] per le proprità comuni.

+ +

[property:Vector3 v1]

+

Il punto di inizio.

+ +

[property:Vector3 v2]

+

Il punto di fine.

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/curves/QuadraticBezierCurve.html b/docs/api/it/extras/curves/QuadraticBezierCurve.html new file mode 100644 index 00000000000000..6f4c6b19a21978 --- /dev/null +++ b/docs/api/it/extras/curves/QuadraticBezierCurve.html @@ -0,0 +1,70 @@ + + + + + + + + + + [page:Curve] → + +

[name]

+ +

+ Crea una + curva di Bezier quadratica 2D smooth, + definita da un punto di inizio, di fine e un punto di controllo. +

+ +

Codice di Esempio

+ + + const curve = new THREE.QuadraticBezierCurve( + new THREE.Vector2( -10, 0 ), + new THREE.Vector2( 20, 15 ), + new THREE.Vector2( 10, 0 ) + ); + + const points = curve.getPoints( 50 ); + const geometry = new THREE.BufferGeometry().setFromPoints( points ); + + const material = new THREE.LineBasicMaterial( { color: 0xff0000 } ); + + // Crea l'oggetto finale da aggiungere alla scena + const curveObject = new THREE.Line( geometry, material ); + + +

Costruttore

+ + +

[name]( [param:Vector2 v0], [param:Vector2 v1], [param:Vector2 v2] )

+

+ [page:Vector2 v0] – Il punto di inizio.
+ [page:Vector2 v1] – Il punto di controllo.
+ [page:Vector2 v2] – Il punto di fine. +

+ + +

Proprietà

+

Vedi la classe [page:Curve] per le proprità comuni.

+ +

[property:Vector2 v0]

+

Il punto di inizio.

+ +

[property:Vector2 v1]

+

Il punto di controllo.

+ +

[property:Vector2 v2]

+

Il punto di fine.

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/curves/QuadraticBezierCurve3.html b/docs/api/it/extras/curves/QuadraticBezierCurve3.html new file mode 100644 index 00000000000000..d56568f92b730d --- /dev/null +++ b/docs/api/it/extras/curves/QuadraticBezierCurve3.html @@ -0,0 +1,71 @@ + + + + + + + + + + [page:Curve] → + +

[name]

+ +

+ Crea una + curva di Bezier quadratica 3D smooth, + definita da un punto di inizio, di fine e un punto di controllo. +

+ +

Codice di Esempio

+ + + const curve = new THREE.QuadraticBezierCurve3( + new THREE.Vector3( -10, 0, 0 ), + new THREE.Vector3( 20, 15, 0 ), + new THREE.Vector3( 10, 0, 0 ) + ); + + const points = curve.getPoints( 50 ); + const geometry = new THREE.BufferGeometry().setFromPoints( points ); + + const material = new THREE.LineBasicMaterial( { color: 0xff0000 } ); + + // Crea l'oggetto finale da aggiungere alla scena + const curveObject = new THREE.Line( geometry, material ); + + +

Costruttore

+ + +

[name]( [param:Vector3 v0], [param:Vector3 v1], [param:Vector3 v2] )

+

+ [page:Vector3 v0] – Il punto di inizio.
+ [page:Vector3 v1] – Il punto di controllo.
+ [page:Vector3 v2] – Il punto di fine. +

+ + + +

Proprietà

+

Vedi la classe [page:Curve] per le proprità comuni.

+ +

[property:Vector3 v0]

+

Il punto di inizio.

+ +

[property:Vector3 v1]

+

Il punto di controllo.

+ +

[property:Vector3 v2]

+

Il punto di fine.

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/extras/curves/SplineCurve.html b/docs/api/it/extras/curves/SplineCurve.html new file mode 100644 index 00000000000000..dcd7303f4ca221 --- /dev/null +++ b/docs/api/it/extras/curves/SplineCurve.html @@ -0,0 +1,62 @@ + + + + + + + + + + [page:Curve] → + +

[name]

+ +

+ Crea una curva spline 2D smooth da una serie di punti. Internamente + utilizza [page:Interpolations.CatmullRom] per creare la curva. +

+ +

Codice di Esempio

+ + + // Crea un onda sinusoidale + const curve = new THREE.SplineCurve( [ + new THREE.Vector2( -10, 0 ), + new THREE.Vector2( -5, 5 ), + new THREE.Vector2( 0, 0 ), + new THREE.Vector2( 5, -5 ), + new THREE.Vector2( 10, 0 ) + ] ); + + const points = curve.getPoints( 50 ); + const geometry = new THREE.BufferGeometry().setFromPoints( points ); + + const material = new THREE.LineBasicMaterial( { color: 0xff0000 } ); + + // Crea l'oggetto finale da aggiungere alla scena + const splineObject = new THREE.Line( geometry, material ); + + +

Costruttore

+ + +

[name]( [param:Array points] )

+

points – Un array di punti [page:Vector2] che definisce la curva.

+ + +

Proprietà

+

Vedi la classe [page:Curve] per le proprità comuni.

+ +

[property:Array points]

+

L'array di punti [page:Vector2] che definisce la curva.

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/list.json b/docs/list.json index ee6d1a961f2375..ebf0e683b58cc0 100644 --- a/docs/list.json +++ b/docs/list.json @@ -1214,6 +1214,36 @@ "Core / BufferAttributes": { "BufferAttribute Types": "api/it/core/bufferAttributeTypes/BufferAttributeTypes" + }, + + "Extras": { + "DataUtils": "api/it/extras/DataUtils", + "Earcut": "api/it/extras/Earcut", + "ImageUtils": "api/it/extras/ImageUtils", + "PMREMGenerator": "api/it/extras/PMREMGenerator", + "ShapeUtils": "api/it/extras/ShapeUtils" + }, + + "Extras / Core": { + "Curve": "api/it/extras/core/Curve", + "CurvePath": "api/it/extras/core/CurvePath", + "Interpolations": "api/it/extras/core/Interpolations", + "Path": "api/it/extras/core/Path", + "Shape": "api/it/extras/core/Shape", + "ShapePath": "api/it/extras/core/ShapePath" + }, + + "Extras / Curves": { + "ArcCurve": "api/it/extras/curves/ArcCurve", + "CatmullRomCurve3": "api/it/extras/curves/CatmullRomCurve3", + "CubicBezierCurve": "api/it/extras/curves/CubicBezierCurve", + "CubicBezierCurve3": "api/it/extras/curves/CubicBezierCurve3", + "EllipseCurve": "api/it/extras/curves/EllipseCurve", + "LineCurve": "api/it/extras/curves/LineCurve", + "LineCurve3": "api/it/extras/curves/LineCurve3", + "QuadraticBezierCurve": "api/it/extras/curves/QuadraticBezierCurve", + "QuadraticBezierCurve3": "api/it/extras/curves/QuadraticBezierCurve3", + "SplineCurve": "api/it/extras/curves/SplineCurve" } } }, From 687937d201c30aa1aa21ac334e321a447878bdb6 Mon Sep 17 00:00:00 2001 From: Angela Busato <44018650+AngyDev@users.noreply.github.com> Date: Tue, 30 Aug 2022 13:05:13 +0200 Subject: [PATCH 07/12] Update docs/api/it/extras/curves/ArcCurve.html Co-authored-by: DaveDev --- docs/api/it/extras/curves/ArcCurve.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/it/extras/curves/ArcCurve.html b/docs/api/it/extras/curves/ArcCurve.html index 01d3651a9af753..e53549f3377e90 100644 --- a/docs/api/it/extras/curves/ArcCurve.html +++ b/docs/api/it/extras/curves/ArcCurve.html @@ -14,7 +14,7 @@

[name]

Alias per [page:EllipseCurve].

Properties

-

Vedi la classe [page:EllipseCurve] per le proprità comuni.

+

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

Source

From 0b3fdd10c32d3a650c79a15d01a227f809477165 Mon Sep 17 00:00:00 2001 From: Angela Busato <44018650+AngyDev@users.noreply.github.com> Date: Tue, 30 Aug 2022 13:05:46 +0200 Subject: [PATCH 08/12] Update docs/api/it/extras/core/Shape.html Co-authored-by: DaveDev --- docs/api/it/extras/core/Shape.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/it/extras/core/Shape.html b/docs/api/it/extras/core/Shape.html index d8012570a65622..09390a5d5f9d33 100644 --- a/docs/api/it/extras/core/Shape.html +++ b/docs/api/it/extras/core/Shape.html @@ -92,7 +92,7 @@

[method:Array getPointsHoles]( [param:Integer divisions] )

divisions -- La finezza del risultato.

- Si Ottiene un array di [page:Vector2 Vector2] che rapprensenta gli hole nella forma. + Ottiene un array di [page:Vector2 Vector2] che rapprensenta gli hole nella forma.

Source

From 0ec6e4a79912d2e302cac47ff9ba3ca475424a1d Mon Sep 17 00:00:00 2001 From: Angela Busato <44018650+AngyDev@users.noreply.github.com> Date: Tue, 30 Aug 2022 13:05:56 +0200 Subject: [PATCH 09/12] Update docs/api/it/extras/curves/CatmullRomCurve3.html Co-authored-by: DaveDev --- docs/api/it/extras/curves/CatmullRomCurve3.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/it/extras/curves/CatmullRomCurve3.html b/docs/api/it/extras/curves/CatmullRomCurve3.html index b3998e1144ac72..bd8ca9c41bd53e 100644 --- a/docs/api/it/extras/curves/CatmullRomCurve3.html +++ b/docs/api/it/extras/curves/CatmullRomCurve3.html @@ -59,7 +59,7 @@

[property:Array points]

L'array di punti [page:Vector3] che definisce la curva. Ha bisogno di almeno due entries.

[property:Boolean closed]

-

Quando questa proprietà viene impostata su true la curva ritornerà su se stessa.

+

Quando questa proprietà viene impostata su `true` la curva ritornerà su se stessa.

[property:String curveType]

I valori possibili sono `centripetal`, `chordal` e `catmullrom`.

From bef0b33a8dde0b99cce33a0fc6d726dc937d2d8d Mon Sep 17 00:00:00 2001 From: Angela Busato <44018650+AngyDev@users.noreply.github.com> Date: Tue, 30 Aug 2022 13:06:44 +0200 Subject: [PATCH 10/12] Update docs/api/it/extras/core/ShapePath.html Co-authored-by: DaveDev --- docs/api/it/extras/core/ShapePath.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/it/extras/core/ShapePath.html b/docs/api/it/extras/core/ShapePath.html index 051a091da650e0..a34207c441222f 100644 --- a/docs/api/it/extras/core/ShapePath.html +++ b/docs/api/it/extras/core/ShapePath.html @@ -83,7 +83,7 @@

[method:Array toShapes]( [param:Boolean isCCW], [param:Boolean noHoles] ) Converte l'array [page:ShapePath.subPaths subPaths] in un array di Shape. Per impostazione predefinita le forme solide sono definite in senso orario (CW) e i fori sono definiti in senso antiorario (CCW). - Se isCCW è impostato su true, le forme sono capovolte. Se il parametro noHoles è impostato su true, + Se isCCW è impostato su `true`, le forme sono capovolte. Se il parametro noHoles è impostato su `true`, tutti i percorsi sono impostati come forme solide e isCCW viene ignorato.
From 2d74d7415b7f3f172bd8557593b061f26518158a Mon Sep 17 00:00:00 2001 From: Angela Busato Date: Thu, 1 Sep 2022 15:06:37 +0200 Subject: [PATCH 11/12] feat: add Geometries italian version --- docs/api/it/geometries/BoxGeometry.html | 74 ++++++++++++ docs/api/it/geometries/CapsuleGeometry.html | 73 +++++++++++ docs/api/it/geometries/CircleGeometry.html | 75 ++++++++++++ docs/api/it/geometries/ConeGeometry.html | 72 +++++++++++ docs/api/it/geometries/CylinderGeometry.html | 73 +++++++++++ .../it/geometries/DodecahedronGeometry.html | 59 +++++++++ docs/api/it/geometries/EdgesGeometry.html | 56 +++++++++ docs/api/it/geometries/ExtrudeGeometry.html | 113 ++++++++++++++++++ .../it/geometries/IcosahedronGeometry.html | 59 +++++++++ docs/api/it/geometries/LatheGeometry.html | 78 ++++++++++++ .../api/it/geometries/OctahedronGeometry.html | 58 +++++++++ docs/api/it/geometries/PlaneGeometry.html | 69 +++++++++++ .../api/it/geometries/PolyhedronGeometry.html | 68 +++++++++++ docs/api/it/geometries/RingGeometry.html | 72 +++++++++++ docs/api/it/geometries/ShapeGeometry.html | 83 +++++++++++++ docs/api/it/geometries/SphereGeometry.html | 79 ++++++++++++ .../it/geometries/TetrahedronGeometry.html | 59 +++++++++ docs/api/it/geometries/TorusGeometry.html | 70 +++++++++++ docs/api/it/geometries/TorusKnotGeometry.html | 74 ++++++++++++ docs/api/it/geometries/TubeGeometry.html | 111 +++++++++++++++++ docs/api/it/geometries/WireframeGeometry.html | 56 +++++++++ docs/list.json | 24 ++++ 22 files changed, 1555 insertions(+) create mode 100644 docs/api/it/geometries/BoxGeometry.html create mode 100644 docs/api/it/geometries/CapsuleGeometry.html create mode 100644 docs/api/it/geometries/CircleGeometry.html create mode 100644 docs/api/it/geometries/ConeGeometry.html create mode 100644 docs/api/it/geometries/CylinderGeometry.html create mode 100644 docs/api/it/geometries/DodecahedronGeometry.html create mode 100644 docs/api/it/geometries/EdgesGeometry.html create mode 100644 docs/api/it/geometries/ExtrudeGeometry.html create mode 100644 docs/api/it/geometries/IcosahedronGeometry.html create mode 100644 docs/api/it/geometries/LatheGeometry.html create mode 100644 docs/api/it/geometries/OctahedronGeometry.html create mode 100644 docs/api/it/geometries/PlaneGeometry.html create mode 100644 docs/api/it/geometries/PolyhedronGeometry.html create mode 100644 docs/api/it/geometries/RingGeometry.html create mode 100644 docs/api/it/geometries/ShapeGeometry.html create mode 100644 docs/api/it/geometries/SphereGeometry.html create mode 100644 docs/api/it/geometries/TetrahedronGeometry.html create mode 100644 docs/api/it/geometries/TorusGeometry.html create mode 100644 docs/api/it/geometries/TorusKnotGeometry.html create mode 100644 docs/api/it/geometries/TubeGeometry.html create mode 100644 docs/api/it/geometries/WireframeGeometry.html diff --git a/docs/api/it/geometries/BoxGeometry.html b/docs/api/it/geometries/BoxGeometry.html new file mode 100644 index 00000000000000..45c7f5501e4c94 --- /dev/null +++ b/docs/api/it/geometries/BoxGeometry.html @@ -0,0 +1,74 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

+ [name] è una classe di geometria per un cuboide rettangolare con una determinata 'larghezza' (width), 'altezza' (height) e 'profondità' (depth). + Al momento della creazione, il cuboide è centrato nell'origine, con ciascun bordo parallelo ad uno degli assi. +

+ + + + + +

Codice di Esempio

+ + const geometry = new THREE.BoxGeometry( 1, 1, 1 ); + const material = new THREE.MeshBasicMaterial( {color: 0x00ff00} ); + const cube = new THREE.Mesh( geometry, material ); + scene.add( cube ); + + +

Costruttore

+ +

[name]([param:Float width], [param:Float height], [param:Float depth], [param:Integer widthSegments], [param:Integer heightSegments], [param:Integer depthSegments])

+

+ width — Larghezza; cioè la lunghezza dei bordi paralleli all'asse X. Opzionale; il valore predefinito è 1.
+ height — Altezza; cioè la lunghezza dei bordi paralleli all'asse Y. Opzionale; il valore predefinito è 1.
+ depth — Profondità; cioè la lunghezza dei bordi paralleli all'asse Z. Opzionale; il valore predefinito è 1.
+ widthSegments — Numero di facce rettangolari segmentate lungo la larghezza dei lati. Opzionale; il valore predefinito è 1.
+ heightSegments — Numero di facce rettangolari segmentate lungo l'altezza dei lati. Opzionale; il valore predefinito è 1.
+ depthSegments — Numero di facce rettangolari segmentate lungo la profondità dei lati. Opzionale; il valore predefinito è 1.
+

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/CapsuleGeometry.html b/docs/api/it/geometries/CapsuleGeometry.html new file mode 100644 index 00000000000000..944b9008df5f0b --- /dev/null +++ b/docs/api/it/geometries/CapsuleGeometry.html @@ -0,0 +1,73 @@ + + + + + + + + + + [page:BufferGeometry] → [page:LatheGeometry] → + +

[name]

+ +

+ [name] è una classe di geometria per una capsula con raggi e altezza dati. + Viene costruita utilizzando un tornio. +

+ + + + + +

Codice di Esempio

+ + const geometry = new THREE.CapsuleGeometry( 1, 1, 4, 8 ); + const material = new THREE.MeshBasicMaterial( {color: 0x00ff00} ); + const capsule = new THREE.Mesh( geometry, material ); + scene.add( capsule ); + + +

Costruttore

+ +

[name]([param:Float radius], [param:Float length], [param:Integer capSubdivisions], [param:Integer radialSegments])

+

+ + radius — Raggio della capsula. Opzionale; il valore predefinito è 1.
+ length — Lunghezza della sezione centrale. Opzionale; il valore predefinito è 1.
+ capSegments — Numero di segmenti curvi utilizzato per costruire i tappi della capsula. Opzionale; il valore predefinito è 4.
+ radialSegments — Numero di facce segmentate attorno alla circonferenza della capsula. Opzionale; il valore predefinito è 8.
+

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/CircleGeometry.html b/docs/api/it/geometries/CircleGeometry.html new file mode 100644 index 00000000000000..92b4a896733139 --- /dev/null +++ b/docs/api/it/geometries/CircleGeometry.html @@ -0,0 +1,75 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

+ [name] è una forma semplice della geometria Euclidea. + È costruita a partire da una serie di segmenti triangolari orientati intorno ad un punto centrale, che si estendono fino ad un determinato raggio. + È costruita in senso antiorario a partire da un angolo iniziale e da un angolo centrale dato. + Può essere utilizzata anche per creare poligoni regolari, dove il numero di segmenti determina il numero di lati. +

+ + + + + +

Codice di Esempio

+ + + const geometry = new THREE.CircleGeometry( 5, 32 ); + const material = new THREE.MeshBasicMaterial( { color: 0xffff00 } ); + const circle = new THREE.Mesh( geometry, material ); + scene.add( circle ); + + +

Costruttore

+ +

[name]([param:Float radius], [param:Integer segments], [param:Float thetaStart], [param:Float thetaLength])

+

+ radius — Raggio del cerchio. Il valore predefinito è 1.
+ segments — Numero di segmenti (triangoli). Il valore minimo è 3. Il valore predefinito è 8.
+ thetaStart — Angolo iniziale per il primo segmento. Il valore predefinito è 0 (posizione ore tre).
+ thetaLength — L'angolo centrale, spesso chiamato theta, del settore circolare. Il valore predefinito è 2*Pi, che crea un cerchio completo. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/ConeGeometry.html b/docs/api/it/geometries/ConeGeometry.html new file mode 100644 index 00000000000000..e5b049ec16b0a1 --- /dev/null +++ b/docs/api/it/geometries/ConeGeometry.html @@ -0,0 +1,72 @@ + + + + + + + + + + [page:BufferGeometry] → [page:CylinderGeometry] → + +

[name]

+ +

Una classe per la generazione di geometrie di coni.

+ + + + + +

Codice di Esempio

+ + const geometry = new THREE.ConeGeometry( 5, 20, 32 ); + const material = new THREE.MeshBasicMaterial( {color: 0xffff00} ); + const cone = new THREE.Mesh( geometry, material ); + scene.add( cone ); + + +

Costruttore

+ +

[name]([param:Float radius], [param:Float height], [param:Integer radialSegments], [param:Integer heightSegments], [param:Boolean openEnded], [param:Float thetaStart], [param:Float thetaLength])

+

+ radius — Raggio della base del cono. Il valore predefinito è 1.
+ height — Altezza del cono. Il valore predefinito è 1.
+ radialSegments — Numero di facce segmentate intorno alla circonferenza del cono. Il valore predefinito è 8.
+ heightSegments — Numero di file di facce lungo l'altezza del cono. Il valore predefinito è 1.
+ openEnded — Un booleano che indica se la base del cono è aperta o chiusa. Il valore predefinito è false, significa chiusa.
+ thetaStart — Angolo iniziale per il primo segmento. Il valore predefinito è 0 (posizione ore tre).
+ thetaLength — L'angolo centrale, spesso chiamato theta, del settore circolare. Il valore predefinito è 2*Pi, che crea un cono completo. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/CylinderGeometry.html b/docs/api/it/geometries/CylinderGeometry.html new file mode 100644 index 00000000000000..7ecf7cfac597db --- /dev/null +++ b/docs/api/it/geometries/CylinderGeometry.html @@ -0,0 +1,73 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

Una classe per la generazione di geometrie di cilindri.

+ + + + + +

Codice di Esempio

+ + const geometry = new THREE.CylinderGeometry( 5, 5, 20, 32 ); + const material = new THREE.MeshBasicMaterial( {color: 0xffff00} ); + const cylinder = new THREE.Mesh( geometry, material ); + scene.add( cylinder ); + + +

Costruttore

+ +

[name]([param:Float radiusTop], [param:Float radiusBottom], [param:Float height], [param:Integer radialSegments], [param:Integer heightSegments], [param:Boolean openEnded], [param:Float thetaStart], [param:Float thetaLength])

+

+ radiusTop — Raggio del cilindro nella parte superiore. Il valore predefinito è 1.
+ radiusBottom — Raggio del cilindro nella parte inferiore. Il valore predefinito è 1.
+ height — Altezza del cilindro. Il valore predefinito è 1.
+ radialSegments — Numero di facce segmentate intorno alla circonferenza del cilindro. Il valore predefinito è 8
+ heightSegments — Numero di file delle facce lungo l'altezza del cilindro. Il valore predefinito è 1.
+ openEnded — Un booleano che indica se le estremità del cilindro sono aperte o chiuse. Il valore predefinito è false, significa chiuse.
+ thetaStart — L'angolo di partenza del primo segmento. Il valore predefinito è 0 (posizione ore tre).
+ thetaLength — L'angolo centrale, spesso chiamato theta, del settore circolare. Il valore predefinito è 2*Pi, che crea un cilindro completo. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/DodecahedronGeometry.html b/docs/api/it/geometries/DodecahedronGeometry.html new file mode 100644 index 00000000000000..89ff5ac5e47e00 --- /dev/null +++ b/docs/api/it/geometries/DodecahedronGeometry.html @@ -0,0 +1,59 @@ + + + + + + + + + + [page:BufferGeometry] → [page:PolyhedronGeometry] → + +

[name]

+ +

Una classe per la generazione di geometrie di un dodecaedro.

+ + + + + +

Costruttore

+ +

[name]([param:Float radius], [param:Integer detail])

+

+ radius — Raggio del dodecaedro. Il valore predefinito è 1.
+ detail — Il valore predefinito è 0. Impostandolo ad un valore maggiore di 0 si aggiungono vertici rendendolo non più un dodecaedro. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/EdgesGeometry.html b/docs/api/it/geometries/EdgesGeometry.html new file mode 100644 index 00000000000000..0541fd1a6ca374 --- /dev/null +++ b/docs/api/it/geometries/EdgesGeometry.html @@ -0,0 +1,56 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

Questa classe può essere utilizzata come oggetto di supporto per visualizzare i bordi di una [page:BufferGeometry geometria].

+ +

Codice di Esempio

+ + +const geometry = new THREE.BoxGeometry( 100, 100, 100 ); +const edges = new THREE.EdgesGeometry( geometry ); +const line = new THREE.LineSegments( edges, new THREE.LineBasicMaterial( { color: 0xffffff } ) ); +scene.add( line ); + + +

Esempi

+

+ [example:webgl_helpers helpers] +

+ +

Costruttore

+ +

[name]( [param:BufferGeometry geometry], [param:Integer thresholdAngle] )

+

+ geometry — Qualsiasi oggetto geometria.
+ thresholdAngle — Un bordo viene renderizzato solo se l'angolo (in gradi) tra le normali delle facce adiacenti supera questo valore. + Il valore predefinito è 1 grado. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/ExtrudeGeometry.html b/docs/api/it/geometries/ExtrudeGeometry.html new file mode 100644 index 00000000000000..8ea08a3fdfc251 --- /dev/null +++ b/docs/api/it/geometries/ExtrudeGeometry.html @@ -0,0 +1,113 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

Crea una geometria estrusa da una forma di tracciato (path shape).

+ + + + + +

Codice di Esempio

+ + + + const length = 12, width = 8; + + const shape = new THREE.Shape(); + shape.moveTo( 0,0 ); + shape.lineTo( 0, width ); + shape.lineTo( length, width ); + shape.lineTo( length, 0 ); + shape.lineTo( 0, 0 ); + + const extrudeSettings = { + steps: 2, + depth: 16, + bevelEnabled: true, + bevelThickness: 1, + bevelSize: 1, + bevelOffset: 0, + bevelSegments: 1 + }; + + const geometry = new THREE.ExtrudeGeometry( shape, extrudeSettings ); + const material = new THREE.MeshBasicMaterial( { color: 0x00ff00 } ); + const mesh = new THREE.Mesh( geometry, material ) ; + scene.add( mesh ); + + + +

Costruttore

+ + +

[name]([param:Array shapes], [param:Object options])

+

+ shapes — Shape o un array di shape.
+ options — Oggetto che può contenere i seguenti parametri. + +

    +
  • curveSegments — int. Numero di punti sulle curve. Il valore predefinito è 12.
    • +
  • steps — int. Numero di punti utilizzati per suddividere i segmenti lungo la profondità della spline estrusa. Il valore predefinito è 1.
    • +
  • depth — float. Profondità per estrudere la forma. Il valore predefinito è 1.
    • +
  • bevelEnabled — bool. Applica la smussatura alla forma. Il valore predefinito è true.
    • +
  • bevelThickness — float. Quanto in profondità nella forma originale va la smussatura. Il valore predefinito è 0.2.
    • +
  • bevelSize — float. Distanza dal contorno della forma a cui si estende lo smusso. Il valore predefinito è bevelThickness - 0.1.
    • +
  • bevelOffset — float. Distanza dal contorno della forma a cui inizia lo smusso. Il valore predefinito è 0.
    • +
  • bevelSegments — int. Numero di strati di smusso. Il valore predefinito è 3.
    • +
  • extrudePath — THREE.Curve. Un path spline 3D lungo il quale deve essere eatrusa la forma. Smussi non supportati per l'estrusione del percorso.
    • +
  • UVGenerator — Object. Oggetto che fornisce le funzioni di generatore UV
    • +
+ +

+

+ Questo oggetto estrude una forma 2D in una geometria 3D. +

+ +

+ Quando viene creata una Mesh con questa geometria, se desideri utilizzare un materiale separato per + la sua faccia e i suoi lati estrusi, puoi utilizzare l'array dei materiali. Il primo materiale + sarà applicato alla faccia; il secondo materiale sarà applicato ai lati. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/IcosahedronGeometry.html b/docs/api/it/geometries/IcosahedronGeometry.html new file mode 100644 index 00000000000000..983949f59258f8 --- /dev/null +++ b/docs/api/it/geometries/IcosahedronGeometry.html @@ -0,0 +1,59 @@ + + + + + + + + + + [page:BufferGeometry] → [page:PolyhedronGeometry] → +

[name]

+ +

Una classe per generare una geometria icosaedrica.

+ + + + + +

Costruttore

+ +

[name]([param:Float radius], [param:Integer detail])

+

+ radius — Il valore predefinito è 1.
+ detail — Il valore predefinito è 0. Impostandolo ad un valore maggiore di 0 si aggiungono più vertici, rendendo il modello non più un icosaedro. + Quando il dettaglio (detail) è maggiore di 1, è effettivamente una sfera. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/LatheGeometry.html b/docs/api/it/geometries/LatheGeometry.html new file mode 100644 index 00000000000000..55226d98ecdf08 --- /dev/null +++ b/docs/api/it/geometries/LatheGeometry.html @@ -0,0 +1,78 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

Crea mesh con simmetria assiale come vasi. Il tornio ruota attorno all'asse Y.

+ + + + + +

Codice di Esempio

+ + + const points = []; + for ( let i = 0; i < 10; i ++ ) { + points.push( new THREE.Vector2( Math.sin( i * 0.2 ) * 10 + 5, ( i - 5 ) * 2 ) ); + } + const geometry = new THREE.LatheGeometry( points ); + const material = new THREE.MeshBasicMaterial( { color: 0xffff00 } ); + const lathe = new THREE.Mesh( geometry, material ); + scene.add( lathe ); + + +

Costruttore

+ +

[name]([param:Array points], [param:Integer segments], [param:Float phiStart], [param:Float phiLength])

+

+ points — Array di Vector2. La coordinata x di ogni punto deve essere maggiore di zero. + Il valore predefinito è un array con (0,-0.5), (0.5,0) e (0,0.5) il quale crea una semplice forma a diamante.
+ segments — il numero di segmenti di circonferenza da generare. Il valore predefinito è 12.
+ phiStart — l'angolo di partenza in radianti. Il valore predefinito è 0.
+ phiLength — l'intervallo in radianti (da 0 ta 2PI) della sezione tornita 2PI è un tornio chiuso, meno di 2PI è una porzione. Il valore predefinito è 2PI. +

+

+ Questo crea una [name] basata sui parametri. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/OctahedronGeometry.html b/docs/api/it/geometries/OctahedronGeometry.html new file mode 100644 index 00000000000000..8b406740aecdb3 --- /dev/null +++ b/docs/api/it/geometries/OctahedronGeometry.html @@ -0,0 +1,58 @@ + + + + + + + + + + [page:BufferGeometry] → [page:PolyhedronGeometry] → +

[name]

+ +

Una classe per generare la geometria di un ottaedro.

+ + + + + +

Costruttore

+ +

[name]([param:Float radius], [param:Integer detail])

+

+ radius — Raggio di un ottaedro. Il valore predefinito è 1.
+ detail — Il valore predefinito è 0. Impostandolo ad un valore maggiore di zero si aggiungono vertici, rendendo l'ottaedro non più tale. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/PlaneGeometry.html b/docs/api/it/geometries/PlaneGeometry.html new file mode 100644 index 00000000000000..e1fc65871a1203 --- /dev/null +++ b/docs/api/it/geometries/PlaneGeometry.html @@ -0,0 +1,69 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

Una classe per generare la geometria di un piano.

+ + + + + +

Codice di Esempio

+ + const geometry = new THREE.PlaneGeometry( 1, 1 ); + const material = new THREE.MeshBasicMaterial( {color: 0xffff00, side: THREE.DoubleSide} ); + const plane = new THREE.Mesh( geometry, material ); + scene.add( plane ); + + +

Costruttore

+ +

[name]([param:Float width], [param:Float height], [param:Integer widthSegments], [param:Integer heightSegments])

+

+ width — Larghezza lungo l'asse X. Il valore predefinito è 1.
+ height — Altezza lungo l'asse Y. Il valore predefinito è 1.
+ widthSegments — Opzionale. Il valore predefinito è 1.
+ heightSegments — Opzionale. Il valore predefinito è 1. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/PolyhedronGeometry.html b/docs/api/it/geometries/PolyhedronGeometry.html new file mode 100644 index 00000000000000..2b1cceee9267b1 --- /dev/null +++ b/docs/api/it/geometries/PolyhedronGeometry.html @@ -0,0 +1,68 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

+ Un poliedro è un solido in tre dimensioni con le facce piatte. Questa classe prende un array di vertici, + li proietta su una sfera, e li dividerà fino al livello di dettaglio desiderato. Questa classe è utilizzata + da [page:DodecahedronGeometry], [page:IcosahedronGeometry], [page:OctahedronGeometry], + e [page:TetrahedronGeometry] per generare queste rispettive geometrie. +

+ +

Codice id Esempio

+ +const verticesOfCube = [ + -1,-1,-1, 1,-1,-1, 1, 1,-1, -1, 1,-1, + -1,-1, 1, 1,-1, 1, 1, 1, 1, -1, 1, 1, +]; + +const indicesOfFaces = [ + 2,1,0, 0,3,2, + 0,4,7, 7,3,0, + 0,1,5, 5,4,0, + 1,2,6, 6,5,1, + 2,3,7, 7,6,2, + 4,5,6, 6,7,4 +]; + +const geometry = new THREE.PolyhedronGeometry( verticesOfCube, indicesOfFaces, 6, 2 ); + + +

Costruttore

+ + +

[name]([param:Array vertices], [param:Array indices], [param:Float radius], [param:Integer detail])

+

+ vertices — [page:Array] di punti della forma [1,1,1, -1,-1,-1, ... ]
+ indices — [page:Array] di indici che compongono le facce della forma [0,1,2, 2,3,0, ... ]
+ radius — [page:Float] - Il raggio della forma finale
+ detail — [page:Integer] - In quanti livelli suddividere la geometria. Più dettagli, più liscia è la forma. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/RingGeometry.html b/docs/api/it/geometries/RingGeometry.html new file mode 100644 index 00000000000000..406cb67830922d --- /dev/null +++ b/docs/api/it/geometries/RingGeometry.html @@ -0,0 +1,72 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

Una classe per la generazione di una geometria ad anello bidimensionale.

+ + + + + +

Codice di Esempio

+ + const geometry = new THREE.RingGeometry( 1, 5, 32 ); + const material = new THREE.MeshBasicMaterial( { color: 0xffff00, side: THREE.DoubleSide } ); + const mesh = new THREE.Mesh( geometry, material ); + scene.add( mesh ); + + +

Costruttore

+ +

[name]([param:Float innerRadius], [param:Float outerRadius], [param:Integer thetaSegments], [param:Integer phiSegments], [param:Float thetaStart], [param:Float thetaLength])

+

+ innerRadius — Il valore predefinito è 0.5.
+ outerRadius — Il valore predefinito è 1.
+ thetaSegments — Numero di segmenti. Un numero alto significa che l'anello sarà più rotondo. Il valore minimo è 3. Il valore predefinito è 8.
+ phiSegments — Il valore minimo è 1. Il valore predefinito è 1.
+ thetaStart — Angolo di partenza. Il valore predefinito è 0.
+ thetaLength — Angolo centrale. Il valore predefinito è Math.PI * 2. +

+ + +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/ShapeGeometry.html b/docs/api/it/geometries/ShapeGeometry.html new file mode 100644 index 00000000000000..9d41f036d135ac --- /dev/null +++ b/docs/api/it/geometries/ShapeGeometry.html @@ -0,0 +1,83 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

Crea una geometria poligonale unilaterale da una o più forme di tracciato.

+ + + + + + +

Codice di Esempio

+ + + + const x = 0, y = 0; + + const heartShape = new THREE.Shape(); + + heartShape.moveTo( x + 5, y + 5 ); + heartShape.bezierCurveTo( x + 5, y + 5, x + 4, y, x, y ); + heartShape.bezierCurveTo( x - 6, y, x - 6, y + 7,x - 6, y + 7 ); + heartShape.bezierCurveTo( x - 6, y + 11, x - 3, y + 15.4, x + 5, y + 19 ); + heartShape.bezierCurveTo( x + 12, y + 15.4, x + 16, y + 11, x + 16, y + 7 ); + heartShape.bezierCurveTo( x + 16, y + 7, x + 16, y, x + 10, y ); + heartShape.bezierCurveTo( x + 7, y, x + 5, y + 5, x + 5, y + 5 ); + + const geometry = new THREE.ShapeGeometry( heartShape ); + const material = new THREE.MeshBasicMaterial( { color: 0x00ff00 } ); + const mesh = new THREE.Mesh( geometry, material ) ; + scene.add( mesh ); + + +

Costruttore

+ + +

[name]([param:Array shapes], [param:Integer curveSegments])

+

+ shapes — [page:Array] di forme o di una singola [page:Shape forma]. L'impostazione predefinita è una singola forma triangolare.
+ curveSegments - [page:Integer] - Numero di segmenti per forma. Il valore predefinito è 12. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/SphereGeometry.html b/docs/api/it/geometries/SphereGeometry.html new file mode 100644 index 00000000000000..565717f4c23063 --- /dev/null +++ b/docs/api/it/geometries/SphereGeometry.html @@ -0,0 +1,79 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

Una classe per generare geometrie di sfere.

+ + + + + +

Codice di Esempio

+ + const geometry = new THREE.SphereGeometry( 15, 32, 16 ); + const material = new THREE.MeshBasicMaterial( { color: 0xffff00 } ); + const sphere = new THREE.Mesh( geometry, material ); + scene.add( sphere ); + + +

Costruttore

+ +

[name]([param:Float radius], [param:Integer widthSegments], [param:Integer heightSegments], [param:Float phiStart], [param:Float phiLength], [param:Float thetaStart], [param:Float thetaLength])

+ +

+ radius — raggio della sfera. Il valore predefinito è 1.
+ widthSegments — numero di segmenti orizzontali. Il valore minimo è 3 e il valore predefinito è 32.
+ heightSegments — numero di segmenti verticali. Il valore minimo è 2 e il valore predefinito è 16.
+ phiStart — specifica l'angolo di partenza orizzontale. Il valore predefinito è 0.
+ phiLength — specifica la dimensione dell'angolo di ampiezza orizzontale. Il valore predefinito è Math.PI * 2.
+ thetaStart — specifica l'angolo di partenza verticale. Il valore predefinito è 0.
+ thetaLength — specifica la dimensione dell'angolo di ampiezza verticale. Il valore predefinito è Math.PI.
+

+ +

+ La geometria viene creata eseguendo lo sweep e il calcolo dei vertici attorno all'asse Y (sweep orizzontale) e all'asse Z (sweep verticale). + Pertanto, le sfere incomplete (simili a `'fette di sfere'`) possono essere create attraverso l'utilizzo dei diversi valori di + phiStart, phiLength, thetaStart e thetaLength, al fine di definire i punti in cui iniziamo (o finiamo) il calcolo di quei vertici. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/TetrahedronGeometry.html b/docs/api/it/geometries/TetrahedronGeometry.html new file mode 100644 index 00000000000000..18bb32881a6f44 --- /dev/null +++ b/docs/api/it/geometries/TetrahedronGeometry.html @@ -0,0 +1,59 @@ + + + + + + + + + + [page:BufferGeometry] → [page:PolyhedronGeometry] → + +

[name]

+ +

Una classe per la generazione di geometrie di tetraedri.

+ + + + + +

Costruttore

+ +

[name]([param:Float radius], [param:Integer detail])

+

+ radius — Raggio del tetraedro. Il valore predefinito è 1.
+ detail — Il valore predefinito è 0. Impostandolo ad un valore maggiore di 0 si aggiungono più vertici, rendendo il modello non più un tetraedro. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/TorusGeometry.html b/docs/api/it/geometries/TorusGeometry.html new file mode 100644 index 00000000000000..f2f638b4f7be83 --- /dev/null +++ b/docs/api/it/geometries/TorusGeometry.html @@ -0,0 +1,70 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

Una classe per la generazione di geometrie toroidali.

+ + + + + +

Codice di Esempio

+ + const geometry = new THREE.TorusGeometry( 10, 3, 16, 100 ); + const material = new THREE.MeshBasicMaterial( { color: 0xffff00 } ); + const torus = new THREE.Mesh( geometry, material ); + scene.add( torus ); + + +

Costruttore

+ +

[name]([param:Float radius], [param:Float tube], [param:Integer radialSegments], [param:Integer tubularSegments], [param:Float arc])

+

+ radius - Raggio del toro, dal centro del toro al centro del tubo. Il valore predefinito è 1.
+ tube — Raggio del tubo. Il valore predefinito è 0.4.
+ radialSegments — Il valore predefinito è 8
+ tubularSegments — Il valore predefinito è 6.
+ arc — Angolo centrale. Il valore predefinito è Math.PI * 2. +

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/TorusKnotGeometry.html b/docs/api/it/geometries/TorusKnotGeometry.html new file mode 100644 index 00000000000000..2aea69daf8e5e6 --- /dev/null +++ b/docs/api/it/geometries/TorusKnotGeometry.html @@ -0,0 +1,74 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

Crea un nodo toroidale, la cui forma particolare è definita da una coppia di interi coprimi, p e q. + Se p e q non sono coprimi, il risultato sarà un collegamento toroidale.

+ + + + + +

Codice di Esempio

+ + const geometry = new THREE.TorusKnotGeometry( 10, 3, 100, 16 ); + const material = new THREE.MeshBasicMaterial( { color: 0xffff00 } ); + const torusKnot = new THREE.Mesh( geometry, material ); + scene.add( torusKnot ); + + +

Costruttrore

+ +

[name]([param:Float radius], [param:Float tube], [param:Integer tubularSegments], [param:Integer radialSegments], [param:Integer p], [param:Integer q])

+

+

    +
  • radius - Raggio del toro. Il valore predefinito è 1.
    • +
  • tube — Raggio del tubo. Il valore predefinito è 0.4.
    • +
  • tubularSegments — Il valore predefinito è 64.
    • +
  • radialSegments — Il valore predefinito è 8.
    • +
  • p — Questo valore determina, quante volte la geometria si avvolge attorno al suo asse di simmetria rotazionale. Il valore predefinito è 2.
    • +
  • q — Questo valore determina, quante volte la geometria si avvolge attorno ad un cerchio all'interno del toro. Il valore predefinito è 3.
    • +
+

+ +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/TubeGeometry.html b/docs/api/it/geometries/TubeGeometry.html new file mode 100644 index 00000000000000..705876b0250d9e --- /dev/null +++ b/docs/api/it/geometries/TubeGeometry.html @@ -0,0 +1,111 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

Crea un tubo che si estrude lungo una curva 3d.

+ + + + + +

Codice di Esempio

+ + + class CustomSinCurve extends THREE.Curve { + + constructor( scale = 1 ) { + + super(); + + this.scale = scale; + + } + + getPoint( t, optionalTarget = new THREE.Vector3() ) { + + const tx = t * 3 - 1.5; + const ty = Math.sin( 2 * Math.PI * t ); + const tz = 0; + + return optionalTarget.set( tx, ty, tz ).multiplyScalar( this.scale ); + + } + + } + + const path = new CustomSinCurve( 10 ); + const geometry = new THREE.TubeGeometry( path, 20, 2, 8, false ); + const material = new THREE.MeshBasicMaterial( { color: 0x00ff00 } ); + const mesh = new THREE.Mesh( geometry, material ); + scene.add( mesh ); + + +

Costruttore

+ + +

[name]([param:Curve path], [param:Integer tubularSegments], [param:Float radius], [param:Integer radialSegments], [param:Boolean closed])

+

+ path — [page:Curve] - Un path 3D che eredita dalla classe base [page:Curve]. Il valore predefinito è una curva quadratica di Bézier.
+ tubularSegments — [page:Integer] - Il numero di segmenti che compongono il tubo. Il valore predefinito è `64`.
+ radius — [page:Float] - Il raggio del tubo. Il valore predefinito è `1`.
+ radialSegments — [page:Integer] - Il numero dei segmenti che compongono la sezione trasversale. Il valore predefinito è `8`.
+ closed — [page:Boolean] Indica se il tubo è aperto o chiuso. Il valore predefinito è `false`.
+

+ + +

Proprietà

+

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

+ +

[property:Object parameters]

+

+ Un oggetto con una proprietà per ognuno dei parametri del costruttore. Qualsiasi modifica dopo l'istanziazione non cambia la geometria. +

+ +

[property:Array tangents]

+

+ Un array [page:Vector3] di tangenti +

+ +

[property:Array normals]

+

+ Un array [page:Vector3] di normali +

+ +

[property:Array binormals]

+

+ Un array [page:Vector3] di binormali +

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/geometries/WireframeGeometry.html b/docs/api/it/geometries/WireframeGeometry.html new file mode 100644 index 00000000000000..96a87401c9c512 --- /dev/null +++ b/docs/api/it/geometries/WireframeGeometry.html @@ -0,0 +1,56 @@ + + + + + + + + + + [page:BufferGeometry] → + +

[name]

+ +

Questa classe può essere utilizzata come oggetto di supporto per la visualizzazione di una [page:BufferGeometry geometria] come wireframe.

+ +

Codice di Esempio

+ + + const geometry = new THREE.SphereGeometry( 100, 100, 100 ); + + const wireframe = new THREE.WireframeGeometry( geometry ); + + const line = new THREE.LineSegments( wireframe ); + line.material.depthTest = false; + line.material.opacity = 0.25; + line.material.transparent = true; + + scene.add( line ); + + +

Esempi

+ +

+ [example:webgl_helpers helpers] +

+ +

Costruttore

+ +

[name]( [param:BufferGeometry geometry] )

+

+ geometry — qualsiasi oggetto geometria. +

+ +

Proprietà

+

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

+ +

Metodi

+

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

+ +

Source

+ +

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

+ + diff --git a/docs/list.json b/docs/list.json index 1f0035c3b3e620..2c850d4212bbcb 100644 --- a/docs/list.json +++ b/docs/list.json @@ -1244,6 +1244,30 @@ "QuadraticBezierCurve": "api/it/extras/curves/QuadraticBezierCurve", "QuadraticBezierCurve3": "api/it/extras/curves/QuadraticBezierCurve3", "SplineCurve": "api/it/extras/curves/SplineCurve" + }, + + "Geometrie": { + "BoxGeometry": "api/it/geometries/BoxGeometry", + "CapsuleGeometry": "api/it/geometries/CapsuleGeometry", + "CircleGeometry": "api/it/geometries/CircleGeometry", + "ConeGeometry": "api/it/geometries/ConeGeometry", + "CylinderGeometry": "api/it/geometries/CylinderGeometry", + "DodecahedronGeometry": "api/it/geometries/DodecahedronGeometry", + "EdgesGeometry": "api/it/geometries/EdgesGeometry", + "ExtrudeGeometry": "api/it/geometries/ExtrudeGeometry", + "IcosahedronGeometry": "api/it/geometries/IcosahedronGeometry", + "LatheGeometry": "api/it/geometries/LatheGeometry", + "OctahedronGeometry": "api/it/geometries/OctahedronGeometry", + "PlaneGeometry": "api/it/geometries/PlaneGeometry", + "PolyhedronGeometry": "api/it/geometries/PolyhedronGeometry", + "RingGeometry": "api/it/geometries/RingGeometry", + "ShapeGeometry": "api/it/geometries/ShapeGeometry", + "SphereGeometry": "api/it/geometries/SphereGeometry", + "TetrahedronGeometry": "api/it/geometries/TetrahedronGeometry", + "TorusGeometry": "api/it/geometries/TorusGeometry", + "TorusKnotGeometry": "api/it/geometries/TorusKnotGeometry", + "TubeGeometry": "api/it/geometries/TubeGeometry", + "WireframeGeometry": "api/it/geometries/WireframeGeometry" } } }, From 6b76005b0ea2c42e97191dad464d333271ce4f1b Mon Sep 17 00:00:00 2001 From: Angela Busato Date: Sat, 3 Sep 2022 11:58:58 +0200 Subject: [PATCH 12/12] feat: add helpers italian version --- docs/api/it/helpers/ArrowHelper.html | 91 +++++++++++++++++++ docs/api/it/helpers/AxesHelper.html | 63 +++++++++++++ docs/api/it/helpers/Box3Helper.html | 61 +++++++++++++ docs/api/it/helpers/BoxHelper.html | 76 ++++++++++++++++ docs/api/it/helpers/CameraHelper.html | 81 +++++++++++++++++ .../it/helpers/DirectionalLightHelper.html | 82 +++++++++++++++++ docs/api/it/helpers/GridHelper.html | 50 ++++++++++ .../api/it/helpers/HemisphereLightHelper.html | 77 ++++++++++++++++ docs/api/it/helpers/PlaneHelper.html | 66 ++++++++++++++ docs/api/it/helpers/PointLightHelper.html | 85 +++++++++++++++++ docs/api/it/helpers/PolarGridHelper.html | 56 ++++++++++++ docs/api/it/helpers/SkeletonHelper.html | 66 ++++++++++++++ docs/api/it/helpers/SpotLightHelper.html | 80 ++++++++++++++++ docs/list.json | 16 ++++ 14 files changed, 950 insertions(+) create mode 100644 docs/api/it/helpers/ArrowHelper.html create mode 100644 docs/api/it/helpers/AxesHelper.html create mode 100644 docs/api/it/helpers/Box3Helper.html create mode 100644 docs/api/it/helpers/BoxHelper.html create mode 100644 docs/api/it/helpers/CameraHelper.html create mode 100644 docs/api/it/helpers/DirectionalLightHelper.html create mode 100644 docs/api/it/helpers/GridHelper.html create mode 100644 docs/api/it/helpers/HemisphereLightHelper.html create mode 100644 docs/api/it/helpers/PlaneHelper.html create mode 100644 docs/api/it/helpers/PointLightHelper.html create mode 100644 docs/api/it/helpers/PolarGridHelper.html create mode 100644 docs/api/it/helpers/SkeletonHelper.html create mode 100644 docs/api/it/helpers/SpotLightHelper.html diff --git a/docs/api/it/helpers/ArrowHelper.html b/docs/api/it/helpers/ArrowHelper.html new file mode 100644 index 00000000000000..e938c1e3fe6357 --- /dev/null +++ b/docs/api/it/helpers/ArrowHelper.html @@ -0,0 +1,91 @@ + + + + + + + + + + [page:Object3D] → + +

[name]

+ +

Un oggetto freccia 3D per visualizzare le direzioni.

+ +

Codice di Esempio

+ + + const dir = new THREE.Vector3( 1, 2, 0 ); + + // normalizza il vettore direzione (converte il vettore di lunghezza 1) + dir.normalize(); + + const origin = new THREE.Vector3( 0, 0, 0 ); + const length = 1; + const hex = 0xffff00; + + const arrowHelper = new THREE.ArrowHelper( dir, origin, length, hex ); + scene.add( arrowHelper ); + + +

Esempi

+ +

+ [example:webgl_shadowmesh WebGL / shadowmesh] +

+ +

Costruttore

+ +

[name]([param:Vector3 dir], [param:Vector3 origin], [param:Number length], [param:Number hex], [param:Number headLength], [param:Number headWidth] )

+

+ [page:Vector3 dir] -- Direzione dall'origine. Deve essere un vettore unitario.
+ [page:Vector3 origin] -- Punto in cui inizia la freccia.
+ [page:Number length] -- Lunghezza della freccia. Il valore predefinito è `1`.
+ [page:Number hex] -- Valore esadecimale per definire il colore. Il valore predefinito è 0xffff00.
+ [page:Number headLength] -- Lunghezza della punta della freccia. Il valore predefinito è 0.2 * length.
+ [page:Number headWidth] -- Larghezza della punta della fraccia. Il valore predefinito è 0.2 * headLength.
+

+ +

Proprietà

+

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

+ +

[property:Line line]

+

Contiene la parte della linea di arrowHelper.

+ +

[property:Mesh cone]

+

Contiene la prte conica dell'arrowHelper.

+ +

Metodi

+

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

+ +

[method:undefined setColor]([param:Color color])

+

+ color -- Il colore desiderato.

+ + Imposta il colore dell'arrowHelper. +

+ +

[method:undefined setLength]([param:Number length], [param:Number headLength], [param:Number headWidth])

+

+ length -- La lunghezza desiderata.
+ headLength -- La lunghezza della punta della freccia.
+ headWidth -- La larghezza della punta della freccia.

+ + Imposta la lunghezza dell'arrowHelper +

+ +

[method:undefined setDirection]([param:Vector3 dir])

+

+ dir -- La direzione desiderata. Deve essere un vettore unitario.

+ + Imposta la direzione dell'arrowHelper. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/helpers/AxesHelper.html b/docs/api/it/helpers/AxesHelper.html new file mode 100644 index 00000000000000..2185a813a05562 --- /dev/null +++ b/docs/api/it/helpers/AxesHelper.html @@ -0,0 +1,63 @@ + + + + + + + + + + [page:Object3D] → [page:Line] → [page:LineSegments] → + +

[name]

+ +

Un oggetto asse per visualizzare i 3 assi in modo semplice.
+ L'asse X è rossa. L'asse Y è verde. L'asse Z è blu. +

+ +

Codice di Esempio

+ + +const axesHelper = new THREE.AxesHelper( 5 ); +scene.add( axesHelper ); + + +

Esempi

+ +

+ [example:webgl_buffergeometry_compression WebGL / buffergeometry / compression]
+ [example:webgl_geometry_convex WebGL / geometry / convex]
+ [example:webgl_loader_nrrd WebGL / loader / nrrd] +

+ +

Costruttore

+ + +

[name]( [param:Number size] )

+

+ [page:Number size] -- (opzionale) dimensione delle linee che rappresentano gli assi. Il valore predefinito è `1`. +

+ +

Proprietà

+

Vedi la classe base [page:LineSegments] per le proprietà in comune.

+ +

Metodi

+

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

+ +

[method:this setColors]( [param:Color xAxisColor], [param:Color yAxisColor], [param:Color zAxisColor] )

+

+ Imposta il colore degli assi a [page:Color xAxisColor], [page:Color yAxisColor], [page:Color zAxisColor]. +

+ +

[method:undefined dispose]()

+

+ Elimina il [page:Line.material materiale] e la [page:Line.geometry geometria] creati internamente utilizzati da questo helper. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/helpers/Box3Helper.html b/docs/api/it/helpers/Box3Helper.html new file mode 100644 index 00000000000000..44df7c7f25533c --- /dev/null +++ b/docs/api/it/helpers/Box3Helper.html @@ -0,0 +1,61 @@ + + + + + + + + + + [page:Object3D] → [page:Line] → [page:LineSegments] → + +

[name]

+ +

+ Oggetto per visualizzare una [page:Box3]. +

+ +

Codice di Esempio

+ + + const box = new THREE.Box3(); + box.setFromCenterAndSize( new THREE.Vector3( 1, 1, 1 ), new THREE.Vector3( 2, 1, 3 ) ); + + const helper = new THREE.Box3Helper( box, 0xffff00 ); + scene.add( helper ); + + + +

Costruttore

+ + +

[name]( [param:Box3 box], [param:Color color] )

+

+ [page:Box3 box] -- il Box3 da mostrare.
+ [page:Color color] -- (opzionale) il colore del box. Il valore predefinito è 0xffff00.

+ + Crea un nuovo wireframe box che rappresenta il Box3 passato. +

+ +

Proprietà

+

Vedi la classe base [page:LineSegments] per le proprietà in comune.

+ +

[property:Box3 box]

+

Il Box3 visualizzato.

+ +

Metodi

+

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

+ +

[method:undefined updateMatrixWorld]( [param:Boolean force] )

+

+ Questo sovrascrive il metodo nella classe base [page:Object3D] così che + aggiorni anche il wireframe box nell'ambito della proprietà [page:Box3Helper.box .box] +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/helpers/BoxHelper.html b/docs/api/it/helpers/BoxHelper.html new file mode 100644 index 00000000000000..d0641aa7ed5589 --- /dev/null +++ b/docs/api/it/helpers/BoxHelper.html @@ -0,0 +1,76 @@ + + + + + + + + + + [page:Object3D] → [page:Line] → [page:LineSegments] → + +

[name]

+ +

+ Oggetto di aiuto per mostrare graficamente il bounding box allineato all'asse world intorno ad un oggetto. + Il bounding box vero e proprio è gestito da [page:Box3], questo è solo un aiuto visivo per il debug. + Può essere ridimensionato automaticamente tramite il metodo [page:BoxHelper.update] quando l'oggetto + da cui è stato creato viene trasformato. Si noti che l'oggetto deve avere una [page:BufferGeometry] + per funzionare, quindi non funziona con gli [page:Sprite Sprite]. +

+ +

Codice di Esempio

+ + + const sphere = new THREE.SphereGeometry(); + const object = new THREE.Mesh( sphere, new THREE.MeshBasicMaterial( 0xff0000 ) ); + const box = new THREE.BoxHelper( object, 0xffff00 ); + scene.add( box ); + + +

Esempi

+ +

+ [example:webgl_helpers WebGL / helpers]
+ [example:webgl_loader_nrrd WebGL / loader / nrrd]
+ [example:webgl_buffergeometry_drawrange WebGL / buffergeometry / drawrange] +

+ +

Costruttore

+ + +

[name]( [param:Object3D object], [param:Color color] )

+

+ [page:Object3D object] -- (opzionale) l'object3D su cui mostrare il bounding box allineato all'asse del world.
+ [page:Color color] -- (opzionale) valore esadecimale che definisce il colore del box. Il valore predefinito è 0xffff00.

+ + Crea un nuovo wireframe box che delimita l'oggetto passato. Internamento utilizza il metodo [page:Box3.setFromObject] + per calcolare le dimansioni. Si noti che include qualsiasi figlio dell'oggetto. +

+ +

Proprietà

+

Vedi la classe base [page:LineSegments] per le proprietà in comune.

+ +

Metodi

+

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

+ +

[method:undefined update]()

+

+ Aggiorna la geometria dell'helper in modo che corrisponda alle dimensioni dell'oggetto, + inclusi eventuali figli. Vedi [page:Box3.setFromObject]. +

+ +

[method:this setFromObject]( [param:Object3D object] )

+

+ [page:Object3D object] - [page:Object3D] su cui creare l'helper.

+ + Aggiorna il wireframe box per l'oggetto passato. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/helpers/CameraHelper.html b/docs/api/it/helpers/CameraHelper.html new file mode 100644 index 00000000000000..6c3523a1d60e5e --- /dev/null +++ b/docs/api/it/helpers/CameraHelper.html @@ -0,0 +1,81 @@ + + + + + + + + + + [page:Object3D] → [page:Line] → [page:LineSegments] → + +

[name]

+ +

+ Questa classe aiuta a visualizzare ciò che una telecamera contiene nel suo frustum.
+ Visualizza il frustum di una telecamera utilizzando un [page:LineSegments]. +

+ +

Codice di Esempio

+ +const camera = new THREE.PerspectiveCamera( 75, window.innerWidth / window.innerHeight, 0.1, 1000 ); +const helper = new THREE.CameraHelper( camera ); +scene.add( helper ); + + +

Esempi

+

+ [example:webgl_camera WebGL / camera]
+ [example:webgl_geometry_extrude_splines WebGL / extrude / splines] +

+ +

Costruttore

+ +

[name]( [param:Camera camera] )

+

+ [page:Camera camera] -- La telecamera da visualizzare.

+ + Crea un nuovo [name] per la telecamera specificata. +

+ +

Proprietà

+

Vedi la classe base [page:LineSegments] per le proprietà in comune.

+ +

[property:Camera camera]

+

La telecamera visualizzata.

+ +

[property:Object pointMap]

+

Contiene i punti utilizzati per visualizzare la telecamera.

+ +

[property:Object matrix]

+

Riferimento a [page:Object3D.matrixWorld camera.matrixWorld].

+ +

[property:Object matrixAutoUpdate]

+

+ Vedi [page:Object3D.matrixAutoUpdate]. In questo caso è impostato su `false`, poiché l'helper sta usando + [page:Object3D.matrixWorld matrixWorld] della telecamera. +

+ +

Metodi

+

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

+ +

[method:undefined dispose]()

+

+ Elimina il [page:Line.material materiale] e la [page:Line.geometry geometria] utilizzati da questo helper. +

+ +

[method:this setColors]( [param:Color frustum], [param:Color cone], [param:Color up], [param:Color target], [param:Color cross] )

+

+ Definisce i colori dell'helper. +

+ +

[method:undefined update]()

+

Aggiorna l'helper in base alla projectionMatrix della telecamera.

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/helpers/DirectionalLightHelper.html b/docs/api/it/helpers/DirectionalLightHelper.html new file mode 100644 index 00000000000000..328ecac81845b4 --- /dev/null +++ b/docs/api/it/helpers/DirectionalLightHelper.html @@ -0,0 +1,82 @@ + + + + + + + + + + [page:Object3D] → + +

[name]

+ +

+ Oggetto di supporto per aiutare a visualizzare l'effetto di una [page:DirectionalLight] nella scena. + Consiste in un piano e una linea che rappresentano la posizione e la direzione della luce. +

+ +

Codice di Esempio

+ + + const light = new THREE.DirectionalLight( 0xFFFFFF ); + const helper = new THREE.DirectionalLightHelper( light, 5 ); + scene.add( helper ); + + +

Costruttore

+ + +

[name]( [param:DirectionalLight light], [param:Number size], [param:Hex color] )

+

+ [page:DirectionalLight light]-- La luce da visualizzare.

+ + [page:Number size] -- (opzionale) le dimensioni del piano. Il valore predefinito è `1`.

+ + [page:Hex color] -- (opzionale) se non è impostato l'helper prenderà il colore della luce. +

+ + +

Proprietà

+

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

+ + +

[property:Line lightPlane]

+

Contiene la mesh della linea che mostra la posizione della luce direzionale.

+ +

[property:DirectionalLight light]

+

Riferimento alla [page:DirectionalLight directionalLight] da visualizzare.

+ +

[property:Object matrix]

+

Riferimento alla [page:Object3D.matrixWorld matrixWorld] della luce.

+ +

[property:Object matrixAutoUpdate]

+

+ Vedi [page:Object3D.matrixAutoUpdate]. In questo caso è impostato su `false`, poiché l'helper sta usando + [page:Object3D.matrixWorld matrixWorld] della telecamera. +

+ +

[property:hex color]

+

+ Il parametro colore passato nel costruttore. Il valore predefinito è `undefined`. Se viene modificato, + il colore dell'helper sarà aggiornato la prossima volta che il metodo [page:.update update] venga chiamato. +

+ + +

Metodi

+

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

+ +

[method:undefined dispose]()

+

Elimina il directionalLightHelper.

+ + +

[method:undefined update]()

+

Aggiorna l'helper in modo che corrisponda alla posizione e alla direzione della [page:.light directionalLight] visualizzata.

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/helpers/GridHelper.html b/docs/api/it/helpers/GridHelper.html new file mode 100644 index 00000000000000..8cbff06639f347 --- /dev/null +++ b/docs/api/it/helpers/GridHelper.html @@ -0,0 +1,50 @@ + + + + + + + + + + [page:Object3D] → [page:Line] → + +

[name]

+ +

Il [name] è un oggetto utilizzato per definire le griglie (grid). Le grigle sono array bidimensionali di linee.

+ +

Codice di Esempio

+ + const size = 10; + const divisions = 10; + + const gridHelper = new THREE.GridHelper( size, divisions ); + scene.add( gridHelper ); + + +

Esempi

+ +

+ [example:webgl_helpers WebGL / helpers] +

+ +

Costruttore

+ +

[name]( [param:number size], [param:Number divisions], [param:Color colorCenterLine], [param:Color colorGrid] )

+

+ size -- La dimensione della griglia. Il valore predefinito è 10.
+ divisions -- Il numero di divisioni nella griglia. Il valore predefinito è 10.
+ colorCenterLine -- (optional) Il colore della linea centrale. Può essere un [page:Color], un valore esadecimale e un nome CSS-Color. Il valore predefinito è 0x444444
+ colorGrid -- (optional) Il colore delle linee della griglia. Può essere un [page:Color], un valore esadecimale e un nome CSS-Color. Il valore predefinito è 0x888888 +

+

+ Crea un nuovo [name] di dimensioni 'size' e suddiso in 'divisions' segmenti per lato. I colori sono opzionali. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/helpers/HemisphereLightHelper.html b/docs/api/it/helpers/HemisphereLightHelper.html new file mode 100644 index 00000000000000..c4345a79304812 --- /dev/null +++ b/docs/api/it/helpers/HemisphereLightHelper.html @@ -0,0 +1,77 @@ + + + + + + + + + + [page:Object3D] → + +

[name]

+ +

+ Crea un aiuto visivo costituito da una [page:Mesh] sferica per un [page:HemisphereLight HemisphereLight]. +

+ +

Codice di Esempio

+ + + const light = new THREE.HemisphereLight( 0xffffbb, 0x080820, 1 ); + const helper = new THREE.HemisphereLightHelper( light, 5 ); + scene.add( helper ); + + + +

Costruttore

+ +

[name]( [param:HemisphereLight light], [param:Number sphereSize], [param:Hex color] )

+

+ [page:HemisphereLight light] -- La luce da visualizzare.

+ + [page:Number size] -- La dimensione della mesh utilizzata per visualizzare la luce.

+ + [page:Hex color] -- (opzionale) se questo non è impostato l'helper avrà il colore della luce. +

+ + +

Proprietà

+

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

+ +

[property:HemisphereLight light]

+

Riferimento alla HemisphereLight da visualizzare.

+ +

[property:Object matrix]

+

Riferimento alla [page:Object3D.matrixWorld matrixWorld] della hemisphereLight.

+ +

[property:Object matrixAutoUpdate]

+

+ Vedi [page:Object3D.matrixAutoUpdate]. In questo caso è impostato su `false`, poiché l'helper sta usando + [page:Object3D.matrixWorld matrixWorld] della telecamera. +

+ +

[property:hex color]

+

+ Il parametro colore passato nel costruttore. Il valore predefinito è `undefined`. + Se viene modificato, il colore dell'helper sarà aggiornato la prossima volta che il metodo [page:.update update] venga chiamato. +

+ + +

Metodi

+

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

+ +

[method:undefined dispose]()

+

Elimina l'hemisphereLightHelper.

+ +

[method:undefined update]()

+

Aggiorna l'helper in modo che corrisponda alla posizione e alla direzione della [page:.light luce].

+ + +

Source

+ +

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

+ + diff --git a/docs/api/it/helpers/PlaneHelper.html b/docs/api/it/helpers/PlaneHelper.html new file mode 100644 index 00000000000000..fa0fdda9e734d4 --- /dev/null +++ b/docs/api/it/helpers/PlaneHelper.html @@ -0,0 +1,66 @@ + + + + + + + + + + [page:Object3D] → [page:Line] → [page:LineSegments] → + +

[name]

+ +

+ Oggetto per visualizzare un [page:Plane Piano]. +

+ + +

Codice di Esempio

+ + + const plane = new THREE.Plane( new THREE.Vector3( 1, 1, 0.2 ), 3 ); + const helper = new THREE.PlaneHelper( plane, 1, 0xffff00 ); + scene.add( helper ); + + + +

Costruttore

+ + +

[name]( [param:Plane plane], [param:Float size], [param:Color hex] )

+

+ [page:Plane plane] -- il piano da visualizzare.
+ [page:Float size] -- (opzionale) lunghezza laterale dell'helper del piano. Il valore predefinito è 1.
+ [page:Color color] -- (opzionale) il colore dell'helper. Il valore predefinito è 0xffff00.

+ + Crea un nuovo wireframe che rappresenta il piano passato. +

+ +

Proprietà

+

Vedi la classe base [page:LineSegments] per le proprietà in comune.

+ +

[property:Plane plane]

+

Il [page:Plane plane] da visualizzare.

+ +

[property:Float size]

+

Le lunghezze laterali dell'helper del piano.

+ + +

Metodi

+

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

+ +

[method:undefined updateMatrixWorld]( [param:Boolean force] )

+

+ Sovrascrive il metodo in base alla classe [page:Object3D]. + Questo sovrascrive il metodo nella classe base [page:Object3D] così che aggiorni anche l'oggetto helper in base alle proprietà + [page:PlaneHelper.plane .plane] e [page:PlaneHelper.size .size]. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/helpers/PointLightHelper.html b/docs/api/it/helpers/PointLightHelper.html new file mode 100644 index 00000000000000..9013db03481680 --- /dev/null +++ b/docs/api/it/helpers/PointLightHelper.html @@ -0,0 +1,85 @@ + + + + + + + + + + [page:Object3D] → [page:Mesh] → + +

[name]

+ +

+ Questo mostra un oggetto helper costituito da una [page:Mesh] sferica per la visualizzazione di + un [page:PointLight]. +

+ +

Codice di Esempio

+ + + const pointLight = new THREE.PointLight( 0xff0000, 1, 100 ); + pointLight.position.set( 10, 10, 10 ); + scene.add( pointLight ); + + const sphereSize = 1; + const pointLightHelper = new THREE.PointLightHelper( pointLight, sphereSize ); + scene.add( pointLightHelper ); + + +

Esempi

+ +

+ [example:webgl_helpers WebGL / helpers] +

+ +

Costruttore

+ +

[name]( [param:PointLight light], [param:Float sphereSize], [param:Hex color] )

+

+ [page:PointLight light] -- La luce da visualizzare.

+ + [page:Float sphereSize] -- (opzionale) La dimensione della sfera. Il valore predefinito è `1`.

+ + [page:Hex color] -- (opzionale) Se non è impostato l'helper prenderà il colore della luce. +

+ +

Proprietà

+

Vedi la classe base [page:Mesh] per le proprietà in comune.

+ +

[property:PointLight light]

+

La [page:PointLight] che viene visualizzata.

+ +

[property:Object matrix]

+

Riferimento alla [page:Object3D.matrixWorld matrixWorld] del pointLight.

+ +

[property:Object matrixAutoUpdate]

+

+ Vedi [page:Object3D.matrixAutoUpdate]. In questo caso è impostato su `false`, poiché l'helper sta usando + [page:Object3D.matrixWorld matrixWorld] della telecamera. +

+ +

[property:hex color]

+

+ Il parametro colore passato nel costruttore. Il valore predefinito è `undefined`. Se viene modificato, + il colore dell'helper sarà aggiornato la prossima volta che il metodo [page:.update update] venga chiamato. +

+ +

Metodi

+

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

+ +

[method:undefined dispose]()

+

Elimina il pointLightHelper.

+ + +

[method:undefined update]()

+

Aggiorna l'helper in modo che corrisponda alla posizione della [page:.light luce].

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/helpers/PolarGridHelper.html b/docs/api/it/helpers/PolarGridHelper.html new file mode 100644 index 00000000000000..9ad435bdc0b329 --- /dev/null +++ b/docs/api/it/helpers/PolarGridHelper.html @@ -0,0 +1,56 @@ + + + + + + + + + + [page:Object3D] → [page:Line] → + +

[name]

+ +

Il PolarGridHelper è un oggetto utilizzato per definire le griglie polari. Le griglie sono array bidimensionli di linee.

+ +

Codice di Esempio

+ + + const radius = 10; + const sectors = 16; + const rings = 8; + const divisions = 64; + + const helper = new THREE.PolarGridHelper( radius, sectors, rings, divisions ); + scene.add( helper ); + + +

Esempi

+ +

+ [example:webgl_helpers WebGL / helpers] +

+ +

Costruttore

+ +

[name]( [param:Number radius], [param:Number sectors], [param:Number rings], [param:Number divisions], [param:Color color1], [param:Color color2] )

+

+ radius -- Il raggio della griglia polare. Può essere qualsiasi numero positivo. Il valore predefinito è 10.
+ sectors -- Il numero di settori in cui deve essere divisa la griglia. Può essere qualsiasi numero intero positivo. Il valore predefinito è 16.
+ rings -- Il numero di anelli. Può essere qualsiasi numero intero positivo. Il valore predefinito è 8.
+ divisions -- Il numero di segmenti linea utilizzato per ogni cerchio. Può essere qualsiasi numero intero positivo pari o superiore a 3. Il valore predefinito è 64.
+ color1 -- Il primo colore utilizzato per gli elementi della griglia. Può essere un [page:Color], un valore esadecimale e un nome CSS-Color. Il valore predefinito è 0x444444
+ color2 -- Il secondo colore utilizzato per gli elementi della griglia. Può essere un [page:Color], un valore esadecimale e un nome CSS-Color. Il valore predefinito è 0x888888 +

+

+ Crea un nuovo [name] di raggio 'radius' con 'sectors' numero di settori e 'rings' numero di anelli, in cui ogni cerchio + viene smussato in 'divisions' numero di segmenti di linea. I colori sono opzionali. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/helpers/SkeletonHelper.html b/docs/api/it/helpers/SkeletonHelper.html new file mode 100644 index 00000000000000..1ff94cc98901b9 --- /dev/null +++ b/docs/api/it/helpers/SkeletonHelper.html @@ -0,0 +1,66 @@ + + + + + + + + + + [page:Object3D] → [page:Line] → [page:LineSegments] → + +

[name]

+ +

+ Un oggetto helper per aiutare a visualizzare uno [page:Skeleton Skeleton]. + L'helper viene visualizzato utilizzando un [page:LineBasicMaterial LineBasicMaterial]. +

+ +

Codice di Esempio

+ + + const helper = new THREE.SkeletonHelper( skinnedMesh ); + scene.add( helper ); + + +

Esempi

+ +

+ [example:webgl_animation_skinning_blending WebGL / animation / skinning / blending]
+ [example:webgl_animation_skinning_morph WebGL / animation / skinning / morph]
+ [example:webgl_loader_bvh WebGL / loader / bvh ] +

+ +

Costruttore

+ + +

[name]( [param:Object3D object] )

+

+ object -- Solitamente un'istanza di [page:SkinnedMesh]. Tuttavia, può essere utilizzata qualsiasi istanza di [page:Object3D] + se rappresenta una gerarchia di [page:Bone Bone] (tramite [page:Object3D.children]). +

+ +

Proprietà

+ +

[property:Array bones]

+

+ L'elenco delle ossa che l'helper visualizza come [page:Line Lines]. +

+ +

[property:Boolean isSkeletonHelper]

+

+ Flag di sola lettura per controllare se un dato oggetto è di tipo [name]. +

+ +

[property:Object3D root]

+

+ L'oggetto passato nel costruttore. +

+ +

Source

+ +

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

+ + diff --git a/docs/api/it/helpers/SpotLightHelper.html b/docs/api/it/helpers/SpotLightHelper.html new file mode 100644 index 00000000000000..17301123b974b6 --- /dev/null +++ b/docs/api/it/helpers/SpotLightHelper.html @@ -0,0 +1,80 @@ + + + + + + + + + + [page:Object3D] → + +

[name]

+ +

Visualizza un oggetto helper a forma di cono per una [page:SpotLight].

+ +

Codice di Esempio

+ + const spotLight = new THREE.SpotLight( 0xffffff ); + spotLight.position.set( 10, 10, 10 ); + scene.add( spotLight ); + + const spotLightHelper = new THREE.SpotLightHelper( spotLight ); + scene.add( spotLightHelper ); + + +

Esempi

+

+ [example:webgl_lights_spotlights WebGL/ lights / spotlights ] +

+ +

Costruttore

+ +

[name]( [param:SpotLight light], [param:Hex color] )

+

+ [page:SpotLight light] -- La [page:SpotLight] da visualizzare.

+ + [page:Hex color] -- (opzionale) Se non è impostato l'helper prenderà il colore della luce. +

+ + +

Proprietà

+

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

+ +

[property:LineSegments cone]

+

[page:LineSegments] usati per visualizzare la luce.

+ +

[property:SpotLight light]

+

Riferimento alla [page:SpotLight] visualizzata.

+ +

[property:Object matrix]

+

Riferimento alla [page:Object3D.matrixWorld matrixWorld] della spotLight.

+ +

[property:Object matrixAutoUpdate]

+

+ Vedi [page:Object3D.matrixAutoUpdate]. In questo caso è impostato su `false`, poiché l'helper sta usando + [page:Object3D.matrixWorld matrixWorld] della telecamera. +

+ +

[property:hex color]

+

+ Il parametro colore passato nel costruttore. Il valore predefinito è `undefined`. Se viene modificato, + il colore dell'helper sarà aggiornato la prossima volta che il metodo [page:.update update] venga chiamato. +

+ +

Metodi

+

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

+ +

[method:undefined dispose]()

+

Elimina l'helper della luce.

+ +

[method:undefined update]()

+

Aggiorna l'helper della luce.

+ +

Source

+ +

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

+ + diff --git a/docs/list.json b/docs/list.json index 2c850d4212bbcb..f7a3d015b87a3a 100644 --- a/docs/list.json +++ b/docs/list.json @@ -1268,6 +1268,22 @@ "TorusKnotGeometry": "api/it/geometries/TorusKnotGeometry", "TubeGeometry": "api/it/geometries/TubeGeometry", "WireframeGeometry": "api/it/geometries/WireframeGeometry" + }, + + "Helpers": { + "ArrowHelper": "api/it/helpers/ArrowHelper", + "AxesHelper": "api/it/helpers/AxesHelper", + "BoxHelper": "api/it/helpers/BoxHelper", + "Box3Helper": "api/it/helpers/Box3Helper", + "CameraHelper": "api/it/helpers/CameraHelper", + "DirectionalLightHelper": "api/it/helpers/DirectionalLightHelper", + "GridHelper": "api/it/helpers/GridHelper", + "PolarGridHelper": "api/it/helpers/PolarGridHelper", + "HemisphereLightHelper": "api/it/helpers/HemisphereLightHelper", + "PlaneHelper": "api/it/helpers/PlaneHelper", + "PointLightHelper": "api/it/helpers/PointLightHelper", + "SkeletonHelper": "api/it/helpers/SkeletonHelper", + "SpotLightHelper": "api/it/helpers/SpotLightHelper" } } },