WebGPUTextureUtils.js 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849
  1. import {
  2. GPUTextureFormat, GPUAddressMode, GPUFilterMode, GPUTextureDimension, GPUFeatureName
  3. } from './WebGPUConstants.js';
  4. import {
  5. CubeTexture, Texture,
  6. NearestFilter, NearestMipmapNearestFilter, NearestMipmapLinearFilter,
  7. RepeatWrapping, MirroredRepeatWrapping,
  8. RGB_ETC2_Format, RGBA_ETC2_EAC_Format,
  9. RGBAFormat, RedFormat, RGFormat, RGBA_S3TC_DXT1_Format, RGBA_S3TC_DXT3_Format, RGBA_S3TC_DXT5_Format, UnsignedByteType, FloatType, HalfFloatType, SRGBColorSpace, DepthFormat, DepthStencilFormat,
  10. RGBA_ASTC_4x4_Format, RGBA_ASTC_5x4_Format, RGBA_ASTC_5x5_Format, RGBA_ASTC_6x5_Format, RGBA_ASTC_6x6_Format, RGBA_ASTC_8x5_Format, RGBA_ASTC_8x6_Format, RGBA_ASTC_8x8_Format, RGBA_ASTC_10x5_Format,
  11. RGBA_ASTC_10x6_Format, RGBA_ASTC_10x8_Format, RGBA_ASTC_10x10_Format, RGBA_ASTC_12x10_Format, RGBA_ASTC_12x12_Format, UnsignedIntType, UnsignedShortType, UnsignedInt248Type,
  12. NeverCompare, AlwaysCompare, LessCompare, LessEqualCompare, EqualCompare, GreaterEqualCompare, GreaterCompare, NotEqualCompare
  13. } from 'three';
  14. import { CubeReflectionMapping, CubeRefractionMapping, EquirectangularReflectionMapping, EquirectangularRefractionMapping } from 'three';
  15. import WebGPUTextureMipmapUtils from './WebGPUTextureMipmapUtils.js';
  16. const _compareToWebGPU = {
  17. [ NeverCompare ]: 'never',
  18. [ LessCompare ]: 'less',
  19. [ EqualCompare ]: 'equal',
  20. [ LessEqualCompare ]: 'less-equal',
  21. [ GreaterCompare ]: 'greater',
  22. [ GreaterEqualCompare ]: 'greater-equal',
  23. [ AlwaysCompare ]: 'always',
  24. [ NotEqualCompare ]: 'not-equal'
  25. };
  26. class WebGPUTextureUtils {
  27. constructor( backend ) {
  28. this.backend = backend;
  29. this.mipmapUtils = null;
  30. this.defaultTexture = null;
  31. this.defaultCubeTexture = null;
  32. }
  33. createSampler( texture ) {
  34. const backend = this.backend;
  35. const device = backend.device;
  36. const textureGPU = backend.get( texture );
  37. const samplerDescriptorGPU = {
  38. addressModeU: this._convertAddressMode( texture.wrapS ),
  39. addressModeV: this._convertAddressMode( texture.wrapT ),
  40. addressModeW: this._convertAddressMode( texture.wrapR ),
  41. magFilter: this._convertFilterMode( texture.magFilter ),
  42. minFilter: this._convertFilterMode( texture.minFilter ),
  43. mipmapFilter: this._convertFilterMode( texture.minFilter ),
  44. maxAnisotropy: texture.anisotropy
  45. };
  46. if ( texture.isDepthTexture && texture.compareFunction !== null ) {
  47. samplerDescriptorGPU.compare = _compareToWebGPU[ texture.compareFunction ];
  48. }
  49. textureGPU.sampler = device.createSampler( samplerDescriptorGPU );
  50. }
  51. createDefaultTexture( texture ) {
  52. let textureGPU;
  53. if ( texture.isCubeTexture ) {
  54. textureGPU = this._getDefaultCubeTextureGPU();
  55. } else {
  56. textureGPU = this._getDefaultTextureGPU();
  57. }
  58. this.backend.get( texture ).texture = textureGPU;
  59. }
  60. createTexture( texture, options = {} ) {
  61. const backend = this.backend;
  62. const textureData = backend.get( texture );
  63. if ( textureData.initialized ) {
  64. throw new Error( 'WebGPUTextureUtils: Texture already initialized.' );
  65. }
  66. if ( options.needsMipmaps === undefined ) options.needsMipmaps = false;
  67. if ( options.levels === undefined ) options.levels = 1;
  68. if ( options.depth === undefined ) options.depth = 1;
  69. const { width, height, depth, levels } = options;
  70. const dimension = this._getDimension( texture );
  71. const format = texture.internalFormat || this._getFormat( texture );
  72. const sampleCount = options.sampleCount !== undefined ? options.sampleCount : 1;
  73. const primarySampleCount = texture.isRenderTargetTexture ? 1 : sampleCount;
  74. let usage = GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST | GPUTextureUsage.COPY_SRC;
  75. if ( texture.isCompressedTexture !== true ) {
  76. usage |= GPUTextureUsage.RENDER_ATTACHMENT;
  77. }
  78. const textureDescriptorGPU = {
  79. label: texture.name,
  80. size: {
  81. width: width,
  82. height: height,
  83. depthOrArrayLayers: depth,
  84. },
  85. mipLevelCount: levels,
  86. sampleCount: primarySampleCount,
  87. dimension: dimension,
  88. format: format,
  89. usage: usage
  90. };
  91. // texture creation
  92. if ( texture.isVideoTexture ) {
  93. const video = texture.source.data;
  94. const videoFrame = new VideoFrame( video );
  95. textureDescriptorGPU.size.width = videoFrame.displayWidth;
  96. textureDescriptorGPU.size.height = videoFrame.displayHeight;
  97. videoFrame.close();
  98. textureData.externalTexture = video;
  99. } else {
  100. if ( format === undefined ) {
  101. console.warn( 'WebGPURenderer: Texture format not supported.' );
  102. return this.createDefaultTexture( texture );
  103. }
  104. textureData.texture = backend.device.createTexture( textureDescriptorGPU );
  105. }
  106. if ( texture.isRenderTargetTexture && sampleCount > 1 ) {
  107. const msaaTextureDescriptorGPU = Object.assign( {}, textureDescriptorGPU );
  108. msaaTextureDescriptorGPU.label = msaaTextureDescriptorGPU.label + '-msaa';
  109. msaaTextureDescriptorGPU.sampleCount = sampleCount;
  110. textureData.msaaTexture = backend.device.createTexture( msaaTextureDescriptorGPU );
  111. }
  112. textureData.initialized = true;
  113. textureData.textureDescriptorGPU = textureDescriptorGPU;
  114. }
  115. destroyTexture( texture ) {
  116. const backend = this.backend;
  117. const textureData = backend.get( texture );
  118. textureData.texture.destroy();
  119. if ( textureData.msaaTexture !== undefined ) textureData.msaaTexture.destroy();
  120. backend.delete( texture );
  121. }
  122. destroySampler( texture ) {
  123. const backend = this.backend;
  124. const textureData = backend.get( texture );
  125. delete textureData.sampler;
  126. }
  127. generateMipmaps( texture ) {
  128. const textureData = this.backend.get( texture );
  129. if ( texture.isCubeTexture ) {
  130. for ( let i = 0; i < 6; i ++ ) {
  131. this._generateMipmaps( textureData.texture, textureData.textureDescriptorGPU, i );
  132. }
  133. } else {
  134. this._generateMipmaps( textureData.texture, textureData.textureDescriptorGPU );
  135. }
  136. }
  137. updateTexture( texture, options ) {
  138. const textureData = this.backend.get( texture );
  139. const { textureDescriptorGPU } = textureData;
  140. if ( texture.isRenderTargetTexture || ( textureDescriptorGPU === undefined /* unsupported texture format */ ) )
  141. return;
  142. // transfer texture data
  143. if ( texture.isDataTexture || texture.isDataArrayTexture || texture.isData3DTexture ) {
  144. this._copyBufferToTexture( options.image, textureData.texture, textureDescriptorGPU );
  145. } else if ( texture.isCompressedTexture ) {
  146. this._copyCompressedBufferToTexture( texture.mipmaps, textureData.texture, textureDescriptorGPU );
  147. } else if ( texture.isCubeTexture ) {
  148. this._copyCubeMapToTexture( options.images, texture, textureData.texture, textureDescriptorGPU );
  149. } else if ( texture.isVideoTexture ) {
  150. const video = texture.source.data;
  151. textureData.externalTexture = video;
  152. } else {
  153. this._copyImageToTexture( options.image, textureData.texture );
  154. }
  155. //
  156. textureData.version = texture.version;
  157. if ( texture.onUpdate ) texture.onUpdate( texture );
  158. }
  159. async copyTextureToBuffer( texture, x, y, width, height ) {
  160. const device = this.backend.device;
  161. const textureData = this.backend.get( texture );
  162. const textureGPU = textureData.texture;
  163. const format = textureData.textureDescriptorGPU.format;
  164. const bytesPerTexel = this._getBytesPerTexel( format );
  165. const readBuffer = device.createBuffer(
  166. {
  167. size: width * height * bytesPerTexel,
  168. usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ
  169. }
  170. );
  171. const encoder = device.createCommandEncoder();
  172. encoder.copyTextureToBuffer(
  173. {
  174. texture: textureGPU,
  175. origin: { x, y },
  176. },
  177. {
  178. buffer: readBuffer,
  179. bytesPerRow: width * bytesPerTexel
  180. },
  181. {
  182. width: width,
  183. height: height
  184. }
  185. );
  186. const typedArrayType = this._getTypedArrayType( format );
  187. device.queue.submit( [ encoder.finish() ] );
  188. await readBuffer.mapAsync( GPUMapMode.READ );
  189. const buffer = readBuffer.getMappedRange();
  190. return new typedArrayType( buffer );
  191. }
  192. _isEnvironmentTexture( texture ) {
  193. const mapping = texture.mapping;
  194. return ( mapping === EquirectangularReflectionMapping || mapping === EquirectangularRefractionMapping ) || ( mapping === CubeReflectionMapping || mapping === CubeRefractionMapping );
  195. }
  196. _getDefaultTextureGPU() {
  197. let defaultTexture = this.defaultTexture;
  198. if ( defaultTexture === null ) {
  199. const texture = new Texture();
  200. texture.minFilter = NearestFilter;
  201. texture.magFilter = NearestFilter;
  202. this.createTexture( texture, { width: 1, height: 1 } );
  203. this.defaultTexture = defaultTexture = texture;
  204. }
  205. return this.backend.get( defaultTexture ).texture;
  206. }
  207. _getDefaultCubeTextureGPU() {
  208. let defaultCubeTexture = this.defaultTexture;
  209. if ( defaultCubeTexture === null ) {
  210. const texture = new CubeTexture();
  211. texture.minFilter = NearestFilter;
  212. texture.magFilter = NearestFilter;
  213. this.createTexture( texture, { width: 1, height: 1, depth: 6 } );
  214. this.defaultCubeTexture = defaultCubeTexture = texture;
  215. }
  216. return this.backend.get( defaultCubeTexture ).texture;
  217. }
  218. _copyCubeMapToTexture( images, texture, textureGPU, textureDescriptorGPU ) {
  219. for ( let i = 0; i < 6; i ++ ) {
  220. const image = images[ i ];
  221. if ( image.isDataTexture ) {
  222. this._copyBufferToTexture( image.image, textureGPU, textureDescriptorGPU, i );
  223. } else {
  224. this._copyImageToTexture( image, textureGPU, i );
  225. }
  226. }
  227. }
  228. _copyImageToTexture( image, textureGPU, originDepth = 0 ) {
  229. const device = this.backend.device;
  230. device.queue.copyExternalImageToTexture(
  231. {
  232. source: image
  233. }, {
  234. texture: textureGPU,
  235. mipLevel: 0,
  236. origin: { x: 0, y: 0, z: originDepth }
  237. }, {
  238. width: image.width,
  239. height: image.height,
  240. depthOrArrayLayers: 1
  241. }
  242. );
  243. }
  244. _generateMipmaps( textureGPU, textureDescriptorGPU, baseArrayLayer = 0 ) {
  245. if ( this.mipmapUtils === null ) {
  246. this.mipmapUtils = new WebGPUTextureMipmapUtils( this.backend.device );
  247. }
  248. this.mipmapUtils.generateMipmaps( textureGPU, textureDescriptorGPU, baseArrayLayer );
  249. }
  250. _copyBufferToTexture( image, textureGPU, textureDescriptorGPU, originDepth = 0 ) {
  251. // @TODO: Consider to use GPUCommandEncoder.copyBufferToTexture()
  252. // @TODO: Consider to support valid buffer layouts with other formats like RGB
  253. const device = this.backend.device;
  254. const data = image.data;
  255. const bytesPerTexel = this._getBytesPerTexel( textureDescriptorGPU.format );
  256. const bytesPerRow = image.width * bytesPerTexel;
  257. device.queue.writeTexture(
  258. {
  259. texture: textureGPU,
  260. mipLevel: 0,
  261. origin: { x: 0, y: 0, z: originDepth }
  262. },
  263. data,
  264. {
  265. offset: 0,
  266. bytesPerRow
  267. },
  268. {
  269. width: image.width,
  270. height: image.height,
  271. depthOrArrayLayers: ( image.depth !== undefined ) ? image.depth : 1
  272. } );
  273. }
  274. _copyCompressedBufferToTexture( mipmaps, textureGPU, textureDescriptorGPU ) {
  275. // @TODO: Consider to use GPUCommandEncoder.copyBufferToTexture()
  276. const device = this.backend.device;
  277. const blockData = this._getBlockData( textureDescriptorGPU.format );
  278. for ( let i = 0; i < mipmaps.length; i ++ ) {
  279. const mipmap = mipmaps[ i ];
  280. const width = mipmap.width;
  281. const height = mipmap.height;
  282. const bytesPerRow = Math.ceil( width / blockData.width ) * blockData.byteLength;
  283. device.queue.writeTexture(
  284. {
  285. texture: textureGPU,
  286. mipLevel: i
  287. },
  288. mipmap.data,
  289. {
  290. offset: 0,
  291. bytesPerRow
  292. },
  293. {
  294. width: Math.ceil( width / blockData.width ) * blockData.width,
  295. height: Math.ceil( height / blockData.width ) * blockData.width,
  296. depthOrArrayLayers: 1
  297. }
  298. );
  299. }
  300. }
  301. _getBlockData( format ) {
  302. // this method is only relevant for compressed texture formats
  303. if ( format === GPUTextureFormat.BC1RGBAUnorm || format === GPUTextureFormat.BC1RGBAUnormSRGB ) return { byteLength: 8, width: 4, height: 4 }; // DXT1
  304. if ( format === GPUTextureFormat.BC2RGBAUnorm || format === GPUTextureFormat.BC2RGBAUnormSRGB ) return { byteLength: 16, width: 4, height: 4 }; // DXT3
  305. if ( format === GPUTextureFormat.BC3RGBAUnorm || format === GPUTextureFormat.BC3RGBAUnormSRGB ) return { byteLength: 16, width: 4, height: 4 }; // DXT5
  306. if ( format === GPUTextureFormat.BC4RUnorm || format === GPUTextureFormat.BC4RSNorm ) return { byteLength: 8, width: 4, height: 4 }; // RGTC1
  307. if ( format === GPUTextureFormat.BC5RGUnorm || format === GPUTextureFormat.BC5RGSnorm ) return { byteLength: 16, width: 4, height: 4 }; // RGTC2
  308. if ( format === GPUTextureFormat.BC6HRGBUFloat || format === GPUTextureFormat.BC6HRGBFloat ) return { byteLength: 16, width: 4, height: 4 }; // BPTC (float)
  309. if ( format === GPUTextureFormat.BC7RGBAUnorm || format === GPUTextureFormat.BC7RGBAUnormSRGB ) return { byteLength: 16, width: 4, height: 4 }; // BPTC (unorm)
  310. if ( format === GPUTextureFormat.ETC2RGB8Unorm || format === GPUTextureFormat.ETC2RGB8UnormSRGB ) return { byteLength: 8, width: 4, height: 4 };
  311. if ( format === GPUTextureFormat.ETC2RGB8A1Unorm || format === GPUTextureFormat.ETC2RGB8A1UnormSRGB ) return { byteLength: 8, width: 4, height: 4 };
  312. if ( format === GPUTextureFormat.ETC2RGBA8Unorm || format === GPUTextureFormat.ETC2RGBA8UnormSRGB ) return { byteLength: 16, width: 4, height: 4 };
  313. if ( format === GPUTextureFormat.EACR11Unorm ) return { byteLength: 8, width: 4, height: 4 };
  314. if ( format === GPUTextureFormat.EACR11Snorm ) return { byteLength: 8, width: 4, height: 4 };
  315. if ( format === GPUTextureFormat.EACRG11Unorm ) return { byteLength: 16, width: 4, height: 4 };
  316. if ( format === GPUTextureFormat.EACRG11Snorm ) return { byteLength: 16, width: 4, height: 4 };
  317. if ( format === GPUTextureFormat.ASTC4x4Unorm || format === GPUTextureFormat.ASTC4x4UnormSRGB ) return { byteLength: 16, width: 4, height: 4 };
  318. if ( format === GPUTextureFormat.ASTC5x4Unorm || format === GPUTextureFormat.ASTC5x4UnormSRGB ) return { byteLength: 16, width: 5, height: 4 };
  319. if ( format === GPUTextureFormat.ASTC5x5Unorm || format === GPUTextureFormat.ASTC5x5UnormSRGB ) return { byteLength: 16, width: 5, height: 5 };
  320. if ( format === GPUTextureFormat.ASTC6x5Unorm || format === GPUTextureFormat.ASTC6x5UnormSRGB ) return { byteLength: 16, width: 6, height: 5 };
  321. if ( format === GPUTextureFormat.ASTC6x6Unorm || format === GPUTextureFormat.ASTC6x6UnormSRGB ) return { byteLength: 16, width: 6, height: 6 };
  322. if ( format === GPUTextureFormat.ASTC8x5Unorm || format === GPUTextureFormat.ASTC8x5UnormSRGB ) return { byteLength: 16, width: 8, height: 5 };
  323. if ( format === GPUTextureFormat.ASTC8x6Unorm || format === GPUTextureFormat.ASTC8x6UnormSRGB ) return { byteLength: 16, width: 8, height: 6 };
  324. if ( format === GPUTextureFormat.ASTC8x8Unorm || format === GPUTextureFormat.ASTC8x8UnormSRGB ) return { byteLength: 16, width: 8, height: 8 };
  325. if ( format === GPUTextureFormat.ASTC10x5Unorm || format === GPUTextureFormat.ASTC10x5UnormSRGB ) return { byteLength: 16, width: 10, height: 5 };
  326. if ( format === GPUTextureFormat.ASTC10x6Unorm || format === GPUTextureFormat.ASTC10x6UnormSRGB ) return { byteLength: 16, width: 10, height: 6 };
  327. if ( format === GPUTextureFormat.ASTC10x8Unorm || format === GPUTextureFormat.ASTC10x8UnormSRGB ) return { byteLength: 16, width: 10, height: 8 };
  328. if ( format === GPUTextureFormat.ASTC10x10Unorm || format === GPUTextureFormat.ASTC10x10UnormSRGB ) return { byteLength: 16, width: 10, height: 10 };
  329. if ( format === GPUTextureFormat.ASTC12x10Unorm || format === GPUTextureFormat.ASTC12x10UnormSRGB ) return { byteLength: 16, width: 12, height: 10 };
  330. if ( format === GPUTextureFormat.ASTC12x12Unorm || format === GPUTextureFormat.ASTC12x12UnormSRGB ) return { byteLength: 16, width: 12, height: 12 };
  331. }
  332. _convertAddressMode( value ) {
  333. let addressMode = GPUAddressMode.ClampToEdge;
  334. if ( value === RepeatWrapping ) {
  335. addressMode = GPUAddressMode.Repeat;
  336. } else if ( value === MirroredRepeatWrapping ) {
  337. addressMode = GPUAddressMode.MirrorRepeat;
  338. }
  339. return addressMode;
  340. }
  341. _convertFilterMode( value ) {
  342. let filterMode = GPUFilterMode.Linear;
  343. if ( value === NearestFilter || value === NearestMipmapNearestFilter || value === NearestMipmapLinearFilter ) {
  344. filterMode = GPUFilterMode.Nearest;
  345. }
  346. return filterMode;
  347. }
  348. _getBytesPerTexel( format ) {
  349. if ( format === GPUTextureFormat.R8Unorm ) return 1;
  350. if ( format === GPUTextureFormat.R16Float ) return 2;
  351. if ( format === GPUTextureFormat.RG8Unorm ) return 2;
  352. if ( format === GPUTextureFormat.RG16Float ) return 4;
  353. if ( format === GPUTextureFormat.R32Float ) return 4;
  354. if ( format === GPUTextureFormat.RGBA8Unorm || format === GPUTextureFormat.RGBA8UnormSRGB ) return 4;
  355. if ( format === GPUTextureFormat.RG32Float ) return 8;
  356. if ( format === GPUTextureFormat.RGBA16Float ) return 8;
  357. if ( format === GPUTextureFormat.RGBA32Float ) return 16;
  358. }
  359. _getTypedArrayType( format ) {
  360. if ( format === GPUTextureFormat.R8Uint ) return Uint8Array;
  361. if ( format === GPUTextureFormat.R8Sint ) return Int8Array;
  362. if ( format === GPUTextureFormat.R8Unorm ) return Uint8Array;
  363. if ( format === GPUTextureFormat.R8Snorm ) return Int8Array;
  364. if ( format === GPUTextureFormat.RG8Uint ) return Uint8Array;
  365. if ( format === GPUTextureFormat.RG8Sint ) return Int8Array;
  366. if ( format === GPUTextureFormat.RG8Unorm ) return Uint8Array;
  367. if ( format === GPUTextureFormat.RG8Snorm ) return Int8Array;
  368. if ( format === GPUTextureFormat.RGBA8Uint ) return Uint8Array;
  369. if ( format === GPUTextureFormat.RGBA8Sint ) return Int8Array;
  370. if ( format === GPUTextureFormat.RGBA8Unorm ) return Uint8Array;
  371. if ( format === GPUTextureFormat.RGBA8Snorm ) return Int8Array;
  372. if ( format === GPUTextureFormat.R16Uint ) return Uint16Array;
  373. if ( format === GPUTextureFormat.R16Sint ) return Int16Array;
  374. if ( format === GPUTextureFormat.RG16Uint ) return Uint16Array;
  375. if ( format === GPUTextureFormat.RG16Sint ) return Int16Array;
  376. if ( format === GPUTextureFormat.RGBA16Uint ) return Uint16Array;
  377. if ( format === GPUTextureFormat.RGBA16Sint ) return Int16Array;
  378. if ( format === GPUTextureFormat.R32Uint ) return Uint32Array;
  379. if ( format === GPUTextureFormat.R32Sint ) return Int32Array;
  380. if ( format === GPUTextureFormat.R32Float ) return Float32Array;
  381. if ( format === GPUTextureFormat.RG32Uint ) return Uint32Array;
  382. if ( format === GPUTextureFormat.RG32Sint ) return Int32Array;
  383. if ( format === GPUTextureFormat.RG32Float ) return Float32Array;
  384. if ( format === GPUTextureFormat.RGBA32Uint ) return Uint32Array;
  385. if ( format === GPUTextureFormat.RGBA32Sint ) return Int32Array;
  386. if ( format === GPUTextureFormat.RGBA32Float ) return Float32Array;
  387. }
  388. _getDimension( texture ) {
  389. let dimension;
  390. if ( texture.isData3DTexture ) {
  391. dimension = GPUTextureDimension.ThreeD;
  392. } else {
  393. dimension = GPUTextureDimension.TwoD;
  394. }
  395. return dimension;
  396. }
  397. _getFormat( texture ) {
  398. const format = texture.format;
  399. const type = texture.type;
  400. const colorSpace = texture.colorSpace;
  401. let formatGPU;
  402. if ( /*texture.isRenderTargetTexture === true ||*/ texture.isFramebufferTexture === true ) {
  403. formatGPU = GPUTextureFormat.BGRA8Unorm;
  404. } else if ( texture.isCompressedTexture === true ) {
  405. switch ( format ) {
  406. case RGBA_S3TC_DXT1_Format:
  407. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.BC1RGBAUnormSRGB : GPUTextureFormat.BC1RGBAUnorm;
  408. break;
  409. case RGBA_S3TC_DXT3_Format:
  410. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.BC2RGBAUnormSRGB : GPUTextureFormat.BC2RGBAUnorm;
  411. break;
  412. case RGBA_S3TC_DXT5_Format:
  413. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.BC3RGBAUnormSRGB : GPUTextureFormat.BC3RGBAUnorm;
  414. break;
  415. case RGB_ETC2_Format:
  416. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ETC2RGB8UnormSRGB : GPUTextureFormat.ETC2RGB8Unorm;
  417. break;
  418. case RGBA_ETC2_EAC_Format:
  419. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ETC2RGBA8UnormSRGB : GPUTextureFormat.ETC2RGBA8Unorm;
  420. break;
  421. case RGBA_ASTC_4x4_Format:
  422. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC4x4UnormSRGB : GPUTextureFormat.ASTC4x4Unorm;
  423. break;
  424. case RGBA_ASTC_5x4_Format:
  425. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC5x4UnormSRGB : GPUTextureFormat.ASTC5x4Unorm;
  426. break;
  427. case RGBA_ASTC_5x5_Format:
  428. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC5x5UnormSRGB : GPUTextureFormat.ASTC5x5Unorm;
  429. break;
  430. case RGBA_ASTC_6x5_Format:
  431. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC6x5UnormSRGB : GPUTextureFormat.ASTC6x5Unorm;
  432. break;
  433. case RGBA_ASTC_6x6_Format:
  434. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC6x6UnormSRGB : GPUTextureFormat.ASTC6x6Unorm;
  435. break;
  436. case RGBA_ASTC_8x5_Format:
  437. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC8x5UnormSRGB : GPUTextureFormat.ASTC8x5Unorm;
  438. break;
  439. case RGBA_ASTC_8x6_Format:
  440. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC8x6UnormSRGB : GPUTextureFormat.ASTC8x6Unorm;
  441. break;
  442. case RGBA_ASTC_8x8_Format:
  443. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC8x8UnormSRGB : GPUTextureFormat.ASTC8x8Unorm;
  444. break;
  445. case RGBA_ASTC_10x5_Format:
  446. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC10x5UnormSRGB : GPUTextureFormat.ASTC10x5Unorm;
  447. break;
  448. case RGBA_ASTC_10x6_Format:
  449. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC10x6UnormSRGB : GPUTextureFormat.ASTC10x6Unorm;
  450. break;
  451. case RGBA_ASTC_10x8_Format:
  452. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC10x8UnormSRGB : GPUTextureFormat.ASTC10x8Unorm;
  453. break;
  454. case RGBA_ASTC_10x10_Format:
  455. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC10x10UnormSRGB : GPUTextureFormat.ASTC10x10Unorm;
  456. break;
  457. case RGBA_ASTC_12x10_Format:
  458. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC12x10UnormSRGB : GPUTextureFormat.ASTC12x10Unorm;
  459. break;
  460. case RGBA_ASTC_12x12_Format:
  461. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.ASTC12x12UnormSRGB : GPUTextureFormat.ASTC12x12Unorm;
  462. break;
  463. default:
  464. console.error( 'WebGPURenderer: Unsupported texture format.', format );
  465. }
  466. } else {
  467. switch ( format ) {
  468. case RGBAFormat:
  469. switch ( type ) {
  470. case UnsignedByteType:
  471. formatGPU = ( colorSpace === SRGBColorSpace ) ? GPUTextureFormat.RGBA8UnormSRGB : GPUTextureFormat.RGBA8Unorm;
  472. break;
  473. case HalfFloatType:
  474. formatGPU = GPUTextureFormat.RGBA16Float;
  475. break;
  476. case FloatType:
  477. formatGPU = GPUTextureFormat.RGBA32Float;
  478. break;
  479. default:
  480. console.error( 'WebGPURenderer: Unsupported texture type with RGBAFormat.', type );
  481. }
  482. break;
  483. case RedFormat:
  484. switch ( type ) {
  485. case UnsignedByteType:
  486. formatGPU = GPUTextureFormat.R8Unorm;
  487. break;
  488. case HalfFloatType:
  489. formatGPU = GPUTextureFormat.R16Float;
  490. break;
  491. case FloatType:
  492. formatGPU = GPUTextureFormat.R32Float;
  493. break;
  494. default:
  495. console.error( 'WebGPURenderer: Unsupported texture type with RedFormat.', type );
  496. }
  497. break;
  498. case RGFormat:
  499. switch ( type ) {
  500. case UnsignedByteType:
  501. formatGPU = GPUTextureFormat.RG8Unorm;
  502. break;
  503. case HalfFloatType:
  504. formatGPU = GPUTextureFormat.RG16Float;
  505. break;
  506. case FloatType:
  507. formatGPU = GPUTextureFormat.RG32Float;
  508. break;
  509. default:
  510. console.error( 'WebGPURenderer: Unsupported texture type with RGFormat.', type );
  511. }
  512. break;
  513. case DepthFormat:
  514. switch ( type ) {
  515. case UnsignedShortType:
  516. formatGPU = GPUTextureFormat.Depth16Unorm;
  517. break;
  518. case UnsignedIntType:
  519. formatGPU = GPUTextureFormat.Depth24Plus;
  520. break;
  521. case FloatType:
  522. formatGPU = GPUTextureFormat.Depth32Float;
  523. break;
  524. default:
  525. console.error( 'WebGPURenderer: Unsupported texture type with DepthFormat.', type );
  526. }
  527. break;
  528. case DepthStencilFormat:
  529. switch ( type ) {
  530. case UnsignedInt248Type:
  531. formatGPU = GPUTextureFormat.Depth24PlusStencil8;
  532. break;
  533. case FloatType:
  534. if ( this.device.features.has( GPUFeatureName.Depth32FloatStencil8 ) === false ) {
  535. console.error( 'WebGPURenderer: Depth textures with DepthStencilFormat + FloatType can only be used with the "depth32float-stencil8" GPU feature.' );
  536. }
  537. formatGPU = GPUTextureFormat.Depth32FloatStencil8;
  538. break;
  539. default:
  540. console.error( 'WebGPURenderer: Unsupported texture type with DepthStencilFormat.', type );
  541. }
  542. break;
  543. default:
  544. console.error( 'WebGPURenderer: Unsupported texture format.', format );
  545. }
  546. }
  547. return formatGPU;
  548. }
  549. }
  550. export default WebGPUTextureUtils;