Textures.html 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550
  1. <!DOCTYPE html>
  2. <html lang="zh">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../../" />
  6. <script src="page.js"></script>
  7. <link type="text/css" rel="stylesheet" href="page.css" />
  8. </head>
  9. <body>
  10. <h1>纹理常量(Texture Constants)</h1>
  11. <h2>映射模式</h2>
  12. <code>
  13. THREE.UVMapping
  14. THREE.CubeReflectionMapping
  15. THREE.CubeRefractionMapping
  16. THREE.EquirectangularReflectionMapping
  17. THREE.EquirectangularRefractionMapping
  18. THREE.CubeUVReflectionMapping
  19. THREE.CubeUVRefractionMapping
  20. </code>
  21. <p>
  22. 这些常量定义了纹理贴图的映射模式。<br />
  23. [page:Constant UVMapping]是默认值,纹理使用网格的坐标来进行映射。<br /><br />
  24. 其它的值定义了环境映射的类型。<br /><br />
  25. [page:Constant CubeReflectionMapping] 和 [page:Constant CubeRefractionMapping] 用于 [page:CubeTexture CubeTexture] ——
  26. 由6个纹理组合而成,每个纹理都是立方体的一个面。
  27. 对于[page:CubeTexture CubeTexture]来说,[page:Constant CubeReflectionMapping]是其默认值。<br /><br />
  28. [page:Constant EquirectangularReflectionMapping] 和 [page:Constant EquirectangularRefractionMapping]
  29. 用于等距圆柱投影的环境贴图,也被叫做经纬线映射贴图。等距圆柱投影贴图表示沿着其水平中线360°的视角,以及沿着其垂直轴向180°的视角。贴图顶部和底部的边缘分别对应于它所映射的球体的北极和南极。
  30. <br /><br />
  31. 请查看示例:[example:webgl_materials_envmaps materials / envmaps] 。
  32. </p>
  33. <h2>包裹模式</h2>
  34. <code>
  35. THREE.RepeatWrapping
  36. THREE.ClampToEdgeWrapping
  37. THREE.MirroredRepeatWrapping
  38. </code>
  39. <p>
  40. 这些常量定义了纹理贴图的 [page:Texture.wrapS wrapS] 和 [page:Texture.wrapT wrapT] 属性,定义了水平和垂直方向上纹理的包裹方式。
  41. <br /><br />
  42. 使用[page:constant RepeatWrapping],纹理将简单地重复到无穷大。
  43. With [page:constant RepeatWrapping] the texture will simply repeat to infinity.<br /><br />
  44. [page:constant ClampToEdgeWrapping]是默认值,纹理中的最后一个像素将延伸到网格的边缘。<br /><br />
  45. 使用[page:constant MirroredRepeatWrapping], 纹理将重复到无穷大,在每次重复时将进行镜像。
  46. </p>
  47. <h2>放大滤镜(Magnification Filters)</h2>
  48. <code>
  49. THREE.NearestFilter
  50. THREE.LinearFilter
  51. </code>
  52. <p>
  53. 这些常量用于纹理的[page:Texture.magFilter magFilter]属性,它们定义了当被纹理化的像素映射到小于或者等于1纹理元素(texel)的区域时,将要使用的纹理放大函数。<br /><br />
  54. [page:constant NearestFilter]返回与指定纹理坐标(在曼哈顿距离之内)最接近的纹理元素的值。<br /><br />
  55. [page:constant LinearFilter]是默认值,返回距离指定的纹理坐标最近的四个纹理元素的加权平均值,
  56. 并且可以包含纹理的其他部分中,被包裹或者被重复的项目,具体取决于 [page:Texture.wrapS wrapS] 和 [page:Texture.wrapT wrapT] 的值,and on the exact mapping。
  57. </p>
  58. <h2>缩小滤镜(Minification Filters)</h2>
  59. <code>
  60. THREE.NearestFilter
  61. THREE.NearestMipmapNearestFilter
  62. THREE.NearestMipmapLinearFilter
  63. THREE.LinearFilter
  64. THREE.LinearMipmapNearestFilter
  65. THREE.LinearMipmapLinearFilter
  66. </code>
  67. <p>
  68. 这些常量用于纹理的[page:Texture.minFilter minFilter]属性,它们定义了当被纹理化的像素映射到大于1纹理元素(texel)的区域时,将要使用的纹理缩小函数。<br /><br />
  69. 除了[page:constant NearestFilter] 和 [page:constant LinearFilter],
  70. 下面的四个函数也可以用于缩小:<br /><br />
  71. [page:constant NearestMipmapNearestFilter]选择与被纹理化像素的尺寸最匹配的mipmap,
  72. 并以[page:constant NearestFilter](最靠近像素中心的纹理元素)为标准来生成纹理值。
  73. <br /><br />
  74. [page:constant NearestMipmapLinearFilter]选择与被纹理化像素的尺寸最接近的两个mipmap,
  75. 并以[page:constant NearestFilter]为标准来从每个mipmap中生成纹理值。最终的纹理值是这两个值的加权平均值。
  76. <br /><br />
  77. [page:constant LinearMipmapNearestFilter]选择与被纹理化像素的尺寸最匹配的mipmap,
  78. 并以[page:constant LinearFilter](最靠近像素中心的四个纹理元素的加权平均值)为标准来生成纹理值。
  79. <br /><br />
  80. [page:constant LinearMipmapLinearFilter]是默认值,它选择与被纹理化像素的尺寸最接近的两个mipmap,
  81. 并以[page:constant LinearFilter]为标准来从每个mipmap中生成纹理值。最终的纹理值是这两个值的加权平均值。<br /><br />
  82. 请查看示例:[example:webgl_materials_texture_filters materials / texture / filters]。
  83. </p>
  84. <h2>类型</h2>
  85. <code>
  86. THREE.UnsignedByteType
  87. THREE.ByteType
  88. THREE.ShortType
  89. THREE.UnsignedShortType
  90. THREE.IntType
  91. THREE.UnsignedIntType
  92. THREE.FloatType
  93. THREE.HalfFloatType
  94. THREE.UnsignedShort4444Type
  95. THREE.UnsignedShort5551Type
  96. THREE.UnsignedShort565Type
  97. THREE.UnsignedInt248Type
  98. </code>
  99. <p>
  100. 这些常量用于纹理的[page:Texture.type type]属性,这些属性必须与正确的格式相对应。详情请查看下方。<br /><br />
  101. [page:constant UnsignedByteType] 是默认值。
  102. </p>
  103. <h2>格式</h2>
  104. <code>
  105. THREE.AlphaFormat
  106. THREE.RedFormat
  107. THREE.RedIntegerFormat
  108. THREE.RGFormat
  109. THREE.RGIntegerFormat
  110. THREE.RGBIntegerFormat
  111. THREE.RGBAFormat
  112. THREE.RGBAIntegerFormat
  113. THREE.LuminanceFormat
  114. THREE.LuminanceAlphaFormat
  115. THREE.DepthFormat
  116. THREE.DepthStencilFormat
  117. </code>
  118. <p>
  119. 这些常量用于纹理的[page:Texture.format format]属性,它们定义了shader(着色器)将如何读取的2D纹理或者*texels*(纹理元素)的元素。.<br /><br />
  120. [page:constant AlphaFormat] 丢弃红、绿、蓝分量,仅读取Alpha分量。<br /><br />
  121. [page:constant RedFormat] discards the green and blue components and reads just the red component.<br /><br />
  122. [page:constant RedIntegerFormat] discards the green and blue components and reads just the red component.
  123. The texels are read as integers instead of floating point.
  124. (can only be used with a WebGL 2 rendering context).
  125. <br /><br />
  126. [page:constant RGFormat] discards the alpha, and blue components and reads the red, and green components.
  127. (can only be used with a WebGL 2 rendering context).
  128. <br /><br />
  129. [page:constant RGIntegerFormat] discards the alpha, and blue components and reads the red, and green components.
  130. The texels are read as integers instead of floating point.
  131. (can only be used with a WebGL 2 rendering context).
  132. <br /><br />
  133. [page:constant RGBIntegerFormat] discards the alpha components and reads the red, green and blue components.
  134. (can only be used with a WebGL 2 rendering context).
  135. <br /><br />
  136. [page:constant RGBAFormat] 是默认值,它将读取红、绿、蓝和Alpha分量。<br /><br />
  137. [page:constant RGBAIntegerFormat] is the default and reads the red, green, blue and alpha components.
  138. The texels are read as integers instead of floating point.
  139. (can only be used with a WebGL 2 rendering context).
  140. <br /><br />
  141. [page:constant LuminanceFormat] 将每个元素作为单独的亮度分量来读取。
  142. 将其转换为范围限制在[0,1]区间的浮点数,然后通过将亮度值放入红、绿、蓝通道,并将1.0赋给Alpha通道,来组装成一个RGBA元素。<br /><br />
  143. [page:constant LuminanceAlphaFormat] 将每个元素同时作为亮度分量和Alpha分量来读取。
  144. 和上面[page:constant LuminanceFormat]的处理过程是一致的,除了Alpha分量具有除了*1.0*以外的值。<br /><br />
  145. [page:constant DepthFormat]将每个元素作为单独的深度值来读取,将其转换为范围限制在[0,1]区间的浮点数。
  146. 它是[page:DepthTexture DepthTexture]的默认值。<br /><br />
  147. [page:constant DepthStencilFormat]将每个元素同时作为一对深度值和模板值来读取。
  148. 其中的深度分量解释为[page:constant DepthFormat]。
  149. 模板分量基于深度+模板的内部格式来进行解释。
  150. <br /><br />
  151. 请注意,纹理必须具有正确的[page:Texture.type type]设置,正如上一节所描述的那样。
  152. 请参阅[link:https://developer.mozilla.org/en/docs/Web/API/WebGLRenderingContext/texImage2D WebGLRenderingContext.texImage2D]
  153. 来获得有关详细信息。
  154. </p>
  155. <h2>DDS / ST3C 压缩纹理格式</h2>
  156. <code>
  157. THREE.RGB_S3TC_DXT1_Format
  158. THREE.RGBA_S3TC_DXT1_Format
  159. THREE.RGBA_S3TC_DXT3_Format
  160. THREE.RGBA_S3TC_DXT5_Format
  161. </code>
  162. <p>
  163. 要使用[page:CompressedTexture CompressedTexture]中的[page:Texture.format format]属性,
  164. 需要获得[link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_s3tc/ WEBGL_compressed_texture_s3tc]
  165. 扩展的支持。<br /><br />
  166. 通过这个扩展,这里的四种[link:https://en.wikipedia.org/wiki/S3_Texture_Compression S3TC]格式将可以使用:<br />
  167. [page:constant RGB_S3TC_DXT1_Format]:RGB图像格式的DXT1压缩图像。
  168. [page:constant RGBA_S3TC_DXT1_Format]:RGB图像格式的DXT1压缩图像,Alpha仅具有是/否透明两个值。<br />
  169. [page:constant RGBA_S3TC_DXT3_Format]:RGBA图像格式的DXT3压缩图像,和32位RGBA纹理贴图相比,它提供了4:1的压缩比。<br />
  170. [page:constant RGBA_S3TC_DXT5_Format]:RGBA图像格式的DXT5压缩图像,它也提供了4:1的压缩比,但与DX3格式的不同之处在于其Alpha是如何被压缩的。<br />
  171. </p>
  172. <h2>PVRTC 压缩纹理格式(PVRTC Compressed Texture Formats)</h2>
  173. <code>
  174. THREE.RGB_PVRTC_4BPPV1_Format
  175. THREE.RGB_PVRTC_2BPPV1_Format
  176. THREE.RGBA_PVRTC_4BPPV1_Format
  177. THREE.RGBA_PVRTC_2BPPV1_Format
  178. </code>
  179. <p>
  180. 要使用[page:CompressedTexture CompressedTexture]中的[page:Texture.format format]属性,需要获得
  181. [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_pvrtc/ WEBGL_compressed_texture_pvrtc]
  182. 扩展的支持。<br />
  183. PVRTC通常只在具有PowerVR芯片的移动设备上可用,这些设备主要是苹果设备。<br /><br />
  184. 通过这个扩展,这里的四种[link:https://en.wikipedia.org/wiki/PVRTC PVRTC]格式将可以使用:<br />
  185. [page:constant RGB_PVRTC_4BPPV1_Format]:4位模式下的RGB压缩,每4x4像素一个块。<br />
  186. [page:constant RGB_PVRTC_2BPPV1_Format]:2位模式下的RGB压缩,每8x4像素一个块。<br />
  187. [page:constant RGBA_PVRTC_4BPPV1_Format]: 4位模式下的RGBA压缩,每4x4像素一个块。<br />
  188. [page:constant RGBA_PVRTC_2BPPV1_Format]: 2位模式下的RGB压缩,每8x4像素一个块。<br />
  189. </p>
  190. <h2>ETC 压缩纹理格式</h2>
  191. <code>
  192. THREE.RGB_ETC1_Format
  193. THREE.RGB_ETC2_Format
  194. THREE.RGBA_ETC2_EAC_Format
  195. </code>
  196. <p>
  197. For use with a [page:CompressedTexture CompressedTexture]'s [page:Texture.format format] property,
  198. these require support for the [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_etc1/ WEBGL_compressed_texture_etc1]
  199. (ETC1) or [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_etc/ WEBGL_compressed_texture_etc]
  200. (ETC2) extensions. <br /><br />
  201. </p>
  202. <h2>ASTC Compressed Texture Format</h2>
  203. <code>
  204. THREE.RGBA_ASTC_4x4_Format
  205. THREE.RGBA_ASTC_5x4_Format
  206. THREE.RGBA_ASTC_5x5_Format
  207. THREE.RGBA_ASTC_6x5_Format
  208. THREE.RGBA_ASTC_6x6_Format
  209. THREE.RGBA_ASTC_8x5_Format
  210. THREE.RGBA_ASTC_8x6_Format
  211. THREE.RGBA_ASTC_8x8_Format
  212. THREE.RGBA_ASTC_10x5_Format
  213. THREE.RGBA_ASTC_10x6_Format
  214. THREE.RGBA_ASTC_10x8_Format
  215. THREE.RGBA_ASTC_10x10_Format
  216. THREE.RGBA_ASTC_12x10_Format
  217. THREE.RGBA_ASTC_12x12_Format
  218. </code>
  219. <p>
  220. For use with a [page:CompressedTexture CompressedTexture]'s [page:Texture.format format] property,
  221. these require support for the [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_astc/ WEBGL_compressed_texture_astc] extension. <br /><br />
  222. </p>
  223. <h2>Internal Formats</h2>
  224. <code>
  225. 'ALPHA'
  226. 'RGB'
  227. 'RGBA'
  228. 'LUMINANCE'
  229. 'LUMINANCE_ALPHA'
  230. 'RED_INTEGER'
  231. 'R8'
  232. 'R8_SNORM'
  233. 'R8I'
  234. 'R8UI'
  235. 'R16I'
  236. 'R16UI'
  237. 'R16F'
  238. 'R32I'
  239. 'R32UI'
  240. 'R32F'
  241. 'RG8'
  242. 'RG8_SNORM'
  243. 'RG8I'
  244. 'RG8UI'
  245. 'RG16I'
  246. 'RG16UI'
  247. 'RG16F'
  248. 'RG32I'
  249. 'RG32UI'
  250. 'RG32F'
  251. 'RGB565'
  252. 'RGB8'
  253. 'RGB8_SNORM'
  254. 'RGB8I'
  255. 'RGB8UI'
  256. 'RGB16I'
  257. 'RGB16UI'
  258. 'RGB16F'
  259. 'RGB32I'
  260. 'RGB32UI'
  261. 'RGB32F'
  262. 'RGB9_E5'
  263. 'SRGB8'
  264. 'R11F_G11F_B10F'
  265. 'RGBA4'
  266. 'RGBA8'
  267. 'RGBA8_SNORM'
  268. 'RGBA8I'
  269. 'RGBA8UI'
  270. 'RGBA16I'
  271. 'RGBA16UI'
  272. 'RGBA16F'
  273. 'RGBA32I'
  274. 'RGBA32UI'
  275. 'RGBA32F'
  276. 'RGB5_A1'
  277. 'RGB10_A2'
  278. 'RGB10_A2UI'
  279. 'SRGB8_ALPHA8'
  280. 'DEPTH_COMPONENT16'
  281. 'DEPTH_COMPONENT24'
  282. 'DEPTH_COMPONENT32F'
  283. 'DEPTH24_STENCIL8'
  284. 'DEPTH32F_STENCIL8'
  285. </code>
  286. <p>
  287. Heads up: changing the internal format of a texture will only affect the
  288. texture when using a WebGL 2 rendering context.<br /><br />
  289. For use with a texture's [page:Texture.internalFormat internalFormat] property,
  290. these define how elements of a texture, or *texels*, are stored on the GPU.<br /><br />
  291. [page:constant R8] stores the red component on 8 bits.<br /><br />
  292. [page:constant R8_SNORM] stores the red component on 8 bits. The component is stored as normalized. <br /><br />
  293. [page:constant R8I] stores the red component on 8 bits. The component is stored as an integer. <br /><br />
  294. [page:constant R8UI] stores the red component on 8 bits. The component is stored as an unsigned integer. <br /><br />
  295. [page:constant R16I] stores the red component on 16 bits. The component is stored as an integer. <br /><br />
  296. [page:constant R16UI] stores the red component on 16 bits. The component is stored as an unsigned integer. <br /><br />
  297. [page:constant R16F] stores the red component on 16 bits. The component is stored as floating point. <br /><br />
  298. [page:constant R32I] stores the red component on 32 bits. The component is stored as an integer. <br /><br />
  299. [page:constant R32UI] stores the red component on 32 bits. The component is stored as an unsigned integer. <br /><br />
  300. [page:constant R32F] stores the red component on 32 bits. The component is stored as floating point. <br /><br />
  301. [page:constant RG8] stores the red and green components on 8 bits each.<br /><br />
  302. [page:constant RG8_SNORM] stores the red and green components on 8 bits each.
  303. Every component is stored as normalized.
  304. <br /><br />
  305. [page:constant RG8I] stores the red and green components on 8 bits each.
  306. Every component is stored as an integer.
  307. <br /><br />
  308. [page:constant RG8UI] stores the red and green components on 8 bits each.
  309. Every component is stored as an unsigned integer.
  310. <br /><br />
  311. [page:constant RG16I] stores the red and green components on 16 bits each.
  312. Every component is stored as an integer.
  313. <br /><br />
  314. [page:constant RG16UI] stores the red and green components on 16 bits each.
  315. Every component is stored as an unsigned integer.
  316. <br /><br />
  317. [page:constant RG16F] stores the red and green components on 16 bits each.
  318. Every component is stored as floating point.
  319. <br /><br />
  320. [page:constant RG32I] stores the red and green components on 32 bits each.
  321. Every component is stored as an integer.
  322. <br /><br />
  323. [page:constant RG32UI] stores the red and green components on 32 bits.
  324. Every component is stored as an unsigned integer.
  325. <br /><br />
  326. [page:constant RG32F] stores the red and green components on 32 bits.
  327. Every component is stored as floating point.
  328. <br /><br />
  329. [page:constant RGB8] stores the red, green, and blue components on 8 bits each.
  330. [page:constant RGB8_SNORM] stores the red, green, and blue components on 8 bits each.
  331. Every component is stored as normalized.
  332. <br /><br />
  333. [page:constant RGB8I] stores the red, green, and blue components on 8 bits each.
  334. Every component is stored as an integer.
  335. <br /><br />
  336. [page:constant RGB8UI] stores the red, green, and blue components on 8 bits each.
  337. Every component is stored as an unsigned integer.
  338. <br /><br />
  339. [page:constant RGB16I] stores the red, green, and blue components on 16 bits each.
  340. Every component is stored as an integer.
  341. <br /><br />
  342. [page:constant RGB16UI] stores the red, green, and blue components on 16 bits each.
  343. Every component is stored as an unsigned integer.
  344. <br /><br />
  345. [page:constant RGB16F] stores the red, green, and blue components on 16 bits each.
  346. Every component is stored as floating point
  347. <br /><br />
  348. [page:constant RGB32I] stores the red, green, and blue components on 32 bits each.
  349. Every component is stored as an integer.
  350. <br /><br />
  351. [page:constant RGB32UI] stores the red, green, and blue components on 32 bits each.
  352. Every component is stored as an unsigned integer.
  353. <br /><br />
  354. [page:constant RGB32F] stores the red, green, and blue components on 32 bits each.
  355. Every component is stored as floating point
  356. <br /><br />
  357. [page:constant R11F_G11F_B10F] stores the red, green, and blue components respectively on 11 bits, 11 bits, and 10bits.
  358. Every component is stored as floating point.
  359. <br /><br />
  360. [page:constant RGB565] stores the red, green, and blue components respectively on 5 bits, 6 bits, and 5 bits.<br /><br />
  361. [page:constant RGB9_E5] stores the red, green, and blue components on 9 bits each.<br /><br />
  362. [page:constant RGBA8] stores the red, green, blue, and alpha components on 8 bits each.<br /><br />
  363. [page:constant RGBA8_SNORM] stores the red, green, blue, and alpha components on 8 bits.
  364. Every component is stored as normalized.
  365. <br /><br />
  366. [page:constant RGBA8I] stores the red, green, blue, and alpha components on 8 bits each.
  367. Every component is stored as an integer.
  368. <br /><br />
  369. [page:constant RGBA8UI] stores the red, green, blue, and alpha components on 8 bits.
  370. Every component is stored as an unsigned integer.
  371. <br /><br />
  372. [page:constant RGBA16I] stores the red, green, blue, and alpha components on 16 bits.
  373. Every component is stored as an integer.
  374. <br /><br />
  375. [page:constant RGBA16UI] stores the red, green, blue, and alpha components on 16 bits.
  376. Every component is stored as an unsigned integer.
  377. <br /><br />
  378. [page:constant RGBA16F] stores the red, green, blue, and alpha components on 16 bits.
  379. Every component is stored as floating point.
  380. <br /><br />
  381. [page:constant RGBA32I] stores the red, green, blue, and alpha components on 32 bits.
  382. Every component is stored as an integer.
  383. <br /><br />
  384. [page:constant RGBA32UI] stores the red, green, blue, and alpha components on 32 bits.
  385. Every component is stored as an unsigned integer.
  386. <br /><br />
  387. [page:constant RGBA32F] stores the red, green, blue, and alpha components on 32 bits.
  388. Every component is stored as floating point.
  389. <br /><br />
  390. [page:constant RGB5_A1] stores the red, green, blue, and alpha components respectively on 5 bits, 5 bits, 5 bits, and 1 bit.<br /><br />
  391. [page:constant RGB10_A2] stores the red, green, blue, and alpha components respectively on 10 bits, 10 bits, 10 bits and 2 bits.<br /><br />
  392. [page:constant RGB10_A2UI] stores the red, green, blue, and alpha components respectively on 10 bits, 10 bits, 10 bits and 2 bits.
  393. Every component is stored as an unsigned integer.
  394. <br /><br />
  395. [page:constant SRGB8] stores the red, green, and blue components on 8 bits each.<br /><br />
  396. [page:constant SRGB8_ALPHA8] stores the red, green, blue, and alpha components on 8 bits each.<br /><br />
  397. [page:constant DEPTH_COMPONENT16] stores the depth component on 16bits.<br /><br />
  398. [page:constant DEPTH_COMPONENT24] stores the depth component on 24bits.<br /><br />
  399. [page:constant DEPTH_COMPONENT32F] stores the depth component on 32bits. The component is stored as floating point.<br /><br />
  400. [page:constant DEPTH24_STENCIL8] stores the depth, and stencil components respectively on 24 bits and 8 bits.
  401. The stencil component is stored as an unsigned integer.
  402. <br /><br />
  403. [page:constant DEPTH32F_STENCIL8] stores the depth, and stencil components respectively on 32 bits and 8 bits.
  404. The depth component is stored as floating point, and the stencil component as an unsigned integer.
  405. <br /><br />
  406. Note that the texture must have the correct [page:Texture.type type] set,
  407. as well as the correct [page:Texture.format format].
  408. See [link:https://developer.mozilla.org/en/docs/Web/API/WebGLRenderingContext/texImage2D WebGLRenderingContext.texImage2D], and
  409. [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGL2RenderingContext/texImage3D WebGL2RenderingContext.texImage3D],
  410. for more details regarding the possible combination of [page:Texture.format format], [page:Texture.internalFormat internalFormat],
  411. and [page:Texture.type type].<br /><br />
  412. For more in-depth information regarding internal formats, you can also refer directly
  413. to the [link:https://www.khronos.org/registry/webgl/specs/latest/2.0/ WebGL2 Specification] and
  414. to the [link:https://www.khronos.org/registry/OpenGL/specs/es/3.0/es_spec_3.0.pdf OpenGL ES 3.0 Specification].
  415. </p>
  416. <h2>编码</h2>
  417. <code>
  418. THREE.LinearEncoding
  419. THREE.sRGBEncoding
  420. THREE.BasicDepthPacking
  421. THREE.RGBADepthPacking
  422. </code>
  423. <p>
  424. 这些常量用于纹理的[page:Texture.encoding encoding]属性。<br /><br />
  425. 如果编码类型在纹理已被一个材质使用之后发生了改变,
  426. 你需要来设置[page:Material.needsUpdate Material.needsUpdate]为*true*来使得材质重新编译。<br /><br />
  427. [page:constant LinearEncoding]是默认值。
  428. 除此之外的其他值仅在材质的贴图、envMap和emissiveMap中有效。
  429. </p>
  430. <h2>源代码</h2>
  431. <p>
  432. [link:https://github.com/mrdoob/three.js/blob/master/src/constants.js src/constants.js]
  433. </p>
  434. </body>
  435. </html>