DeprecatedList.html 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../" />
  6. <script src="list.js"></script>
  7. <script src="page.js"></script>
  8. <link type="text/css" rel="stylesheet" href="page.css" />
  9. </head>
  10. <body>
  11. <h1>Deprecated API List</h1>
  12. <div>
  13. As three.js has a rapidly evolving interface, you may come across examples that
  14. suggest the use of API elements that are no longer part of the core.<br /><br />
  15. Below is a list of such elements, along with info regarding their replacements.
  16. </div>
  17. <h2>Audio</h2>
  18. <h3>[page:Audio]</h3>
  19. <div>Audio.load has been deprecated. Use [page:AudioLoader] instead.</div>
  20. <h3>[page:AudioAnalyser]</h3>
  21. <div>AudioAnalyser.getData() has been renamed to [page:AudioAnalyser.getFrequencyData]().</div>
  22. <h3>[page:BinaryTextureLoader]</h3>
  23. <div>BinaryTextureLoader has been renamed to [page:DataTextureLoader].</div>
  24. <h2>Buffers</h2>
  25. <h3>[page:BufferAttribute]</h3>
  26. <div>BufferAttribute.length has been renamed to [page:BufferAttribute.count].</div>
  27. <div>BufferAttribute.copyIndicesArray() has been removed.</div>
  28. <h3>[page:DynamicBufferAttribute]</h3>
  29. <div>DynamicBufferAttribute has been removed. Use [page:BufferAttribute.setDynamic]( true ) instead.</div>
  30. <h3>[page:Int8Attribute]</h3>
  31. <div>Int8Attribute has been removed. Use [page:BufferAttributeTypes Int8BufferAttribute] instead.</div>
  32. <h3>[page:Uint8Attribute]</h3>
  33. <div>Uint8Attribute has been removed. Use [page:BufferAttributeTypes Uint8BufferAttribute] instead.</div>
  34. <h3>[page:Uint8ClampedAttribute]</h3>
  35. <div>Uint8ClampedAttribute has been removed. Use [page:BufferAttributeTypes Uint8ClampedBufferAttribute] instead.</div>
  36. <h3>[page:Int16Attribute]</h3>
  37. <div>Int16Attribute has been removed. Use [page:BufferAttributeTypes Int16BufferAttribute] instead.</div>
  38. <h3>[page:Uint16Attribute]</h3>
  39. <div>Uint16Attribute has been removed. Use [page:BufferAttributeTypes Uint16BufferAttribute] instead.</div>
  40. <h3>[page:Int32Attribute]</h3>
  41. <div>Int32Attribute has been removed. Use [page:BufferAttributeTypes Int32BufferAttribute] instead.</div>
  42. <h3>[page:Uint32Attribute]</h3>
  43. <div>Uint32Attribute has been removed. Use [page:BufferAttributeTypes Uint32BufferAttribute] instead.</div>
  44. <h3>[page:Float32Attribute]</h3>
  45. <div>Float32Attribute has been removed. Use [page:BufferAttributeTypes Float32BufferAttribute] instead.</div>
  46. <h3>[page:Float64Attribute]</h3>
  47. <div>Float64Attribute has been removed. Use [page:BufferAttributeTypes Float64BufferAttribute] instead.</div>
  48. <h2>Cameras</h2>
  49. <h3>[page:PerspectiveCamera]</h3>
  50. <div>
  51. PerspectiveCamera.setLens() is deprecated. Use [page:PerspectiveCamera.setFocalLength]()
  52. and [page:PerspectiveCamera.filmGauge]() for a photographic setup.
  53. </div>
  54. <h2>Constants</h2>
  55. <h3>[page:LineStrip]</h3>
  56. <h3>[page:LinePieces]</h3>
  57. <div>
  58. LinePieces mode is no longer supported for [page:Line]s. Create a [page:LineSegments] instead.
  59. </div>
  60. <h2>Core</h2>
  61. <h3>[page:EventDispatcher]</h3>
  62. <div>EventDispatcher.apply has been removed. Inherit or Object.assign the prototype to mix-in instead.</div>
  63. <h3>[page:Raycaster]</h3>
  64. <div>Raycaster.params.PointCloud has been renamed to [page:Raycaster.params.Points].</div>
  65. <h3>[page:Uniform]</h3>
  66. <div>
  67. Uniform.dynamic has been removed. Use object.onBeforeRender() instead.<br /><br />
  68. Uniform.onUpdate has been removed. Use object.onBeforeRender() instead.
  69. </div>
  70. <h2>Extras</h2>
  71. <h3>[page:ClosedSplineCurve3]</h3>
  72. <div>ClosedSplineCurve3 has been deprecated. Use [page:CatmullRomCurve3] instead.</div>
  73. <h3>[page:SplineCurve3]</h3>
  74. <div>SplineCurve3 has been deprecated. Use [page:CatmullRomCurve3] instead.</div>
  75. <h2>Geometry</h2>
  76. <div>
  77. Geometry.computeTangents() has been removed.<br /><br />
  78. Geometry.computeLineDistances() has been removed. Use [page:Line.computeLineDistances] instead.<br /><br />
  79. </div>
  80. <h3>[page:BufferGeometry]</h3>
  81. <div>
  82. BufferGeometry.addIndex has been renamed to [page:BufferGeometry.setIndex].<br /><br />
  83. BufferGeometry.addDrawCall is now [page:BufferGeometry.addGroup].<br /><br />
  84. BufferGeometry.clearDrawCalls is now [page:BufferGeometry.clearGroups].<br /><br />
  85. BufferGeometry.computeTangents has been removed.<br /><br />
  86. BufferGeometry.computeOffsets has been removed.<br /><br />
  87. BufferGeometry.drawcalls has been renamed to [page:BufferGeometry.groups].<br /><br />
  88. BufferGeometry.offsets has been renamed to [page:BufferGeometry.groups].<br /><br />
  89. </div>
  90. <h3>[page:CubeGeometry]</h3>
  91. <div>CubeGeometry has been renamed to [page:BoxGeometry].</div>
  92. <h3>[page:Geometry]</h3>
  93. <div>Geometry.computeTangents() has been removed.</div>
  94. <h3>[page:GeometryUtils]</h3>
  95. <div>
  96. GeometryUtils.merge has been moved to [page:Geometry]. Use [page:Geometry.merge]( geometry2, matrix, materialIndexOffset ) instead.<br /><br />
  97. GeometryUtils.center has been moved to [page:Geometry]. Use [page:Geometry.center]( ) instead.
  98. </div>
  99. <h3>[page:Plane]</h3>
  100. <div>
  101. Plane.isIntersectionLine() has been renamed to [page:Plane.intersectsLine]().
  102. </div>
  103. <h2>Helpers</h2>
  104. <h3>[page:BoundingBoxHelper]</h3>
  105. <div>BoundingBoxHelper has been deprecated. Use [page:BoxHelper] instead.</div>
  106. <h3>[page:EdgesHelper]</h3>
  107. <div>EdgesHelper has been removed. Use [page:EdgesGeometry] instead.</div>
  108. <h3>[page:GridHelper]</h3>
  109. <div>GridHelper.setColors() has been deprecated, pass them in the constructor instead.</div>
  110. <h3>[page:WireframeHelper WireframeHelper]</h3>
  111. <div>WireframeHelper has been removed. Use [page:WireframeGeometry] instead.</div>
  112. <h2>Lights</h2>
  113. <h3>[page:Light]</h3>
  114. <div>
  115. Light.onlyShadow has been removed.<br /><br />
  116. Light.shadowCameraLeft is now [page:Light.shadow.camera.left].<br /><br />
  117. Light.shadowCameraRight is now [page:Light.shadow.camera.right].<br /><br />
  118. Light.shadowCameraTop is now [page:Light.shadow.camera.top].<br /><br />
  119. Light.shadowCameraBottom is now [page:Light.shadow.camera.bottom].<br /><br />
  120. Light.shadowCameraNear is now [page:Light.shadow.camera.near].<br /><br />
  121. Light.shadowCameraFar is now [page:Light.shadow.camera.far].<br /><br />
  122. Light.shadowCameraVisible has been removed. Use [page:CameraHelper] ( light.shadow.camera ) instead.<br /><br />
  123. Light.shadowMapWidth is now [page:Light.shadow.mapSize.width].<br /><br />
  124. Light.shadowMapHeight is now [page:Light.shadow.mapSize.height].
  125. </div>
  126. <h2>Loaders</h2>
  127. <h3>[page:XHRLoader]</h3>
  128. <div>XHRLoader has been renamed to [page:FileLoader].</div>
  129. <h2>Maths</h2>
  130. <h3>[page:Box2]</h3>
  131. <div>
  132. Box2.center has been renamed to [page:Box2.getCenter]().<br /><br />
  133. Box2.empty has been renamed to [page:Box2.isEmpty]().<br /><br />
  134. Box2.isIntersectionBox has been renamed to [page:Box2.intersectsBox]().<br /><br />
  135. Box2.size has been renamed to [page:Box2.getSize]().
  136. </div>
  137. <h3>[page:Box3]</h3>
  138. <div>
  139. Box3.center has been renamed to [page:Box3.getCenter]().<br /><br />
  140. Box3.empty has been renamed to [page:Box3.isEmpty]().<br /><br />
  141. Box3.isIntersectionBox has been renamed to [page:Box3.intersectsBox]().<br /><br />
  142. Box3.isIntersectionSphere has been renamed to [page:Box3.intersectsSphere]().<br /><br />
  143. Box3.size has been renamed to [page:Box3.getSize]().
  144. </div>
  145. <h3>[page:Face4]</h3>
  146. <div>Face4 has been removed. Use [page:Face3] instead.</div>
  147. <h3>[page:Line3]</h3>
  148. <div>Line3.center has been renamed to [page:Line3.getCenter]().</div>
  149. <h3>[page:Math]</h3>
  150. <div>
  151. Math.random16() has been deprecated. Use Math.random() instead.
  152. </div>
  153. <h3>[page:Matrix3]</h3>
  154. <div>
  155. Matrix3.flattenToArrayOffset is deprecated. Use [page:Matrix3.toArray]() instead.<br /><br />
  156. Matrix3.multiplyVector3 has been removed. Use vector.applyMatrix3( matrix ) instead.<br /><br />
  157. Matrix3.multiplyVector3Array has been renamed to [page:Matrix3.applyToVector3Array]( array ).<br /><br />
  158. Matrix3.applyToBuffer has been removed. Use matrix.applyToBufferAttribute( attribute ) instead.<br /><br />
  159. Matrix3.applyToVector3Array has been removed.
  160. <div>
  161. <h3>[page:Matrix4]</h3>
  162. <div>
  163. Matrix4.flattenToArrayOffset() is deprecated. Use [page:Matrix4.toArray]() instead.<br /><br />
  164. Matrix4.extractPosition() has been renamed to [page:Matrix4.copyPosition]( matrix ).<br /><br />
  165. Matrix4.getPosition() has been removed. Use [page:Vector3.setFromMatrixPosition]( matrix ) instead.<br /><br />
  166. Matrix4.setRotationFromQuaternion() has been renamed to [page:Matrix4.makeRotationFromQuaternion]( quaternion ).<br /><br />
  167. Matrix4.multiplyVector3() has been removed. Use vector.applyMatrix4( matrix ) instead.<br /><br />
  168. Matrix4.multiplyVector4() has been removed. Use vector.applyMatrix4( matrix ) instead.<br /><br />
  169. Matrix4.multiplyVector3Array() has been renamed to [page:Matrix4.applyToVector3Array] ( array ).<br /><br />
  170. Matrix4.rotateAxis() has been removed. Use [page:Matrix4.transformDirection]( matrix ) instead.<br /><br />
  171. Matrix4.crossVector() has been removed. Use vector.applyMatrix4( matrix ) instead.<br /><br />
  172. Matrix4.rotateX() has been removed.<br /><br />
  173. Matrix4.rotateY() has been removed.<br /><br />
  174. Matrix4.rotateZ() has been removed.<br /><br />
  175. Matrix4.rotateByAxis() has been removed.<br /><br />
  176. Matrix4.applyToBuffer() has been removed. Use matrix.applyToBufferAttribute() instead.<br /><br />
  177. Matrix4.applyToVector3Array() has been removed.<br /><br />
  178. Matrix4.makeFrustum() has been removed. Use [page:Matrix4.makePerspective]( left, right, top, bottom, near, far ) instead.
  179. </div>
  180. <h3>[page:Quaternion.multiplyVector3]</h3>
  181. <div>Quaternion.multiplyVector3() has been removed. Use vector.applyQuaternion( quaternion ) instead.</div>
  182. <h3>[page:Ray]</h3>
  183. <div>
  184. Ray.isIntersectionBox() has been renamed to [page:Ray.intersectsBox]().<br /><br />
  185. Ray.isIntersectionPlane has been renamed to [page:Ray.intersectsPlane].<br /><br />
  186. Ray.isIntersectionSphere has been renamed to [page:Ray.intersectsSphere].
  187. </div>
  188. <h3>[page:Vector2]</h3>
  189. <div>
  190. Vector2.fromAttribute() has been renamed to [page:Vector2.fromBufferAttribute]().
  191. </div>
  192. <h3>[page:Vector3]</h3>
  193. <div>
  194. Vector3.setEulerFromRotationMatrix() has been removed. Use [page:Euler.setFromRotationMatrix]() instead.<br /><br />
  195. Vector3.setEulerFromQuaternion() has been removed. Use [page:Euler.setFromQuaternion]() instead.<br /><br />
  196. Vector3.getPositionFromMatrix() has been renamed to [page:Vector3.setFromMatrixPosition]().<br /><br />
  197. Vector3.getScaleFromMatrix() has been renamed to [page:Vector3.setFromMatrixScale]().<br /><br />
  198. Vector3.getColumnFromMatrix() has been renamed to [page:Vector3.setFromMatrixColumn]().<br /><br />
  199. Vector3.applyProjection() has been removed. Use [page:Vector3.applyMatrix4]() instead.<br /><br />
  200. Vector3.fromAttribute() has been renamed to [page:Vector3.fromBufferAttribute]().
  201. </div>
  202. <h3>[page:Vector4]</h3>
  203. <div>
  204. Vector4.fromAttribute() has been renamed to [page:Vector4.fromBufferAttribute]().
  205. </div>
  206. <h3>[page:Vertex]</h3>
  207. <div>Vertex has been removed. Use [page:Vector3] instead.</div>
  208. <h3>[page:Spline]</h3>
  209. <div>Spline has been removed. Use [page:CatmullRomCurve3] instead.</div>
  210. <h2>Materials</h2>
  211. <h3>[page:Material]</h3>
  212. <div>
  213. Material.wrapAround has been removed.<br /><br />
  214. Material.wrapRGB has been removed.
  215. </div>
  216. <h3>[page:MeshFaceMaterial]</h3>
  217. <div>MeshFaceMaterial has been removed. Use an array of materials instead.</div>
  218. <h3>[page:MultiMaterial]</h3>
  219. <div>MultiMaterial has been removed. Use an array of materials instead.</div>
  220. <h3>[page:MeshPhongMaterial]</h3>
  221. <div>MeshPhongMaterial.metal has been removed. Use [page:MeshStandardMaterial] instead.</div>
  222. <h3>[page:ParticleBasicMaterial]</h3>
  223. <div>ParticleBasicMaterial has been renamed to [page:PointsMaterial].</div>
  224. <h3>[page:ParticleSystemMaterial]</h3>
  225. <div>ParticleBasicMaterial has been renamed to [page:PointsMaterial].</div>
  226. <h3>[page:PointCloudMaterial]</h3>
  227. <div>PointCloudMaterial has been renamed to [page:PointsMaterial].</div>
  228. <h3>[page:ShaderMaterial.derivatives]</h3>
  229. <div>ShaderMaterial.derivatives has been moved to [page:ShaderMaterial.extensions.derivatives].</div>
  230. <h2>Objects</h2>
  231. <h3>[page:LOD.objects]</h3>
  232. <div>LOD.objects has been renamed to [page:LOD.levels].</div>
  233. <h3>[page:Object3D]</h3>
  234. <div>
  235. Object3D.eulerOrder is now [page:Object3D.rotation.order].<br /><br />
  236. Object3D.getChildByName() has been renamed to [page:Object3D.getObjectByName]().<br /><br />
  237. Object3D.renderDepth has been removed. Use [page:Object3D.renderOrder] instead.<br /><br />
  238. Object3D.translate() has been removed. Use [page:Object3D.translateOnAxis]( axis, distance ) instead.<br /><br />
  239. Object3D.useQuaternion has been removed. The library now uses quaternions by default.
  240. </div>
  241. <h3>[page:LensFlare]</h3>
  242. <div>
  243. LensFlare has been moved to [link:https://github.com/mrdoob/three.js/blob/master/examples/js/objects/Lensflare.js /examples/js/objects/Lensflare.js].
  244. </div>
  245. <h3>[page:Particle]</h3>
  246. <div>Particle has been renamed to [page:Sprite].</div>
  247. <h3>[page:ParticleSystem]</h3>
  248. <div>ParticleSystem has been renamed to [page:Points].</div>
  249. <h3>[page:PointCloud]</h3>
  250. <div>PointCloud has been renamed to [page:Points].</div>
  251. <h3>[page:Shape]</h3>
  252. <div>
  253. Shape.extrude has been removed. Use [page:ExtrudeGeometry] instead.<br /><br />
  254. Shape.makeGeometry has been removed. Use [page:ShapeGeometry] instead.
  255. </div>
  256. <h2>Renderer</h2>
  257. <h3>[page:Projector]</h3>
  258. <div>
  259. CanvasRenderer has been moved to [link:https://github.com/mrdoob/three.js/blob/master/examples/js/renderers/CanvasRenderer.js /examples/js/renderers/CanvasRenderer.js].
  260. </div>
  261. <h3>[page:Projector]</h3>
  262. <div>
  263. Projector has been moved to
  264. [link:https://github.com/mrdoob/three.js/blob/master/examples/js/renderers/Projector.js /examples/js/renderers/Projector.js].<br /><br />
  265. Projector.projectVector() is now [page:Vector.project]().<br /><br />
  266. Projector.unprojectVector() is now [page:Vector.unproject]().<br /><br />
  267. Projector:.pickingRay() is now [page:Raycaster.setFromCamera]().
  268. </div>
  269. <h3>[page:WebGLProgram]</h3>
  270. <div>
  271. WebGLProgram.uniforms is now [page: WebGLProgram.getUniforms]().<br /><br />
  272. WebGLProgram.attributes is now [page: WebGLProgram.getAttributes]().
  273. </div>
  274. <h3>[page:WebGLRenderer]</h3>
  275. <div>
  276. WebGLRenderer.supportsFloatTextures() is now [page:WebGLRenderer.extensions.get]( 'OES_texture_float' ).<br /><br />
  277. WebGLRenderer.supportsHalfFloatTextures() is now [page:WebGLRenderer.extensions.get]( 'OES_texture_half_float' ).<br /><br />
  278. WebGLRenderer.supportsStandardDerivatives() is now [page:WebGLRenderer.extensions.get]( 'OES_standard_derivatives' ).<br /><br />
  279. WebGLRenderer.supportsCompressedTextureS3TC() is now [page:WebGLRenderer.extensions.get]( 'WEBGL_compressed_texture_s3tc' ).<br /><br />
  280. WebGLRenderer.supportsCompressedTexturePVRTC() is now [page:WebGLRenderer.extensions.get]( 'WEBGL_compressed_texture_pvrtc' ).<br /><br />
  281. WebGLRenderer.supportsBlendMinMax() is now [page:WebGLRenderer.extensions.get]( 'EXT_blend_minmax' ).<br /><br />
  282. WebGLRenderer.supportsVertexTextures() is now [page:WebGLRenderer.capabilities.vertexTextures].<br /><br />
  283. WebGLRenderer.supportsInstancedArrays() is now [page:WebGLRenderer.extensions.get]( 'ANGLE_instanced_arrays' ).<br /><br />
  284. WebGLRenderer.enableScissorTest() is now [page:WebGLRenderer.setScissorTest]().<br /><br />
  285. WebGLRenderer.initMaterial() has been removed.<br /><br />
  286. WebGLRenderer.addPrePlugin() has been removed.<br /><br />
  287. WebGLRenderer.addPostPlugin() has been removed.<br /><br />
  288. WebGLRenderer.updateShadowMap() has been removed.<br /><br />
  289. WebGLRenderer.setFaceCulling() has been removed.<br /><br />
  290. WebGLRenderer.setTexture is deprecated, use [page:WebGLRenderer.setTexture2D]() instead.<br /><br />
  291. WebGLRenderer.shadowMapEnabled is now [page:WebGLRenderer.shadowMap.enabled].<br /><br />
  292. WebGLRenderer.shadowMapType is now [page:WebGLRenderer.shadowMap.type].<br /><br />
  293. WebGLRenderer.shadowMapCullFace has been removed. Set [page:Material.shadowSide] instead.<br /><br />
  294. WebGLRenderer.shadowMap.cullFace has been removed. Set [page:Material.shadowSide] instead.<br /><br />
  295. WebGLRenderer.shadowMap.renderReverseSided has been removed. Set [page:Material.shadowSide] instead.<br /><br />
  296. WebGLRenderer.shadowMap.renderSingleSided has been removed. Set [page:Material.shadowSide] instead.
  297. </div>
  298. <h3>[page:WebGLRenderTarget]</h3>
  299. <div>
  300. WebGLRenderTarget.wrapS is now [page:WebGLRenderTarget.texture.wrapS].<br /><br />
  301. WebGLRenderTarget.wrapT is now [page:WebGLRenderTarget.texture.wrapT].<br /><br />
  302. WebGLRenderTarget.magFilter is now [page:WebGLRenderTarget.texture.magFilter].<br /><br />
  303. WebGLRenderTarget.minFilter is now [page:WebGLRenderTarget.texture.minFilter].<br /><br />
  304. WebGLRenderTarget.anisotropy is now [page:WebGLRenderTarget.texture.anisotropy].<br /><br />
  305. WebGLRenderTarget.offset is now [page:WebGLRenderTarget.texture.offset].<br /><br />
  306. WebGLRenderTarget.repeat is now [page:WebGLRenderTarget.texture.repeat].<br /><br />
  307. WebGLRenderTarget.format is now [page:WebGLRenderTarget.texture.format].<br /><br />
  308. WebGLRenderTarget.type is now [page:WebGLRenderTarget.texture.type].<br /><br />
  309. WebGLRenderTarget.generateMipmaps is now [page:WebGLRenderTarget.texture.generateMipmaps].
  310. </div>
  311. <h2>Textures</h2>
  312. <h3>[page:ImageUtils]</h3>
  313. <div>
  314. ImageUtils.loadTexture has been deprecated. Use [page:TextureLoader] instead.<br /><br />
  315. ImageUtils.loadTextureCube has been deprecated. Use [page:CubeTextureLoader] instead.<br /><br />
  316. ImageUtils.loadCompressedTexture has been removed. Use [page:DDSLoader] instead.<br /><br />
  317. ImageUtils.loadCompressedTextureCube has been removed. Use [page:DDSLoader] instead.
  318. </div>
  319. <h2>Source</h2>
  320. [link:https://github.com/mrdoob/three.js/blob/master/src/Three.Legacy.js src/Three.Legacy.js]
  321. </body>
  322. </html>