@aura3d/rendering 1.3.3 → 1.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (314) hide show
  1. package/dist/ForwardPass.js +7 -1
  2. package/dist/ForwardPass.js.map +1 -1
  3. package/dist/MorphTarget.d.ts +1 -0
  4. package/dist/MorphTarget.d.ts.map +1 -1
  5. package/dist/MorphTarget.js.map +1 -1
  6. package/dist/Renderer.js +7 -1
  7. package/dist/Renderer.js.map +1 -1
  8. package/package.json +38 -4
  9. package/src/ArchitecturalLightingFixtures.ts +0 -241
  10. package/src/ArchitecturalMaterialCatalog.ts +0 -130
  11. package/src/ArchitecturalMeasurementFixtures.ts +0 -155
  12. package/src/BRDFLut.ts +0 -47
  13. package/src/CameraFraming.ts +0 -200
  14. package/src/CanonicalSceneFixtures.ts +0 -95
  15. package/src/CascadedShadowMaps.ts +0 -449
  16. package/src/ColorManagement.ts +0 -127
  17. package/src/CullingFixtures.ts +0 -280
  18. package/src/DecalGeometry.ts +0 -26
  19. package/src/DepthPass.ts +0 -110
  20. package/src/EnvironmentBackgroundPass.ts +0 -194
  21. package/src/EnvironmentBackgroundResources.ts +0 -309
  22. package/src/EnvironmentLighting.ts +0 -96
  23. package/src/EnvironmentMapResources.ts +0 -1026
  24. package/src/EnvironmentPipeline.ts +0 -69
  25. package/src/EnvironmentPlatform.ts +0 -1306
  26. package/src/EnvironmentPreset.ts +0 -155
  27. package/src/Exposure.ts +0 -66
  28. package/src/ExternalParityRenderPreset.ts +0 -725
  29. package/src/ForwardPass.ts +0 -1663
  30. package/src/FrameVisualMetrics.ts +0 -301
  31. package/src/Geometry.ts +0 -461
  32. package/src/GeometryPrimitives.ts +0 -2
  33. package/src/HDRRenderPipeline.ts +0 -94
  34. package/src/IBL.ts +0 -86
  35. package/src/IndexBuffer.ts +0 -57
  36. package/src/InstancedPBRMaterial.ts +0 -186
  37. package/src/InstancedUnlitMaterial.ts +0 -60
  38. package/src/Instancing.ts +0 -19
  39. package/src/LightCollector.ts +0 -82
  40. package/src/LightUniforms.ts +0 -47
  41. package/src/LightingDebug.ts +0 -80
  42. package/src/LightingDefaults.ts +0 -79
  43. package/src/LightingRig.ts +0 -301
  44. package/src/LineGeometry.ts +0 -2
  45. package/src/Material.ts +0 -209
  46. package/src/MaterialBinding.ts +0 -131
  47. package/src/MaterialInstance.ts +0 -59
  48. package/src/MaterialPresets.ts +0 -272
  49. package/src/MorphTarget.ts +0 -123
  50. package/src/MorphTargetPlan.ts +0 -178
  51. package/src/MorphUnlitMaterial.ts +0 -60
  52. package/src/NormalMappedPBRMaterial.ts +0 -188
  53. package/src/OceanFixtures.ts +0 -318
  54. package/src/PBRLightingDefaults.ts +0 -12
  55. package/src/PBRMaterial.ts +0 -442
  56. package/src/PMREM.ts +0 -53
  57. package/src/PbrReference.ts +0 -681
  58. package/src/PostProcessPass.ts +0 -2507
  59. package/src/ProceduralTextureFixtures.ts +0 -393
  60. package/src/ProductTurntableFixtures.ts +0 -815
  61. package/src/Raycaster.ts +0 -21
  62. package/src/ReflectionProbe.ts +0 -13
  63. package/src/ReflectionSurfaces.ts +0 -219
  64. package/src/RenderBackend.ts +0 -43
  65. package/src/RenderDebugViews.ts +0 -138
  66. package/src/RenderDevice.ts +0 -836
  67. package/src/RenderGraph.ts +0 -194
  68. package/src/RenderPass.ts +0 -27
  69. package/src/RenderPipeline.ts +0 -101
  70. package/src/RenderQueue.ts +0 -12
  71. package/src/RenderState.ts +0 -12
  72. package/src/Renderer.ts +0 -2626
  73. package/src/RendererDebugOverlay.ts +0 -80
  74. package/src/RendererFeatureGates.ts +0 -150
  75. package/src/RendererPostprocessPlan.ts +0 -279
  76. package/src/RendererTiming.ts +0 -251
  77. package/src/RendererVisualPipelineReport.ts +0 -836
  78. package/src/ResourceLifecycle.ts +0 -21
  79. package/src/Sampler.ts +0 -37
  80. package/src/SceneOptimization.ts +0 -518
  81. package/src/ShaderChunks.ts +0 -393
  82. package/src/ShaderLibrary.ts +0 -2766
  83. package/src/ShaderModule.ts +0 -36
  84. package/src/ShaderPreprocessor.ts +0 -260
  85. package/src/ShaderReflection.ts +0 -201
  86. package/src/ShadowMap.ts +0 -237
  87. package/src/ShadowPass.ts +0 -198
  88. package/src/ShadowProjection.ts +0 -115
  89. package/src/SkinnedLitMaterial.ts +0 -397
  90. package/src/SkinnedUnlitMaterial.ts +0 -63
  91. package/src/SkinningBounds.ts +0 -131
  92. package/src/SpaceEnvironmentFixtures.ts +0 -200
  93. package/src/SpriteGeometry.ts +0 -21
  94. package/src/StereoCameraRig.ts +0 -127
  95. package/src/StereoEffects.ts +0 -274
  96. package/src/TerrainFixtures.ts +0 -180
  97. package/src/Texture.ts +0 -307
  98. package/src/TextureBinding.ts +0 -91
  99. package/src/TexturedPBRMaterial.ts +0 -1112
  100. package/src/TexturedUnlitMaterial.ts +0 -67
  101. package/src/ToneMapping.ts +0 -105
  102. package/src/UniformBinder.ts +0 -16
  103. package/src/UniformLayout.ts +0 -129
  104. package/src/UnlitMaterial.ts +0 -75
  105. package/src/VegetationFixtures.ts +0 -314
  106. package/src/VertexBuffer.ts +0 -120
  107. package/src/VertexFormat.ts +0 -171
  108. package/src/VoxelWorldFixtures.ts +0 -280
  109. package/src/WeatherFixtures.ts +0 -223
  110. package/src/WebGL2Device.ts +0 -2280
  111. package/src/WebGL2StateCache.ts +0 -330
  112. package/src/WebGPUDevice.ts +0 -2877
  113. package/src/WebGPURenderToTextureProof.ts +0 -139
  114. package/src/advanced-runtime/AdvancedRenderer.ts +0 -73
  115. package/src/advanced-runtime/index.ts +0 -9
  116. package/src/animation/AnimationMaterialStyle.ts +0 -32
  117. package/src/animation/AnimationRenderPreset.ts +0 -45
  118. package/src/animation/AnimationToonMaterial.ts +0 -387
  119. package/src/animation/AnimationVisualQuality.ts +0 -71
  120. package/src/animation/applyAnimationRenderPreset.ts +0 -180
  121. package/src/animation/index.ts +0 -5
  122. package/src/cinematic/BloomPass.ts +0 -26
  123. package/src/cinematic/CinematicDepthComposition.ts +0 -30
  124. package/src/cinematic/CinematicEvidence.ts +0 -123
  125. package/src/cinematic/CinematicLightingRig.ts +0 -144
  126. package/src/cinematic/CinematicMaterialPresets.ts +0 -130
  127. package/src/cinematic/CinematicPostProcess.ts +0 -83
  128. package/src/cinematic/DepthHazePass.ts +0 -30
  129. package/src/cinematic/EmissivePracticalLightSystem.ts +0 -45
  130. package/src/cinematic/FilmGrainPass.ts +0 -24
  131. package/src/cinematic/FogVolumeSystem.ts +0 -30
  132. package/src/cinematic/GlowCardSystem.ts +0 -44
  133. package/src/cinematic/RainParticleSystem.ts +0 -151
  134. package/src/cinematic/VignettePass.ts +0 -25
  135. package/src/cinematic/WetReflectionApproximation.ts +0 -27
  136. package/src/cinematic/index.ts +0 -14
  137. package/src/effects/CollisionModule.ts +0 -64
  138. package/src/effects/ColorModule.ts +0 -60
  139. package/src/effects/ForceModule.ts +0 -25
  140. package/src/effects/GPUParticleBackend.ts +0 -569
  141. package/src/effects/Particle.ts +0 -108
  142. package/src/effects/ParticleDiagnostics.ts +0 -224
  143. package/src/effects/ParticleEffectPresets.ts +0 -147
  144. package/src/effects/ParticleEmitter.ts +0 -326
  145. package/src/effects/ParticleModule.ts +0 -26
  146. package/src/effects/ParticleRenderPass.ts +0 -117
  147. package/src/effects/ParticleRenderer.ts +0 -132
  148. package/src/effects/ParticleSystem.ts +0 -333
  149. package/src/effects/SizeModule.ts +0 -56
  150. package/src/effects/TrailModule.ts +0 -72
  151. package/src/effects/VelocityModule.ts +0 -75
  152. package/src/effects/index.ts +0 -15
  153. package/src/index.ts +0 -925
  154. package/src/materials/AlphaSorting.ts +0 -30
  155. package/src/materials/MaterialExtensions.ts +0 -42
  156. package/src/materials/PhysicalMaterial.ts +0 -133
  157. package/src/materials/TransmissionPass.ts +0 -51
  158. package/src/performance/BVH.ts +0 -18
  159. package/src/performance/Batcher.ts +0 -2
  160. package/src/performance/FrustumCuller.ts +0 -9
  161. package/src/performance/LOD.ts +0 -20
  162. package/src/performance/Octree.ts +0 -10
  163. package/src/performance/RenderItemSorting.ts +0 -170
  164. package/src/performance/RendererStats.ts +0 -43
  165. package/src/performance/ResourceBudget.ts +0 -44
  166. package/src/postprocess/BloomPass.ts +0 -28
  167. package/src/postprocess/CinematicDiagnostics.ts +0 -642
  168. package/src/postprocess/ColorGradingPass.ts +0 -24
  169. package/src/postprocess/DepthOfFieldPass.ts +0 -12
  170. package/src/postprocess/EffectComposer.ts +0 -349
  171. package/src/postprocess/SSAOPass.ts +0 -20
  172. package/src/postprocess/index.ts +0 -34
  173. package/src/production-runtime/AnimationControlsPipeline.ts +0 -77
  174. package/src/production-runtime/PBRHDRPipeline.ts +0 -381
  175. package/src/production-runtime/ProductionEffectsPipeline.ts +0 -85
  176. package/src/production-runtime/ProductionRendererTypes.ts +0 -136
  177. package/src/production-runtime/ProductionRuntimeRenderer.ts +0 -172
  178. package/src/production-runtime/ProductionWebGL2Renderer.ts +0 -313
  179. package/src/production-runtime/ProductionWebGPURenderer.ts +0 -396
  180. package/src/production-runtime/TransmissionBackdropCapture.ts +0 -130
  181. package/src/production-runtime/animation/MorphTargetRenderer.ts +0 -2
  182. package/src/production-runtime/animation/SkinningRenderer.ts +0 -2
  183. package/src/production-runtime/backends/RendererBackend.ts +0 -17
  184. package/src/production-runtime/backends/WebGL2RendererBackend.ts +0 -30
  185. package/src/production-runtime/backends/WebGPURendererBackend.ts +0 -24
  186. package/src/production-runtime/backends/webgl2/WebGL2Buffer.ts +0 -2
  187. package/src/production-runtime/backends/webgl2/WebGL2Capabilities.ts +0 -2
  188. package/src/production-runtime/backends/webgl2/WebGL2RenderTarget.ts +0 -2
  189. package/src/production-runtime/backends/webgl2/WebGL2Shader.ts +0 -2
  190. package/src/production-runtime/backends/webgl2/WebGL2StateCache.ts +0 -1
  191. package/src/production-runtime/backends/webgl2/WebGL2Texture.ts +0 -2
  192. package/src/production-runtime/backends/webgpu/WebGPUBuffer.ts +0 -2
  193. package/src/production-runtime/backends/webgpu/WebGPUCapabilities.ts +0 -2
  194. package/src/production-runtime/backends/webgpu/WebGPURenderTarget.ts +0 -2
  195. package/src/production-runtime/backends/webgpu/WebGPUShader.ts +0 -2
  196. package/src/production-runtime/backends/webgpu/WebGPUTexture.ts +0 -2
  197. package/src/production-runtime/color/ColorManagement.ts +0 -3
  198. package/src/production-runtime/color/ToneMapping.ts +0 -7
  199. package/src/production-runtime/diagnostics/FrameCapture.ts +0 -2
  200. package/src/production-runtime/diagnostics/GPUCapabilities.ts +0 -2
  201. package/src/production-runtime/diagnostics/RendererStats.ts +0 -2
  202. package/src/production-runtime/environment/EnvironmentMap.ts +0 -1
  203. package/src/production-runtime/environment/HDRLoader.ts +0 -57
  204. package/src/production-runtime/environment/PMREMGenerator.ts +0 -713
  205. package/src/production-runtime/framegraph/FrameGraph.ts +0 -18
  206. package/src/production-runtime/framegraph/RenderPass.ts +0 -15
  207. package/src/production-runtime/geometry/ProjectedDecalGeometry.ts +0 -439
  208. package/src/production-runtime/index.ts +0 -127
  209. package/src/production-runtime/lights/LightManager.ts +0 -7
  210. package/src/production-runtime/lights/ShadowMapRenderer.ts +0 -5
  211. package/src/production-runtime/materials/GLTFMaterialAdapter.ts +0 -6
  212. package/src/production-runtime/materials/GLTFPBRMaterialAdapter.ts +0 -2
  213. package/src/production-runtime/materials/MaterialCompiler.ts +0 -7
  214. package/src/production-runtime/materials/MaterialTextureBindings.ts +0 -5
  215. package/src/production-runtime/materials/PBRMaterial.ts +0 -2
  216. package/src/production-runtime/materials/PBRShaderFeatures.ts +0 -2
  217. package/src/production-runtime/passes/ContactShadowPass.ts +0 -184
  218. package/src/production-runtime/passes/DepthPrepass.ts +0 -7
  219. package/src/production-runtime/passes/OpaquePass.ts +0 -7
  220. package/src/production-runtime/passes/ShadowPass.ts +0 -7
  221. package/src/production-runtime/passes/SkyboxPass.ts +0 -7
  222. package/src/production-runtime/passes/ToneMappingPass.ts +0 -7
  223. package/src/production-runtime/passes/TransparentPass.ts +0 -7
  224. package/src/production-runtime/postprocess/BloomPass.ts +0 -51
  225. package/src/production-runtime/postprocess/ColorGradingPass.ts +0 -49
  226. package/src/production-runtime/postprocess/DOFPass.ts +0 -47
  227. package/src/production-runtime/postprocess/FXAAPass.ts +0 -53
  228. package/src/production-runtime/postprocess/ProductionEffectComposer.ts +0 -78
  229. package/src/production-runtime/postprocess/ProductionPostProcessTypes.ts +0 -174
  230. package/src/production-runtime/postprocess/SSAOPass.ts +0 -45
  231. package/src/production-runtime/resources/GPUBuffer.ts +0 -2
  232. package/src/production-runtime/resources/GPUTexture.ts +0 -2
  233. package/src/production-runtime/resources/RenderTarget.ts +0 -3
  234. package/src/production-runtime/resources/ResourceCache.ts +0 -7
  235. package/src/production-runtime/scene/Camera.ts +0 -1
  236. package/src/production-runtime/scene/Lights.ts +0 -2
  237. package/src/production-runtime/scene/RenderableMesh.ts +0 -2
  238. package/src/production-runtime/scene/RenderablePrimitive.ts +0 -1
  239. package/src/production-runtime/scene/RenderableScene.ts +0 -4
  240. package/src/production-runtime/shaders/ShaderProgramLibrary.ts +0 -7
  241. package/src/production-runtime/shaders/chunks/brdf.glsl +0 -2
  242. package/src/production-runtime/shaders/chunks/ibl.glsl +0 -3
  243. package/src/production-runtime/shaders/chunks/pbr.frag.glsl +0 -47
  244. package/src/production-runtime/shaders/chunks/pbr.vert.glsl +0 -8
  245. package/src/production-runtime/shaders/chunks/shadows.glsl +0 -2
  246. package/src/production-runtime/shaders/wgsl/pbr.wgsl +0 -3
  247. package/src/production-runtime/shaders/wgsl/postprocess.wgsl +0 -2
  248. package/src/production-runtime/shaders/wgsl/skybox.wgsl +0 -2
  249. package/src/shaders/depth.frag.glsl +0 -5
  250. package/src/shaders/depth.vert.glsl +0 -8
  251. package/src/shaders/pbr-direct.frag.glsl +0 -687
  252. package/src/shaders/pbr-direct.vert.glsl +0 -18
  253. package/src/shaders/unlit.frag.glsl +0 -18
  254. package/src/shaders/unlit.vert.glsl +0 -13
  255. package/src/shadows/CascadedShadowPipeline.ts +0 -53
  256. package/src/shadows/ContactShadows.ts +0 -106
  257. package/src/shadows/ShadowDebugViews.ts +0 -46
  258. package/src/threejs-compatibility/InstancingSystem.ts +0 -17
  259. package/src/threejs-compatibility/LightingSystem.ts +0 -22
  260. package/src/threejs-compatibility/MaterialSystem.ts +0 -9
  261. package/src/threejs-compatibility/RenderTargetSystem.ts +0 -35
  262. package/src/threejs-compatibility/RendererDiagnostics.ts +0 -61
  263. package/src/threejs-compatibility/SceneRenderer.ts +0 -34
  264. package/src/threejs-compatibility/ShadowSystem.ts +0 -19
  265. package/src/threejs-compatibility/TextureSystem.ts +0 -19
  266. package/src/threejs-compatibility/ThreeCompatRenderer.ts +0 -90
  267. package/src/threejs-compatibility/TransparencySystem.ts +0 -19
  268. package/src/threejs-compatibility/index.ts +0 -29
  269. package/src/threejs-compatibility/performance/BVH.ts +0 -14
  270. package/src/threejs-compatibility/performance/FrustumCulling.ts +0 -10
  271. package/src/threejs-compatibility/performance/Instancing.ts +0 -4
  272. package/src/threejs-compatibility/performance/LODSystem.ts +0 -16
  273. package/src/threejs-compatibility/performance/OcclusionCulling.ts +0 -6
  274. package/src/threejs-compatibility/performance/RaycastAcceleration.ts +0 -12
  275. package/src/threejs-compatibility/performance/RendererProfiler.ts +0 -19
  276. package/src/threejs-compatibility/performance/TextureStreaming.ts +0 -4
  277. package/src/threejs-compatibility/performance/index.ts +0 -12
  278. package/src/threejs-compatibility/postprocess/BloomPass.ts +0 -16
  279. package/src/threejs-compatibility/postprocess/ColorGradingPass.ts +0 -16
  280. package/src/threejs-compatibility/postprocess/DepthOfFieldPass.ts +0 -21
  281. package/src/threejs-compatibility/postprocess/EffectComposer.ts +0 -14
  282. package/src/threejs-compatibility/postprocess/FXAAPass.ts +0 -15
  283. package/src/threejs-compatibility/postprocess/MotionBlurPass.ts +0 -20
  284. package/src/threejs-compatibility/postprocess/OutlinePass.ts +0 -21
  285. package/src/threejs-compatibility/postprocess/PostProcessTypes.ts +0 -169
  286. package/src/threejs-compatibility/postprocess/RenderPass.ts +0 -9
  287. package/src/threejs-compatibility/postprocess/SMAAPass.ts +0 -15
  288. package/src/threejs-compatibility/postprocess/SSAOPass.ts +0 -21
  289. package/src/threejs-compatibility/postprocess/ShaderPass.ts +0 -7
  290. package/src/threejs-compatibility/postprocess/TAAPass.ts +0 -15
  291. package/src/threejs-compatibility/postprocess/VignettePass.ts +0 -16
  292. package/src/threejs-compatibility/postprocess/index.ts +0 -15
  293. package/src/threejs-compatibility/shaders/NodeMaterial.ts +0 -21
  294. package/src/threejs-compatibility/shaders/RawShaderMaterial.ts +0 -6
  295. package/src/threejs-compatibility/shaders/ShaderDiagnostics.ts +0 -17
  296. package/src/threejs-compatibility/shaders/ShaderMaterial.ts +0 -18
  297. package/src/threejs-compatibility/shaders/ThreeCompatShaderChunks.ts +0 -6
  298. package/src/threejs-compatibility/shaders/Uniforms.ts +0 -18
  299. package/src/threejs-compatibility/shaders/index.ts +0 -9
  300. package/src/threejs-compatibility/vfx/GPUPointCloud.ts +0 -7
  301. package/src/threejs-compatibility/vfx/LineRenderer.ts +0 -13
  302. package/src/threejs-compatibility/vfx/ParticleSystem.ts +0 -23
  303. package/src/threejs-compatibility/vfx/SpriteSystem.ts +0 -14
  304. package/src/threejs-compatibility/vfx/TrailRenderer.ts +0 -8
  305. package/src/threejs-compatibility/vfx/VFXDiagnostics.ts +0 -23
  306. package/src/threejs-compatibility/vfx/index.ts +0 -9
  307. package/src/threejs-example-parity/index.ts +0 -205
  308. package/src/webgpu/WebGPUBuffer.ts +0 -1
  309. package/src/webgpu/WebGPUCompute.ts +0 -2
  310. package/src/webgpu/WebGPUPipelineCache.ts +0 -15
  311. package/src/webgpu/WebGPUPostProcess.ts +0 -2
  312. package/src/webgpu/WebGPUTexture.ts +0 -2
  313. package/tsconfig.json +0 -26
  314. package/vitest.config.ts +0 -20
