@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,314 +0,0 @@
1
- import { sampleTerrainHeightfield, type TerrainHeightfieldFixture } from "./TerrainFixtures";
2
-
3
- export type VegetationFixtureLayer = "tree" | "grass" | "shrub";
4
- export type VegetationFixtureLod = "mesh" | "impostor" | "culled";
5
-
6
- export interface VegetationFixtureOptions {
7
- readonly terrain: TerrainHeightfieldFixture;
8
- readonly seed?: number;
9
- readonly cameraX?: number;
10
- readonly elapsedSeconds?: number;
11
- readonly maxInstances?: number;
12
- }
13
-
14
- export interface VegetationFixtureInstance {
15
- readonly id: string;
16
- readonly layer: VegetationFixtureLayer;
17
- readonly x: number;
18
- readonly y: number;
19
- readonly z: number;
20
- readonly scale: number;
21
- readonly rotation: number;
22
- readonly distanceToCamera: number;
23
- readonly lod: VegetationFixtureLod;
24
- readonly windOffsetX: number;
25
- readonly windOffsetZ: number;
26
- }
27
-
28
- export interface VegetationLSystemBranchSegment {
29
- readonly instanceId: string;
30
- readonly startX: number;
31
- readonly startY: number;
32
- readonly startZ: number;
33
- readonly endX: number;
34
- readonly endY: number;
35
- readonly endZ: number;
36
- readonly width: number;
37
- readonly depth: number;
38
- }
39
-
40
- export interface VegetationLSystemFixture {
41
- readonly source: "origin-master-lsystem-turtle-adapted";
42
- readonly axiom: "F";
43
- readonly rule: "F -> F[+F][-F]!F";
44
- readonly iterations: number;
45
- readonly generatedSymbolLength: number;
46
- readonly branchSegmentCount: number;
47
- readonly renderedBranchSegmentCount: number;
48
- readonly branchTipCount: number;
49
- readonly maxDepth: number;
50
- readonly hash: string;
51
- readonly segments: readonly VegetationLSystemBranchSegment[];
52
- readonly claimBoundary: string;
53
- }
54
-
55
- export interface VegetationFixtureSample {
56
- readonly id: "external-parity-old-branch-vegetation-fixture";
57
- readonly source: "origin-master-vegetation-system-adapted";
58
- readonly seed: number;
59
- readonly instanceCount: number;
60
- readonly visibleCount: number;
61
- readonly culledCount: number;
62
- readonly meshLodCount: number;
63
- readonly impostorLodCount: number;
64
- readonly treeCount: number;
65
- readonly grassCount: number;
66
- readonly shrubCount: number;
67
- readonly maxWindOffset: number;
68
- readonly instances: readonly VegetationFixtureInstance[];
69
- readonly lsystem: VegetationLSystemFixture;
70
- readonly hash: string;
71
- readonly claimBoundary: string;
72
- }
73
-
74
- export function sampleVegetationFixture(options: VegetationFixtureOptions): VegetationFixtureSample {
75
- const terrain = options.terrain;
76
- const seed = options.seed ?? terrain.seed ^ 0x6eed;
77
- if (!Number.isInteger(seed)) {
78
- throw new RangeError("Vegetation fixture seed must be an integer.");
79
- }
80
- const cameraX = finite(options.cameraX ?? 0, "cameraX");
81
- const elapsedSeconds = Math.max(0, finite(options.elapsedSeconds ?? 0, "elapsedSeconds"));
82
- const maxInstances = Math.max(1, Math.min(512, Math.floor(options.maxInstances ?? 96)));
83
- const instances: VegetationFixtureInstance[] = [];
84
- const step = Math.max(2, Math.floor(Math.sqrt((terrain.width * terrain.height) / maxInstances)));
85
- for (let y = 1; y < terrain.height - 1 && instances.length < maxInstances; y += step) {
86
- for (let x = 1; x < terrain.width - 1 && instances.length < maxInstances; x += step) {
87
- const sample = sampleTerrainHeightfield(terrain, x / (terrain.width - 1), y / (terrain.height - 1));
88
- const placement = placementFor(sample.biome, seed + x * 17 + y * 31);
89
- if (!placement) continue;
90
- const worldX = (x / (terrain.width - 1) - 0.5) * 5.2;
91
- const worldZ = (y / (terrain.height - 1) - 0.5) * 1.1;
92
- const distance = Math.abs(worldX - cameraX) + Math.abs(worldZ) * 0.35;
93
- const lod: VegetationFixtureLod = distance > 1.18 ? "culled" : distance > 0.62 ? "impostor" : "mesh";
94
- const wind = windDisplacement(worldX, worldZ, elapsedSeconds, placement.windResponse, seed);
95
- instances.push({
96
- id: `veg-${x}-${y}`,
97
- layer: placement.layer,
98
- x: Number(worldX.toFixed(4)),
99
- y: Number((sample.height * 0.7 - 0.53).toFixed(4)),
100
- z: Number(worldZ.toFixed(4)),
101
- scale: placement.scale,
102
- rotation: Number((seeded01(seed + x * 101 + y * 7) * Math.PI * 2).toFixed(4)),
103
- distanceToCamera: Number(distance.toFixed(4)),
104
- lod,
105
- windOffsetX: wind.x,
106
- windOffsetZ: wind.z
107
- });
108
- }
109
- }
110
- const visible = instances.filter((instance) => instance.lod !== "culled");
111
- const meshLodCount = instances.filter((instance) => instance.lod === "mesh").length;
112
- const impostorLodCount = instances.filter((instance) => instance.lod === "impostor").length;
113
- const treeCount = instances.filter((instance) => instance.layer === "tree").length;
114
- const grassCount = instances.filter((instance) => instance.layer === "grass").length;
115
- const shrubCount = instances.filter((instance) => instance.layer === "shrub").length;
116
- const maxWindOffset = Math.max(0, ...instances.map((instance) => Math.hypot(instance.windOffsetX, instance.windOffsetZ)));
117
- const lsystem = createVegetationLSystemFixture(instances, seed);
118
- return {
119
- id: "external-parity-old-branch-vegetation-fixture",
120
- source: "origin-master-vegetation-system-adapted",
121
- seed,
122
- instanceCount: instances.length,
123
- visibleCount: visible.length,
124
- culledCount: instances.length - visible.length,
125
- meshLodCount,
126
- impostorLodCount,
127
- treeCount,
128
- grassCount,
129
- shrubCount,
130
- maxWindOffset: Number(maxWindOffset.toFixed(5)),
131
- instances,
132
- lsystem,
133
- hash: hashVegetation(instances, lsystem.hash),
134
- claimBoundary: "Deterministic biome-aware vegetation placement, LOD selection, culling, wind-displacement telemetry, and bounded L-system branch/tip telemetry adapted from the old vegetation and L-system systems; this is bounded fixture evidence, not instanced vegetation rendering, billboards, collision, seasonal growth, procedural mesh generation, or production terrain vegetation parity."
135
- };
136
- }
137
-
138
- function createVegetationLSystemFixture(instances: readonly VegetationFixtureInstance[], seed: number): VegetationLSystemFixture {
139
- const iterations = 3;
140
- const generated = generateDOL("F", "F[+F][-F]!F", iterations);
141
- const visibleTrees = instances.filter((instance) => instance.layer === "tree" && instance.lod !== "culled");
142
- const visibleVegetation = instances.filter((instance) => instance.lod !== "culled");
143
- const treeFallback = instances.filter((instance) => instance.layer === "tree");
144
- const branchSources = (visibleTrees.length > 0 ? visibleTrees : visibleVegetation.length > 0 ? visibleVegetation : treeFallback).slice(0, 8);
145
- const segments = branchSources.flatMap((instance, index) => interpretTreeLSystem(generated, instance, seed + index * 971)).slice(0, 160);
146
- const branchTipCount = countBranchTips(generated) * branchSources.length;
147
- const maxDepth = segments.reduce((max, segment) => Math.max(max, segment.depth), 0);
148
- return {
149
- source: "origin-master-lsystem-turtle-adapted",
150
- axiom: "F",
151
- rule: "F -> F[+F][-F]!F",
152
- iterations,
153
- generatedSymbolLength: generated.length,
154
- branchSegmentCount: countDrawCommands(generated) * branchSources.length,
155
- renderedBranchSegmentCount: segments.length,
156
- branchTipCount,
157
- maxDepth,
158
- hash: hashLSystemSegments(generated, segments),
159
- segments,
160
- claimBoundary: "D0L grammar expansion and turtle-style branch interpretation adapted from the old L-system code as deterministic vegetation evidence only; this does not claim production procedural tree meshes, botanical simulation, growth, collision, or Unity/Unreal vegetation parity."
161
- };
162
- }
163
-
164
- function generateDOL(axiom: string, successor: string, iterations: number): string {
165
- let current = axiom;
166
- for (let iteration = 0; iteration < iterations; iteration += 1) {
167
- let next = "";
168
- for (const symbol of current) {
169
- next += symbol === "F" ? successor : symbol;
170
- }
171
- current = next.length > 4_096 ? next.slice(0, 4_096) : next;
172
- }
173
- return current;
174
- }
175
-
176
- function interpretTreeLSystem(generated: string, instance: VegetationFixtureInstance, seed: number): VegetationLSystemBranchSegment[] {
177
- const angle = 0.45 + seeded01(seed ^ 0x512) * 0.22;
178
- const step = instance.scale * (instance.lod === "impostor" ? 0.72 : 1);
179
- const stack: { x: number; y: number; z: number; heading: number; width: number; depth: number }[] = [];
180
- const state = { x: instance.x + instance.windOffsetX, y: instance.y, z: instance.z + instance.windOffsetZ, heading: Math.PI / 2, width: Math.max(0.006, step * 0.28), depth: 0 };
181
- const segments: VegetationLSystemBranchSegment[] = [];
182
- for (const symbol of generated) {
183
- if (symbol === "F") {
184
- const startX = state.x;
185
- const startY = state.y;
186
- const startZ = state.z;
187
- state.x += Math.cos(state.heading) * step;
188
- state.y += Math.sin(state.heading) * step * 1.45;
189
- state.z += Math.sin(state.heading * 0.73 + seed * 0.001) * step * 0.22;
190
- segments.push({
191
- instanceId: instance.id,
192
- startX: Number(startX.toFixed(4)),
193
- startY: Number(startY.toFixed(4)),
194
- startZ: Number(startZ.toFixed(4)),
195
- endX: Number(state.x.toFixed(4)),
196
- endY: Number(state.y.toFixed(4)),
197
- endZ: Number(state.z.toFixed(4)),
198
- width: Number(state.width.toFixed(5)),
199
- depth: state.depth
200
- });
201
- } else if (symbol === "+") {
202
- state.heading += angle;
203
- } else if (symbol === "-") {
204
- state.heading -= angle;
205
- } else if (symbol === "[") {
206
- stack.push({ ...state });
207
- state.depth += 1;
208
- state.width *= 0.72;
209
- } else if (symbol === "]") {
210
- const popped = stack.pop();
211
- if (popped) {
212
- state.x = popped.x;
213
- state.y = popped.y;
214
- state.z = popped.z;
215
- state.heading = popped.heading;
216
- state.width = popped.width;
217
- state.depth = popped.depth;
218
- }
219
- } else if (symbol === "!") {
220
- state.width *= 0.78;
221
- }
222
- }
223
- return segments;
224
- }
225
-
226
- function countDrawCommands(value: string): number {
227
- let count = 0;
228
- for (const symbol of value) {
229
- if (symbol === "F") count += 1;
230
- }
231
- return count;
232
- }
233
-
234
- function countBranchTips(value: string): number {
235
- let tips = 0;
236
- for (let index = 0; index < value.length; index += 1) {
237
- if (value[index] === "F" && value[index + 1] !== "[") tips += 1;
238
- }
239
- return tips;
240
- }
241
-
242
- function placementFor(biome: string, seed: number): { readonly layer: VegetationFixtureLayer; readonly scale: number; readonly windResponse: number } | null {
243
- const roll = seeded01(seed);
244
- if (biome === "forest") {
245
- return roll < 0.72 ? { layer: "tree", scale: 0.09 + seeded01(seed ^ 0x51) * 0.08, windResponse: 0.45 } : { layer: "shrub", scale: 0.05, windResponse: 0.7 };
246
- }
247
- if (biome === "grassland") {
248
- return roll < 0.62 ? { layer: "grass", scale: 0.035 + seeded01(seed ^ 0x22) * 0.025, windResponse: 1 } : null;
249
- }
250
- if (biome === "beach") {
251
- return roll < 0.2 ? { layer: "grass", scale: 0.03, windResponse: 0.9 } : null;
252
- }
253
- return null;
254
- }
255
-
256
- function windDisplacement(x: number, z: number, time: number, response: number, seed: number): { readonly x: number; readonly z: number } {
257
- const gust = Math.sin(time * 1.8 + x * 2.1 + z * 1.3 + seeded01(seed) * Math.PI * 2);
258
- const turbulence = Math.sin(time * 3.2 + x * 4.4 - z * 2.7);
259
- return {
260
- x: Number(((gust * 0.018 + turbulence * 0.006) * response).toFixed(5)),
261
- z: Number((Math.cos(time * 1.3 + z * 3.1) * 0.01 * response).toFixed(5))
262
- };
263
- }
264
-
265
- function hashVegetation(instances: readonly VegetationFixtureInstance[], lsystemHash: string): string {
266
- let hash = 0x811c9dc5;
267
- for (const char of lsystemHash) {
268
- hash ^= char.charCodeAt(0);
269
- hash = Math.imul(hash, 0x01000193) >>> 0;
270
- }
271
- for (const instance of instances) {
272
- for (const value of [instance.x, instance.y, instance.z, instance.scale, instance.windOffsetX, instance.windOffsetZ]) {
273
- const scaled = Math.round(value * 10_000);
274
- hash ^= scaled & 0xff;
275
- hash = Math.imul(hash, 0x01000193) >>> 0;
276
- hash ^= (scaled >>> 8) & 0xff;
277
- hash = Math.imul(hash, 0x01000193) >>> 0;
278
- }
279
- hash ^= instance.layer.charCodeAt(0);
280
- hash = Math.imul(hash, 0x01000193) >>> 0;
281
- hash ^= instance.lod.charCodeAt(0);
282
- hash = Math.imul(hash, 0x01000193) >>> 0;
283
- }
284
- return hash.toString(16).padStart(8, "0");
285
- }
286
-
287
- function hashLSystemSegments(generated: string, segments: readonly VegetationLSystemBranchSegment[]): string {
288
- let hash = 0x9e3779b9;
289
- for (const symbol of generated) {
290
- hash ^= symbol.charCodeAt(0);
291
- hash = Math.imul(hash, 0x85ebca6b) >>> 0;
292
- }
293
- for (const segment of segments) {
294
- for (const value of [segment.startX, segment.startY, segment.startZ, segment.endX, segment.endY, segment.endZ, segment.width, segment.depth]) {
295
- const scaled = Math.round(value * 10_000);
296
- hash ^= scaled & 0xffff;
297
- hash = Math.imul(hash, 0xc2b2ae35) >>> 0;
298
- }
299
- }
300
- return hash.toString(16).padStart(8, "0");
301
- }
302
-
303
- function seeded01(seed: number): number {
304
- let value = seed >>> 0;
305
- value ^= value << 13;
306
- value ^= value >>> 17;
307
- value ^= value << 5;
308
- return ((value >>> 0) % 10_000) / 10_000;
309
- }
310
-
311
- function finite(value: number, label: string): number {
312
- if (!Number.isFinite(value)) throw new RangeError(`Vegetation fixture ${label} must be finite.`);
313
- return value;
314
- }
@@ -1,120 +0,0 @@
1
- import { type RenderBuffer, type RenderDevice, RenderDeviceError } from "./RenderDevice";
2
- import { type VertexAttributeSemantic, VertexFormat } from "./VertexFormat";
3
-
4
- export class VertexBuffer {
5
- public readonly data: ArrayBuffer;
6
- public readonly floats: Float32Array;
7
- private gpuBuffer: RenderBuffer | null = null;
8
- private dirtyStart = Number.POSITIVE_INFINITY;
9
- private dirtyEnd = 0;
10
- private disposed = false;
11
-
12
- constructor(
13
- public readonly format: VertexFormat,
14
- public readonly vertexCount: number
15
- ) {
16
- if (vertexCount <= 0 || !Number.isInteger(vertexCount)) {
17
- throw new Error("VertexBuffer vertexCount must be a positive integer");
18
- }
19
- this.data = new ArrayBuffer(format.stride * vertexCount);
20
- this.floats = new Float32Array(this.data);
21
- this.markDirty(0, this.data.byteLength);
22
- }
23
-
24
- get byteLength(): number {
25
- return this.data.byteLength;
26
- }
27
-
28
- get uploadedBuffer(): RenderBuffer | null {
29
- return this.gpuBuffer;
30
- }
31
-
32
- setAttribute(vertexIndex: number, semantic: VertexAttributeSemantic, values: readonly number[]): void {
33
- this.assertAlive();
34
- this.assertVertexIndex(vertexIndex);
35
- const attribute = this.format.getAttribute(semantic);
36
- if (values.length !== attribute.components) {
37
- throw new Error(`Semantic ${semantic} requires ${attribute.components} values, got ${values.length}`);
38
- }
39
- if (!values.every(Number.isFinite)) {
40
- throw new Error(`Semantic ${semantic} values must be finite`);
41
- }
42
- const byteOffset = vertexIndex * this.format.stride + attribute.offset;
43
- const floatOffset = byteOffset / 4;
44
- for (let i = 0; i < values.length; i += 1) {
45
- this.floats[floatOffset + i] = values[i] ?? 0;
46
- }
47
- this.markDirty(byteOffset, attribute.byteLength);
48
- }
49
-
50
- getAttribute(vertexIndex: number, semantic: VertexAttributeSemantic): readonly number[] {
51
- this.assertAlive();
52
- this.assertVertexIndex(vertexIndex);
53
- const attribute = this.format.getAttribute(semantic);
54
- const byteOffset = vertexIndex * this.format.stride + attribute.offset;
55
- const floatOffset = byteOffset / 4;
56
- return Array.from(this.floats.slice(floatOffset, floatOffset + attribute.components));
57
- }
58
-
59
- upload(device: RenderDevice): RenderBuffer {
60
- this.assertAlive();
61
- if (!this.gpuBuffer || this.gpuBuffer.disposed) {
62
- this.gpuBuffer = device.createBuffer("vertex", this.byteLength, new Uint8Array(this.data));
63
- this.clearDirty();
64
- return this.gpuBuffer;
65
- }
66
- if (this.isDirty()) {
67
- const start = alignDown(this.dirtyStart, 4);
68
- const end = alignUp(this.dirtyEnd, 4);
69
- device.updateBuffer(this.gpuBuffer, start, new Uint8Array(this.data, start, end - start));
70
- this.clearDirty();
71
- }
72
- return this.gpuBuffer;
73
- }
74
-
75
- getDirtyRange(): { readonly start: number; readonly end: number } | null {
76
- if (!this.isDirty()) {
77
- return null;
78
- }
79
- return { start: this.dirtyStart, end: this.dirtyEnd };
80
- }
81
-
82
- dispose(): void {
83
- this.gpuBuffer?.dispose();
84
- this.disposed = true;
85
- }
86
-
87
- private assertVertexIndex(vertexIndex: number): void {
88
- if (!Number.isInteger(vertexIndex) || vertexIndex < 0 || vertexIndex >= this.vertexCount) {
89
- throw new RangeError(`Vertex index ${vertexIndex} is out of range`);
90
- }
91
- }
92
-
93
- private assertAlive(): void {
94
- if (this.disposed) {
95
- throw new RenderDeviceError("VertexBuffer is disposed", "DISPOSED_RESOURCE");
96
- }
97
- }
98
-
99
- private markDirty(start: number, byteLength: number): void {
100
- this.dirtyStart = Math.min(this.dirtyStart, start);
101
- this.dirtyEnd = Math.max(this.dirtyEnd, start + byteLength);
102
- }
103
-
104
- private isDirty(): boolean {
105
- return this.dirtyStart <= this.dirtyEnd;
106
- }
107
-
108
- private clearDirty(): void {
109
- this.dirtyStart = Number.POSITIVE_INFINITY;
110
- this.dirtyEnd = 0;
111
- }
112
- }
113
-
114
- function alignDown(value: number, alignment: number): number {
115
- return Math.floor(value / alignment) * alignment;
116
- }
117
-
118
- function alignUp(value: number, alignment: number): number {
119
- return Math.ceil(value / alignment) * alignment;
120
- }
@@ -1,171 +0,0 @@
1
- export type VertexAttributeSemantic = "position" | "normal" | "uv" | "uv1" | "tangent" | "color" | "joints" | "weights";
2
-
3
- export type VertexAttributeType = "float32";
4
-
5
- export interface VertexAttributeDescriptor {
6
- readonly semantic: VertexAttributeSemantic;
7
- readonly components: 1 | 2 | 3 | 4;
8
- readonly offset: number;
9
- readonly type?: VertexAttributeType;
10
- readonly normalized?: boolean;
11
- readonly shaderLocation?: number;
12
- readonly shaderName?: string;
13
- }
14
-
15
- export class VertexAttribute {
16
- public readonly semantic: VertexAttributeSemantic;
17
- public readonly components: 1 | 2 | 3 | 4;
18
- public readonly offset: number;
19
- public readonly type: VertexAttributeType;
20
- public readonly normalized: boolean;
21
- public readonly shaderLocation: number;
22
- public readonly shaderName: string;
23
-
24
- constructor(descriptor: VertexAttributeDescriptor) {
25
- if (descriptor.offset < 0 || descriptor.offset % 4 !== 0) {
26
- throw new Error(`Vertex attribute ${descriptor.semantic} offset must be non-negative and 4-byte aligned`);
27
- }
28
- this.semantic = descriptor.semantic;
29
- this.components = descriptor.components;
30
- this.offset = descriptor.offset;
31
- this.type = descriptor.type ?? "float32";
32
- this.normalized = descriptor.normalized ?? false;
33
- this.shaderLocation = descriptor.shaderLocation ?? defaultShaderLocation(descriptor.semantic);
34
- this.shaderName = descriptor.shaderName ?? defaultShaderName(descriptor.semantic);
35
- }
36
-
37
- get byteLength(): number {
38
- return this.components * 4;
39
- }
40
- }
41
-
42
- export class VertexFormat {
43
- public readonly attributes: readonly VertexAttribute[];
44
- public readonly stride: number;
45
-
46
- constructor(attributes: readonly VertexAttributeDescriptor[], stride?: number) {
47
- if (attributes.length === 0) {
48
- throw new Error("VertexFormat requires at least one attribute");
49
- }
50
-
51
- const seen = new Set<VertexAttributeSemantic>();
52
- this.attributes = attributes.map((attribute) => {
53
- if (seen.has(attribute.semantic)) {
54
- throw new Error(`Duplicate vertex semantic: ${attribute.semantic}`);
55
- }
56
- seen.add(attribute.semantic);
57
- return new VertexAttribute(attribute);
58
- });
59
-
60
- const minimumStride = Math.max(...this.attributes.map((attribute) => attribute.offset + attribute.byteLength));
61
- this.stride = stride ?? minimumStride;
62
- if (this.stride < minimumStride) {
63
- throw new Error(`Vertex stride ${this.stride} is smaller than minimum required stride ${minimumStride}`);
64
- }
65
- if (this.stride % 4 !== 0) {
66
- throw new Error("Vertex stride must be 4-byte aligned");
67
- }
68
- }
69
-
70
- static readonly P3 = new VertexFormat([{ semantic: "position", components: 3, offset: 0 }], 12);
71
-
72
- static readonly P3N3 = new VertexFormat(
73
- [
74
- { semantic: "position", components: 3, offset: 0 },
75
- { semantic: "normal", components: 3, offset: 12 }
76
- ],
77
- 24
78
- );
79
-
80
- static readonly P3N3T2 = new VertexFormat(
81
- [
82
- { semantic: "position", components: 3, offset: 0 },
83
- { semantic: "normal", components: 3, offset: 12 },
84
- { semantic: "uv", components: 2, offset: 24 }
85
- ],
86
- 32
87
- );
88
-
89
- static readonly P3N3T4T2 = new VertexFormat(
90
- [
91
- { semantic: "position", components: 3, offset: 0 },
92
- { semantic: "normal", components: 3, offset: 12 },
93
- { semantic: "tangent", components: 4, offset: 24 },
94
- { semantic: "uv", components: 2, offset: 40 }
95
- ],
96
- 48
97
- );
98
-
99
- static readonly P3J4W4 = new VertexFormat(
100
- [
101
- { semantic: "position", components: 3, offset: 0 },
102
- { semantic: "joints", components: 4, offset: 12 },
103
- { semantic: "weights", components: 4, offset: 28 }
104
- ],
105
- 44
106
- );
107
-
108
- static readonly P3N3J4W4 = new VertexFormat(
109
- [
110
- { semantic: "position", components: 3, offset: 0 },
111
- { semantic: "normal", components: 3, offset: 12 },
112
- { semantic: "joints", components: 4, offset: 24 },
113
- { semantic: "weights", components: 4, offset: 40 }
114
- ],
115
- 56
116
- );
117
-
118
- getAttribute(semantic: VertexAttributeSemantic): VertexAttribute {
119
- const attribute = this.attributes.find((candidate) => candidate.semantic === semantic);
120
- if (!attribute) {
121
- throw new Error(`Vertex format does not contain semantic ${semantic}`);
122
- }
123
- return attribute;
124
- }
125
-
126
- hasAttribute(semantic: VertexAttributeSemantic): boolean {
127
- return this.attributes.some((attribute) => attribute.semantic === semantic);
128
- }
129
- }
130
-
131
- function defaultShaderLocation(semantic: VertexAttributeSemantic): number {
132
- switch (semantic) {
133
- case "position":
134
- return 0;
135
- case "normal":
136
- return 1;
137
- case "uv":
138
- return 2;
139
- case "tangent":
140
- return 3;
141
- case "color":
142
- return 4;
143
- case "joints":
144
- return 5;
145
- case "weights":
146
- return 6;
147
- case "uv1":
148
- return 7;
149
- }
150
- }
151
-
152
- function defaultShaderName(semantic: VertexAttributeSemantic): string {
153
- switch (semantic) {
154
- case "position":
155
- return "a_position";
156
- case "normal":
157
- return "a_normal";
158
- case "uv":
159
- return "a_uv";
160
- case "uv1":
161
- return "a_uv1";
162
- case "tangent":
163
- return "a_tangent";
164
- case "color":
165
- return "a_color";
166
- case "joints":
167
- return "a_joints";
168
- case "weights":
169
- return "a_weights";
170
- }
171
- }