WebGLTextures.js 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821
  1. /**
  2. * @author mrdoob / http://mrdoob.com/
  3. */
  4. import { LinearFilter, NearestFilter, RGBFormat, RGBAFormat, DepthFormat, DepthStencilFormat, UnsignedShortType, UnsignedIntType, UnsignedInt248Type, FloatType, HalfFloatType, ClampToEdgeWrapping, NearestMipMapLinearFilter, NearestMipMapNearestFilter } from '../../constants.js';
  5. import { _Math } from '../../math/Math.js';
  6. function WebGLTextures( _gl, extensions, state, properties, capabilities, utils, infoMemory ) {
  7. var _isWebGL2 = ( typeof WebGL2RenderingContext !== 'undefined' && _gl instanceof window.WebGL2RenderingContext );
  8. var _videoTextures = {};
  9. //
  10. function clampToMaxSize( image, maxSize ) {
  11. if ( image.width > maxSize || image.height > maxSize ) {
  12. // Warning: Scaling through the canvas will only work with images that use
  13. // premultiplied alpha.
  14. var scale = maxSize / Math.max( image.width, image.height );
  15. var canvas = document.createElementNS( 'http://www.w3.org/1999/xhtml', 'canvas' );
  16. canvas.width = Math.floor( image.width * scale );
  17. canvas.height = Math.floor( image.height * scale );
  18. var context = canvas.getContext( '2d' );
  19. context.drawImage( image, 0, 0, image.width, image.height, 0, 0, canvas.width, canvas.height );
  20. console.warn( 'THREE.WebGLRenderer: image is too big (' + image.width + 'x' + image.height + '). Resized to ' + canvas.width + 'x' + canvas.height, image );
  21. return canvas;
  22. }
  23. return image;
  24. }
  25. function isPowerOfTwo( image ) {
  26. return _Math.isPowerOfTwo( image.width ) && _Math.isPowerOfTwo( image.height );
  27. }
  28. function makePowerOfTwo( image ) {
  29. if ( image instanceof HTMLImageElement || image instanceof HTMLCanvasElement || image instanceof ImageBitmap ) {
  30. var canvas = document.createElementNS( 'http://www.w3.org/1999/xhtml', 'canvas' );
  31. canvas.width = _Math.floorPowerOfTwo( image.width );
  32. canvas.height = _Math.floorPowerOfTwo( image.height );
  33. var context = canvas.getContext( '2d' );
  34. context.drawImage( image, 0, 0, canvas.width, canvas.height );
  35. console.warn( 'THREE.WebGLRenderer: image is not power of two (' + image.width + 'x' + image.height + '). Resized to ' + canvas.width + 'x' + canvas.height, image );
  36. return canvas;
  37. }
  38. return image;
  39. }
  40. function textureNeedsPowerOfTwo( texture ) {
  41. return ( texture.wrapS !== ClampToEdgeWrapping || texture.wrapT !== ClampToEdgeWrapping ) ||
  42. ( texture.minFilter !== NearestFilter && texture.minFilter !== LinearFilter );
  43. }
  44. function textureNeedsGenerateMipmaps( texture, isPowerOfTwo ) {
  45. return texture.generateMipmaps && isPowerOfTwo &&
  46. texture.minFilter !== NearestFilter && texture.minFilter !== LinearFilter;
  47. }
  48. // Fallback filters for non-power-of-2 textures
  49. function filterFallback( f ) {
  50. if ( f === NearestFilter || f === NearestMipMapNearestFilter || f === NearestMipMapLinearFilter ) {
  51. return _gl.NEAREST;
  52. }
  53. return _gl.LINEAR;
  54. }
  55. //
  56. function onTextureDispose( event ) {
  57. var texture = event.target;
  58. texture.removeEventListener( 'dispose', onTextureDispose );
  59. deallocateTexture( texture );
  60. if ( texture.isVideoTexture ) {
  61. delete _videoTextures[ texture.id ];
  62. }
  63. infoMemory.textures --;
  64. }
  65. function onRenderTargetDispose( event ) {
  66. var renderTarget = event.target;
  67. renderTarget.removeEventListener( 'dispose', onRenderTargetDispose );
  68. deallocateRenderTarget( renderTarget );
  69. infoMemory.textures --;
  70. }
  71. //
  72. function deallocateTexture( texture ) {
  73. var textureProperties = properties.get( texture );
  74. if ( texture.image && textureProperties.__image__webglTextureCube ) {
  75. // cube texture
  76. _gl.deleteTexture( textureProperties.__image__webglTextureCube );
  77. } else {
  78. // 2D texture
  79. if ( textureProperties.__webglInit === undefined ) return;
  80. _gl.deleteTexture( textureProperties.__webglTexture );
  81. }
  82. // remove all webgl properties
  83. properties.remove( texture );
  84. }
  85. function deallocateRenderTarget( renderTarget ) {
  86. var renderTargetProperties = properties.get( renderTarget );
  87. var textureProperties = properties.get( renderTarget.texture );
  88. if ( ! renderTarget ) return;
  89. if ( textureProperties.__webglTexture !== undefined ) {
  90. _gl.deleteTexture( textureProperties.__webglTexture );
  91. }
  92. if ( renderTarget.depthTexture ) {
  93. renderTarget.depthTexture.dispose();
  94. }
  95. if ( renderTarget.isWebGLRenderTargetCube ) {
  96. for ( var i = 0; i < 6; i ++ ) {
  97. _gl.deleteFramebuffer( renderTargetProperties.__webglFramebuffer[ i ] );
  98. if ( renderTargetProperties.__webglDepthbuffer ) _gl.deleteRenderbuffer( renderTargetProperties.__webglDepthbuffer[ i ] );
  99. }
  100. } else {
  101. _gl.deleteFramebuffer( renderTargetProperties.__webglFramebuffer );
  102. if ( renderTargetProperties.__webglDepthbuffer ) _gl.deleteRenderbuffer( renderTargetProperties.__webglDepthbuffer );
  103. }
  104. properties.remove( renderTarget.texture );
  105. properties.remove( renderTarget );
  106. }
  107. //
  108. function setTexture2D( texture, slot ) {
  109. var textureProperties = properties.get( texture );
  110. if ( texture.version > 0 && textureProperties.__version !== texture.version ) {
  111. var image = texture.image;
  112. if ( image === undefined ) {
  113. console.warn( 'THREE.WebGLRenderer: Texture marked for update but image is undefined', texture );
  114. } else if ( image.complete === false ) {
  115. console.warn( 'THREE.WebGLRenderer: Texture marked for update but image is incomplete', texture );
  116. } else {
  117. uploadTexture( textureProperties, texture, slot );
  118. return;
  119. }
  120. }
  121. state.activeTexture( _gl.TEXTURE0 + slot );
  122. state.bindTexture( _gl.TEXTURE_2D, textureProperties.__webglTexture );
  123. }
  124. function setTextureCube( texture, slot ) {
  125. var textureProperties = properties.get( texture );
  126. if ( texture.image.length === 6 ) {
  127. if ( texture.version > 0 && textureProperties.__version !== texture.version ) {
  128. if ( ! textureProperties.__image__webglTextureCube ) {
  129. texture.addEventListener( 'dispose', onTextureDispose );
  130. textureProperties.__image__webglTextureCube = _gl.createTexture();
  131. infoMemory.textures ++;
  132. }
  133. state.activeTexture( _gl.TEXTURE0 + slot );
  134. state.bindTexture( _gl.TEXTURE_CUBE_MAP, textureProperties.__image__webglTextureCube );
  135. _gl.pixelStorei( _gl.UNPACK_FLIP_Y_WEBGL, texture.flipY );
  136. var isCompressed = ( texture && texture.isCompressedTexture );
  137. var isDataTexture = ( texture.image[ 0 ] && texture.image[ 0 ].isDataTexture );
  138. var cubeImage = [];
  139. for ( var i = 0; i < 6; i ++ ) {
  140. if ( ! isCompressed && ! isDataTexture ) {
  141. cubeImage[ i ] = clampToMaxSize( texture.image[ i ], capabilities.maxCubemapSize );
  142. } else {
  143. cubeImage[ i ] = isDataTexture ? texture.image[ i ].image : texture.image[ i ];
  144. }
  145. }
  146. var image = cubeImage[ 0 ],
  147. isPowerOfTwoImage = isPowerOfTwo( image ),
  148. glFormat = utils.convert( texture.format ),
  149. glType = utils.convert( texture.type );
  150. setTextureParameters( _gl.TEXTURE_CUBE_MAP, texture, isPowerOfTwoImage );
  151. for ( var i = 0; i < 6; i ++ ) {
  152. if ( ! isCompressed ) {
  153. if ( isDataTexture ) {
  154. state.texImage2D( _gl.TEXTURE_CUBE_MAP_POSITIVE_X + i, 0, glFormat, cubeImage[ i ].width, cubeImage[ i ].height, 0, glFormat, glType, cubeImage[ i ].data );
  155. } else {
  156. state.texImage2D( _gl.TEXTURE_CUBE_MAP_POSITIVE_X + i, 0, glFormat, glFormat, glType, cubeImage[ i ] );
  157. }
  158. } else {
  159. var mipmap, mipmaps = cubeImage[ i ].mipmaps;
  160. for ( var j = 0, jl = mipmaps.length; j < jl; j ++ ) {
  161. mipmap = mipmaps[ j ];
  162. if ( texture.format !== RGBAFormat && texture.format !== RGBFormat ) {
  163. if ( state.getCompressedTextureFormats().indexOf( glFormat ) > - 1 ) {
  164. state.compressedTexImage2D( _gl.TEXTURE_CUBE_MAP_POSITIVE_X + i, j, glFormat, mipmap.width, mipmap.height, 0, mipmap.data );
  165. } else {
  166. console.warn( 'THREE.WebGLRenderer: Attempt to load unsupported compressed texture format in .setTextureCube()' );
  167. }
  168. } else {
  169. state.texImage2D( _gl.TEXTURE_CUBE_MAP_POSITIVE_X + i, j, glFormat, mipmap.width, mipmap.height, 0, glFormat, glType, mipmap.data );
  170. }
  171. }
  172. }
  173. }
  174. if ( textureNeedsGenerateMipmaps( texture, isPowerOfTwoImage ) ) {
  175. _gl.generateMipmap( _gl.TEXTURE_CUBE_MAP );
  176. }
  177. textureProperties.__version = texture.version;
  178. if ( texture.onUpdate ) texture.onUpdate( texture );
  179. } else {
  180. state.activeTexture( _gl.TEXTURE0 + slot );
  181. state.bindTexture( _gl.TEXTURE_CUBE_MAP, textureProperties.__image__webglTextureCube );
  182. }
  183. }
  184. }
  185. function setTextureCubeDynamic( texture, slot ) {
  186. state.activeTexture( _gl.TEXTURE0 + slot );
  187. state.bindTexture( _gl.TEXTURE_CUBE_MAP, properties.get( texture ).__webglTexture );
  188. }
  189. function setTextureParameters( textureType, texture, isPowerOfTwoImage ) {
  190. var extension;
  191. if ( isPowerOfTwoImage ) {
  192. _gl.texParameteri( textureType, _gl.TEXTURE_WRAP_S, utils.convert( texture.wrapS ) );
  193. _gl.texParameteri( textureType, _gl.TEXTURE_WRAP_T, utils.convert( texture.wrapT ) );
  194. _gl.texParameteri( textureType, _gl.TEXTURE_MAG_FILTER, utils.convert( texture.magFilter ) );
  195. _gl.texParameteri( textureType, _gl.TEXTURE_MIN_FILTER, utils.convert( texture.minFilter ) );
  196. } else {
  197. _gl.texParameteri( textureType, _gl.TEXTURE_WRAP_S, _gl.CLAMP_TO_EDGE );
  198. _gl.texParameteri( textureType, _gl.TEXTURE_WRAP_T, _gl.CLAMP_TO_EDGE );
  199. if ( texture.wrapS !== ClampToEdgeWrapping || texture.wrapT !== ClampToEdgeWrapping ) {
  200. console.warn( 'THREE.WebGLRenderer: Texture is not power of two. Texture.wrapS and Texture.wrapT should be set to THREE.ClampToEdgeWrapping.', texture );
  201. }
  202. _gl.texParameteri( textureType, _gl.TEXTURE_MAG_FILTER, filterFallback( texture.magFilter ) );
  203. _gl.texParameteri( textureType, _gl.TEXTURE_MIN_FILTER, filterFallback( texture.minFilter ) );
  204. if ( texture.minFilter !== NearestFilter && texture.minFilter !== LinearFilter ) {
  205. console.warn( 'THREE.WebGLRenderer: Texture is not power of two. Texture.minFilter should be set to THREE.NearestFilter or THREE.LinearFilter.', texture );
  206. }
  207. }
  208. extension = extensions.get( 'EXT_texture_filter_anisotropic' );
  209. if ( extension ) {
  210. if ( texture.type === FloatType && extensions.get( 'OES_texture_float_linear' ) === null ) return;
  211. if ( texture.type === HalfFloatType && extensions.get( 'OES_texture_half_float_linear' ) === null ) return;
  212. if ( texture.anisotropy > 1 || properties.get( texture ).__currentAnisotropy ) {
  213. _gl.texParameterf( textureType, extension.TEXTURE_MAX_ANISOTROPY_EXT, Math.min( texture.anisotropy, capabilities.getMaxAnisotropy() ) );
  214. properties.get( texture ).__currentAnisotropy = texture.anisotropy;
  215. }
  216. }
  217. }
  218. function uploadTexture( textureProperties, texture, slot ) {
  219. if ( textureProperties.__webglInit === undefined ) {
  220. textureProperties.__webglInit = true;
  221. texture.addEventListener( 'dispose', onTextureDispose );
  222. textureProperties.__webglTexture = _gl.createTexture();
  223. if ( texture.isVideoTexture ) {
  224. _videoTextures[ texture.id ] = texture;
  225. }
  226. infoMemory.textures ++;
  227. }
  228. state.activeTexture( _gl.TEXTURE0 + slot );
  229. state.bindTexture( _gl.TEXTURE_2D, textureProperties.__webglTexture );
  230. _gl.pixelStorei( _gl.UNPACK_FLIP_Y_WEBGL, texture.flipY );
  231. _gl.pixelStorei( _gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, texture.premultiplyAlpha );
  232. _gl.pixelStorei( _gl.UNPACK_ALIGNMENT, texture.unpackAlignment );
  233. var image = clampToMaxSize( texture.image, capabilities.maxTextureSize );
  234. if ( textureNeedsPowerOfTwo( texture ) && isPowerOfTwo( image ) === false ) {
  235. image = makePowerOfTwo( image );
  236. }
  237. var isPowerOfTwoImage = isPowerOfTwo( image ),
  238. glFormat = utils.convert( texture.format ),
  239. glType = utils.convert( texture.type );
  240. setTextureParameters( _gl.TEXTURE_2D, texture, isPowerOfTwoImage );
  241. var mipmap, mipmaps = texture.mipmaps;
  242. if ( texture.isDepthTexture ) {
  243. // populate depth texture with dummy data
  244. var internalFormat = _gl.DEPTH_COMPONENT;
  245. if ( texture.type === FloatType ) {
  246. if ( ! _isWebGL2 ) throw new Error( 'Float Depth Texture only supported in WebGL2.0' );
  247. internalFormat = _gl.DEPTH_COMPONENT32F;
  248. } else if ( _isWebGL2 ) {
  249. // WebGL 2.0 requires signed internalformat for glTexImage2D
  250. internalFormat = _gl.DEPTH_COMPONENT16;
  251. }
  252. if ( texture.format === DepthFormat && internalFormat === _gl.DEPTH_COMPONENT ) {
  253. // The error INVALID_OPERATION is generated by texImage2D if format and internalformat are
  254. // DEPTH_COMPONENT and type is not UNSIGNED_SHORT or UNSIGNED_INT
  255. // (https://www.khronos.org/registry/webgl/extensions/WEBGL_depth_texture/)
  256. if ( texture.type !== UnsignedShortType && texture.type !== UnsignedIntType ) {
  257. console.warn( 'THREE.WebGLRenderer: Use UnsignedShortType or UnsignedIntType for DepthFormat DepthTexture.' );
  258. texture.type = UnsignedShortType;
  259. glType = utils.convert( texture.type );
  260. }
  261. }
  262. // Depth stencil textures need the DEPTH_STENCIL internal format
  263. // (https://www.khronos.org/registry/webgl/extensions/WEBGL_depth_texture/)
  264. if ( texture.format === DepthStencilFormat ) {
  265. internalFormat = _gl.DEPTH_STENCIL;
  266. // The error INVALID_OPERATION is generated by texImage2D if format and internalformat are
  267. // DEPTH_STENCIL and type is not UNSIGNED_INT_24_8_WEBGL.
  268. // (https://www.khronos.org/registry/webgl/extensions/WEBGL_depth_texture/)
  269. if ( texture.type !== UnsignedInt248Type ) {
  270. console.warn( 'THREE.WebGLRenderer: Use UnsignedInt248Type for DepthStencilFormat DepthTexture.' );
  271. texture.type = UnsignedInt248Type;
  272. glType = utils.convert( texture.type );
  273. }
  274. }
  275. state.texImage2D( _gl.TEXTURE_2D, 0, internalFormat, image.width, image.height, 0, glFormat, glType, null );
  276. } else if ( texture.isDataTexture ) {
  277. // use manually created mipmaps if available
  278. // if there are no manual mipmaps
  279. // set 0 level mipmap and then use GL to generate other mipmap levels
  280. if ( mipmaps.length > 0 && isPowerOfTwoImage ) {
  281. for ( var i = 0, il = mipmaps.length; i < il; i ++ ) {
  282. mipmap = mipmaps[ i ];
  283. state.texImage2D( _gl.TEXTURE_2D, i, glFormat, mipmap.width, mipmap.height, 0, glFormat, glType, mipmap.data );
  284. }
  285. texture.generateMipmaps = false;
  286. } else {
  287. state.texImage2D( _gl.TEXTURE_2D, 0, glFormat, image.width, image.height, 0, glFormat, glType, image.data );
  288. }
  289. } else if ( texture.isCompressedTexture ) {
  290. for ( var i = 0, il = mipmaps.length; i < il; i ++ ) {
  291. mipmap = mipmaps[ i ];
  292. if ( texture.format !== RGBAFormat && texture.format !== RGBFormat ) {
  293. if ( state.getCompressedTextureFormats().indexOf( glFormat ) > - 1 ) {
  294. state.compressedTexImage2D( _gl.TEXTURE_2D, i, glFormat, mipmap.width, mipmap.height, 0, mipmap.data );
  295. } else {
  296. console.warn( 'THREE.WebGLRenderer: Attempt to load unsupported compressed texture format in .uploadTexture()' );
  297. }
  298. } else {
  299. state.texImage2D( _gl.TEXTURE_2D, i, glFormat, mipmap.width, mipmap.height, 0, glFormat, glType, mipmap.data );
  300. }
  301. }
  302. } else {
  303. // regular Texture (image, video, canvas)
  304. // use manually created mipmaps if available
  305. // if there are no manual mipmaps
  306. // set 0 level mipmap and then use GL to generate other mipmap levels
  307. if ( mipmaps.length > 0 && isPowerOfTwoImage ) {
  308. for ( var i = 0, il = mipmaps.length; i < il; i ++ ) {
  309. mipmap = mipmaps[ i ];
  310. state.texImage2D( _gl.TEXTURE_2D, i, glFormat, glFormat, glType, mipmap );
  311. }
  312. texture.generateMipmaps = false;
  313. } else {
  314. state.texImage2D( _gl.TEXTURE_2D, 0, glFormat, glFormat, glType, image );
  315. }
  316. }
  317. if ( textureNeedsGenerateMipmaps( texture, isPowerOfTwoImage ) ) _gl.generateMipmap( _gl.TEXTURE_2D );
  318. textureProperties.__version = texture.version;
  319. if ( texture.onUpdate ) texture.onUpdate( texture );
  320. }
  321. // Render targets
  322. // Setup storage for target texture and bind it to correct framebuffer
  323. function setupFrameBufferTexture( framebuffer, renderTarget, attachment, textureTarget ) {
  324. var glFormat = utils.convert( renderTarget.texture.format );
  325. var glType = utils.convert( renderTarget.texture.type );
  326. state.texImage2D( textureTarget, 0, glFormat, renderTarget.width, renderTarget.height, 0, glFormat, glType, null );
  327. _gl.bindFramebuffer( _gl.FRAMEBUFFER, framebuffer );
  328. _gl.framebufferTexture2D( _gl.FRAMEBUFFER, attachment, textureTarget, properties.get( renderTarget.texture ).__webglTexture, 0 );
  329. _gl.bindFramebuffer( _gl.FRAMEBUFFER, null );
  330. }
  331. // Setup storage for internal depth/stencil buffers and bind to correct framebuffer
  332. function setupRenderBufferStorage( renderbuffer, renderTarget ) {
  333. _gl.bindRenderbuffer( _gl.RENDERBUFFER, renderbuffer );
  334. if ( renderTarget.depthBuffer && ! renderTarget.stencilBuffer ) {
  335. _gl.renderbufferStorage( _gl.RENDERBUFFER, _gl.DEPTH_COMPONENT16, renderTarget.width, renderTarget.height );
  336. _gl.framebufferRenderbuffer( _gl.FRAMEBUFFER, _gl.DEPTH_ATTACHMENT, _gl.RENDERBUFFER, renderbuffer );
  337. } else if ( renderTarget.depthBuffer && renderTarget.stencilBuffer ) {
  338. _gl.renderbufferStorage( _gl.RENDERBUFFER, _gl.DEPTH_STENCIL, renderTarget.width, renderTarget.height );
  339. _gl.framebufferRenderbuffer( _gl.FRAMEBUFFER, _gl.DEPTH_STENCIL_ATTACHMENT, _gl.RENDERBUFFER, renderbuffer );
  340. } else {
  341. // FIXME: We don't support !depth !stencil
  342. _gl.renderbufferStorage( _gl.RENDERBUFFER, _gl.RGBA4, renderTarget.width, renderTarget.height );
  343. }
  344. _gl.bindRenderbuffer( _gl.RENDERBUFFER, null );
  345. }
  346. // Setup resources for a Depth Texture for a FBO (needs an extension)
  347. function setupDepthTexture( framebuffer, renderTarget ) {
  348. var isCube = ( renderTarget && renderTarget.isWebGLRenderTargetCube );
  349. if ( isCube ) throw new Error( 'Depth Texture with cube render targets is not supported' );
  350. _gl.bindFramebuffer( _gl.FRAMEBUFFER, framebuffer );
  351. if ( ! ( renderTarget.depthTexture && renderTarget.depthTexture.isDepthTexture ) ) {
  352. throw new Error( 'renderTarget.depthTexture must be an instance of THREE.DepthTexture' );
  353. }
  354. // upload an empty depth texture with framebuffer size
  355. if ( ! properties.get( renderTarget.depthTexture ).__webglTexture ||
  356. renderTarget.depthTexture.image.width !== renderTarget.width ||
  357. renderTarget.depthTexture.image.height !== renderTarget.height ) {
  358. renderTarget.depthTexture.image.width = renderTarget.width;
  359. renderTarget.depthTexture.image.height = renderTarget.height;
  360. renderTarget.depthTexture.needsUpdate = true;
  361. }
  362. setTexture2D( renderTarget.depthTexture, 0 );
  363. var webglDepthTexture = properties.get( renderTarget.depthTexture ).__webglTexture;
  364. if ( renderTarget.depthTexture.format === DepthFormat ) {
  365. _gl.framebufferTexture2D( _gl.FRAMEBUFFER, _gl.DEPTH_ATTACHMENT, _gl.TEXTURE_2D, webglDepthTexture, 0 );
  366. } else if ( renderTarget.depthTexture.format === DepthStencilFormat ) {
  367. _gl.framebufferTexture2D( _gl.FRAMEBUFFER, _gl.DEPTH_STENCIL_ATTACHMENT, _gl.TEXTURE_2D, webglDepthTexture, 0 );
  368. } else {
  369. throw new Error( 'Unknown depthTexture format' );
  370. }
  371. }
  372. // Setup GL resources for a non-texture depth buffer
  373. function setupDepthRenderbuffer( renderTarget ) {
  374. var renderTargetProperties = properties.get( renderTarget );
  375. var isCube = ( renderTarget.isWebGLRenderTargetCube === true );
  376. if ( renderTarget.depthTexture ) {
  377. if ( isCube ) throw new Error( 'target.depthTexture not supported in Cube render targets' );
  378. setupDepthTexture( renderTargetProperties.__webglFramebuffer, renderTarget );
  379. } else {
  380. if ( isCube ) {
  381. renderTargetProperties.__webglDepthbuffer = [];
  382. for ( var i = 0; i < 6; i ++ ) {
  383. _gl.bindFramebuffer( _gl.FRAMEBUFFER, renderTargetProperties.__webglFramebuffer[ i ] );
  384. renderTargetProperties.__webglDepthbuffer[ i ] = _gl.createRenderbuffer();
  385. setupRenderBufferStorage( renderTargetProperties.__webglDepthbuffer[ i ], renderTarget );
  386. }
  387. } else {
  388. _gl.bindFramebuffer( _gl.FRAMEBUFFER, renderTargetProperties.__webglFramebuffer );
  389. renderTargetProperties.__webglDepthbuffer = _gl.createRenderbuffer();
  390. setupRenderBufferStorage( renderTargetProperties.__webglDepthbuffer, renderTarget );
  391. }
  392. }
  393. _gl.bindFramebuffer( _gl.FRAMEBUFFER, null );
  394. }
  395. // Set up GL resources for the render target
  396. function setupRenderTarget( renderTarget ) {
  397. var renderTargetProperties = properties.get( renderTarget );
  398. var textureProperties = properties.get( renderTarget.texture );
  399. renderTarget.addEventListener( 'dispose', onRenderTargetDispose );
  400. textureProperties.__webglTexture = _gl.createTexture();
  401. infoMemory.textures ++;
  402. var isCube = ( renderTarget.isWebGLRenderTargetCube === true );
  403. var isTargetPowerOfTwo = isPowerOfTwo( renderTarget );
  404. // Setup framebuffer
  405. if ( isCube ) {
  406. renderTargetProperties.__webglFramebuffer = [];
  407. for ( var i = 0; i < 6; i ++ ) {
  408. renderTargetProperties.__webglFramebuffer[ i ] = _gl.createFramebuffer();
  409. }
  410. } else {
  411. renderTargetProperties.__webglFramebuffer = _gl.createFramebuffer();
  412. }
  413. // Setup color buffer
  414. if ( isCube ) {
  415. state.bindTexture( _gl.TEXTURE_CUBE_MAP, textureProperties.__webglTexture );
  416. setTextureParameters( _gl.TEXTURE_CUBE_MAP, renderTarget.texture, isTargetPowerOfTwo );
  417. for ( var i = 0; i < 6; i ++ ) {
  418. setupFrameBufferTexture( renderTargetProperties.__webglFramebuffer[ i ], renderTarget, _gl.COLOR_ATTACHMENT0, _gl.TEXTURE_CUBE_MAP_POSITIVE_X + i );
  419. }
  420. if ( textureNeedsGenerateMipmaps( renderTarget.texture, isTargetPowerOfTwo ) ) _gl.generateMipmap( _gl.TEXTURE_CUBE_MAP );
  421. state.bindTexture( _gl.TEXTURE_CUBE_MAP, null );
  422. } else {
  423. state.bindTexture( _gl.TEXTURE_2D, textureProperties.__webglTexture );
  424. setTextureParameters( _gl.TEXTURE_2D, renderTarget.texture, isTargetPowerOfTwo );
  425. setupFrameBufferTexture( renderTargetProperties.__webglFramebuffer, renderTarget, _gl.COLOR_ATTACHMENT0, _gl.TEXTURE_2D );
  426. if ( textureNeedsGenerateMipmaps( renderTarget.texture, isTargetPowerOfTwo ) ) _gl.generateMipmap( _gl.TEXTURE_2D );
  427. state.bindTexture( _gl.TEXTURE_2D, null );
  428. }
  429. // Setup depth and stencil buffers
  430. if ( renderTarget.depthBuffer ) {
  431. setupDepthRenderbuffer( renderTarget );
  432. }
  433. }
  434. function updateRenderTargetMipmap( renderTarget ) {
  435. var texture = renderTarget.texture;
  436. var isTargetPowerOfTwo = isPowerOfTwo( renderTarget );
  437. if ( textureNeedsGenerateMipmaps( texture, isTargetPowerOfTwo ) ) {
  438. var target = renderTarget.isWebGLRenderTargetCube ? _gl.TEXTURE_CUBE_MAP : _gl.TEXTURE_2D;
  439. var webglTexture = properties.get( texture ).__webglTexture;
  440. state.bindTexture( target, webglTexture );
  441. _gl.generateMipmap( target );
  442. state.bindTexture( target, null );
  443. }
  444. }
  445. function updateVideoTextures() {
  446. for ( var id in _videoTextures ) {
  447. _videoTextures[ id ].update();
  448. }
  449. }
  450. this.setTexture2D = setTexture2D;
  451. this.setTextureCube = setTextureCube;
  452. this.setTextureCubeDynamic = setTextureCubeDynamic;
  453. this.setupRenderTarget = setupRenderTarget;
  454. this.updateRenderTargetMipmap = updateRenderTargetMipmap;
  455. this.updateVideoTextures = updateVideoTextures;
  456. }
  457. export { WebGLTextures };