Update the splat LOD docs for engine 2.23's distance-only LOD - #1267
Open
willeastcott wants to merge 1 commit into
Open
willeastcott wants to merge 1 commit into
willeastcott wants to merge 1 commit into
Conversation
Engine 2.23 (playcanvas/engine#9584) removed GSplatParams#lodMode and GSplatComponent#lodFalloff. LOD is chosen by distance from lodBaseDistance and lodMultiplier, and the new splatBudgetMode makes the splat budget a target to fill (default) or a limit. A budget of 0 or less means no budget. Rewrite the Streamed SOG and Performance LOD sections (en + ja) to match, and correct the Streamed SOG format spec, which said the engine spends its budget by the lodErrors data it no longer reads. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Updates the engine Gaussian splatting LOD docs (en + ja) for PlayCanvas Engine 2.23.0, where splat LOD became distance-only again (playcanvas/engine#9584). I checked the text against
gsplat-params.js,component.js,constants.jsand the budget balancer at engine tagv2.23.0.What changed
Streamed SOG (
building/lod-streaming.md)lodBaseDistance(default 5, minimum 0.1, world units, the LOD 0 → 1 transition) andlodMultiplier(default 3, minimum 1.2, the factor between successive transitions). It includes a worked example of the transition distances and the FOV compensation.splatBudgetMode:GSPLAT_BUDGET_TARGET(default) raises detail until the budget is used up. The engine scales every splat's LOD distances by one shared factor, so the distances only shape the falloff.GSPLAT_BUDGET_LIMITlets the distances decide the detail, and the budget only lowers it.Performance (
building/performance.md)lodBaseDistance/lodMultiplier/splatBudgetModesnippet instead oflodMode/lodFalloff.Streamed SOG format spec (
formats/streamed-sog.md, §3.3)lodErrors/errorsdata, so the line "the PlayCanvas engine spends its splat budget by error removed per splat" now says it picks LOD levels by camera distance and does not read them. The format section itself is unchanged.Japanese
{#how-lod-is-chosen},{#budget-mode},{#lod-distances-and-budget-mode}).Not changed
docs-web-components-0-28-0branch.editor/scenes/components/gsplat.mdLOD Falloff,editor/interface/settings/rendering.md): it documents the Editor UI, and Editormainstill exposes LOD Falloff and LOD Mode (src/editor/inspector/components/gsplat.ts,settings-panels/rendering.ts). Those pages should change when the Editor picks up engine 2.23.Verification
npm run lint: 0 issues.npm run build(en + ja): succeeds with no broken links or anchors.🤖 Generated with Claude Code