THREE.UVMapping
THREE.CubeReflectionMapping
THREE.CubeRefractionMapping
THREE.EquirectangularReflectionMapping
THREE.EquirectangularRefractionMapping
THREE.CubeUVReflectionMapping
这些常量定义了纹理贴图的映射模式。
[page:Constant UVMapping]是默认值,纹理使用网格的坐标来进行映射。
其它的值定义了环境映射的类型。
[page:Constant CubeReflectionMapping] 和 [page:Constant CubeRefractionMapping] 用于 [page:CubeTexture CubeTexture] ——
由6个纹理组合而成,每个纹理都是立方体的一个面。
对于[page:CubeTexture CubeTexture]来说,[page:Constant CubeReflectionMapping]是其默认值。
[page:Constant EquirectangularReflectionMapping] 和 [page:Constant EquirectangularRefractionMapping]
用于等距圆柱投影的环境贴图,也被叫做经纬线映射贴图。等距圆柱投影贴图表示沿着其水平中线360°的视角,以及沿着其垂直轴向180°的视角。贴图顶部和底部的边缘分别对应于它所映射的球体的北极和南极。
请查看示例:[example:webgl_materials_envmaps materials / envmaps] 。
THREE.RepeatWrapping
THREE.ClampToEdgeWrapping
THREE.MirroredRepeatWrapping
这些常量定义了纹理贴图的 [page:Texture.wrapS wrapS] 和 [page:Texture.wrapT wrapT] 属性,定义了水平和垂直方向上纹理的包裹方式。
使用[page:constant RepeatWrapping],纹理将简单地重复到无穷大。
With [page:constant RepeatWrapping] the texture will simply repeat to infinity.
[page:constant ClampToEdgeWrapping]是默认值,纹理中的最后一个像素将延伸到网格的边缘。
使用[page:constant MirroredRepeatWrapping], 纹理将重复到无穷大,在每次重复时将进行镜像。
THREE.NearestFilter
THREE.LinearFilter
这些常量用于纹理的[page:Texture.magFilter magFilter]属性,它们定义了当被纹理化的像素映射到小于或者等于1纹理元素(texel)的区域时,将要使用的纹理放大函数。
[page:constant NearestFilter]返回与指定纹理坐标(在曼哈顿距离之内)最接近的纹理元素的值。
[page:constant LinearFilter]是默认值,返回距离指定的纹理坐标最近的四个纹理元素的加权平均值,
并且可以包含纹理的其他部分中,被包裹或者被重复的项目,具体取决于 [page:Texture.wrapS wrapS] 和 [page:Texture.wrapT wrapT] 的值,and on the exact mapping。
THREE.NearestFilter
THREE.NearestMipmapNearestFilter
THREE.NearestMipmapLinearFilter
THREE.LinearFilter
THREE.LinearMipmapNearestFilter
THREE.LinearMipmapLinearFilter
这些常量用于纹理的[page:Texture.minFilter minFilter]属性,它们定义了当被纹理化的像素映射到大于1纹理元素(texel)的区域时,将要使用的纹理缩小函数。
除了[page:constant NearestFilter] 和 [page:constant LinearFilter],
下面的四个函数也可以用于缩小:
[page:constant NearestMipmapNearestFilter]选择与被纹理化像素的尺寸最匹配的mipmap,
并以[page:constant NearestFilter](最靠近像素中心的纹理元素)为标准来生成纹理值。
[page:constant NearestMipmapLinearFilter]选择与被纹理化像素的尺寸最接近的两个mipmap,
并以[page:constant NearestFilter]为标准来从每个mipmap中生成纹理值。最终的纹理值是这两个值的加权平均值。
[page:constant LinearMipmapNearestFilter]选择与被纹理化像素的尺寸最匹配的mipmap,
并以[page:constant LinearFilter](最靠近像素中心的四个纹理元素的加权平均值)为标准来生成纹理值。
[page:constant LinearMipmapLinearFilter]是默认值,它选择与被纹理化像素的尺寸最接近的两个mipmap,
并以[page:constant LinearFilter]为标准来从每个mipmap中生成纹理值。最终的纹理值是这两个值的加权平均值。
请查看示例:[example:webgl_materials_texture_filters materials / texture / filters]。
THREE.UnsignedByteType
THREE.ByteType
THREE.ShortType
THREE.UnsignedShortType
THREE.IntType
THREE.UnsignedIntType
THREE.FloatType
THREE.HalfFloatType
THREE.UnsignedShort4444Type
THREE.UnsignedShort5551Type
THREE.UnsignedInt248Type
THREE.UnsignedInt5999Type
这些常量用于纹理的[page:Texture.type type]属性,这些属性必须与正确的格式相对应。详情请查看下方。
[page:constant UnsignedByteType] 是默认值。
THREE.AlphaFormat
THREE.RedFormat
THREE.RedIntegerFormat
THREE.RGFormat
THREE.RGIntegerFormat
THREE.RGBFormat
THREE.RGBAFormat
THREE.RGBAIntegerFormat
THREE.DepthFormat
THREE.DepthStencilFormat
这些常量用于纹理的[page:Texture.format format]属性,它们定义了shader(着色器)将如何读取的2D纹理或者*texels*(纹理元素)的元素。.
[page:constant AlphaFormat] 丢弃红、绿、蓝分量,仅读取Alpha分量。
[page:constant RedFormat] 丢弃绿、蓝分量,仅读取红分量。
[page:constant RedIntegerFormat] 丢弃绿、蓝分量,仅读取红分量。
纹理像素以整数形式读取,而非浮点数。
[page:constant RGFormat] 丢弃 alpha、蓝分量,仅读取红、绿分量。
[page:constant RGIntegerFormat] 丢弃 alpha、蓝分量,仅读取红、绿分量。
纹理像素以整数形式读取,而非浮点数。
[page:constant RGBAFormat] 是默认值,它将读取红、绿、蓝和Alpha分量。
[page:constant RGBAIntegerFormat] 是默认值,读取红、绿、蓝 和 alpha 分量。
纹理像素以整数形式读取,而非浮点数。
[page:constant DepthFormat]将每个元素作为单独的深度值来读取,将其转换为范围限制在[0,1]区间的浮点数。
它是[page:DepthTexture DepthTexture]的默认值。
[page:constant DepthStencilFormat]将每个元素同时作为一对深度值和模板值来读取。
其中的深度分量解释为[page:constant DepthFormat]。
模板分量基于深度+模板的内部格式来进行解释。
请注意,纹理必须具有正确的[page:Texture.type type]设置,正如上一节所描述的那样。
请参阅[link:https://developer.mozilla.org/en/docs/Web/API/WebGLRenderingContext/texImage2D WebGLRenderingContext.texImage2D]
来获得有关详细信息。
THREE.RGB_S3TC_DXT1_Format
THREE.RGBA_S3TC_DXT1_Format
THREE.RGBA_S3TC_DXT3_Format
THREE.RGBA_S3TC_DXT5_Format
要使用[page:CompressedTexture CompressedTexture]中的[page:Texture.format format]属性,
需要获得[link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_s3tc/ WEBGL_compressed_texture_s3tc]
扩展的支持。
通过这个扩展,这里的四种[link:https://en.wikipedia.org/wiki/S3_Texture_Compression S3TC]格式将可以使用:
[page:constant RGB_S3TC_DXT1_Format]:RGB图像格式的DXT1压缩图像。
[page:constant RGBA_S3TC_DXT1_Format]:RGB图像格式的DXT1压缩图像,Alpha仅具有是/否透明两个值。
[page:constant RGBA_S3TC_DXT3_Format]:RGBA图像格式的DXT3压缩图像,和32位RGBA纹理贴图相比,它提供了4:1的压缩比。
[page:constant RGBA_S3TC_DXT5_Format]:RGBA图像格式的DXT5压缩图像,它也提供了4:1的压缩比,但与DX3格式的不同之处在于其Alpha是如何被压缩的。
THREE.RGB_PVRTC_4BPPV1_Format
THREE.RGB_PVRTC_2BPPV1_Format
THREE.RGBA_PVRTC_4BPPV1_Format
THREE.RGBA_PVRTC_2BPPV1_Format
要使用[page:CompressedTexture CompressedTexture]中的[page:Texture.format format]属性,需要获得
[link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_pvrtc/ WEBGL_compressed_texture_pvrtc]
扩展的支持。
PVRTC通常只在具有PowerVR芯片的移动设备上可用,这些设备主要是苹果设备。
通过这个扩展,这里的四种[link:https://en.wikipedia.org/wiki/PVRTC PVRTC]格式将可以使用:
[page:constant RGB_PVRTC_4BPPV1_Format]:4位模式下的RGB压缩,每4x4像素一个块。
[page:constant RGB_PVRTC_2BPPV1_Format]:2位模式下的RGB压缩,每8x4像素一个块。
[page:constant RGBA_PVRTC_4BPPV1_Format]: 4位模式下的RGBA压缩,每4x4像素一个块。
[page:constant RGBA_PVRTC_2BPPV1_Format]: 2位模式下的RGB压缩,每8x4像素一个块。
THREE.RGB_ETC1_Format
THREE.RGB_ETC2_Format
THREE.RGBA_ETC2_EAC_Format
为了与 [page:CompressedTexture CompressedTexture] 的 [page:Texture.format format] 属性一起使用,这些需要支持 [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_etc1/ WEBGL_compressed_texture_etc1]
(ETC1) 或 [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_etc/ WEBGL_compressed_texture_etc]
(ETC2) 扩展。
THREE.RGBA_ASTC_4x4_Format
THREE.RGBA_ASTC_5x4_Format
THREE.RGBA_ASTC_5x5_Format
THREE.RGBA_ASTC_6x5_Format
THREE.RGBA_ASTC_6x6_Format
THREE.RGBA_ASTC_8x5_Format
THREE.RGBA_ASTC_8x6_Format
THREE.RGBA_ASTC_8x8_Format
THREE.RGBA_ASTC_10x5_Format
THREE.RGBA_ASTC_10x6_Format
THREE.RGBA_ASTC_10x8_Format
THREE.RGBA_ASTC_10x10_Format
THREE.RGBA_ASTC_12x10_Format
THREE.RGBA_ASTC_12x12_Format
为了与 [page:CompressedTexture CompressedTexture] 的 [page:Texture.format format] 属性一起使用,这些需要支持 [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_astc/ WEBGL_compressed_texture_astc] 扩展。
'ALPHA'
'RGB'
'RGBA'
'LUMINANCE'
'LUMINANCE_ALPHA'
'RED_INTEGER'
'R8'
'R8_SNORM'
'R8I'
'R8UI'
'R16I'
'R16UI'
'R16F'
'R32I'
'R32UI'
'R32F'
'RG8'
'RG8_SNORM'
'RG8I'
'RG8UI'
'RG16I'
'RG16UI'
'RG16F'
'RG32I'
'RG32UI'
'RG32F'
'RGB565'
'RGB8'
'RGB8_SNORM'
'RGB8I'
'RGB8UI'
'RGB16I'
'RGB16UI'
'RGB16F'
'RGB32I'
'RGB32UI'
'RGB32F'
'RGB9_E5'
'SRGB8'
'R11F_G11F_B10F'
'RGBA4'
'RGBA8'
'RGBA8_SNORM'
'RGBA8I'
'RGBA8UI'
'RGBA16I'
'RGBA16UI'
'RGBA16F'
'RGBA32I'
'RGBA32UI'
'RGBA32F'
'RGB5_A1'
'RGB10_A2'
'RGB10_A2UI'
'SRGB8_ALPHA8'
'DEPTH_COMPONENT16'
'DEPTH_COMPONENT24'
'DEPTH_COMPONENT32F'
'DEPTH24_STENCIL8'
'DEPTH32F_STENCIL8'
为了与纹理 [page:Texture.internalFormat internalFormat] 属性一起使用,
这些属性定义了纹理元素或 *texels* 在GPU上的存储方式。
[page:constant R8] 存储红色分量,占用 8 bits。
[page:constant R8_SNORM] 存储红色分量,占用 8 bits。 分量值为归一化后的值。
[page:constant R8I] 存储红色分量,占用 8 bits。 分量值为整数。
[page:constant R8UI] 存储红色分量,占用 8 bits。 分量值为无符号整数。
[page:constant R16I] 存储红色分量,占用 16 bits。 分量值为整数。
[page:constant R16UI] 存储红色分量,占用 16 bits。 分量值为无符号整数。
[page:constant R16F] 存储红色分量,占用 16 bits。 分量值为浮点数。
[page:constant R32I] 存储红色分量,占用 32 bits。 分量值为整数。
[page:constant R32UI] 存储红色分量,占用 32 bits。 分量值为无符号整数。
[page:constant R32F] 存储红色分量,占用 32 bits。 分量值为浮点数。
[page:constant RG8] 存储红色和绿色分量,分别占用 8 bits。
[page:constant RG8_SNORM] 存储红色和绿色分量,分别占用 8 bits。
每个分量都是归一化后的值。
[page:constant RG8I] 存储红色和绿色分量,分别占用 8 bits。
每个分量都是整数。
[page:constant RG8UI] 存储红色和绿色分量,分别占用 8 bits。
每个分量都是无符号整数。
[page:constant RG16I] 存储红色和绿色分量,分别占用 16 bits。
每个分量都是整数。
[page:constant RG16UI] 存储红色和绿色分量,分别占用 16 bits。
每个分量都是无符号整数。
[page:constant RG16F] 存储红色和绿色分量,分别占用 16 bits。
每个分量都是浮点数。
[page:constant RG32I] 存储红色和绿色分量,分别占用 32 bits。
每个分量都是整数。
[page:constant RG32UI] 存储红色和绿色分量,分别占用 32 bits。
每个分量都是无符号整数。
[page:constant RG32F] 存储红色和绿色分量,分别占用 32 bits。
每个分量都是浮点数。
[page:constant RGB8] 存储红色、绿色和蓝色分量,分别占用 8 bits。
[page:constant RGB8_SNORM] 存储红色、绿色和蓝色分量,分别占用 8 bits。
每个分量都是归一化后的值。
[page:constant RGB8I] 存储红色、绿色和蓝色分量,分别占用 8 bits。
每个分量都是整数。
[page:constant RGB8UI] 存储红色、绿色和蓝色分量,分别占用 8 bits。
每个分量都是无符号整数。
[page:constant RGB16I] 存储红色、绿色和蓝色分量,分别占用 16 bits。
每个分量都是整数。
[page:constant RGB16UI] 存储红色、绿色和蓝色分量,分别占用 16 bits。
每个分量都是无符号整数。
[page:constant RGB16F] 存储红色、绿色和蓝色分量,分别占用 16 bits。
每个分量都是浮点数。
[page:constant RGB32I] 存储红色、绿色和蓝色分量,分别占用 32 bits。
每个分量都是整数。
[page:constant RGB32UI] 存储红色、绿色和蓝色分量,分别占用 32 bits。
每个分量都是无符号整数。
[page:constant RGB32F] 存储红色、绿色和蓝色分量,分别占用 32 bits。
每个分量都是浮点数。
[page:constant R11F_G11F_B10F] 存储红色、绿色和蓝色分量,分别占用 11 bits、11 bits 和 10bits。
每个分量都是浮点数。
[page:constant RGB565] 存储红色、绿色和蓝色分量,分别占用 5 bits、6 bits 和 5 bits。
[page:constant RGB9_E5] 存储红色、绿色和蓝色分量,分别占用 9 bits。
[page:constant RGBA8] 存储红色、绿色、蓝色和 alpha 分量,分别占用 8 bits。
[page:constant RGBA8_SNORM] 存储红色、绿色、蓝色和 alpha 分量,分别占用 8 bits。
每个分量都是归一化后的值。
[page:constant RGBA8I] 存储红色、绿色、蓝色和 alpha 分量,分别占用 8 bits。
每个分量都是整数。
[page:constant RGBA8UI] 存储红色、绿色、蓝色和 alpha 分量,分别占用 8 bits。
每个分量都是无符号整数。
[page:constant RGBA16I] 存储红色、绿色、蓝色和 alpha 分量,分别占用 16 bits。
每个分量都是整数。
[page:constant RGBA16UI] 存储红色、绿色、蓝色和 alpha 分量,分别占用 16 bits。
每个分量都是无符号整数。
[page:constant RGBA16F] 存储红色、绿色、蓝色和 alpha 分量,分别占用 16 bits。
每个分量都是浮点数。
[page:constant RGBA32I] 存储红色、绿色、蓝色和 alpha 分量,分别占用 32 bits。
每个分量都是整数。
[page:constant RGBA32UI] 存储红色、绿色、蓝色和 alpha 分量,分别占用 32 bits。
每个分量都是无符号整数。
[page:constant RGBA32F] 存储红色、绿色、蓝色和 alpha 分量,分别占用 32 bits。
每个分量都是浮点数。
[page:constant RGB5_A1] 存储红色、绿色、蓝色和 alpha 分量,分别占用 5 bits、5 bits、5 bits 和 1 bit。
[page:constant RGB10_A2] 存储红色、绿色、蓝色和 alpha 分量,分别占用 10 bits、10 bits、10 bits 和 2 bits。
[page:constant RGB10_A2UI] 存储红色、绿色、蓝色和 alpha 分量,分别占用 10 bits、10 bits、10 bits 和 2 bits。
每个分量都是无符号整数。
[page:constant SRGB8] 存储红色、绿色和蓝色分量,分别占用 8 bits。
[page:constant SRGB8_ALPHA8] 存储红色、绿色、蓝色和 alpha 分量,分别占用 8 bits。
[page:constant DEPTH_COMPONENT16] 存储深度分量,占用 16bits。
[page:constant DEPTH_COMPONENT24] 存储深度分量,占用 24bits。
[page:constant DEPTH_COMPONENT32F] 存储深度分量,占用 32bits。分量值为浮点数。
[page:constant DEPTH24_STENCIL8] 存储深度和模板分量,分别占用 24 bits 和 8 bits。
模板分量为无符号整数。
[page:constant DEPTH32F_STENCIL8] 存储深度和模板分量,分别占用 32 bits 和 8 bits。
深度分量为浮点数,模板分量为无符号整数。
请注意,纹理必须具有正确的 [page:Texture.type type] 设置,以及正确的 [page:Texture.format format]。
查看 [link:https://developer.mozilla.org/en/docs/Web/API/WebGLRenderingContext/texImage2D WebGLRenderingContext.texImage2D] 和
[link:https://developer.mozilla.org/en-US/docs/Web/API/WebGL2RenderingContext/texImage3D WebGL2RenderingContext.texImage3D],
有关可能组合的更多详细信息 [page:Texture.format format]、[page:Texture.internalFormat internalFormat] 和 [page:Texture.type type]。
有关内部格式的更多详细信息,您还可以直接参考 [link:https://www.khronos.org/registry/webgl/specs/latest/2.0/ WebGL2 Specification] 和 [link:https://www.khronos.org/registry/OpenGL/specs/es/3.0/es_spec_3.0.pdf OpenGL ES 3.0 Specification]。
THREE.BasicDepthPacking
THREE.RGBADepthPacking
与 `MeshDepthMaterial` 的 [page:MeshDepthMaterial.depthPacking depthPacking] 属性一起使用。
THREE.NoColorSpace = ""
THREE.SRGBColorSpace = "srgb"
THREE.LinearSRGBColorSpace = "srgb-linear"
用于定义纹理的颜色空间(以及渲染器的输出颜色空间)。
如果在纹理已被材质使用后更改颜色空间类型,则需要将 [page:Material.needsUpdate Material.needsUpdate] 设置为 `true` 以使材质重新编译。
[link:https://github.com/mrdoob/three.js/blob/master/src/constants.js src/constants.js]