#15 Introduce Text Renderer by Av3boy · Pull Request #145 · Av3boy/SharpEngine

Av3boy · 2026-09-05T11:43:20Z

#15 Introduce Text Renderer

Checklist

I have merged the latest changes from main to my branch.
I have tested my changes and any affected components.
I have added the proper documentation about my changes
I have made sure there is no overlapping work.
I have discussed any / all issues brought up from code review.

Doesn't work quite yet

Everything after this point needs to have a structure and proper planning. It's been a wild west until now

We need to start figuring out the shared repo and how the "main" repo will build as open source

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

sonarqubecloud · 2026-09-20T17:21:13Z

Quality Gate passed

Issues
58 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

Copilot

Copilot review overview

🟡 Changes recommended

Unresolved critical and moderate rendering, atlas, API, cross-platform, and integration issues block approval.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 4 · 11 · 9

Open (24)

Provide cross-platform vector text extraction · New
Pack glyph bitmaps using stored dimensions · New
Encode and clamp SDF values around 0.5 · New
Make FontGlyphExtractor constructible by consumers · New
TextElement does not inherit from GameObject · New
Rebuild text resources when properties change · New
Apply the public text Color property · New
Advance glyph position for outline-less characters · New
Text mesh uses an inactive renderer · New
Implement signed winding for contour holes · New
Avoid duplicate initialization on window attachment · New
Remove deleted text elements from the renderer cache · New
Prevent duplicate rendering by UI and text renderers · New
Enable alpha blending in the text render pass · New
Log advance-width fallback failures · New
Rename misspelled public enum member Opague · New
Initialize the text element logger · New
Log font preloading failures · New
Log tessellation failures before fallback · New
Log font-file fallback failures · New

And 4 more that still need to be addressed.

What changed in this PR

Introduces a text-rendering subsystem with glyph extraction, tessellation, bitmap/vector rendering, caching, shaders, and sample integration. Tests were not run.

Changes:

Adds SharpEngine.Text, text entities, font handling, glyph utilities, and renderers.
Adds text shaders, atlas/SDF support, texture caching, and project wiring.
Refactors UI, audio, resources, numerics, namespaces, examples, and tests.

