docs(shaders): add v2.20 msdfPS chunk migration entry#1067
Merged
Conversation
Document the v2.20 msdfPS chunk rework (text now renders at the true glyph edge with gradient-based AA) and the removal of the font_pxrange and font_textureWidth uniforms and the map() helper. Custom msdfPS overrides referencing these must be updated, otherwise the old smoothing calculation hits a divide-by-zero and text breaks. Added to both the English and Japanese migration pages, linking the engine PR. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…page The Japanese migration page lagged the English one, missing the v2.16 (gsplat accessor renames, gsplatCustomizeVS removal) and v2.15 (gsplat shader customization) entries. Add translated versions so the JA page structurally matches the English page. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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
1 participant
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.
!!!!!!!! MERGE WHEN engine v2.20.0 is out !!!!!!!!!
Summary
Updates the shader chunk migrations page (English + Japanese):
msdfPSchunk rework, companion to engine PR fix(element): render MSDF text at the true glyph edge engine#8935 (will be merged shortly).v2.20 entry
The engine PR:
msdfPSto render text at the true glyph edge and anti-alias from the distance-field gradient.font_pxrangeandfont_textureWidthuniforms (no longer set by the engine) and themap()helper.msdfPSin the chunk-version table at API2.20, so a custom override of the chunk is flagged by the chunk validator.The migration note warns that a custom
msdfPSoverride copied from an earlier release that still references the removed uniforms will no longer receive their values — the old smoothing calculation then hits a divide-by-zero, breaking text — and points users to update their override and bumpshaderChunksVersionto2.20.Japanese backfill
The JA page lagged the English one, with its newest entry at v2.6. Added translated v2.16 (gsplat accessor renames,
gsplatCustomizeVSremoval) and v2.15 (gsplat shader customization) entries so the two pages list the same releases.Changes
docs/user-manual/graphics/shaders/migrations.md— English v2.20 entry.i18n/ja/.../graphics/shaders/migrations.md— Japanese v2.20 entry + backfilled v2.16 / v2.15.Notes