@@ -1,381 +0,0 @@
1
- import {
2
- createEnvironmentMapResourceSet,
3
- decodeRgbeEnvironmentMap,
4
- generateRgba16fSpecularPrefilterMipLevels,
5
- type EnvironmentMapResourceSet,
6
- type EnvironmentToneMappingOperator,
7
- type LinearHdrEnvironmentMapSource,
8
- type RgbeEnvironmentMapSource
9
- } from "../EnvironmentMapResources";
10
- import type { EnvironmentLightingOptions } from "../ForwardPass";
11
- import { Sampler } from "../Sampler";
12
- import { Texture, type TextureCubeFace } from "../Texture";
13
- import { TextureBinding } from "../TextureBinding";
14
- import {
15
- createCubemapPMREMShaderContract,
16
- generateCubemapPMREMResources,
17
- type CubemapPMREMResources,
18
- type CubemapPMREMShaderContract
19
- } from "./environment/PMREMGenerator";
20
-
21
- export type ProductionToneMappingOperator = "aces" | "filmic" | "linear" | "reinhard";
22
-
23
- export interface ProductionToneMappingPolicy {
24
- readonly operator: ProductionToneMappingOperator;
25
- readonly exposure: number;
26
- readonly whitePoint: number;
27
- readonly outputColorSpace: "srgb" | "linear";
28
- }
29
-
30
- export interface ProductionPbrHdrPipelineOptions {
31
- readonly id: string;
32
- readonly label: string;
33
- readonly intensity?: number;
34
- readonly backgroundIntensity?: number;
35
- readonly rotation?: number;
36
- readonly toneMapping?: Partial<ProductionToneMappingPolicy>;
37
- readonly specularLevels?: number;
38
- readonly cubemapFaceSize?: number;
39
- readonly cubemapMipCount?: number;
40
- readonly irradianceWidth?: number;
41
- readonly irradianceHeight?: number;
42
- readonly brdfLutSize?: number;
43
- readonly brdfLutSampleCount?: number;
44
- readonly specularSampleCount?: number;
45
- readonly cubemapSampleCount?: number;
46
- }
47
-
48
- export interface ProductionRadianceHDR {
49
- readonly width: number;
50
- readonly height: number;
51
- readonly rgbe: Uint8Array;
52
- readonly header: string;
53
- readonly format: "32-bit_rle_rgbe";
54
- }
55
-
56
- export interface ProductionPbrHdrPipeline {
57
- readonly id: string;
58
- readonly label: string;
59
- readonly radiance: ProductionRadianceHDR;
60
- readonly linear: LinearHdrEnvironmentMapSource;
61
- readonly resources: EnvironmentMapResourceSet;
62
- readonly environmentMipLevels: ReturnType<typeof generateRgba16fSpecularPrefilterMipLevels>;
63
- readonly cubemapPMREM: CubemapPMREMResources;
64
- readonly cubemapPMREMShaderContract: CubemapPMREMShaderContract;
65
- readonly toneMapping: ProductionToneMappingPolicy;
66
- readonly intensity: number;
67
- readonly backgroundIntensity: number;
68
- readonly rotation: number;
69
- readonly diagnostics: {
70
- readonly realRadianceHdr: boolean;
71
- readonly environmentTextureEncoding: "rgba8-linear" | "rgba8-srgb" | "rgbe" | "rgba16f-linear";
72
- readonly environmentTextureFormat: "rgba8" | "rgba16f";
73
- readonly hdrPixelCount: number;
74
- readonly maxLinearValue: number;
75
- readonly diffuseIrradiance: boolean;
76
- readonly diffuseIrradianceModel: "cosine-weighted-hemisphere";
77
- readonly specularPrefilter: boolean;
78
- readonly specularPrefilterModel: "ggx-importance-sampled";
79
- readonly cubemapPMREM: boolean;
80
- readonly cubemapPMREMModel: "equirectangular-to-cubemap-ggx-importance-sampled-prefilter";
81
- readonly cubemapPMREMShaderSampling: "webgl2-sampler-cube";
82
- readonly cubemapPMREMShaderContract: "webgl2-sampler-cube-split-sum";
83
- readonly cubemapFaceSize: number;
84
- readonly cubemapMipCount: number;
85
- readonly brdfLut: boolean;
86
- readonly specularMipCount: number;
87
- readonly textureBytes: number;
88
- };
89
- }
90
-
91
- export interface ProductionEnvironmentLightingResources {
92
- readonly lighting: EnvironmentLightingOptions;
93
- readonly environmentTexture: Texture;
94
- readonly environmentCubeTexture: Texture;
95
- readonly brdfLutTexture: Texture;
96
- dispose(): void;
97
- }
98
-
99
- const DEFAULT_TONE_MAPPING: ProductionToneMappingPolicy = {
100
- operator: "filmic",
101
- exposure: 1,
102
- whitePoint: 11.2,
103
- outputColorSpace: "srgb"
104
- };
105
-
106
- const CUBE_TEXTURE_FACES: readonly TextureCubeFace[] = ["px", "nx", "py", "ny", "pz", "nz"];
107
-
108
- export function parseProductionRadianceHDR(buffer: ArrayBuffer | Uint8Array): ProductionRadianceHDR {
109
- const bytes = buffer instanceof Uint8Array ? buffer : new Uint8Array(buffer);
110
- const headerProbe = new TextDecoder("ascii").decode(bytes.slice(0, Math.min(bytes.length, 4096)));
111
- const resolutionMatch = /(^|\n)-Y\s+(\d+)\s+\+X\s+(\d+)\s*\n/.exec(headerProbe);
112
- if (!/^#\?RADIANCE/m.test(headerProbe) && !/^#\?RGBE/m.test(headerProbe)) {
113
- throw new Error("Production HDR parser requires a Radiance/RGBE header.");
114
- }
115
- if (!/FORMAT=32-bit_rle_rgbe/.test(headerProbe)) {
116
- throw new Error("Production HDR parser requires FORMAT=32-bit_rle_rgbe.");
117
- }
118
- if (!resolutionMatch || resolutionMatch.index === undefined) {
119
- throw new Error("Production HDR parser could not find -Y +X resolution.");
120
- }
121
- const height = Number(resolutionMatch[2]);
122
- const width = Number(resolutionMatch[3]);
123
- if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) {
124
- throw new Error("Production HDR parser found invalid dimensions.");
125
- }
126
- const dataOffset = resolutionMatch.index + resolutionMatch[0].length;
127
- const rgbe = decodeRadianceRle(bytes.subarray(dataOffset), width, height);
128
- return {
129
- width,
130
- height,
131
- rgbe,
132
- header: headerProbe.slice(0, dataOffset),
133
- format: "32-bit_rle_rgbe"
134
- };
135
- }
136
-
137
- export function createProductionPbrHdrPipelineFromRadiance(
138
- buffer: ArrayBuffer | Uint8Array,
139
- options: ProductionPbrHdrPipelineOptions
140
- ): ProductionPbrHdrPipeline {
141
- const radiance = parseProductionRadianceHDR(buffer);
142
- const rgbeSource: RgbeEnvironmentMapSource = {
143
- width: radiance.width,
144
- height: radiance.height,
145
- data: radiance.rgbe
146
- };
147
- const linear = decodeRgbeEnvironmentMap(rgbeSource);
148
- const toneMapping = createProductionToneMappingPolicy(options.toneMapping);
149
- const resources = createEnvironmentMapResourceSet({ ...rgbeSource, encoding: "rgbe" }, {
150
- textureEncoding: "rgbe",
151
- outputColorSpace: toneMapping.outputColorSpace,
152
- exposure: toneMapping.exposure,
153
- toneMapping: environmentToneMappingOperator(toneMapping.operator),
154
- specularLevels: options.specularLevels ?? 9,
155
- specularBlurRadius: 3,
156
- irradianceWidth: options.irradianceWidth ?? 32,
157
- irradianceHeight: options.irradianceHeight ?? 16,
158
- irradianceBlurRadius: 12,
159
- brdfLutSize: options.brdfLutSize ?? 64,
160
- brdfLutSampleCount: options.brdfLutSampleCount
161
- });
162
- const environmentMipLevels = generateRgba16fSpecularPrefilterMipLevels(linear, {
163
- levels: resources.specularMipLevels.length,
164
- sampleCount: options.specularSampleCount ?? 16
165
- });
166
- const cubemapPMREM = generateCubemapPMREMResources(linear, {
167
- faceSize: options.cubemapFaceSize ?? 128,
168
- mipCount: options.cubemapMipCount,
169
- sampleCount: options.cubemapSampleCount ?? 32
170
- });
171
- const cubemapPMREMShaderContract = createCubemapPMREMShaderContract(cubemapPMREM);
172
- const textureBytes = environmentMipLevels.reduce((total, level) => total + level.data.byteLength, 0)
173
- + cubemapPMREM.diagnostics.totalByteLength
174
- + resources.brdfLut.data.byteLength
175
- + resources.diffuseIrradiance.data.byteLength;
176
- return {
177
- id: options.id,
178
- label: options.label,
179
- radiance,
180
- linear,
181
- resources,
182
- environmentMipLevels,
183
- cubemapPMREM,
184
- cubemapPMREMShaderContract,
185
- toneMapping,
186
- intensity: options.intensity ?? 1,
187
- backgroundIntensity: options.backgroundIntensity ?? 0.8,
188
- rotation: options.rotation ?? 0,
189
- diagnostics: {
190
- realRadianceHdr: true,
191
- environmentTextureEncoding: "rgba16f-linear",
192
- environmentTextureFormat: "rgba16f",
193
- hdrPixelCount: radiance.width * radiance.height,
194
- maxLinearValue: resources.diagnostics.maxLinearValue,
195
- diffuseIrradiance: resources.diffuseIrradiance.width > 0 && resources.diffuseIrradiance.height > 0,
196
- diffuseIrradianceModel: "cosine-weighted-hemisphere",
197
- specularPrefilter: resources.specularMipLevels.length >= 4,
198
- specularPrefilterModel: "ggx-importance-sampled",
199
- cubemapPMREM: cubemapPMREM.levels.length > 0 && cubemapPMREM.levels.every((level) => level.faces.length === 6),
200
- cubemapPMREMModel: "equirectangular-to-cubemap-ggx-importance-sampled-prefilter",
201
- cubemapPMREMShaderSampling: "webgl2-sampler-cube",
202
- cubemapPMREMShaderContract: "webgl2-sampler-cube-split-sum",
203
- cubemapFaceSize: cubemapPMREM.faceSize,
204
- cubemapMipCount: cubemapPMREM.mipCount,
205
- brdfLut: resources.brdfLut.width > 0 && resources.brdfLut.height > 0,
206
- specularMipCount: resources.specularMipLevels.length,
207
- textureBytes
208
- }
209
- };
210
- }
211
-
212
- export function createProductionEnvironmentLightingResources(
213
- pipeline: ProductionPbrHdrPipeline
214
- ): ProductionEnvironmentLightingResources {
215
- const environmentTexture = new Texture({
216
- width: pipeline.resources.base.width,
217
- height: pipeline.resources.base.height,
218
- format: "rgba16f",
219
- colorSpace: "linear",
220
- label: `production-runtime-${pipeline.id}-pmrem`,
221
- mipLevels: pipeline.environmentMipLevels
222
- });
223
- const brdfLutTexture = new Texture({
224
- width: pipeline.resources.brdfLut.width,
225
- height: pipeline.resources.brdfLut.height,
226
- colorSpace: "linear",
227
- label: `production-runtime-${pipeline.id}-brdf-lut`,
228
- data: pipeline.resources.brdfLut.data
229
- });
230
- const environmentCubeTexture = new Texture({
231
- width: pipeline.cubemapPMREM.faceSize,
232
- height: pipeline.cubemapPMREM.faceSize,
233
- dimension: "cube",
234
- format: "rgba16f",
235
- colorSpace: "linear",
236
- label: `production-runtime-${pipeline.id}-cubemap-pmrem`,
237
- cubeFaces: CUBE_TEXTURE_FACES.map((face) => ({
238
- face,
239
- mipLevels: pipeline.cubemapPMREM.levels.map((level) => {
240
- const faceLevel = level.faces.find((candidate) => candidate.face === face);
241
- if (!faceLevel) {
242
- throw new Error(`Missing cubemap PMREM face ${face} at mip ${level.mip}`);
243
- }
244
- return {
245
- width: faceLevel.width,
246
- height: faceLevel.height,
247
- data: faceLevel.data
248
- };
249
- })
250
- }))
251
- });
252
- return {
253
- environmentTexture,
254
- environmentCubeTexture,
255
- brdfLutTexture,
256
- lighting: {
257
- color: [1, 1, 1],
258
- intensity: 0.08,
259
- proceduralMap: {
260
- skyColor: [0.2, 0.24, 0.32],
261
- horizonColor: [0.22, 0.2, 0.18],
262
- groundColor: [0.03, 0.035, 0.045],
263
- specularColor: [1, 1, 1],
264
- intensity: 0.06,
265
- specularIntensity: 0.1
266
- },
267
- environmentMapTexture: new TextureBinding({
268
- name: "u_environmentMapTexture",
269
- texture: environmentTexture,
270
- sampler: new Sampler({ minFilter: "linear-mipmap-linear", magFilter: "linear", addressU: "repeat", addressV: "clamp-to-edge" }),
271
- expectedColorSpace: "linear"
272
- }),
273
- environmentCubeMapTexture: new TextureBinding({
274
- name: "u_environmentCubeMapTexture",
275
- texture: environmentCubeTexture,
276
- sampler: new Sampler({ minFilter: "linear-mipmap-linear", magFilter: "linear", addressU: "clamp-to-edge", addressV: "clamp-to-edge" }),
277
- expectedColorSpace: "linear"
278
- }),
279
- environmentMapIntensity: pipeline.intensity,
280
- environmentMapSpecularIntensity: pipeline.intensity * 0.38,
281
- environmentMapRotation: pipeline.rotation,
282
- environmentMapMipCount: pipeline.cubemapPMREM.mipCount,
283
- environmentMapEncoding: "linear",
284
- environmentBrdfLutTexture: new TextureBinding({
285
- name: "u_environmentBrdfLutTexture",
286
- texture: brdfLutTexture,
287
- sampler: new Sampler({ minFilter: "linear", magFilter: "linear", addressU: "clamp-to-edge", addressV: "clamp-to-edge" }),
288
- expectedColorSpace: "linear"
289
- })
290
- },
291
- dispose: () => {
292
- environmentTexture.dispose();
293
- environmentCubeTexture.dispose();
294
- brdfLutTexture.dispose();
295
- }
296
- };
297
- }
298
-
299
- export function createProductionToneMappingPolicy(overrides: Partial<ProductionToneMappingPolicy> = {}): ProductionToneMappingPolicy {
300
- const policy = { ...DEFAULT_TONE_MAPPING, ...overrides };
301
- if (!Number.isFinite(policy.exposure) || policy.exposure < 0) {
302
- throw new RangeError("Production tone mapping exposure must be finite and non-negative.");
303
- }
304
- if (!Number.isFinite(policy.whitePoint) || policy.whitePoint <= 0) {
305
- throw new RangeError("Production tone mapping whitePoint must be finite and positive.");
306
- }
307
- return policy;
308
- }
309
-
310
- function environmentToneMappingOperator(operator: ProductionToneMappingOperator): EnvironmentToneMappingOperator {
311
- return operator === "linear" ? "linear" : "reinhard";
312
- }
313
-
314
- function decodeRadianceRle(data: Uint8Array, width: number, height: number): Uint8Array {
315
- const output = new Uint8Array(width * height * 4);
316
- let offset = 0;
317
- for (let y = 0; y < height; y += 1) {
318
- if (offset + 4 > data.length) {
319
- throw new Error(`Production HDR scanline ${y} is truncated.`);
320
- }
321
- const b0 = data[offset] ?? 0;
322
- const b1 = data[offset + 1] ?? 0;
323
- const b2 = data[offset + 2] ?? 0;
324
- const b3 = data[offset + 3] ?? 0;
325
- if (width >= 8 && width < 32768 && b0 === 2 && b1 === 2 && (b2 & 0x80) === 0) {
326
- const scanlineWidth = (b2 << 8) | b3;
327
- if (scanlineWidth !== width) {
328
- throw new Error(`Production HDR scanline ${y} width ${scanlineWidth} does not match ${width}.`);
329
- }
330
- offset += 4;
331
- const scanline = new Uint8Array(width * 4);
332
- for (let channel = 0; channel < 4; channel += 1) {
333
- let x = 0;
334
- while (x < width) {
335
- const count = data[offset++];
336
- if (count === undefined) {
337
- throw new Error(`Production HDR scanline ${y} channel ${channel} is truncated.`);
338
- }
339
- if (count === 0) {
340
- throw new Error(`Production HDR scanline ${y} channel ${channel} has invalid zero run length.`);
341
- }
342
- if (count > 128) {
343
- const runLength = count - 128;
344
- if (x + runLength > width) {
345
- throw new Error(`Production HDR scanline ${y} channel ${channel} run exceeds width ${width}.`);
346
- }
347
- const value = data[offset++];
348
- if (value === undefined) {
349
- throw new Error(`Production HDR scanline ${y} channel ${channel} run is truncated.`);
350
- }
351
- for (let index = 0; index < runLength; index += 1) {
352
- scanline[(x + index) * 4 + channel] = value;
353
- }
354
- x += runLength;
355
- } else {
356
- if (x + count > width) {
357
- throw new Error(`Production HDR scanline ${y} channel ${channel} literal exceeds width ${width}.`);
358
- }
359
- for (let index = 0; index < count; index += 1) {
360
- const value = data[offset++];
361
- if (value === undefined) {
362
- throw new Error(`Production HDR scanline ${y} channel ${channel} literal is truncated.`);
363
- }
364
- scanline[(x + index) * 4 + channel] = value;
365
- }
366
- x += count;
367
- }
368
- }
369
- }
370
- output.set(scanline, y * width * 4);
371
- } else {
372
- const byteLength = width * 4;
373
- if (offset + byteLength > data.length) {
374
- throw new Error(`Production HDR scanline ${y} is truncated.`);
375
- }
376
- output.set(data.subarray(offset, offset + byteLength), y * byteLength);
377
- offset += byteLength;
378
- }
379
- }
380
- return output;
381
- }
@@ -1,85 +0,0 @@
1
- import type { RenderSource, RendererPostProcessOptions, RendererShadowOptions } from "../Renderer";
2
- import type { ProductionRenderProof } from "./ProductionRendererTypes";
3
-
4
- export interface ProductionEffectsOptions {
5
- readonly shadow?: RendererShadowOptions | boolean;
6
- readonly postprocess?: RendererPostProcessOptions | boolean;
7
- readonly transparentItemCount?: number;
8
- }
9
-
10
- export interface ProductionEffectsSummary {
11
- readonly pass: boolean;
12
- readonly shadowProof: boolean;
13
- readonly transparencyProof: boolean;
14
- readonly postprocessProof: boolean;
15
- readonly drawCalls: number;
16
- readonly nonBlackPixels: number;
17
- readonly uniqueColorBuckets: number;
18
- readonly failures: readonly string[];
19
- }
20
-
21
- export function createProductionEffectsRenderSource(source: RenderSource, options: ProductionEffectsOptions = {}): RenderSource {
22
- return {
23
- ...source,
24
- shadow: options.shadow ?? {
25
- enabled: true,
26
- size: 512,
27
- bias: 0.0008,
28
- strength: 0.48,
29
- filter: "pcf",
30
- pcfRadius: 1.25,
31
- pcfSamples: 9
32
- },
33
- postprocess: options.postprocess ?? {
34
- targetFormat: "rgba8",
35
- toneMapping: {
36
- operator: "filmic",
37
- exposure: 1.08,
38
- whitePoint: 1.18,
39
- inputColorSpace: "linear",
40
- outputColorSpace: "srgb"
41
- },
42
- colorGrade: {
43
- contrast: 1.08,
44
- saturation: 1.06,
45
- vibrance: 0.08,
46
- vignette: 0.12,
47
- sharpening: 0.24
48
- },
49
- bloom: {
50
- threshold: 0.84,
51
- intensity: 0.08,
52
- radius: 1
53
- },
54
- fxaa: {
55
- edgeThreshold: 0.08,
56
- subpixelBlend: 0.55
57
- }
58
- }
59
- };
60
- }
61
-
62
- export function summarizeProductionEffectsProof(proof: ProductionRenderProof, options: ProductionEffectsOptions = {}): ProductionEffectsSummary {
63
- const shadowProof = proof.diagnostics.drawCalls >= 2;
64
- const transparencyProof = (options.transparentItemCount ?? 0) > 0;
65
- const postprocessProof = proof.pixels.uniqueColorBuckets > 12 && proof.pixels.maxLuma > 40;
66
- const failures = [
67
- ...(!proof.realWebGL2 ? ["not a real WebGL2 proof"] : []),
68
- ...(proof.mockDevice ? ["mock renderer was used"] : []),
69
- ...(proof.canvas2dProof ? ["Canvas 2D proof was used"] : []),
70
- ...(!shadowProof ? ["shadow pass did not add draw-call evidence"] : []),
71
- ...(!transparencyProof ? ["transparent item ordering was not declared"] : []),
72
- ...(!postprocessProof ? ["postprocess pixel metrics are too weak"] : []),
73
- ...(proof.pixels.nonBlackPixels <= 1000 ? ["visible pixel count is too low"] : [])
74
- ];
75
- return {
76
- pass: failures.length === 0,
77
- shadowProof,
78
- transparencyProof,
79
- postprocessProof,
80
- drawCalls: proof.diagnostics.drawCalls,
81
- nonBlackPixels: proof.pixels.nonBlackPixels,
82
- uniqueColorBuckets: proof.pixels.uniqueColorBuckets,
83
- failures
84
- };
85
- }
@@ -1,136 +0,0 @@
1
- import type { CameraLike, RenderSource } from "../Renderer";
2
- import type { RenderDeviceDiagnostics } from "../RenderDevice";
3
-
4
- export type ProductionRendererBackend = "webgl2" | "webgpu";
5
- export type ProductionRendererFeatureState = "supported" | "partial" | "blocked";
6
-
7
- export interface ProductionRendererFeature {
8
- readonly id: string;
9
- readonly state: ProductionRendererFeatureState;
10
- readonly detail: string;
11
- }
12
-
13
- export interface ProductionImportedAssetRenderMetadata {
14
- readonly assetId: string;
15
- readonly assetUri: string;
16
- readonly assetName?: string;
17
- readonly meshCount: number;
18
- readonly primitiveCount: number;
19
- readonly materialCount: number;
20
- readonly textureCount: number;
21
- readonly imageCount: number;
22
- readonly animationCount: number;
23
- readonly skinCount: number;
24
- readonly morphTargetCount: number;
25
- readonly extensionsUsed: readonly string[];
26
- readonly environmentId?: string;
27
- readonly hdrEnvironmentUri?: string;
28
- }
29
-
30
- export interface ProductionRendererInput {
31
- readonly source: RenderSource;
32
- readonly camera?: CameraLike;
33
- readonly metadata: ProductionImportedAssetRenderMetadata;
34
- readonly transmissionBackdropCapture?: false | RuntimeParityTransmissionBackdropCaptureOptions;
35
- }
36
-
37
- export interface RuntimeParityTransmissionBackdropCaptureOptions {
38
- readonly mode?: "scene-color-readback";
39
- readonly strength?: number;
40
- readonly refractionScale?: number;
41
- }
42
-
43
- export interface RuntimeParityTransmissionBackdropCaptureProof {
44
- readonly mode: "renderer-owned-scene-color-readback";
45
- readonly width: number;
46
- readonly height: number;
47
- readonly byteLength: number;
48
- readonly mipCount: number;
49
- readonly strength: number;
50
- readonly refractionScale: number;
51
- readonly materialBindings: number;
52
- }
53
-
54
- export interface ProductionPixelMetrics {
55
- readonly width: number;
56
- readonly height: number;
57
- readonly nonTransparentPixels: number;
58
- readonly nonBlackPixels: number;
59
- readonly averageLuma: number;
60
- readonly maxLuma: number;
61
- readonly uniqueColorBuckets: number;
62
- readonly centerPixel: readonly [number, number, number, number];
63
- }
64
-
65
- export interface CurrentRoutesRendererTimingDiagnostics {
66
- readonly source: "performance-now" | "date-now";
67
- readonly totalMs: number;
68
- readonly renderMs: number;
69
- readonly readbackMs?: number;
70
- readonly pixelAnalysisMs?: number;
71
- readonly transmissionBackdropCaptureMs?: number;
72
- }
73
-
74
- export interface ProductionRenderProof {
75
- readonly backend: ProductionRendererBackend;
76
- readonly realWebGL2: boolean;
77
- readonly mockDevice: boolean;
78
- readonly canvas2dProof: boolean;
79
- readonly importedAsset: ProductionImportedAssetRenderMetadata;
80
- readonly diagnostics: RenderDeviceDiagnostics;
81
- readonly features: readonly ProductionRendererFeature[];
82
- readonly pixels: ProductionPixelMetrics;
83
- readonly timing?: CurrentRoutesRendererTimingDiagnostics;
84
- readonly transmissionBackdropCapture?: RuntimeParityTransmissionBackdropCaptureProof;
85
- }
86
-
87
- export interface RuntimeParityFrameRenderResult {
88
- readonly backend: ProductionRendererBackend;
89
- readonly diagnostics: RenderDeviceDiagnostics;
90
- readonly features: readonly ProductionRendererFeature[];
91
- readonly timing?: CurrentRoutesRendererTimingDiagnostics;
92
- }
93
-
94
- export interface ProductionProductionRenderer {
95
- readonly backend: ProductionRendererBackend;
96
- renderFrame(input: ProductionRendererInput): RuntimeParityFrameRenderResult;
97
- renderImportedAsset(input: ProductionRendererInput): ProductionRenderProof;
98
- getFeatures(): readonly ProductionRendererFeature[];
99
- getDiagnostics(): RenderDeviceDiagnostics;
100
- dispose(): void;
101
- }
102
-
103
- export interface CurrentRoutesProductionRenderer extends ProductionProductionRenderer {
104
- renderInteractiveFrame(input: ProductionRendererInput): RuntimeParityFrameRenderResult;
105
- captureProof(input: ProductionRendererInput): ProductionRenderProof;
106
- }
107
-
108
- export const PRODUCTION_WEBGL2_REQUIRED_FEATURES = [
109
- "real-webgl2-context",
110
- "no-canvas2d-proof",
111
- "no-mock-device",
112
- "imported-gltf-render-source",
113
- "pbr-materials",
114
- "texture-upload-diagnostics",
115
- "render-target-diagnostics",
116
- "draw-call-diagnostics",
117
- "pixel-readback",
118
- "hdr-ibl-ready"
119
- ] as const;
120
-
121
- export const RUNTIME_PARITY_WEBGPU_REQUIRED_FEATURES = [
122
- "real-webgpu-context",
123
- "no-canvas2d-proof",
124
- "no-mock-device",
125
- "imported-gltf-render-source",
126
- "pbr-materials",
127
- "texture-upload-diagnostics",
128
- "render-target-diagnostics",
129
- "draw-call-diagnostics",
130
- "pixel-readback",
131
- "hdr-ibl-ready",
132
- "native-webgpu-render-pipeline",
133
- "native-webgpu-sampled-textures",
134
- "native-webgpu-texture-readback",
135
- "native-webgpu-pbr-submissions"
136
- ] as const;