Skip to content

Examples: add three/addons/* alias #23406

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 17 commits into from
Aug 25, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion docs/manual/ar/introduction/How-to-create-VR-content.html
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ <h2>سير العمل</h2>
</p>

<code>
import { VRButton } from 'three/examples/jsm/webxr/VRButton.js';
import { VRButton } from 'three/addons/webxr/VRButton.js';
</code>

<p>
Expand Down
10 changes: 5 additions & 5 deletions docs/manual/ar/introduction/How-to-use-post-processing.html
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,9 @@ <h2>سير العمل</h2>
</p>

<code>
import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass.js';
import { GlitchPass } from 'three/examples/jsm/postprocessing/GlitchPass.js';
import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
import { GlitchPass } from 'three/addons/postprocessing/GlitchPass.js';
</code>

<p>
Expand Down Expand Up @@ -80,8 +80,8 @@ <h2>تصاريح مخصصة</h2>
</p>

<code>
import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass.js';
import { LuminosityShader } from 'three/examples/jsm/shaders/LuminosityShader.js';
import { ShaderPass } from 'three/addons/postprocessing/ShaderPass.js';
import { LuminosityShader } from 'three/addons/shaders/LuminosityShader.js';

// later in your init routine

Expand Down
2 changes: 1 addition & 1 deletion docs/manual/ar/introduction/Installation.html
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,7 @@ <h2>أمثلة</h2>
</p>

<code>
import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
import { OrbitControls } from 'three/addons/controls/OrbitControls.js';

const controls = new OrbitControls( camera, renderer.domElement );
</code>
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/ar/introduction/Loading-3D-models.html
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ <h2>التحميل</h2>
</p>

<code>
import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
</code>

<p>
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/en/introduction/How-to-create-VR-content.html
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ <h2>Workflow</h2>
</p>

<code>
import { VRButton } from 'three/examples/jsm/webxr/VRButton.js';
import { VRButton } from 'three/addons/webxr/VRButton.js';
</code>

<p>
Expand Down
10 changes: 5 additions & 5 deletions docs/manual/en/introduction/How-to-use-post-processing.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,9 +28,9 @@ <h2>Workflow</h2>
</p>

<code>
import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass.js';
import { GlitchPass } from 'three/examples/jsm/postprocessing/GlitchPass.js';
import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
import { GlitchPass } from 'three/addons/postprocessing/GlitchPass.js';
</code>

<p>
Expand Down Expand Up @@ -92,8 +92,8 @@ <h2>Custom Passes</h2>
</p>

<code>
import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass.js';
import { LuminosityShader } from 'three/examples/jsm/shaders/LuminosityShader.js';
import { ShaderPass } from 'three/addons/postprocessing/ShaderPass.js';
import { LuminosityShader } from 'three/addons/shaders/LuminosityShader.js';

// later in your init routine

Expand Down
2 changes: 1 addition & 1 deletion docs/manual/en/introduction/Installation.html
Original file line number Diff line number Diff line change
Expand Up @@ -103,7 +103,7 @@ <h2>Examples</h2>


<code>
import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
import { OrbitControls } from 'three/addons/controls/OrbitControls.js';

const controls = new OrbitControls( camera, renderer.domElement );
</code>
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/en/introduction/Loading-3D-models.html
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ <h2>Loading</h2>
</p>

<code>
import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
</code>

<p>
Expand Down
4 changes: 2 additions & 2 deletions docs/manual/fr/introduction/How-to-create-VR-content.html
Original file line number Diff line number Diff line change
Expand Up @@ -24,12 +24,12 @@ <h2>Workflow</h2>
</p>

<code>
import { VRButton } from 'three/examples/jsm/webxr/VRButton.js';
import { VRButton } from 'three/addons/webxr/VRButton.js';
</code>

<p>
*VRButton.createButton()* fait deux choses importantes: Cela crée un bouton qui indique
la compatibilité VR. De plus, cela initie une session VR si l'utilisateur active le bouton. La seule chose que vous avez
la compatibilité VR. De plus, cela initie une session VR si l'utilisateur active le bouton. La seule chose que vous avez
à faire est d'ajouter la ligne de code suivante à votre application.
</p>

Expand Down
10 changes: 5 additions & 5 deletions docs/manual/fr/introduction/How-to-use-post-processing.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,9 +28,9 @@ <h2>Workflow</h2>
</p>

<code>
import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass.js';
import { GlitchPass } from 'three/examples/jsm/postprocessing/GlitchPass.js';
import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
import { GlitchPass } from 'three/addons/postprocessing/GlitchPass.js';
</code>

<p>
Expand Down Expand Up @@ -92,8 +92,8 @@ <h2>Effets Customisés</h2>
</p>

<code>
import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass.js';
import { LuminosityShader } from 'three/examples/jsm/shaders/LuminosityShader.js';
import { ShaderPass } from 'three/addons/postprocessing/ShaderPass.js';
import { LuminosityShader } from 'three/addons/shaders/LuminosityShader.js';

// later in your init routine

Expand Down
2 changes: 1 addition & 1 deletion docs/manual/fr/introduction/Installation.html
Original file line number Diff line number Diff line change
Expand Up @@ -103,7 +103,7 @@ <h2>Exemples</h2>


<code>
import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
import { OrbitControls } from 'three/addons/controls/OrbitControls.js';

const controls = new OrbitControls( camera, renderer.domElement );
</code>
Expand Down
18 changes: 9 additions & 9 deletions docs/manual/fr/introduction/Loading-3D-models.html
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ <h2>Charger les modèles</h2>
</p>

<code>
import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
</code>

<p>
Expand Down Expand Up @@ -114,7 +114,7 @@ <h2>Charger les modèles</h2>
<h2>Dépannage</h2>

<p>
Vous avez passé des heures à modeler votre chef-d'oeuvre artisanal, vous le chargez sur
Vous avez passé des heures à modeler votre chef-d'oeuvre artisanal, vous le chargez sur
la page web, et — oh non! 😭 Il est tordu, mal coloré, ou tout simplement porté-disparu.
Commencez par ces étapes de dépannage:
</p>
Expand All @@ -135,8 +135,8 @@ <h2>Dépannage</h2>
le signalement d'un bug auprès de l'application avec laquelle vous avez réalisé le modèle 3D.
</li>
<li>
Essayez de divisier ou de multiplier la taille du modèle par un facteur de 1000. Plusieurs modèles sont mis à
l'échelles différemment, et les gros modèles peuvent ne pas apparaître si la caméra est
Essayez de divisier ou de multiplier la taille du modèle par un facteur de 1000. Plusieurs modèles sont mis à
l'échelles différemment, et les gros modèles peuvent ne pas apparaître si la caméra est
à l'intérieur du modèle.
</li>
<li>
Expand All @@ -145,20 +145,20 @@ <h2>Dépannage</h2>
<li>
Cherchez des requêtes concernant des textures erronnées dans votre onglet réseau, comme
`"C:\\Path\To\Model\texture.jpg"`. Utilisez des chemins relatifs menant à votre
modèle à la place, comme `images/texture.jpg` — cela peut nécessiter
modèle à la place, comme `images/texture.jpg` — cela peut nécessiter
la modification du fichier du modèle dans un éditeur de texte.
</li>
</ol>

<h2>Demander de l'aide</h2>

<p>
Si vous avez effectué le processus de dépannage ci-dessus et que votre modèle
ne fonctionne toujours pas, utiliser la bonne approche pour demander de l'aide vous mènera
Si vous avez effectué le processus de dépannage ci-dessus et que votre modèle
ne fonctionne toujours pas, utiliser la bonne approche pour demander de l'aide vous mènera
plus rapidement à la solution. Postez une question sur le
<a href="https://discourse.threejs.org/" target="_blank" rel="noopener">forum three.js</a> et, incluez dès que possible,
votre modèle (ou un modèle plus simple avec le même problème) dans n'importe quel format
qui vous est disponible. Incluez sufisamment d'informations pour que quelqu'un puisse reproduire
votre modèle (ou un modèle plus simple avec le même problème) dans n'importe quel format
qui vous est disponible. Incluez sufisamment d'informations pour que quelqu'un puisse reproduire
ce problème rapidement — idéalement, une démo live.
</p>

Expand Down
2 changes: 1 addition & 1 deletion docs/manual/it/introduction/How-to-create-VR-content.html
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ <h2>Workflow</h2>
</p>

<code>
import { VRButton } from 'three/examples/jsm/webxr/VRButton.js';
import { VRButton } from 'three/addons/webxr/VRButton.js';
</code>

<p>
Expand Down
22 changes: 11 additions & 11 deletions docs/manual/it/introduction/How-to-use-post-processing.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ <h1>Come utilizzare il post-processing (How to use post-processing)</h1>
Molte applicazioni 3D visualizzano i loro oggetti 3D direttamente sullo schermo. A volte, tuttavia, si vuole applicare uno o più effetti grafici
come Depth-Of-Field, Bloom, Film Grain o vari tipi di Anti-aliasing. Il Post-processing è una soluzione ampiamente utilizzata per implementare questi effetti.
Prima di tutto, la scena viene renderizzata su un target di rendering che rappresenta un buffer nella memoria della scheda video.
Nella fase successiva, uno o più passaggi di post-processing applicano filtri ed effetti al buffer dell'immagine prima che questa venga infine renderizzata
Nella fase successiva, uno o più passaggi di post-processing applicano filtri ed effetti al buffer dell'immagine prima che questa venga infine renderizzata
sullo schermo.
</p>
<p>
Expand All @@ -23,15 +23,15 @@ <h1>Come utilizzare il post-processing (How to use post-processing)</h1>
<h2>Workflow</h2>

<p>
Il primo step, nel processo, è quello di importare tutti i file necessari dalla cartella degli esempi. La guida presuppone che si utilizzi
il [link:https://www.npmjs.com/package/three pacchetto npm] ufficiale di three.js. Per la nostra demo di base in questa guida abbiamo
Il primo step, nel processo, è quello di importare tutti i file necessari dalla cartella degli esempi. La guida presuppone che si utilizzi
il [link:https://www.npmjs.com/package/three pacchetto npm] ufficiale di three.js. Per la nostra demo di base in questa guida abbiamo
bisogno dei seguenti file:
</p>

<code>
import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass.js';
import { GlitchPass } from 'three/examples/jsm/postprocessing/GlitchPass.js';
import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
import { GlitchPass } from 'three/addons/postprocessing/GlitchPass.js';
</code>

<p>
Expand Down Expand Up @@ -73,29 +73,29 @@ <h2>Workflow</h2>
</code>

<p>
`RenderPass` viene normalmente posizionata all'inizio della catena per fornire la scena renderizzata come input per il passaggio successivo di post-processing.
`RenderPass` viene normalmente posizionata all'inizio della catena per fornire la scena renderizzata come input per il passaggio successivo di post-processing.
Nel nostro caso `GlitchPass` utilizzarà questi dati di immagine per applicare un effetto glitch selvaggio. Guarda questo [link:https://threejs.org/examples/webgl_postprocessing_glitch esempio live]
per vederli in azione.
</p>

<h2>Passi Built-in</h2>

<p>
È possibile utilizzare un'ampia gamma di passaggi di post-processing predefiniti forniti dall'engine. Si possono trovare nella
È possibile utilizzare un'ampia gamma di passaggi di post-processing predefiniti forniti dall'engine. Si possono trovare nella
cartella di [link:https://github.com/mrdoob/three.js/tree/dev/examples/jsm/postprocessing postprocessing].
</p>

<h2>Passi personalizzati</h2>

<p>
A volte si desidera scrivere uno shader di post-processing personalizzato e includerlo nella catena dei passi di post-processing.
Per questo scenario puoi utilizzare `ShaderPass`. Dopo aver importato il file e lo shader personalizzato, si può usare il seguente codice per
Per questo scenario puoi utilizzare `ShaderPass`. Dopo aver importato il file e lo shader personalizzato, si può usare il seguente codice per
impostare i passaggi:
</p>

<code>
import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass.js';
import { LuminosityShader } from 'three/examples/jsm/shaders/LuminosityShader.js';
import { ShaderPass } from 'three/addons/postprocessing/ShaderPass.js';
import { LuminosityShader } from 'three/addons/shaders/LuminosityShader.js';

// later in your init routine

Expand Down
8 changes: 4 additions & 4 deletions docs/manual/it/introduction/Installation.html
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ <h1>Installazione ([name])</h1>
</p>

<p>
Qualsiasi soluzione venga scelta, sii coerente e importa tutti i file della stessa versione della libreria.
Qualsiasi soluzione venga scelta, sii coerente e importa tutti i file della stessa versione della libreria.
Mescolare file provenienti da fonti diverse può causare l'inclusione di codice duplicato o addirittura rompere l'applicazione in modo imprevisto.
</p>

Expand Down Expand Up @@ -95,15 +95,15 @@ <h2>Installazione da CDN o hosting statico</h2>
<h2>Esempi</h2>

<p>
Il core di three.js è incentrato sui componenti più importanti di un engine 3D. Molti altri componenti utili - come i controls, i loaders e gli effetti post-processing - sono parte della sottocartella [link:https://github.com/mrdoob/three.js/tree/dev/examples/jsm examples/jsm]. Vengono definiti "esempi" perché, pur potendo essere utilizzati in modo immediato, sono anche destinati a essere remixati e personalizzati. Questi componenti vengono sempre mantenuti sincronizzati con la libreria principale, mentre i pacchetti di terze parti su npm sono gestiti da persone differenti e potrebbero non essere aggiornati.
Il core di three.js è incentrato sui componenti più importanti di un engine 3D. Molti altri componenti utili - come i controls, i loaders e gli effetti post-processing - sono parte della sottocartella [link:https://github.com/mrdoob/three.js/tree/dev/examples/jsm examples/jsm]. Vengono definiti "esempi" perché, pur potendo essere utilizzati in modo immediato, sono anche destinati a essere remixati e personalizzati. Questi componenti vengono sempre mantenuti sincronizzati con la libreria principale, mentre i pacchetti di terze parti su npm sono gestiti da persone differenti e potrebbero non essere aggiornati.
</p>

<p>
Non è necessario <em>installare</em> gli esempi separatamente, ma dovranno essere <em>importati</em> separatamente. Se three.js è stato installato con npm, è possibile caricare il componente [page:OrbitControls] con:
</p>

<code>
import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
import { OrbitControls } from 'three/addons/controls/OrbitControls.js';

const controls = new OrbitControls( camera, renderer.domElement );
</code>
Expand Down Expand Up @@ -137,7 +137,7 @@ <h3>Import CommonJS</h3>
<h3>Node.js</h3>

<p>
Poiché three.js è stato creato per il web, dipende dal browser e dalle API del DOM che non sempre esistono in Node.js. Alcuni di questi problemi possono essere risolti usando dei "tappa buchi" come [link:https://github.com/stackgl/headless-gl headless-gl], o sostituendo i componenti come [page:TextureLoader] con alternative personalizzate. Altre API del DOM potrebbero essere profondamente intrecciate con il codice che le utilizza e potrebbe essere più difficile aggirarle. Accettiamo benvolentieri le pull request semplici e gestibili per migliorare il supporto di Node.js, ma raccomandiamo di aprire prima una issue per discutere dei tuoi miglioramenti.
Poiché three.js è stato creato per il web, dipende dal browser e dalle API del DOM che non sempre esistono in Node.js. Alcuni di questi problemi possono essere risolti usando dei "tappa buchi" come [link:https://github.com/stackgl/headless-gl headless-gl], o sostituendo i componenti come [page:TextureLoader] con alternative personalizzate. Altre API del DOM potrebbero essere profondamente intrecciate con il codice che le utilizza e potrebbe essere più difficile aggirarle. Accettiamo benvolentieri le pull request semplici e gestibili per migliorare il supporto di Node.js, ma raccomandiamo di aprire prima una issue per discutere dei tuoi miglioramenti.
</p>

<p>
Expand Down
Loading