@meimu/mutracer 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -0,0 +1,222 @@
+# Changelog
+
+All notable changes to MuTracer will be documented here.
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## 0.3.1 - 2026-11-05
+
+Display upscaling with texture detail recovery, faster tiled rendering and faster dispersion.
+
+### Added
+
+- `createEasuPass()` is an edge-adaptive display upscale pass. With `albedoDetail: true` it restores surface texture detail from display-resolution color and depth AOVs, so beauty can render at a reduced `resolutionScale`. See [post-processing](docs/post-processing.md).
+- `display.addPostProcess(pass, {outputSize})` lets a pass output a different size than its input, for example the canvas size. `PostProcessOptions` is exported.
+- The `aovResolution: 'display'` render option traces AOVs at canvas size on WebGPU, capped at 4 samples, while beauty keeps the render resolution. WebGL 2 falls back to render resolution and warns once. See [surface outputs](docs/api.md#surface-outputs).
+- `diffuseColor` and `specularColor` AOVs output resolved material colors without BSDF integration, on both backends.
+- `render.getAovTexture('diffuseColor' | 'specularColor' | 'depth')` borrows raw AOV textures on WebGPU.
+
+### Changed
+
+- Missing tangents are generated only for materials that use anisotropy or a coat normal map. Base normal maps use triangle UV derivatives.
+- WebGPU stores vertex normals and tangents in compact form, and vertex colors in [0, 1] with at most 1/510 error per channel. Positions, UVs, HDR or negative vertex colors and displaced normals keep full precision. See [performance](docs/performance.md).
+- Exports of fixed-size renders are cropped to the requested size before post-process passes run.
+
+### Performance
+
+- Large scenes load faster and use less GPU memory on WebGPU with compact vertices.
+- Dispersion traces the shared camera path once before the first wavelength-dependent interaction, and direct-light resampling balances its candidates across RGB channels.
+- TLAS builds cull leaf instances by world bounds and use more SAH bins on the web.
+- Tiled rendering stops subdividing when the time budget cannot be reached or smaller tiles bring little speedup.
+- Russian roulette is deferred only for paths inside scattering media, so absorbing materials no longer lengthen every path in the scene.
+
+### Fixed
+
+- Multiple-scattering compensation for low-roughness metals no longer adds too much energy; they can look slightly darker under broad lighting.
+- Paths inside a subsurface medium intersect its boundary correctly; materials with short scattering radii can look darker.
+- Dispersive scenes no longer overcount emissive meshes, and WebGL 2 spectral direct lighting follows the same random streams as WebGPU.
+- Camera rays stay stable with very small near planes or extreme clip ranges.
+- An engine created on a canvas right after another engine on it was disposed no longer fails with "context is not configured".
+- WebGL 2 scenes that combine vertex colors, tangents, texture maps, emissive meshes and an environment no longer exceed 16 texture units and fail to link.
+- WebGL 2 scenes mixing analytic lights and emissive meshes compile again, and sphere and spot lights seen through transmissive surfaces keep their own radiance instead of the background.
+
+## 0.3.0 - 2026-11-02
+
+Experimental WebGPU caustics, continuous-wavelength dispersion and more responsive progressive rendering.
+
+### Added
+
+- Experimental WebGPU caustics with `render.caustics`, off by default and ignored on WebGL 2: `lightTracing` for directly visible receivers, `photonMapping` for receivers seen through glass or water. See the [caustics guide](docs/caustics.md).
+- `render.refineUntil(deadline, {signal})` refines once, then keeps sampling until the deadline or cancellation. Use it for custom frame loops; see [sample batching](docs/progressive-rendering.md#sample-batching).
+- `RenderLoop.lastError` holds the exception from the latest failed tick; `status` is `error` while it is set.
+
+### Changed
+
+- Dispersion samples continuous wavelengths, on camera paths and caustic photons, so rainbows and dispersive glass form smooth gradients instead of separate red, green and blue images. Scenes with dispersion render differently. `dispersionWavelengths` now counts paths per sample, each carrying one RGB channel.
+- `whenReadyToRefine()` returns `Promise<boolean>`: `true` when sampling was queued. Code typed against `Promise<void>` needs updating.
+- `gpuSampleTimeMs` also reports tiled samples, extrapolated from tile GPU time.
+
+### Deprecated
+
+Use `render.refineUntil()` instead of these. They keep working and will be removed in a later release.
+
+- `render.whenReadyToRefine()`
+- `render.gpuSampleTimeMs`
+- The `targetBatchTimeMs` and `deferResolve` options of `render.refine()`
+
+### Performance
+
+- RenderLoop keeps sampling expensive tiled renders between display frames instead of waiting for the next frame.
+
+### Fixed
+
+- Fixed-size renders, `readPixels()` and image exports return exactly the requested dimensions and keep their framing.
+- Renders with different caustic or shader settings no longer stall each other at 0 samples. Shader compilation keeps accumulated samples, and returning to a compiled configuration no longer waits for an obsolete compilation.
+- RenderLoop applies scene edits after a stalled preview denoiser, and resumes after caustic settings change on a finished render.
+- A cancelled denoiser that does not settle within 10 seconds no longer blocks later denoising, and new meshes no longer wait for obsolete BVH preparation.
+- Caustics stay visible in high-resolution renders and across clear interfaces.
+- Small spot lights no longer show precision banding.
+- One-sided emitters no longer emit from their back faces on secondary hits.
+- WebGL 2 samples emissive meshes as lights, so small emitters no longer produce heavy noise.
+- WebGL 2 keeps accumulated lighting when a path escapes to a flat or texture background.
+- WebGL 2 renders a selected AOV channel when it is the first thing drawn after a scene change, instead of staying at 0 samples.
+
+## 0.2.0 - 2026-10-28
+
+Faster WebGPU rendering, surface AOVs and procedural skies.
+
+### Performance
+
+Compared with v0.1.5, WebGPU shader compilation and rendering are faster across a 10-scene glTF benchmark (geometric means across scenes):
+
+| GPU | Shader compilation | Render time |
+| --- | ---: | ---: |
+| Apple M4 Max | -53.8% | -25.6% |
+| NVIDIA RTX 4060 Laptop GPU (Windows 11) | -74.5% | -40.9% |
+
+Results vary by scene, hardware, GPU load and shader cache.
+
+<details>
+<summary>Per-scene results</summary>
+
+Chrome 156, WebGPU, 1280×720, full-frame rendering without tiling, 3 bounces, denoising off. Render time is 32 samples after warmup, excluding loading, preparation and shader compilation, and waits for GPU completion. Each run uses the median of three measurements; results are medians of three runs. M4 Max shader compilation times are from the previous measurements. Values are v0.1.5 → v0.2.0 in seconds.
+
+Windows uses driver 617.42, comparing `a646620` → `08d6c63`, with `maxTiles=1`, Sobol sampling, atlas textures and 8 samples per batch. Each process warms up for 8 samples before three 32-sample renders; timings include scheduling and post-processing but exclude pixel readback. Fresh profiles, disabled shader disk caching and unique shader function names do not guarantee an empty driver cache. Across the three Windows rounds, compilation reductions ranged from 74.5% to 74.7%, and render-time reductions from 40.6% to 40.9%.
+
+| Scene | M4 Max compile | M4 Max render | RTX 4060 compile | RTX 4060 render |
+| --- | ---: | ---: | ---: | ---: |
+| Classroom 2 | 2.32 → 1.15 | 3.49 → 2.52 | 8.082 → 2.154 | 7.181 → 5.153 |
+| Bathroom | 2.34 → 1.01 | 3.20 → 2.49 | 8.043 → 1.913 | 5.343 → 3.801 |
+| BMW M6 | 2.13 → 0.88 | 1.55 → 0.97 | 7.210 → 1.490 | 2.870 → 1.524 |
+| House | 2.15 → 0.93 | 1.63 → 1.30 | 7.238 → 1.603 | 4.468 → 2.167 |
+| Kitchen | 2.12 → 0.92 | 2.69 → 1.98 | 7.247 → 1.750 | 5.832 → 3.065 |
+| Blender Cover Remix | 2.35 → 1.15 | 1.34 → 0.91 | 8.193 → 2.422 | 2.078 → 1.437 |
+| LEGO Technic Bugatti Chiron | 2.13 → 1.01 | 1.46 → 1.15 | 7.109 → 1.807 | 4.142 → 2.026 |
+| 2025 Yamaha MT-09 SP V4 | 2.34 → 1.16 | 1.97 → 1.62 | 8.176 → 2.401 | 4.446 → 3.005 |
+| Gelatinous Cube | 2.31 → 1.15 | 2.60 → 2.02 | 8.104 → 2.403 | 5.025 → 3.390 |
+| Dragon | 2.16 → 1.03 | 1.76 → 1.32 | 7.574 → 1.886 | 3.896 → 1.904 |
+
+Earlier Windows 360p timings included excessive tile submissions in Classroom 2 and Kitchen. This rerun disables tiling in both versions to exclude that scheduling issue from the comparison.
+
+</details>
+
+### Added
+
+- Surface AOVs (`render.aovs`, `aovSamples`): depth, position, ID, motion and directional reflectance, on WebGPU and WebGL 2. View them with `display.channel`, read them back, or pass them to a custom denoiser.
+- `render.refine(kind)` traces a single AOV without adding beauty samples.
+- `batchSamples` lets one `refine()` call submit several samples within its time budget, so still renders are no longer limited to one sample per frame. Thanks to [@cedricpinson](https://github.com/cedricpinson) for the report and prototype ([#11](https://github.com/pissang/mutracer/issues/11)).
+- `ProceduralSky`: clear-sky environment textures.
+- `EquirectBackground` with `intensity` and rotation, synced from Three.js `backgroundIntensity` and `backgroundRotation`. Thanks to [@cedricpinson](https://github.com/cedricpinson) for the rotation report and proposed fix ([#9](https://github.com/pissang/mutracer/issues/9)).
+- Experimental WebGPU bindless material textures (`textureBinding: 'auto'`), falling back to the texture atlas.
+
+### Changed
+
+- SDR display and denoising use exact sRGB encoding on all backends instead of the browser's gamma 2.2 approximation. Dark and midtone pixels may look slightly different.
+- Progressive denoising updates are at least 500 ms apart.
+
+### Deprecated
+
+- `allowMultipleSamplesPerFrame`; use `batchSamples`.
+
+### Fixed
+
+- Public TypeScript declarations resolve under NodeNext module resolution with `skipLibCheck` off.
+- Shadow catcher contact shadows no longer weaken under environment light from below the receiver, or near emissive meshes on WebGPU. Thanks to [@cedricpinson](https://github.com/cedricpinson) for the emissive-mesh report and proposed fix ([#10](https://github.com/pissang/mutracer/issues/10)).
+- WebGL 2 waits for asynchronously compiled shaders before drawing.
+- Diagnostic channels show their original images without color denoising; native albedo display now matches the browser.
+- Native HDR presentation applies JNLM to extended-range output and can show completed display-linear denoising results.
+
+## 0.1.5 - 2026-10-22
+
+### Fixed
+
+- Coat normals no longer inherit the base normal map. Assign the same texture to both maps to perturb both layers. Thanks to [@BruceCherniak](https://github.com/BruceCherniak) ([#8](https://github.com/pissang/mutracer/issues/8)).
+
+## 0.1.4 - 2026-10-21
+
+### Added
+
+- Environment and grounded skybox intensity and rotation, synchronized from Three.js scenes.
+- Per-axis texture wrapping (repeat, clamp-to-edge, mirrored-repeat).
+- Explicit sRGB or linear decoding for color textures, preserved from Three.js.
+
+### Fixed
+
+- Three.js conversion keeps vertex colors. Thanks to [@zz85](https://github.com/zz85) ([#7](https://github.com/pissang/mutracer/issues/7)).
+- Three.js conversion keeps back-side materials and half-float or R/RG/RGB/RGBA data textures.
+- Converted equirectangular environments match Three.js orientation. Thanks to [@zz85](https://github.com/zz85) ([#6](https://github.com/pissang/mutracer/issues/6)).
+- Fully metallic glTF materials without a metalness map ignore specular settings, as in glTF. Thanks to [@BruceCherniak](https://github.com/BruceCherniak) ([#4](https://github.com/pissang/mutracer/issues/4)).
+- Spot light falloff between the inner and outer cones. Thanks to [@zz85](https://github.com/zz85) ([#5](https://github.com/pissang/mutracer/issues/5)).
+
+## 0.1.3 - 2026-10-19
+
+### Changed
+
+- `webgpu-utils` is no longer a dependency.
+
+### Fixed
+
+- Adding untextured lights after a scene update. Thanks to [@ertugrulerkan](https://github.com/ertugrulerkan) ([#1](https://github.com/pissang/mutracer/issues/1)).
+- WebGPU shadow catcher edges over opaque flat backgrounds, and OIDN artifacts around silhouettes over shadow catchers.
+
+## 0.1.2 - 2026-10-16
+
+### Added
+
+- `displacementBias` (default `0`) for signed displacement offsets on WebGPU.
+
+### Changed
+
+- `displacementStepSize` defaults to `0` (1/32 of the displacement height). Set `0.01` for the previous behavior.
+- Three.js materials without a displacement map convert with MuTracer's default height `0.1` instead of `1`.
+
+### Fixed
+
+- Displacement updates after map, image or height edits, including shared geometry, and stays consistent under scaled transforms.
+- WebGL 2 renders the undisplaced surface when displacement settings are present.
+- Stationary clicks with Three.js controls keep accumulated samples.
+
+## 0.1.1 - 2026-10-14
+
+### Changed
+
+- Interactive previews adapt resolution to frame latency.
+
+### Fixed
+
+- Denoised previews stay responsive during interaction and transition smoothly to the final render.
+- Three.js camera damping settles reliably.
+- Animation and incremental geometry updates keep prepared BVHs.
+- Shadow catcher denoising uses albedo and normal guides.
+
+## 0.1.0 - 2026-10-14
+
+### Added
+
+- Progressive path tracing on WebGPU with a WebGL 2 fallback.
+- Area, sphere, spot/IES, directional and environment lights with MIS.
+- OpenPBR 1.1 materials.
+- Worker-built static BVHs (TypeScript SAH or TinyBVH WebAssembly) with instance refits.
+- OIDN denoising for previews and final images.
+- Three.js scene conversion and synchronization with `THREESceneSync`.
+- Sobol, ZSobol and random sampling, deterministic offline rendering and adaptive sampling.
+- Tone mapping, color grading, bloom, shadow catchers, transparent backgrounds and depth of field.

package/LICENSES/FidelityFX-FSR.txt

@@ -0,0 +1,19 @@
+Copyright (c) 2021 Advanced Micro Devices, Inc. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/LICENSES/pbrt-v4-Apache-2.0.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -19,6 +19,9 @@ APIs may change between minor releases.
   fuzz, thin-film interference, dispersive transmission with absorption and
   volume scattering, subsurface scattering, emission and ray-marched
   height-field displacement.
+- **Experimental caustics (WebGPU)**: light tracing for directly visible
+  receivers and photon mapping for receivers seen through glass or water. See
+  the [caustics guide](docs/caustics.md).
 - **Interactive with millions of triangles**: a two-level BVH whose BLASes are
   built with binned SAH in parallel Workers (a JavaScript port of TinyBVH, or
   the TinyBVH WebAssembly builder with SBVH and CWBVH layouts). Moving

package/THIRD_PARTY_NOTICES.md

@@ -45,10 +45,7 @@ The ideal-metal direction/average energy tables and multiple-scattering lobe
 additionally adapt `impl/openpbr_microfacet_multiple_scattering_lobes.h`,
 `impl/openpbr_microfacet_multiple_scattering_data.h`, and
 `impl/data/openpbr_ideal_metal_{,avg_}energy_complement_data.h` at the same
-`c91aad1d1ce1693e803f039d7c92c2965c4eb013` commit. Directional tables use
-row-normalized encoding; metal and ideal-dielectric averages retain exact u16
-values in compact rows. The uniform-hemisphere proposal is mixed within the
-existing metal sampling lobe.
+`c91aad1d1ce1693e803f039d7c92c2965c4eb013` commit.
 
 The ideal-dielectric reflection/transmission multiple-scattering lobe and
 three additional tables adapt the same commit's
@@ -163,3 +160,20 @@ and MIT license are described in the TinyBVH section above; the full text is
 also included in [`LICENSES/TinyBVH-MIT.txt`](./LICENSES/TinyBVH-MIT.txt).
 These license files are copied without modification from the installed
 packages and the checked-in TinyBVH license.
+
+## PBRT-v4 spectral data and Loop subdivision
+
+The developer/viewer PBRT importer includes spectral tables derived from
+[`mmp/pbrt-v4@b0bdf461ba5dd6504b70ebf0932acc0fe7aa744f`](https://github.com/mmp/pbrt-v4/tree/b0bdf461ba5dd6504b70ebf0932acc0fe7aa744f),
+`src/pbrt/util/spectrum.cpp` and measured scattering coefficients from
+`src/pbrt/media.cpp`, and Loop subdivision weights and limit projection
+from `src/pbrt/util/loopsubdiv.cpp`, copyright (c) 1998-2020 Matt Pharr, Wenzel Jakob,
+and Greg Humphreys. Licensed under Apache-2.0; the license is reproduced in
+[`LICENSES/pbrt-v4-Apache-2.0.txt`](LICENSES/pbrt-v4-Apache-2.0.txt).
+
+## AMD FidelityFX FSR 1
+
+The optional Web and native EASU display upscale adapts the 32-bit EASU functions from
+[FidelityFX FSR 1](https://github.com/GPUOpen-Effects/FidelityFX-FSR),
+`ffx_fsr1.h` v1.20210629, copyright (c) 2021 Advanced Micro Devices, Inc.
+Licensed under MIT; see [LICENSES/FidelityFX-FSR.txt](LICENSES/FidelityFX-FSR.txt).