@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,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
- }