已被弃用API列表（Deprecated API List）

由于three.js具有一个快速发展的接口，你可能会遇上类似“提示你当前所调用的API元素不再是Three.js核心的一部分”的提示。

下面就列举出了这些API元素，以及一些关于他们的替代信息。

音频（Audio）

[page:Audio]

Audio.load 已被弃用。 请使用 [page:AudioLoader]。

[page:AudioAnalyser]

AudioAnalyser.getData() 已被重命名为 [page:AudioAnalyser.getFrequencyData]()。

[page:BinaryTextureLoader]

BinaryTextureLoader 已被重命名为 [page:DataTextureLoader]。

缓冲器（Buffers）

[page:BufferAttribute]

BufferAttribute.length 已被重命名为 [page:BufferAttribute.count]。

BufferAttribute.copyIndicesArray() 已被删除。

[page:DynamicBufferAttribute]

DynamicBufferAttribute 已被删除。 请使用[page:BufferAttribute.setDynamic]( true )。

[page:Int8Attribute]

Int8Attribute 已被删除。 请使用[page:BufferAttributeTypes Int8BufferAttribute]。

[page:Uint8Attribute]

Uint8Attribute 已被删除。 请使用[page:BufferAttributeTypes Uint8BufferAttribute]。

[page:Uint8ClampedAttribute]

Uint8ClampedAttribute 已被删除。 请使用[page:BufferAttributeTypes Uint8ClampedBufferAttribute]。

[page:Int16Attribute]

Int16Attribute 已被删除。 请使用[page:BufferAttributeTypes Int16BufferAttribute]。

[page:Uint16Attribute]

Uint16Attribute 已被删除。 请使用[page:BufferAttributeTypes Uint16BufferAttribute]。

[page:Int32Attribute]

Int32Attribute 已被删除。 请使用[page:BufferAttributeTypes Int32BufferAttribute]。

[page:Uint32Attribute]

Uint32Attribute 已被删除。 请使用[page:BufferAttributeTypes Uint32BufferAttribute]。

[page:Float32Attribute]

Float32Attribute 已被删除。 请使用[page:BufferAttributeTypes Float32BufferAttribute]。

[page:Float64Attribute]

Float64Attribute 已被删除。 请使用[page:BufferAttributeTypes Float64BufferAttribute]。

摄像机（Cameras）

[page:PerspectiveCamera]

PerspectiveCamera.setLens() 已被弃用。 请使用[page:PerspectiveCamera.setFocalLength]() 和 [page:PerspectiveCamera.filmGauge]() 来对摄像机拍摄进行设置。

常量（Constants）

[page:LineStrip]

[page:LinePieces]

LinePieces mode 已经不再对 [page:Line]s 进行支持。 请创建一个 [page:LineSegments] 。

核心（Core）

[page:EventDispatcher]

EventDispatcher.apply 已被删除。 请继承或者Object.assign其原型来“混合”。Inherit or Object.assign the prototype to mix-in。

[page:Raycaster]

Raycaster.params.PointCloud 已被重命名为 [page:Raycaster.params.Points]。

[page:Uniform]

Uniform.dynamic 已被删除。 请使用object.onBeforeRender()。

Uniform.onUpdate 已被删除。 请使用object.onBeforeRender() 。

附件（Extras）

[page:ClosedSplineCurve3]

ClosedSplineCurve3 已被弃用。 请使用[page:CatmullRomCurve3]。

[page:SplineCurve3]

SplineCurve3 已被弃用。 请使用[page:CatmullRomCurve3]。

几何体（Geometry）

Geometry.computeTangents() 已被删除。

Geometry.computeLineDistances() 已被删除。 请使用[page:Line.computeLineDistances]。

[page:BufferGeometry]

BufferGeometry.addIndex 已被重命名为 [page:BufferGeometry.setIndex]。

BufferGeometry.addDrawCall 现在是 [page:BufferGeometry.addGroup]。

BufferGeometry.clearDrawCalls 现在是 [page:BufferGeometry.clearGroups]。

BufferGeometry.computeTangents 已被删除。

BufferGeometry.computeOffsets 已被删除。

BufferGeometry.drawcalls 已被重命名为 [page:BufferGeometry.groups]。

BufferGeometry.offsets 已被重命名为 [page:BufferGeometry.groups]。

[page:CubeGeometry]

CubeGeometry 已被重命名为 [page:BoxGeometry]。

[page:Geometry]

Geometry.computeTangents() 已被删除。

[page:GeometryUtils]

GeometryUtils.merge 已被移动到了 [page:Geometry]，请使用[page:Geometry.merge]( geometry2, matrix, materialIndexOffset )。

GeometryUtils.center 已被移动到了 [page:Geometry]，请使用[page:Geometry.center]( ) 。

[page:Plane]

Plane.isIntersectionLine() 已被重命名为 [page:Plane.intersectsLine]()。

辅助工具（Helpers）

[page:BoundingBoxHelper]

BoundingBoxHelper 已被弃用。 请使用[page:BoxHelper]。

[page:EdgesHelper]

EdgesHelper 已被删除。 请使用[page:EdgesGeometry]。

[page:GridHelper]

GridHelper.setColors() 已被弃用，请在构造器中传递它们。

[page:WireframeHelper WireframeHelper]

WireframeHelper 已被删除。 请使用[page:WireframeGeometry]。

灯光（Lights）

[page:Light]

Light.onlyShadow 已被删除。

Light.shadowCameraLeft 现在是 [page:Light.shadow.camera.left]。

Light.shadowCameraRight 现在是 [page:Light.shadow.camera.right]。

Light.shadowCameraTop 现在是 [page:Light.shadow.camera.top]。

Light.shadowCameraBottom 现在是 [page:Light.shadow.camera.bottom]。

Light.shadowCameraNear 现在是 [page:Light.shadow.camera.near]。

Light.shadowCameraFar 现在是 [page:Light.shadow.camera.far]。

Light.shadowCameraVisible 已被删除。 请使用[page:CameraHelper] ( light.shadow.camera )。

Light.shadowMapWidth 现在是 [page:Light.shadow.mapSize.width]。

Light.shadowMapHeight 现在是 [page:Light.shadow.mapSize.height]。

加载器（Loaders）

[page:XHRLoader]

XHRLoader 已被重命名为 [page:FileLoader]。

[page:JSONLoader]

JSONLoader has been removed from core.

数学（Maths）

[page:Box2]

Box2.center 已被重命名为 [page:Box2.getCenter]()。

Box2.empty 已被重命名为 [page:Box2.isEmpty]()。

Box2.isIntersectionBox 已被重命名为 [page:Box2.intersectsBox]()。

Box2.size 已被重命名为 [page:Box2.getSize]()。

[page:Box3]

Box3.center 已被重命名为 [page:Box3.getCenter]()。

Box3.empty 已被重命名为 [page:Box3.isEmpty]()。

Box3.isIntersectionBox 已被重命名为 [page:Box3.intersectsBox]()。

Box3.isIntersectionSphere 已被重命名为 [page:Box3.intersectsSphere]()。

Box3.size 已被重命名为 [page:Box3.getSize]()。

[page:Face4]

Face4 已被删除。 请使用[page:Face3]。

[page:Line3]

Line3.center 已被重命名为 [page:Line3.getCenter]()。

[page:Math]

Math.random16() 已被弃用。 请使用Math.random() 。

[page:Matrix3]

Matrix3.flattenToArrayOffset 已被弃用。请使用[page:Matrix3.toArray]()。

Matrix3.multiplyVector3 已被删除。 请使用vector.applyMatrix3( matrix )。

Matrix3.multiplyVector3Array 已被重命名为 [page:Matrix3.applyToVector3Array]( array )。

Matrix3.applyToBuffer 已被删除。 请使用matrix.applyToBufferAttribute( attribute )。

Matrix3.applyToVector3Array 已被删除。

[page:Matrix4]

Matrix4.flattenToArrayOffset() 已被弃用。请使用[page:Matrix4.toArray]()。

Matrix4.extractPosition() 已被重命名为 [page:Matrix4.copyPosition]( matrix )。

Matrix4.getPosition() 已被删除。 请使用[page:Vector3.setFromMatrixPosition]( matrix )。

Matrix4.setRotationFromQuaternion() 已被重命名为 [page:Matrix4.makeRotationFromQuaternion]( quaternion )。

Matrix4.multiplyVector3() 已被删除。 请使用vector.applyMatrix4( matrix )。

Matrix4.multiplyVector4() 已被删除。 请使用vector.applyMatrix4( matrix )。

Matrix4.multiplyVector3Array() 已被重命名为 [page:Matrix4.applyToVector3Array] ( array )。

Matrix4.rotateAxis() 已被删除。 请使用[page:Matrix4.transformDirection]( matrix )。

Matrix4.crossVector() 已被删除。 请使用vector.applyMatrix4( matrix )。

Matrix4.rotateX() 已被删除。

Matrix4.rotateY() 已被删除。

Matrix4.rotateZ() 已被删除。

Matrix4.rotateByAxis() 已被删除。

Matrix4.applyToBuffer() 已被删除。 请使用matrix.applyToBufferAttribute()。

Matrix4.applyToVector3Array() 已被删除。

Matrix4.makeFrustum() 已被删除。 请使用[page:Matrix4.makePerspective]( left, right, top, bottom, near, far ) 。

[page:Quaternion.multiplyVector3]

Quaternion.multiplyVector3() 已被删除。 请使用vector.applyQuaternion( quaternion )。

[page:Ray]

Ray.isIntersectionBox() 已被重命名为 [page:Ray.intersectsBox]()。

Ray.isIntersectionPlane 已被重命名为 [page:Ray.intersectsPlane]。

Ray.isIntersectionSphere 已被重命名为 [page:Ray.intersectsSphere]。

[page:Triangle]

Triangle.area() 已被重命名为 [page:Triangle.getArea]()。

Triangle.barycoordFromPoint() 已被重命名为 [page:Triangle.getBarycoord]()。

Triangle.midpoint() 已被重命名为 [page:Triangle.getMidpoint]()。

Triangle.normal() 已被重命名为 [page:Triangle.getNormal]()。

Triangle.plane() 已被重命名为 [page:Triangle.getPlane]()。

[page:Vector2]

Vector2.fromAttribute() 已被重命名为 [page:Vector2.fromBufferAttribute]()。

[page:Vector3]

Vector3.setEulerFromRotationMatrix() 已被删除。 请使用[page:Euler.setFromRotationMatrix]()。

Vector3.setEulerFromQuaternion() 已被删除。 请使用[page:Euler.setFromQuaternion]()。

Vector3.getPositionFromMatrix() 已被重命名为 [page:Vector3.setFromMatrixPosition]()。

Vector3.getScaleFromMatrix() 已被重命名为 [page:Vector3.setFromMatrixScale]()。

Vector3.getColumnFromMatrix() 已被重命名为 [page:Vector3.setFromMatrixColumn]()。

Vector3.applyProjection() 已被删除。 请使用[page:Vector3.applyMatrix4]()。

Vector3.fromAttribute() 已被重命名为 [page:Vector3.fromBufferAttribute]()。

[page:Vector4]

Vector4.fromAttribute() 已被重命名为 [page:Vector4.fromBufferAttribute]().

[page:Vertex]

Vertex 已被删除。 请使用[page:Vector3]。

[page:Spline]

Spline 已被删除。 请使用[page:CatmullRomCurve3]。

材质（Materials）

[page:Material]

Material.wrapAround 已被删除。

Material.wrapRGB 已被删除。

[page:MeshFaceMaterial]

MeshFaceMaterial 已被删除。 请使用一个材质数组。

[page:MultiMaterial]

MultiMaterial 已被删除。 请使用一个材质数组。

[page:MeshPhongMaterial]

MeshPhongMaterial.metal 已被删除。 请使用[page:MeshStandardMaterial]。

[page:ParticleBasicMaterial]

ParticleBasicMaterial 已被重命名为 [page:PointsMaterial]。

[page:ParticleSystemMaterial]

ParticleBasicMaterial 已被重命名为 [page:PointsMaterial]。

[page:PointCloudMaterial]

PointCloudMaterial 已被重命名为 [page:PointsMaterial]。

[page:ShaderMaterial.derivatives]

ShaderMaterial.derivatives 已被移动到了 [page:ShaderMaterial.extensions.derivatives]。

物体（Objects）

[page:LOD.objects]

LOD.objects 已被重命名为 [page:LOD.levels]。

[page:Object3D]

Object3D.eulerOrder 现在是 [page:Object3D.rotation.order]。

Object3D.getChildByName() 已被重命名为 [page:Object3D.getObjectByName]()。

Object3D.renderDepth 已被删除。 请使用[page:Object3D.renderOrder]。

Object3D.translate() 已被删除。 请使用[page:Object3D.translateOnAxis]( axis, distance )。

Object3D.useQuaternion 已被删除。 默认情况下，Three.js库是使用quaternions（四元数）的。

[page:LensFlare]

