Text encoding
Generated from engine/render/text_encoding.h at aceb130. The text under each declaration is the header's own comment, word for word. About the reference says how these pages are made.
Audience: game code.
#include "engine/render/text_encoding.h" · namespace labrador
UTF-8 to UTF-16, for the boundary where narrow text meets the render module's wide text API.
The render module holds text as std::wstring, because a glyph table is keyed by code unit and a narrow entry point would therefore convert on the draw path - which is either an allocation per string per view per frame or a buffer shared between render workers. Converting here means converting once, into storage the caller owns, off the draw path.
Content strings arrive narrow - content files are UTF-8 - so this is where they come across. Invalid UTF-8 becomes U+FFFD rather than nothing: text about to be drawn should show mojibake, not vanish.
U+FFFD is in no font MakeSpriteFont makes by default - its default region is the 95 characters U+0020 to U+007E - so what draws in its place is the font's stand-in glyph. The resource factory installs one on every font that HAS a candidate - the font's own choice, then '?', then ' ' - so on every font in this tree a replacement character draws as a question mark, and on a font carrying none of the three nothing is installed and drawing one throws (Font::drawn). RenderResources::can_render is how a caller finds out before it gets that far.
narrow
Section titled “narrow”UTF-16 to UTF-8, for text a platform API hands back wide, such as an adapter's name. The inverse of widen() for every well-formed string.
A surrogate without its partner becomes U+FFFD, as invalid UTF-8 does in widen(): the text is reported, not refused. Where wchar_t is 32 bits a unit may also hold a whole code point past the basic plane, which encodes as itself; one past U+10FFFF is U+FFFD.
In the samples and tests
Section titled “In the samples and tests”The files that include this header directly. A file can also reach it through another header.
samples/components/binding_label.cpp,gallery_text.cpp,main_web.cpp,text_field.cpp,text_field_tests.cpptests/app/key_labels_tests.cpp,window_tests.cpptests/assets/string_table_text_tests.cpptests/render/d3d12/instrumented_device_resources.cpptests/render/font_tests.cpp,text_encoding_tests.cpp
Explained in
Section titled “Explained in”Development documentation (unreleased). Built from Labrador aceb130 of 2026-11-20.