Initial upload: aesthetic-immich-starter

2026-08-16 19:59:33 +01:00
commit 8938106e99
4777 changed files with 2176899 additions and 0 deletions
@@ -0,0 +1,50 @@
+"""
+Low-level text helper utilities.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Iterator
+
+from . import _api
+from .ft2font import FT2Font, CharacterCodeType, LayoutItem, LoadFlags
+
+
+def warn_on_missing_glyph(codepoint: CharacterCodeType, fontnames: str):
+    _api.warn_external(
+        f"Glyph {codepoint} "
+        f"({chr(codepoint).encode('ascii', 'namereplace').decode('ascii')}) "
+        f"missing from font(s) {fontnames}.")
+
+
+def layout(string: str, font: FT2Font, *,
+           features: tuple[str] | None = None,
+           language: str | tuple[tuple[str, int, int], ...] | None = None
+           ) -> Iterator[LayoutItem]:
+    """
+    Render *string* with *font*.
+
+    For each character in *string*, yield a LayoutItem instance. When such an instance
+    is yielded, the font's glyph is set to the corresponding character.
+
+    Parameters
+    ----------
+    string : str
+        The string to be rendered.
+    font : FT2Font
+        The font.
+    features : tuple of str, optional
+        The font features to apply to the text.
+    language : str, optional
+        The language of the text in a format accepted by libraqm, namely `a BCP47
+        language code <https://www.w3.org/International/articles/language-tags/>`_.
+
+    Yields
+    ------
+    LayoutItem
+    """
+    for raqm_item in font._layout(string, LoadFlags.NO_HINTING,
+                                  features=features, language=language):
+        raqm_item.ft_object.load_glyph(raqm_item.glyph_index,
+                                       flags=LoadFlags.NO_HINTING)
+        yield raqm_item