File	Reviewed change
`Tests/SharpEngine.Core.UI.Text.Tests/SharpEngine.Core.UI.Text.Tests.csproj`	Adds text test project dependencies.
`Tests/SharpEngine.Core.UI.Text.Tests/GlyphTests.cs`	Adds glyph triangulation test scaffolding.
`Tests/SharpEngine.Core.UI.Text.Tests/GeometryUtilsTests.cs`	Adds geometry test scaffolding.
`Tests/SharpEngine.Core.Tests/SharpEngine.Core.Tests.csproj`	Updates test project dependencies.
`Tests/SharpEngine.Core.ArchitectureTests/GameObjectTests.cs`	Cleans formatting.
`Tests/ObjLoader.Test/SharpEngine.Core.ObjLoader.Tests.csproj`	Removes a duplicate project reference.
`SharpEngine.Text/TypographyGlyphExtractor.cs`	Adds Typography font extraction.
`SharpEngine.Text/Translator.cs`	Converts font commands to glyph segments.
`SharpEngine.Text/TextTextureCache.cs`	Adds runtime text texture caching.
`SharpEngine.Text/TextRenderer.cs`	Adds scene text rendering.
`SharpEngine.Text/SharpEngine.Core.UI.Text.csproj`	Adds text project dependencies.
`SharpEngine.Text/SegmentType.cs`	Defines glyph segment types.
`SharpEngine.Text/Glyphs/GlyphSegment.cs`	Represents glyph outline segments.
`SharpEngine.Text/Glyphs/GlyphMetricsExtractor.cs`	Extracts glyph outlines and metrics.
`SharpEngine.Text/Glyphs/GlyphMeshCache.cs`	Adds glyph mesh caching.
`SharpEngine.Text/Glyphs/GlyphAtlasExtensions.cs`	Builds runtime atlas textures.
`SharpEngine.Text/Glyphs/GlyphAtlas.cs`	Adds atlas packing and SDF generation.
`SharpEngine.Text/Glyphs/Glyph.cs`	Adds glyph triangulation.
`SharpEngine.Text/GeometryUtils.cs`	Adds Bézier and polygon utilities.
`SharpEngine.Text/Fonts/FontManager.cs`	Adds font loading and lookup.
`SharpEngine.Text/Fonts/FontGlyphExtractor.cs`	Adds font outline extraction.
`SharpEngine.Text/Fonts/Font.cs`	Adds font metadata abstraction.
`SharpEngine.Text/Entities/TextElement.cs`	Adds renderable text scene elements.
`SharpEngine.Text/BitMapExtensions.cs`	Adds bitmap text rendering.
`SharpEngine.slnx`	Registers projects and reorganizes solution folders.
`SharpEngine.Core/Windowing/Window.cs`	Updates path helper usage.
`SharpEngine.Core/SharpEngine.Core.csproj`	Updates dependencies and shader resources.
`SharpEngine.Core/Shaders/LightingShader.cs`	Updates default resource references.
`SharpEngine.Core/Shaders/LampShader.cs`	Updates default resource references.
`SharpEngine.Core/Shaders/DefaultShader.cs`	Updates default resource references.
`SharpEngine.Core/Scenes/SceneNode.cs`	Simplifies scene references.
`SharpEngine.Core/Renderers/TextRenderer.cs`	Removes the placeholder renderer.
`SharpEngine.Core/Primitives/PrimitiveFactory.cs`	Updates default resource usage.
`SharpEngine.Core/Primitives/Plane.cs`	Corrects plane UVs.
`SharpEngine.Core/Primitives/Cube.cs`	Updates default texture usage.
`SharpEngine.Core/InputManager.cs`	Clarifies vector type usage.
`SharpEngine.Core/Extensions/PathExtensions.cs`	Removes the moved path helper.
`SharpEngine.Core/Entities/MaterialExtensions.cs`	Extracts material helpers.
`SharpEngine.Core/Entities/Lights/DirectionalLight.cs`	Updates default shader usage.
`SharpEngine.Core/Entities/GameObject.cs`	Updates renderer and resource namespaces.
`SharpEngine.Core/Entities/Components/MeshRenderer.cs`	Moves the renderer namespace.
`SharpEngine.Core/_Resources/Shaders/ui_sdf.vert`	Adds the UI SDF vertex shader.
`SharpEngine.Core/_Resources/Shaders/ui_sdf.frag`	Adds the UI SDF fragment shader.
`SharpEngine.Core/_Resources/Shaders/text-sdf.vert`	Adds the text SDF vertex shader.
`SharpEngine.Core/_Resources/Shaders/text-sdf.frag`	Adds the text SDF fragment shader.
`SharpEngine.Core/_Resources/Shaders/text-curve.vert`	Adds the curve text vertex shader.
`SharpEngine.Core/_Resources/Shaders/text-curve.frag`	Adds a curve text fragment shader placeholder.
`SharpEngine.Core/_Resources/Shaders/text-bitmap.vert`	Adds the bitmap text vertex shader.
`SharpEngine.Core/_Resources/Shaders/text-bitmap.frag`	Adds the bitmap text fragment shader.
`SharpEngine.Core.UI/SharpEngine.Core.UI.csproj`	Adds the UI project definition.
`SharpEngine.Core.UI/Shaders/UIShader.cs`	Updates UI resource usage.
`SharpEngine.Core.UI/Renderers/UIRenderer.cs`	Moves the UI renderer namespace.
`SharpEngine.Core.UI/Renderers/ParticleRenderer.cs`	Moves the particle renderer namespace.
`SharpEngine.Core.UI/Handlers/ParticleEmitter.cs`	Updates UI handler imports.
`SharpEngine.Core.UI/Entities/UIElement.cs`	Moves the UI element namespace.
`SharpEngine.Core.UI/Entities/Layouts/LayoutBase.cs`	Moves the layout namespace.
`SharpEngine.Core.UI/Entities/Layouts/GridLayout.cs`	Moves the grid layout namespace.
`SharpEngine.Core.UI/Entities/Layouts/FlexLayout.cs`	Moves the flex layout namespace.
`SharpEngine.Core.UI/Entities/DraggableUIElement.cs`	Moves the draggable UI namespace.
`SharpEngine.Core.Physics/SharpEngine.Core.Physics.csproj`	Adds the physics project definition.
`SharpEngine.Core.Numerics/Vector3_Intrinsics.cs`	Refactors vector implementation namespaces.
`SharpEngine.Core.Numerics/Vector2.cs`	Refactors vector implementation namespaces.
`SharpEngine.Core.Numerics/Noise/PerlinNoiseGenerator.cs`	Disambiguates math calls.
`SharpEngine.Core.Numerics/Math.cs`	Adds core math helpers.
`SharpEngine.Core.DependencyInjection/WindowServiceCollectionExtensions.cs`	Updates input manager access.
`SharpEngine.Core.Defaults/SharpEngine.Core.Defaults.csproj`	Adds the defaults project definition.
`SharpEngine.Core.Defaults/Defaults.cs`	Moves default resources and adds font paths.
`SharpEngine.Core.Components/SharpEngine.Core.Components.csproj`	Adds component project metadata.
`SharpEngine.Core.Components/Properties/Transform2D.cs`	Enables 2D rotation.
`SharpEngine.Core.Components/Properties/Textures/TextureRuntime.cs`	Adds runtime texture construction.
`SharpEngine.Core.Components/IComponent.cs`	Removes a duplicate component interface.
`SharpEngine.Core.Audio/SharpEngine.Core.Audio.csproj`	Adds the audio project definition.
`SharpEngine.Core.Audio/Players/WavPlayer.cs`	Moves the WAV player namespace.
`SharpEngine.Core.Audio/Players/Mp3Player.cs`	Moves the MP3 player namespace.
`SharpEngine.Core.Audio/AudioSource.cs`	Adds an OpenAL audio source.
`SharpEngine.Core.Audio/AudioProperties.cs`	Adds audio playback properties.
`SharpEngine.Core.Audio/AudioPlayerBase.cs`	Updates audio player imports.
`SharpEngine.Core.Audio/AudioFileExtensions.cs`	Adds audio extension constants.
`SharpEngine.Core.Audio/AudioDevice.cs`	Adds OpenAL device management.
`SharpEngine.Core.Audio/AudioData.cs`	Adds an audio metadata model.
`SharpEngine.Core.Audio/AudioBuffer.cs`	Cleans audio buffer formatting.
`SharpEngine.Core.Audio/Audio.cs`	Updates player namespace usage.
`Examples/Tutorial 4.1 - Model Loading/Tutorial 4.1 - Model Loading.csproj`	Removes a duplicate project reference.
`Examples/Tutorial 4.1 - Model Loading/Program.cs`	Updates default resource usage.
`Examples/MultipleWindows/Program.cs`	Updates vector conversion.
`Examples/MinecraftClone/Terrain/Block/Wood.cs`	Updates defaults namespace usage.
`Examples/MinecraftClone/Terrain/Block/Stone.cs`	Updates defaults namespace usage.
`Examples/MinecraftClone/Terrain/Block/Leaf.cs`	Updates defaults namespace usage.
`Examples/MinecraftClone/Terrain/Block/Iron.cs`	Updates defaults namespace usage.
`Examples/MinecraftClone/Terrain/Block/Grass.cs`	Updates defaults namespace usage.
`Examples/MinecraftClone/Terrain/Block/Dirt.cs`	Updates defaults namespace usage.
`Examples/MinecraftClone/Terrain/Block/BlockBase.cs`	Simplifies vector conversion.
`Examples/MinecraftClone/Program.cs`	Updates renderer namespace imports.
`Examples/MinecraftClone/Minecraft.csproj`	References UI and text projects.
`Examples/MinecraftClone/Minecraft.cs`	Adds text rendering example usage.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

