@aura3d/rendering 1.4.0 → 1.4.2

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 (308) hide show
  1. package/package.json +38 -4
  2. package/AGENTS.md +0 -46
  3. package/src/ArchitecturalLightingFixtures.ts +0 -241
  4. package/src/ArchitecturalMaterialCatalog.ts +0 -130
  5. package/src/ArchitecturalMeasurementFixtures.ts +0 -155
  6. package/src/BRDFLut.ts +0 -47
  7. package/src/CameraFraming.ts +0 -200
  8. package/src/CanonicalSceneFixtures.ts +0 -95
  9. package/src/CascadedShadowMaps.ts +0 -449
  10. package/src/ColorManagement.ts +0 -127
  11. package/src/CullingFixtures.ts +0 -280
  12. package/src/DecalGeometry.ts +0 -26
  13. package/src/DepthPass.ts +0 -110
  14. package/src/EnvironmentBackgroundPass.ts +0 -194
  15. package/src/EnvironmentBackgroundResources.ts +0 -309
  16. package/src/EnvironmentLighting.ts +0 -96
  17. package/src/EnvironmentMapResources.ts +0 -1026
  18. package/src/EnvironmentPipeline.ts +0 -69
  19. package/src/EnvironmentPlatform.ts +0 -1306
  20. package/src/EnvironmentPreset.ts +0 -155
  21. package/src/Exposure.ts +0 -66
  22. package/src/ExternalParityRenderPreset.ts +0 -725
  23. package/src/ForwardPass.ts +0 -1668
  24. package/src/FrameVisualMetrics.ts +0 -301
  25. package/src/Geometry.ts +0 -461
  26. package/src/GeometryPrimitives.ts +0 -2
  27. package/src/HDRRenderPipeline.ts +0 -94
  28. package/src/IBL.ts +0 -86
  29. package/src/IndexBuffer.ts +0 -57
  30. package/src/InstancedPBRMaterial.ts +0 -186
  31. package/src/InstancedUnlitMaterial.ts +0 -60
  32. package/src/Instancing.ts +0 -19
  33. package/src/LightCollector.ts +0 -82
  34. package/src/LightUniforms.ts +0 -47
  35. package/src/LightingDebug.ts +0 -80
  36. package/src/LightingDefaults.ts +0 -79
  37. package/src/LightingRig.ts +0 -301
  38. package/src/LineGeometry.ts +0 -2
  39. package/src/Material.ts +0 -209
  40. package/src/MaterialBinding.ts +0 -131
  41. package/src/MaterialInstance.ts +0 -59
  42. package/src/MaterialPresets.ts +0 -272
  43. package/src/MorphTarget.ts +0 -124
  44. package/src/MorphTargetPlan.ts +0 -178
  45. package/src/MorphUnlitMaterial.ts +0 -60
  46. package/src/NormalMappedPBRMaterial.ts +0 -188
  47. package/src/OceanFixtures.ts +0 -318
  48. package/src/PBRLightingDefaults.ts +0 -12
  49. package/src/PBRMaterial.ts +0 -442
  50. package/src/PMREM.ts +0 -53
  51. package/src/PbrReference.ts +0 -681
  52. package/src/PostProcessPass.ts +0 -2507
  53. package/src/ProceduralTextureFixtures.ts +0 -393
  54. package/src/ProductTurntableFixtures.ts +0 -815
  55. package/src/Raycaster.ts +0 -21
  56. package/src/ReflectionProbe.ts +0 -13
  57. package/src/ReflectionSurfaces.ts +0 -219
  58. package/src/RenderBackend.ts +0 -43
  59. package/src/RenderDebugViews.ts +0 -138
  60. package/src/RenderDevice.ts +0 -836
  61. package/src/RenderGraph.ts +0 -194
  62. package/src/RenderPass.ts +0 -27
  63. package/src/RenderPipeline.ts +0 -101
  64. package/src/RenderQueue.ts +0 -12
  65. package/src/RenderState.ts +0 -12
  66. package/src/Renderer.ts +0 -2631
  67. package/src/RendererDebugOverlay.ts +0 -80
  68. package/src/RendererFeatureGates.ts +0 -150
  69. package/src/RendererPostprocessPlan.ts +0 -279
  70. package/src/RendererTiming.ts +0 -251
  71. package/src/RendererVisualPipelineReport.ts +0 -836
  72. package/src/ResourceLifecycle.ts +0 -21
  73. package/src/Sampler.ts +0 -37
  74. package/src/SceneOptimization.ts +0 -518
  75. package/src/ShaderChunks.ts +0 -393
  76. package/src/ShaderLibrary.ts +0 -2766
  77. package/src/ShaderModule.ts +0 -36
  78. package/src/ShaderPreprocessor.ts +0 -260
  79. package/src/ShaderReflection.ts +0 -201
  80. package/src/ShadowMap.ts +0 -237
  81. package/src/ShadowPass.ts +0 -198
  82. package/src/ShadowProjection.ts +0 -115
  83. package/src/SkinnedLitMaterial.ts +0 -397
  84. package/src/SkinnedUnlitMaterial.ts +0 -63
  85. package/src/SkinningBounds.ts +0 -131
  86. package/src/SpaceEnvironmentFixtures.ts +0 -200
  87. package/src/SpriteGeometry.ts +0 -21
  88. package/src/StereoCameraRig.ts +0 -127
  89. package/src/StereoEffects.ts +0 -274
  90. package/src/TerrainFixtures.ts +0 -180
  91. package/src/Texture.ts +0 -307
  92. package/src/TextureBinding.ts +0 -91
  93. package/src/TexturedPBRMaterial.ts +0 -1112
  94. package/src/TexturedUnlitMaterial.ts +0 -67
  95. package/src/ToneMapping.ts +0 -105
  96. package/src/UniformBinder.ts +0 -16
  97. package/src/UniformLayout.ts +0 -129
  98. package/src/UnlitMaterial.ts +0 -75
  99. package/src/VegetationFixtures.ts +0 -314
  100. package/src/VertexBuffer.ts +0 -120
  101. package/src/VertexFormat.ts +0 -171
  102. package/src/VoxelWorldFixtures.ts +0 -280
  103. package/src/WeatherFixtures.ts +0 -223
  104. package/src/WebGL2Device.ts +0 -2280
  105. package/src/WebGL2StateCache.ts +0 -330
  106. package/src/WebGPUDevice.ts +0 -2877
  107. package/src/WebGPURenderToTextureProof.ts +0 -139
  108. package/src/advanced-runtime/AdvancedRenderer.ts +0 -73
  109. package/src/advanced-runtime/index.ts +0 -9
  110. package/src/animation/AnimationMaterialStyle.ts +0 -32
  111. package/src/animation/AnimationRenderPreset.ts +0 -45
  112. package/src/animation/AnimationToonMaterial.ts +0 -387
  113. package/src/animation/AnimationVisualQuality.ts +0 -71
  114. package/src/animation/applyAnimationRenderPreset.ts +0 -180
  115. package/src/animation/index.ts +0 -5
  116. package/src/cinematic/BloomPass.ts +0 -26
  117. package/src/cinematic/CinematicDepthComposition.ts +0 -30
  118. package/src/cinematic/CinematicEvidence.ts +0 -123
  119. package/src/cinematic/CinematicLightingRig.ts +0 -144
  120. package/src/cinematic/CinematicMaterialPresets.ts +0 -130
  121. package/src/cinematic/CinematicPostProcess.ts +0 -83
  122. package/src/cinematic/DepthHazePass.ts +0 -30
  123. package/src/cinematic/EmissivePracticalLightSystem.ts +0 -45
  124. package/src/cinematic/FilmGrainPass.ts +0 -24
  125. package/src/cinematic/FogVolumeSystem.ts +0 -30
  126. package/src/cinematic/GlowCardSystem.ts +0 -44
  127. package/src/cinematic/RainParticleSystem.ts +0 -151
  128. package/src/cinematic/VignettePass.ts +0 -25
  129. package/src/cinematic/WetReflectionApproximation.ts +0 -27
  130. package/src/cinematic/index.ts +0 -14
  131. package/src/effects/CollisionModule.ts +0 -64
  132. package/src/effects/ColorModule.ts +0 -60
  133. package/src/effects/ForceModule.ts +0 -25
  134. package/src/effects/GPUParticleBackend.ts +0 -569
  135. package/src/effects/Particle.ts +0 -108
  136. package/src/effects/ParticleDiagnostics.ts +0 -224
  137. package/src/effects/ParticleEffectPresets.ts +0 -147
  138. package/src/effects/ParticleEmitter.ts +0 -326
  139. package/src/effects/ParticleModule.ts +0 -26
  140. package/src/effects/ParticleRenderPass.ts +0 -117
  141. package/src/effects/ParticleRenderer.ts +0 -132
  142. package/src/effects/ParticleSystem.ts +0 -333
  143. package/src/effects/SizeModule.ts +0 -56
  144. package/src/effects/TrailModule.ts +0 -72
  145. package/src/effects/VelocityModule.ts +0 -75
  146. package/src/effects/index.ts +0 -15
  147. package/src/index.ts +0 -925
  148. package/src/materials/AlphaSorting.ts +0 -30
  149. package/src/materials/MaterialExtensions.ts +0 -42
  150. package/src/materials/PhysicalMaterial.ts +0 -133
  151. package/src/materials/TransmissionPass.ts +0 -51
  152. package/src/performance/BVH.ts +0 -18
  153. package/src/performance/Batcher.ts +0 -2
  154. package/src/performance/FrustumCuller.ts +0 -9
  155. package/src/performance/LOD.ts +0 -20
  156. package/src/performance/Octree.ts +0 -10
  157. package/src/performance/RenderItemSorting.ts +0 -170
  158. package/src/performance/RendererStats.ts +0 -43
  159. package/src/performance/ResourceBudget.ts +0 -44
  160. package/src/postprocess/BloomPass.ts +0 -28
  161. package/src/postprocess/CinematicDiagnostics.ts +0 -642
  162. package/src/postprocess/ColorGradingPass.ts +0 -24
  163. package/src/postprocess/DepthOfFieldPass.ts +0 -12
  164. package/src/postprocess/EffectComposer.ts +0 -349
  165. package/src/postprocess/SSAOPass.ts +0 -20
  166. package/src/postprocess/index.ts +0 -34
  167. package/src/production-runtime/AnimationControlsPipeline.ts +0 -77
  168. package/src/production-runtime/PBRHDRPipeline.ts +0 -381
  169. package/src/production-runtime/ProductionEffectsPipeline.ts +0 -85
  170. package/src/production-runtime/ProductionRendererTypes.ts +0 -136
  171. package/src/production-runtime/ProductionRuntimeRenderer.ts +0 -172
  172. package/src/production-runtime/ProductionWebGL2Renderer.ts +0 -313
  173. package/src/production-runtime/ProductionWebGPURenderer.ts +0 -396
  174. package/src/production-runtime/TransmissionBackdropCapture.ts +0 -130
  175. package/src/production-runtime/animation/MorphTargetRenderer.ts +0 -2
  176. package/src/production-runtime/animation/SkinningRenderer.ts +0 -2
  177. package/src/production-runtime/backends/RendererBackend.ts +0 -17
  178. package/src/production-runtime/backends/WebGL2RendererBackend.ts +0 -30
  179. package/src/production-runtime/backends/WebGPURendererBackend.ts +0 -24
  180. package/src/production-runtime/backends/webgl2/WebGL2Buffer.ts +0 -2
  181. package/src/production-runtime/backends/webgl2/WebGL2Capabilities.ts +0 -2
  182. package/src/production-runtime/backends/webgl2/WebGL2RenderTarget.ts +0 -2
  183. package/src/production-runtime/backends/webgl2/WebGL2Shader.ts +0 -2
  184. package/src/production-runtime/backends/webgl2/WebGL2StateCache.ts +0 -1
  185. package/src/production-runtime/backends/webgl2/WebGL2Texture.ts +0 -2
  186. package/src/production-runtime/backends/webgpu/WebGPUBuffer.ts +0 -2
  187. package/src/production-runtime/backends/webgpu/WebGPUCapabilities.ts +0 -2
  188. package/src/production-runtime/backends/webgpu/WebGPURenderTarget.ts +0 -2
  189. package/src/production-runtime/backends/webgpu/WebGPUShader.ts +0 -2
  190. package/src/production-runtime/backends/webgpu/WebGPUTexture.ts +0 -2
  191. package/src/production-runtime/color/ColorManagement.ts +0 -3
  192. package/src/production-runtime/color/ToneMapping.ts +0 -7
  193. package/src/production-runtime/diagnostics/FrameCapture.ts +0 -2
  194. package/src/production-runtime/diagnostics/GPUCapabilities.ts +0 -2
  195. package/src/production-runtime/diagnostics/RendererStats.ts +0 -2
  196. package/src/production-runtime/environment/EnvironmentMap.ts +0 -1
  197. package/src/production-runtime/environment/HDRLoader.ts +0 -57
  198. package/src/production-runtime/environment/PMREMGenerator.ts +0 -713
  199. package/src/production-runtime/framegraph/FrameGraph.ts +0 -18
  200. package/src/production-runtime/framegraph/RenderPass.ts +0 -15
  201. package/src/production-runtime/geometry/ProjectedDecalGeometry.ts +0 -439
  202. package/src/production-runtime/index.ts +0 -127
  203. package/src/production-runtime/lights/LightManager.ts +0 -7
  204. package/src/production-runtime/lights/ShadowMapRenderer.ts +0 -5
  205. package/src/production-runtime/materials/GLTFMaterialAdapter.ts +0 -6
  206. package/src/production-runtime/materials/GLTFPBRMaterialAdapter.ts +0 -2
  207. package/src/production-runtime/materials/MaterialCompiler.ts +0 -7
  208. package/src/production-runtime/materials/MaterialTextureBindings.ts +0 -5
  209. package/src/production-runtime/materials/PBRMaterial.ts +0 -2
  210. package/src/production-runtime/materials/PBRShaderFeatures.ts +0 -2
  211. package/src/production-runtime/passes/ContactShadowPass.ts +0 -184
  212. package/src/production-runtime/passes/DepthPrepass.ts +0 -7
  213. package/src/production-runtime/passes/OpaquePass.ts +0 -7
  214. package/src/production-runtime/passes/ShadowPass.ts +0 -7
  215. package/src/production-runtime/passes/SkyboxPass.ts +0 -7
  216. package/src/production-runtime/passes/ToneMappingPass.ts +0 -7
  217. package/src/production-runtime/passes/TransparentPass.ts +0 -7
  218. package/src/production-runtime/postprocess/BloomPass.ts +0 -51
  219. package/src/production-runtime/postprocess/ColorGradingPass.ts +0 -49
  220. package/src/production-runtime/postprocess/DOFPass.ts +0 -47
  221. package/src/production-runtime/postprocess/FXAAPass.ts +0 -53
  222. package/src/production-runtime/postprocess/ProductionEffectComposer.ts +0 -78
  223. package/src/production-runtime/postprocess/ProductionPostProcessTypes.ts +0 -174
  224. package/src/production-runtime/postprocess/SSAOPass.ts +0 -45
  225. package/src/production-runtime/resources/GPUBuffer.ts +0 -2
  226. package/src/production-runtime/resources/GPUTexture.ts +0 -2
  227. package/src/production-runtime/resources/RenderTarget.ts +0 -3
  228. package/src/production-runtime/resources/ResourceCache.ts +0 -7
  229. package/src/production-runtime/scene/Camera.ts +0 -1
  230. package/src/production-runtime/scene/Lights.ts +0 -2
  231. package/src/production-runtime/scene/RenderableMesh.ts +0 -2
  232. package/src/production-runtime/scene/RenderablePrimitive.ts +0 -1
  233. package/src/production-runtime/scene/RenderableScene.ts +0 -4
  234. package/src/production-runtime/shaders/ShaderProgramLibrary.ts +0 -7
  235. package/src/production-runtime/shaders/chunks/brdf.glsl +0 -2
  236. package/src/production-runtime/shaders/chunks/ibl.glsl +0 -3
  237. package/src/production-runtime/shaders/chunks/pbr.frag.glsl +0 -47
  238. package/src/production-runtime/shaders/chunks/pbr.vert.glsl +0 -8
  239. package/src/production-runtime/shaders/chunks/shadows.glsl +0 -2
  240. package/src/production-runtime/shaders/wgsl/pbr.wgsl +0 -3
  241. package/src/production-runtime/shaders/wgsl/postprocess.wgsl +0 -2
  242. package/src/production-runtime/shaders/wgsl/skybox.wgsl +0 -2
  243. package/src/shaders/depth.frag.glsl +0 -5
  244. package/src/shaders/depth.vert.glsl +0 -8
  245. package/src/shaders/pbr-direct.frag.glsl +0 -687
  246. package/src/shaders/pbr-direct.vert.glsl +0 -18
  247. package/src/shaders/unlit.frag.glsl +0 -18
  248. package/src/shaders/unlit.vert.glsl +0 -13
  249. package/src/shadows/CascadedShadowPipeline.ts +0 -53
  250. package/src/shadows/ContactShadows.ts +0 -106
  251. package/src/shadows/ShadowDebugViews.ts +0 -46
  252. package/src/threejs-compatibility/InstancingSystem.ts +0 -17
  253. package/src/threejs-compatibility/LightingSystem.ts +0 -22
  254. package/src/threejs-compatibility/MaterialSystem.ts +0 -9
  255. package/src/threejs-compatibility/RenderTargetSystem.ts +0 -35
  256. package/src/threejs-compatibility/RendererDiagnostics.ts +0 -61
  257. package/src/threejs-compatibility/SceneRenderer.ts +0 -34
  258. package/src/threejs-compatibility/ShadowSystem.ts +0 -19
  259. package/src/threejs-compatibility/TextureSystem.ts +0 -19
  260. package/src/threejs-compatibility/ThreeCompatRenderer.ts +0 -90
  261. package/src/threejs-compatibility/TransparencySystem.ts +0 -19
  262. package/src/threejs-compatibility/index.ts +0 -29
  263. package/src/threejs-compatibility/performance/BVH.ts +0 -14
  264. package/src/threejs-compatibility/performance/FrustumCulling.ts +0 -10
  265. package/src/threejs-compatibility/performance/Instancing.ts +0 -4
  266. package/src/threejs-compatibility/performance/LODSystem.ts +0 -16
  267. package/src/threejs-compatibility/performance/OcclusionCulling.ts +0 -6
  268. package/src/threejs-compatibility/performance/RaycastAcceleration.ts +0 -12
  269. package/src/threejs-compatibility/performance/RendererProfiler.ts +0 -19
  270. package/src/threejs-compatibility/performance/TextureStreaming.ts +0 -4
  271. package/src/threejs-compatibility/performance/index.ts +0 -12
  272. package/src/threejs-compatibility/postprocess/BloomPass.ts +0 -16
  273. package/src/threejs-compatibility/postprocess/ColorGradingPass.ts +0 -16
  274. package/src/threejs-compatibility/postprocess/DepthOfFieldPass.ts +0 -21
  275. package/src/threejs-compatibility/postprocess/EffectComposer.ts +0 -14
  276. package/src/threejs-compatibility/postprocess/FXAAPass.ts +0 -15
  277. package/src/threejs-compatibility/postprocess/MotionBlurPass.ts +0 -20
  278. package/src/threejs-compatibility/postprocess/OutlinePass.ts +0 -21
  279. package/src/threejs-compatibility/postprocess/PostProcessTypes.ts +0 -169
  280. package/src/threejs-compatibility/postprocess/RenderPass.ts +0 -9
  281. package/src/threejs-compatibility/postprocess/SMAAPass.ts +0 -15
  282. package/src/threejs-compatibility/postprocess/SSAOPass.ts +0 -21
  283. package/src/threejs-compatibility/postprocess/ShaderPass.ts +0 -7
  284. package/src/threejs-compatibility/postprocess/TAAPass.ts +0 -15
  285. package/src/threejs-compatibility/postprocess/VignettePass.ts +0 -16
  286. package/src/threejs-compatibility/postprocess/index.ts +0 -15
  287. package/src/threejs-compatibility/shaders/NodeMaterial.ts +0 -21
  288. package/src/threejs-compatibility/shaders/RawShaderMaterial.ts +0 -6
  289. package/src/threejs-compatibility/shaders/ShaderDiagnostics.ts +0 -17
  290. package/src/threejs-compatibility/shaders/ShaderMaterial.ts +0 -18
  291. package/src/threejs-compatibility/shaders/ThreeCompatShaderChunks.ts +0 -6
  292. package/src/threejs-compatibility/shaders/Uniforms.ts +0 -18
  293. package/src/threejs-compatibility/shaders/index.ts +0 -9
  294. package/src/threejs-compatibility/vfx/GPUPointCloud.ts +0 -7
  295. package/src/threejs-compatibility/vfx/LineRenderer.ts +0 -13
  296. package/src/threejs-compatibility/vfx/ParticleSystem.ts +0 -23
  297. package/src/threejs-compatibility/vfx/SpriteSystem.ts +0 -14
  298. package/src/threejs-compatibility/vfx/TrailRenderer.ts +0 -8
  299. package/src/threejs-compatibility/vfx/VFXDiagnostics.ts +0 -23
  300. package/src/threejs-compatibility/vfx/index.ts +0 -9
  301. package/src/threejs-example-parity/index.ts +0 -205
  302. package/src/webgpu/WebGPUBuffer.ts +0 -1
  303. package/src/webgpu/WebGPUCompute.ts +0 -2
  304. package/src/webgpu/WebGPUPipelineCache.ts +0 -15
  305. package/src/webgpu/WebGPUPostProcess.ts +0 -2
  306. package/src/webgpu/WebGPUTexture.ts +0 -2
  307. package/tsconfig.json +0 -26
  308. 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;