LensFlare 已被移动到了 [link:https://github.com/mrdoob/three.js/blob/master/examples/js/objects/Lensflare.js /examples/js/objects/Lensflare.js].

[page:Particle]

Particle 已被重命名为 [page:Sprite]。

[page:ParticleSystem]

ParticleSystem 已被重命名为 [page:Points]。

[page:PointCloud]

PointCloud 已被重命名为 [page:Points]。

[page:Shape]

Shape.extrude 已被删除。 请使用[page:ExtrudeGeometry]。

Shape.makeGeometry 已被删除。 请使用[page:ShapeGeometry] 。

[page:SkinnedMesh]

SkinnedMesh.initBones() has been removed.

渲染器（Renderer）

[page:Projector]

CanvasRenderer 已被移动到了 [link:https://github.com/mrdoob/three.js/blob/master/examples/js/renderers/CanvasRenderer.js /examples/js/renderers/CanvasRenderer.js].

[page:Projector]

Projector 已被移动到了 [link:https://github.com/mrdoob/three.js/blob/master/examples/js/renderers/Projector.js /examples/js/renderers/Projector.js]。

Projector.projectVector() 现在是 [page:Vector.project]()。

Projector.unprojectVector() 现在是 [page:Vector.unproject]()。

Projector:.pickingRay() 现在是 [page:Raycaster.setFromCamera]()。

[page:WebGLProgram]

WebGLProgram.uniforms 现在是 [page:WebGLProgram.getUniforms]()。

WebGLProgram.attributes 现在是 [page:WebGLProgram.getAttributes]()。

[page:WebGLRenderer]

WebGLRenderer.supportsFloatTextures() 现在是 [page:WebGLRenderer.extensions.get]( 'OES_texture_float' )。

WebGLRenderer.supportsHalfFloatTextures() 现在是 [page:WebGLRenderer.extensions.get]( 'OES_texture_half_float' )。

WebGLRenderer.supportsStandardDerivatives() 现在是 [page:WebGLRenderer.extensions.get]( 'OES_standard_derivatives' )。

WebGLRenderer.supportsCompressedTextureS3TC() 现在是 [page:WebGLRenderer.extensions.get]( 'WEBGL_compressed_texture_s3tc' )。

WebGLRenderer.supportsCompressedTexturePVRTC() 现在是 [page:WebGLRenderer.extensions.get]( 'WEBGL_compressed_texture_pvrtc' )。

WebGLRenderer.supportsBlendMinMax() 现在是 [page:WebGLRenderer.extensions.get]( 'EXT_blend_minmax' )。

WebGLRenderer.supportsVertexTextures() 现在是 [page:WebGLRenderer.capabilities.vertexTextures]。

WebGLRenderer.supportsInstancedArrays() 现在是 [page:WebGLRenderer.extensions.get]( 'ANGLE_instanced_arrays' )。

WebGLRenderer.enableScissorTest() 现在是 [page:WebGLRenderer.setScissorTest]()。

WebGLRenderer.initMaterial() 已被删除。

WebGLRenderer.addPrePlugin() 已被删除。

WebGLRenderer.addPostPlugin() 已被删除。

WebGLRenderer.updateShadowMap() 已被删除。

WebGLRenderer.setFaceCulling() 已被删除。

WebGLRenderer.setTexture is deprecated, 请使用[page:WebGLRenderer.setTexture2D]()。

WebGLRenderer.shadowMapEnabled 现在是 [page:WebGLRenderer.shadowMap.enabled]。

WebGLRenderer.shadowMapType 现在是 [page:WebGLRenderer.shadowMap.type]。

WebGLRenderer.shadowMapCullFace 已被删除。请设置[page:Material.shadowSide]。

WebGLRenderer.shadowMap.cullFace 已被删除。请设置[page:Material.shadowSide]。

WebGLRenderer.shadowMap.renderReverseSided 已被删除。请设置[page:Material.shadowSide]。

WebGLRenderer.shadowMap.renderSingleSided 已被删除。请设置[page:Material.shadowSide]。

[page:WebGLRenderTarget]

WebGLRenderTarget.wrapS 现在是 [page:WebGLRenderTarget.texture.wrapS]。

WebGLRenderTarget.wrapT 现在是 [page:WebGLRenderTarget.texture.wrapT]。

WebGLRenderTarget.magFilter 现在是 [page:WebGLRenderTarget.texture.magFilter]。

WebGLRenderTarget.minFilter 现在是 [page:WebGLRenderTarget.texture.minFilter]。

WebGLRenderTarget.anisotropy 现在是 [page:WebGLRenderTarget.texture.anisotropy]。

WebGLRenderTarget.offset 现在是 [page:WebGLRenderTarget.texture.offset]。

WebGLRenderTarget.repeat 现在是 [page:WebGLRenderTarget.texture.repeat]。

WebGLRenderTarget.format 现在是 [page:WebGLRenderTarget.texture.format]。

WebGLRenderTarget.type 现在是 [page:WebGLRenderTarget.texture.type]。

WebGLRenderTarget.generateMipmaps 现在是 [page:WebGLRenderTarget.texture.generateMipmaps].

纹理（Textures）

[page:ImageUtils]

ImageUtils.loadTexture 已被弃用。 请使用[page:TextureLoader]。

ImageUtils.loadTextureCube 已被弃用。 请使用[page:CubeTextureLoader]。

ImageUtils.loadCompressedTexture 已被删除。 请使用[page:DDSLoader]。

ImageUtils.loadCompressedTextureCube 已被删除。 请使用[page:DDSLoader] 。

源代码

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