+            if (!OperatingSystem.IsWindows())
+            {
+                // On non-Windows platforms, skip the System.Drawing raster path.
+                // The vector path or other rendering approaches (SDF, external renderer) should be used instead.
+                return;


+            // For prototype we assume glyph metadata contains width/height encoded in name as name|w|h
+            var parts = name.Split('|');
+            var w = int.Parse(parts[1]);
+            var h = int.Parse(parts[2]);


+                var dist = System.Math.Sqrt(bestDistSq);
+                // positive outside distances, negative inside distances
+                sdf[idx] = (float)(dist / spread / 2.0 + 0.5) * (inside ? -1 : 1);


+    private readonly ILogger? _logger;
+    private readonly IFileSystem _fileSystem;
+
+    internal TypographyGlyphExtractor(ILogger? logger = null, IFileSystem? fileSystem = null)


+///     Uses UIElement as a base so it can reuse the UI mesh/shader for textured quads.
+///     This implementation draws the text into a bitmap and uploads it as a texture on initialization.
+/// </summary>
+public class TextElement : UIElement


+            catch
+            {
+                fam = null;
+            }


+            try 
+            { 
+            kv.Value.tex?.Dispose(); 
+            } 
+            catch { }


+        catch
+        {
+            return typeface.CalculateScaleToPixel(fontSize);
+        }


+
+public class GeometryUtilsTests
+{
+    /*[Fact]


+        var contour = new List<GlyphSegment>
+        {
+            // TODO: Resolve package reference conflict with System.Numerics.
+            // new GlyphSegment(SegmentType.Line, new Vector2(0,0), new Vector2(1,0)),
+            // new GlyphSegment(SegmentType.Line, new Vector2(1,0), new Vector2(1,1)),
+            // new GlyphSegment(SegmentType.Line, new Vector2(1,1), new Vector2(0,1)),
+            // new GlyphSegment(SegmentType.Line, new Vector2(0,1), new Vector2(0,0)),
+        };
+
+        g.AddContour(contour);
+
+        var tris = g.Triangulate();
+        // Should emit at least one triangle (3 verts)
+        Assert.True(tris != null);


Av3boy · 2026-09-20T18:31:36Z

After this PR goes in I'm doing a full pass of the application and making sure sonar cloud gets an A for all stats with all unit tests passing

Av3boy and others added 23 commits July 18, 2026 01:49

#21 Input and windowing improvements

196faa7

#21 Fix window load and input (wip)

f2a4cf6

#21 Fix UI rendering to use pixel

0715fa2

#21 UI alignment works (WIP)

93673c3

#21 Rearrange logic into the grid container (WIP)

ad9d208

Doesn't work quite yet

#21 Temp

117aefb

Temp

29fff27

Placeholder commit

958a83b

Everything after this point needs to have a structure and proper planning. It's been a wild west until now

Temp

968d582

We need to start figuring out the shared repo and how the "main" repo will build as open source

Structural consistency cleanup

ee1e2f1

Add Copilot MCP config

8660a46

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Add copilot instruction file

601ae10

Update docs

08cfbfd

Structural updates

db71057

Fix renderers

e2fe85b

Add mcp for sonarcloud

e63ab43

Project improvements

e3f83ce

Fixes & Cleanup

b3d3113

Merge remote-tracking branch 'origin/21-av-temp' into 21-av-temp

28f8afb

Fix build

a5ca88d

#15 Initial implementation

548ab83

#15 Example uasge

90709d7

Merge remote-tracking branch 'origin/dev' into 15-av-text-renderer

93adeaa

Av3boy added this to the SharpEngine 1.0 MVP milestone Sep 5, 2026

Av3boy self-assigned this Sep 5, 2026

Av3boy added this to A sharp plan Sep 5, 2026

Av3boy added enhancement New feature or request rendering Rendering related issues / questions core The issue is related to the Core library. labels Sep 5, 2026

Av3boy moved this to In Progress in A sharp plan Sep 5, 2026

Antti Veikkolainen added 4 commits September 13, 2026 03:01

#15 Additional changes

8dbaaeb

#15 Light cleanup and fix build

bd025ae

Merge branch 'dev' into 15-av-text-renderer

da300fe

#15 Fix build and refine dependency graph

bbe8b3b

Av3boy requested a lite review from Copilot September 20, 2026 17:20

Copilot started reviewing on behalf of Av3boy September 20, 2026 17:21 View session

Copilot AI reviewed Sep 20, 2026

View reviewed changes

Av3boy marked this pull request as ready for review September 20, 2026 18:30

Av3boy merged commit a4d9131 into dev Sep 20, 2026
5 checks passed

github-project-automation Bot moved this from In Progress to Done in A sharp plan Sep 20, 2026

Navigation Menu

#15 Introduce Text Renderer - #145

#15 Introduce Text Renderer#145
Av3boy merged 27 commits into
devfrom
15-av-text-renderer

Av3boy commented Sep 5, 2026

Uh oh!

sonarqubecloud Bot commented Sep 20, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Av3boy commented Sep 20, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

Av3boy commented Sep 5, 2026

Contents

Checklist

Uh oh!

sonarqubecloud Bot commented Sep 20, 2026

Quality Gate passed

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot review overview

🟡 Changes recommended

Uh oh!

Av3boy commented Sep 20, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants