From c898d5f00ffeba54950e73b218c6ac18db2c1d05 Mon Sep 17 00:00:00 2001
From: Mugen87
Date: Wed, 26 Feb 2020 21:06:50 +0100
Subject: [PATCH] Examples: Deprecate examples/js.
---
docs/manual/en/introduction/Import-via-modules.html | 9 +++++++--
docs/manual/en/introduction/Loading-3D-models.html | 11 +----------
docs/manual/zh/introduction/Import-via-modules.html | 13 +++++++++----
docs/manual/zh/introduction/Loading-3D-models.html | 11 ++---------
examples/js/WebGL.js | 1 +
examples/js/animation/AnimationClipCreator.js | 1 +
examples/js/animation/CCDIKSolver.js | 1 +
examples/js/animation/MMDAnimationHelper.js | 1 +
examples/js/animation/MMDPhysics.js | 1 +
examples/js/animation/TimelinerController.js | 1 +
examples/js/cameras/CinematicCamera.js | 1 +
examples/js/controls/DeviceOrientationControls.js | 1 +
examples/js/controls/DragControls.js | 1 +
examples/js/controls/FirstPersonControls.js | 1 +
examples/js/controls/FlyControls.js | 1 +
examples/js/controls/OrbitControls.js | 1 +
examples/js/controls/PointerLockControls.js | 1 +
examples/js/controls/TrackballControls.js | 1 +
examples/js/controls/TransformControls.js | 1 +
examples/js/curves/CurveExtras.js | 1 +
examples/js/curves/NURBSCurve.js | 1 +
examples/js/curves/NURBSSurface.js | 1 +
examples/js/curves/NURBSUtils.js | 1 +
examples/js/effects/AnaglyphEffect.js | 1 +
examples/js/effects/AsciiEffect.js | 1 +
examples/js/effects/OutlineEffect.js | 1 +
examples/js/effects/ParallaxBarrierEffect.js | 1 +
examples/js/effects/PeppersGhostEffect.js | 1 +
examples/js/effects/StereoEffect.js | 1 +
examples/js/exporters/ColladaExporter.js | 1 +
examples/js/exporters/DRACOExporter.js | 1 +
examples/js/exporters/GLTFExporter.js | 1 +
examples/js/exporters/MMDExporter.js | 1 +
examples/js/exporters/OBJExporter.js | 1 +
examples/js/exporters/PLYExporter.js | 1 +
examples/js/exporters/STLExporter.js | 1 +
examples/js/exporters/TypedGeometryExporter.js | 1 +
examples/js/geometries/BoxLineGeometry.js | 1 +
examples/js/geometries/ConvexGeometry.js | 1 +
examples/js/geometries/DecalGeometry.js | 1 +
examples/js/geometries/LightningStrike.js | 1 +
examples/js/geometries/ParametricGeometries.js | 1 +
examples/js/geometries/TeapotBufferGeometry.js | 1 +
examples/js/interactive/SelectionBox.js | 1 +
examples/js/interactive/SelectionHelper.js | 1 +
examples/js/lights/LightProbeGenerator.js | 1 +
examples/js/lights/RectAreaLightUniformsLib.js | 1 +
examples/js/lines/Line2.js | 1 +
examples/js/lines/LineGeometry.js | 1 +
examples/js/lines/LineMaterial.js | 1 +
examples/js/lines/LineSegments2.js | 1 +
examples/js/lines/LineSegmentsGeometry.js | 1 +
examples/js/lines/Wireframe.js | 1 +
examples/js/lines/WireframeGeometry2.js | 1 +
examples/js/loaders/3MFLoader.js | 1 +
examples/js/loaders/AMFLoader.js | 1 +
examples/js/loaders/AssimpLoader.js | 1 +
examples/js/loaders/BVHLoader.js | 1 +
examples/js/loaders/BasisTextureLoader.js | 1 +
examples/js/loaders/ColladaLoader.js | 1 +
examples/js/loaders/DDSLoader.js | 1 +
examples/js/loaders/DRACOLoader.js | 1 +
examples/js/loaders/EXRLoader.js | 1 +
examples/js/loaders/FBXLoader.js | 1 +
examples/js/loaders/GCodeLoader.js | 1 +
examples/js/loaders/GLTFLoader.js | 1 +
examples/js/loaders/HDRCubeTextureLoader.js | 1 +
examples/js/loaders/KMZLoader.js | 1 +
examples/js/loaders/KTXLoader.js | 1 +
examples/js/loaders/LDrawLoader.js | 1 +
examples/js/loaders/LWOLoader.js | 1 +
examples/js/loaders/MD2Loader.js | 1 +
examples/js/loaders/MMDLoader.js | 1 +
examples/js/loaders/MTLLoader.js | 1 +
examples/js/loaders/NRRDLoader.js | 1 +
examples/js/loaders/OBJLoader.js | 1 +
examples/js/loaders/PCDLoader.js | 1 +
examples/js/loaders/PDBLoader.js | 1 +
examples/js/loaders/PLYLoader.js | 1 +
examples/js/loaders/PRWMLoader.js | 1 +
examples/js/loaders/PVRLoader.js | 1 +
examples/js/loaders/RGBELoader.js | 1 +
examples/js/loaders/STLLoader.js | 1 +
examples/js/loaders/SVGLoader.js | 1 +
examples/js/loaders/TDSLoader.js | 1 +
examples/js/loaders/TGALoader.js | 1 +
examples/js/loaders/TTFLoader.js | 1 +
examples/js/loaders/VRMLLoader.js | 1 +
examples/js/loaders/VRMLoader.js | 1 +
examples/js/loaders/VTKLoader.js | 1 +
examples/js/loaders/XLoader.js | 1 +
examples/js/math/ColorConverter.js | 1 +
examples/js/math/ConvexHull.js | 1 +
examples/js/math/ImprovedNoise.js | 1 +
examples/js/math/Lut.js | 1 +
examples/js/math/SimplexNoise.js | 1 +
examples/js/misc/ConvexObjectBreaker.js | 1 +
examples/js/misc/GPUComputationRenderer.js | 1 +
examples/js/misc/Gyroscope.js | 1 +
examples/js/misc/MD2Character.js | 1 +
examples/js/misc/MD2CharacterComplex.js | 1 +
examples/js/misc/MorphAnimMesh.js | 1 +
examples/js/misc/MorphBlendMesh.js | 1 +
examples/js/misc/Ocean.js | 1 +
examples/js/misc/RollerCoaster.js | 1 +
examples/js/misc/Volume.js | 1 +
examples/js/misc/VolumeSlice.js | 1 +
examples/js/modifiers/ExplodeModifier.js | 1 +
examples/js/modifiers/SimplifyModifier.js | 1 +
examples/js/modifiers/SubdivisionModifier.js | 1 +
examples/js/modifiers/TessellateModifier.js | 1 +
examples/js/objects/Fire.js | 1 +
examples/js/objects/Lensflare.js | 1 +
examples/js/objects/LightningStorm.js | 1 +
examples/js/objects/MarchingCubes.js | 1 +
examples/js/objects/Reflector.js | 1 +
examples/js/objects/ReflectorRTT.js | 1 +
examples/js/objects/Refractor.js | 1 +
examples/js/objects/ShadowMesh.js | 1 +
examples/js/objects/Sky.js | 1 +
examples/js/objects/Water.js | 1 +
examples/js/objects/Water2.js | 1 +
.../js/postprocessing/AdaptiveToneMappingPass.js | 1 +
examples/js/postprocessing/AfterimagePass.js | 1 +
examples/js/postprocessing/BloomPass.js | 1 +
examples/js/postprocessing/BokehPass.js | 1 +
examples/js/postprocessing/ClearPass.js | 1 +
examples/js/postprocessing/CubeTexturePass.js | 1 +
examples/js/postprocessing/DotScreenPass.js | 1 +
examples/js/postprocessing/EffectComposer.js | 1 +
examples/js/postprocessing/FilmPass.js | 1 +
examples/js/postprocessing/GlitchPass.js | 1 +
examples/js/postprocessing/HalftonePass.js | 1 +
examples/js/postprocessing/MaskPass.js | 1 +
examples/js/postprocessing/OutlinePass.js | 1 +
examples/js/postprocessing/RenderPass.js | 1 +
examples/js/postprocessing/SAOPass.js | 1 +
examples/js/postprocessing/SMAAPass.js | 1 +
examples/js/postprocessing/SSAARenderPass.js | 1 +
examples/js/postprocessing/SSAOPass.js | 1 +
examples/js/postprocessing/SavePass.js | 1 +
examples/js/postprocessing/ShaderPass.js | 1 +
examples/js/postprocessing/TAARenderPass.js | 1 +
examples/js/postprocessing/TexturePass.js | 1 +
examples/js/postprocessing/UnrealBloomPass.js | 1 +
examples/js/renderers/CSS2DRenderer.js | 1 +
examples/js/renderers/CSS3DRenderer.js | 1 +
examples/js/renderers/Projector.js | 1 +
examples/js/renderers/SVGRenderer.js | 1 +
examples/js/shaders/AfterimageShader.js | 1 +
examples/js/shaders/BasicShader.js | 1 +
examples/js/shaders/BleachBypassShader.js | 1 +
examples/js/shaders/BlendShader.js | 1 +
examples/js/shaders/BokehShader.js | 1 +
examples/js/shaders/BokehShader2.js | 1 +
examples/js/shaders/BrightnessContrastShader.js | 1 +
examples/js/shaders/ColorCorrectionShader.js | 1 +
examples/js/shaders/ColorifyShader.js | 1 +
examples/js/shaders/ConvolutionShader.js | 1 +
examples/js/shaders/CopyShader.js | 1 +
examples/js/shaders/DOFMipMapShader.js | 1 +
examples/js/shaders/DepthLimitedBlurShader.js | 1 +
examples/js/shaders/DigitalGlitch.js | 1 +
examples/js/shaders/DotScreenShader.js | 1 +
examples/js/shaders/FXAAShader.js | 1 +
examples/js/shaders/FilmShader.js | 1 +
examples/js/shaders/FocusShader.js | 1 +
examples/js/shaders/FreiChenShader.js | 1 +
examples/js/shaders/FresnelShader.js | 1 +
examples/js/shaders/GammaCorrectionShader.js | 1 +
examples/js/shaders/GodRaysShader.js | 1 +
examples/js/shaders/HalftoneShader.js | 1 +
examples/js/shaders/HorizontalBlurShader.js | 1 +
examples/js/shaders/HorizontalTiltShiftShader.js | 1 +
examples/js/shaders/HueSaturationShader.js | 1 +
examples/js/shaders/KaleidoShader.js | 1 +
examples/js/shaders/LuminosityHighPassShader.js | 1 +
examples/js/shaders/LuminosityShader.js | 1 +
examples/js/shaders/MirrorShader.js | 1 +
examples/js/shaders/NormalMapShader.js | 1 +
examples/js/shaders/OceanShaders.js | 1 +
examples/js/shaders/ParallaxShader.js | 1 +
examples/js/shaders/PixelShader.js | 1 +
examples/js/shaders/RGBShiftShader.js | 1 +
examples/js/shaders/SAOShader.js | 1 +
examples/js/shaders/SMAAShader.js | 1 +
examples/js/shaders/SSAOShader.js | 1 +
examples/js/shaders/SepiaShader.js | 1 +
examples/js/shaders/SobelOperatorShader.js | 1 +
examples/js/shaders/TechnicolorShader.js | 1 +
examples/js/shaders/ToneMapShader.js | 1 +
examples/js/shaders/ToonShader.js | 1 +
examples/js/shaders/TranslucentShader.js | 1 +
examples/js/shaders/TriangleBlurShader.js | 1 +
examples/js/shaders/UnpackDepthRGBAShader.js | 1 +
examples/js/shaders/VerticalBlurShader.js | 1 +
examples/js/shaders/VerticalTiltShiftShader.js | 1 +
examples/js/shaders/VignetteShader.js | 1 +
examples/js/shaders/VolumeShader.js | 1 +
examples/js/shaders/WaterRefractionShader.js | 1 +
examples/js/utils/BufferGeometryUtils.js | 1 +
examples/js/utils/GeometryUtils.js | 1 +
examples/js/utils/SceneUtils.js | 1 +
examples/js/utils/ShadowMapViewer.js | 1 +
examples/js/utils/SkeletonUtils.js | 1 +
examples/js/utils/TypedArrayUtils.js | 1 +
examples/js/utils/UVsDebug.js | 1 +
utils/modularize.js | 4 ++++
208 files changed, 226 insertions(+), 25 deletions(-)
diff --git a/docs/manual/en/introduction/Import-via-modules.html b/docs/manual/en/introduction/Import-via-modules.html
index ed7e07f2f6f6c5..99a90559b2d92c 100644
--- a/docs/manual/en/introduction/Import-via-modules.html
+++ b/docs/manual/en/introduction/Import-via-modules.html
@@ -66,8 +66,8 @@ Importable Examples
The core of three.js is focused on the most important components of a 3D engine. Many other components like loaders or controls are part of the
examples directory. three.js ensures that these files are kept in sync with the core but users have to import them separately if they are required
- for a project. You can find in the [link:https://github.com/mrdoob/three.js/tree/master/examples/jsm examples/jsm] directory an ES6
- module version for almost all example files. If you install three.js via npm, you can import them like so:
+ for a project. You can find them in the [link:https://github.com/mrdoob/three.js/tree/master/examples/jsm examples/jsm] directory. If you install three.js
+ via npm, import example files like so:
import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
@@ -77,5 +77,10 @@ Importable Examples
your three.js main file. For example, it's not acceptable to use *GLTFLoader* and *OrbitControls* from R96 together
with three.js R103.
+
+ As of THREE R117, the *examples/js* directory will not be available anymore. That means it's no longer possible to import examples files via
+ *require()* (CommonJS). Besides, it's no longer possible to include example files with the *script* tag into HTML files. The only way of importing
+ example files is via ES6 import statements.
+