# 已被弃用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]