WebGLTextures.js 25 KB

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