Squashed 'vendor/kb_text_shape/' content from commit aed9b60

git-subtree-dir: vendor/kb_text_shape
git-subtree-split: aed9b60129aca5e3cf4dcc86e88f2a381aa820c7

LICENSE

@@ -0,0 +1,19 @@
+zlib License
+
+(C) Copyright 2024-2025 Jimmy Lefevre
+
+This software is provided 'as-is', without any express or implied
+warranty.  In no event will the authors be held liable for any damages
+arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose,
+including commercial applications, and to alter it and redistribute it
+freely, subject to the following restrictions:
+
+1. The origin of this software must not be misrepresented; you must not
+  claim that you wrote the original software. If you use this software
+  in a product, an acknowledgment in the product documentation would be
+  appreciated but is not required.
+2. Altered source versions must be plainly marked as such, and must not be
+  misrepresented as being the original software.
+3. This notice may not be removed or altered from any source distribution.

README.md

@@ -0,0 +1,70 @@
+# kb
+
+[Single-header](https://github.com/nothings/stb/blob/master/docs/stb_howto.txt) permissively-licensed libraries for C/C++.
+
+## Libraries
+
+- [kb\_text\_shape.h](./kb_text_shape.h): Unicode text segmentation and OpenType shaping
+
+## kb_text_shape.h
+
+![Example of Arabic shaping with stb_truetype](./images/arabic.png)
+![Example of Hindi shaping with stb_truetype](./images/hindi.png)
+![Example of Khmer shaping with stb_truetype](./images/khmer.png)
+![Example of Myanmar shaping with stb_truetype](./images/myanmar.png)
+![Example of Gunjala Gondi shaping with stb_truetype](./images/gunjala_gondi.png)
+![Example of toggling the smallcaps font feature](./images/smallcaps.png)
+
+[kb\_text\_shape.h](./kb_text_shape.h) provides:
+- ICU-like text segmentation (i.e. breaking Unicode text by direction, line, script, word and grapheme).
+- Harfbuzz-like text shaping for OpenType fonts, which means it is capable of handling complex script layout and ligatures, among other things.
+- Font coverage checking: know if a font can display a given string.
+
+It does **not** handle rasterization. It does **not** handle paragraph layout. It does **not** handle selection and loading of system fonts. It will only help you know which glyphs to display where on a single, infinitely-long line, using the fonts you have provided!
+
+(See https://www.newroadoldway.com/text1.html for an explanation of the different steps of text processing.)
+
+For an in-depth usage example, check out [refpad](https://github.com/JimmyLefevre/refpad).
+
+```c
+// Yours to provide:
+void DrawGlyph(kbts_u16 GlyphId, kbts_s32 GlyphOffsetX, kbts_s32 GlyphOffsetY, kbts_s32 GlyphAdvanceX, kbts_s32 GlyphAdvanceY,
+               kbts_direction ParagraphDirection, kbts_direction RunDirection, kbts_script Script, kbts_font *Font);
+void NextLine(void);
+void *CreateRenderFont(const char *FontPath);
+
+void HandleText(kbts_shape_context *Context, const char *Text, kbts_language Language)
+{
+  kbts_ShapeBegin(Context, KBTS_DIRECTION_DONT_KNOW, Language);
+  kbts_ShapeUtf8(Context, Text, (int)strlen(Text), KBTS_USER_ID_GENERATION_MODE_CODEPOINT_INDEX);
+  kbts_ShapeEnd(Context);
+
+  kbts_run Run;
+  while(kbts_ShapeRun(Context, &Run))
+  {
+    if(Run.Flags & KBTS_BREAK_FLAG_LINE_HARD)
+    {
+      NextLine();
+    }
+
+    kbts_glyph *Glyph;
+    while(kbts_GlyphIteratorNext(&Run.Glyphs, &Glyph))
+    {
+      DrawGlyph(Glyph->Id, Glyph->OffsetX, Glyph->OffsetY, Glyph->AdvanceX, Glyph->AdvanceY,
+                Run.ParagraphDirection, Run.Direction, Run.Script, Run.Font);
+    }
+  }
+}
+
+void Example(void)
+{
+  kbts_shape_context *Context = kbts_CreateShapeContext(0, 0);
+  kbts_font *FontA = kbts_ShapePushFontFromFile(Context, "NotoSansMyanmar-Regular.ttf", 0);
+  kbts_font *FontB = kbts_ShapePushFontFromFile(Context, "NotoSansArabic-Regular.ttf", 0);
+
+  FontA->UserData = CreateRenderFont("NotoSansMyanmar-Regular.ttf");
+  FontB->UserData = CreateRenderFont("NotoSansArabic-Regular.ttf");
+
+  HandleText(Context, (const char *)u8"یکအမည်မရှိیک", KBTS_LANGUAGE_ARABIC);
+}
+```