Enhance font hinting and ANI documentation in ImageSharp - #81
Merged
Conversation
Updates documentation across Fonts and ImageSharp with major new guidance: generalized font hinting (including Standard/Full modes and CFF behavior), direct text shaping APIs, layout additions like visible bounds and font weight/style synthesis, and custom renderer parameter updates. Adds a new ANI format page and links ANI throughout image format docs and TOC. ImageSharp.Drawing docs now cover layer/backdrop effects, antialias and blending clarifications, and WebGPU alpha/pixel-format behavior (including associated-alpha readback mapping). External submodule references were also advanced.
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.
This pull request updates and expands the documentation for SixLabors.Fonts, introducing new features and clarifying existing behaviors related to color fonts, fallback font resolution, font metrics, hinting, and custom rendering. The most significant changes include new documentation for font palettes and fallback resolvers, a comprehensive rewrite of the font hinting section to explain multiple hinting modes, and updates to custom rendering APIs and examples.
Color Font and Palette Enhancements:
TextOptions.FontPalette,FontPaletteOverride, and related APIs.BeginGroup/EndGroupin custom renderers, and updated references fromClipQuadtoClipBounds. [1] [2]Font Fallback Improvements:
TextOptions.FontFallbackResolver, including usage ofSystemFonts.FallbackResolverand custom resolvers viaIFontFallbackResolver. Updated shaping documentation to reflect the new fallback resolution order. [1] [2] [3]Font Hinting Documentation Rewrite:
HintingMode.Standard(vertical-only) andHintingMode.Full(classic bi-level) with detailed explanations of their effects and tradeoffs. [1] [2] [3] [4]Custom Rendering API and Example Updates:
TextRenderer.RenderToinstead ofRenderTextTo, addedBeginGroup/EndGroupto theIGlyphRendererexample, and clarified thatGlyphRendererParametersnow includesHintingModefor cache key purposes. [1] [2] [3] [4]Font Metrics Clarification:
FontMetrics.XHeightandFontMetrics.CapHeightto clarify how lowercase and capital letter heights are represented.