[page:Texture] →

# 深度纹理（[name]）

创建一个作为深度纹理贴图来使用的纹理。需要支持[link:https://www.khronos.org/registry/webgl/extensions/WEBGL_depth_texture/ WEBGL_depth_texture]扩展。

## 示例

[example:webgl_depth_texture depth / texture]

## 构造函数

### [name]( [param:Number width], [param:Number height], [param:Constant type], [param:Constant wrapS], [param:Constant wrapT], [param:Constant magFilter], [param:Constant minFilter], [param:Number anisotropy], [param:Constant format] )

[page:Number width] -- 纹理的宽度。
[page:Number height] -- 纹理的高度。
[page:Constant type] -- 默认值是[page:Textures THREE.UnsignedShortType]。 请参阅[page:Textures type constants]（类型常量）来了解其他选项。
[page:Constant mapping] -- 请参阅[page:Textures mapping constants]（映射模式常量）来了解其他选项。
[page:Constant wrapS] -- 默认值是[page:Textures THREE.ClampToEdgeWrapping]. 请参阅[page:Textures wrap mode constants]（包裹模式常量）来了解其他选项。
[page:Constant wrapT] -- 默认值是[page:Textures THREE.ClampToEdgeWrapping]. 请参阅[page:Textures wrap mode constants]（包裹模式常量）来了解其他选项。
[page:Constant magFilter] -- 当一个纹素覆盖大于一个像素时，贴图将如何采样。 其默认值为[page:Textures THREE.LinearFilter]。请参阅[page:Textures magnification filter constants]（放大滤镜常量）来了解其它选项。
[page:Constant minFilter] -- 当一个纹素覆盖小于一个像素时，贴图将如何采样。 其默认值为[page:Textures THREE.LinearMipMapLinearFilter]。请参阅[page:Textures minification filter constants]（缩小滤镜常量）来了解其它选项。
[page:Number anisotropy] -- 沿着轴，通过具有最高纹素密度的像素的样本数。 默认情况下，这个值为1。设置一个较高的值将会产生比基本的mipmap更清晰的效果，代价是需要使用更多纹理样本。 使用[page:WebGLrenderer.getMaxAnisotropy renderer.getMaxAnisotropy]() 来查询GPU中各向异性的最大有效值；这个值通常是2的幂。
[page:Constant format] -- 这个值必须是[page:Textures DepthFormat]（默认值）或者[page:Textures DepthStencilFormat]。 请参阅[page:Textures format constants]（格式常量）来了解详细信息。

## 属性

共有属性请参见其基类[page:Texture Texture]。 —— 以下属性也是texture类中的一部分，但在这里默认值不同。

### [page:Texture.format .format]

[page:Textures DepthFormat]（默认值）或者[page:Textures DepthStencilFormat]中的一个。 请参阅[page:Textures format constants]来了解详细信息。

### [page:Texture.type .type]

默认值是[page:Textures THREE.UnsignedShortType]。 请参阅[page:Textures format constants]来了解详细信息。

### [page:Texture.magFilter .magFilter]

当一个纹素覆盖大于一个像素时，贴图将如何采样。 其默认值为[page:Textures THREE.NearestFilter]。 请参阅[page:Textures magnification filter constants]（放大滤镜常量）来了解其他选项。

### [page:Texture.minFilter .minFilter]

当一个纹素覆盖小于一个像素时，贴图将如何采样。 其默认值为[page:Textures THREE.NearestFilter]。 请参阅[page:Textures minification filter constants]（缩小滤镜常量）来了解其他选项。

### [page:Texture.flipY .flipY]

深度贴图不需要被翻转，因此其默认值为*false*。

### [page:Texture.generateMipmaps .generateMipmaps]

深度贴图不使用mipmap。

## 方法

共有方法请参见其基类[page:Texture Texture]。

## 源代码

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