深度纹理([name])

此类可用于自动将渲染的深度信息保存到纹理中。

例子

[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] -- Default is [page:Textures THREE.UnsignedIntType] when using [page:Textures DepthFormat] and [page:Textures THREE.UnsignedInt248Type] when using [page:Textures DepthStencilFormat]. 请参阅[page:Textures type constants]（类型常量）来了解其他选项。
[page:Constant mapping] -- 请参阅[page:Textures mapping mode 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]

默认为 THREE.UnsignedIntType。 以下是选项以及它们如何根据模板格式映射到内部 gl 深度格式类型： THREE.UnsignedIntType——内部使用 DEPTH_COMPONENT24 或 DEPTH24_STENCIL8。 THREE.FloatType——内部使用 DEPTH_COMPONENT32F 或 DEPTH32F_STENCIL8。 THREE.UnsignedShortType——内部使用 DEPTH_COMPONENT16。使用此类型时，模板缓冲区不受支持。

[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，因此其默认值为*false*。

[property:Boolean isDepthTexture]

只读属性，用于检查给定对象是否为[name]类型。

[property:number compareFunction]

用于定义将深度纹理中的纹素与深度缓冲区中的值进行比较时使用的比较函数。默认值为 `null`，表示禁用比较。​​

有关其他函数的详细信息，请参阅纹理常量页面 [page:Textures texture constants]。

方法

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

源代码

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