gstrainovic/zid / .claude/skills/emoji
emoji
VerifiedFarbige Emoji in zid: Rückfall-Schrift (Linux CBDT über FreeType, Windows Segoe UI Emoji über DirectWrite-Farbschichten und MuPDFs HarfBuzz), Bitmap-Skalierung, Farbatlas, zusammengesetzte Zeichen. Use when touching src/text/emoji_font.zig, bitmap_scale.zig, src/text/backends/directwrite/*, emoji_hb.c, glyph cache color atlas, text_atlas.wgsl, or scripts/e2e_emoji.py.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.4 KB |
SKILL.md
View on GitHub---
name: emoji
description: >
Farbige Emoji in zid: Rückfall-Schrift (Linux CBDT über FreeType, Windows Segoe UI Emoji über DirectWrite-Farbschichten und MuPDFs HarfBuzz), Bitmap-Skalierung, Farbatlas, zusammengesetzte Zeichen. Use when touching src/text/emoji_font.zig, bitmap_scale.zig, src/text/backends/directwrite/*, emoji_hb.c, glyph cache color atlas, text_atlas.wgsl, or scripts/e2e_emoji.py.
---
## Farbige Emoji (`src/text/emoji_font.zig`, `bitmap_scale.zig`)
- JetBrains Mono hat keine Emoji. `TextSystem.shapeText` prüft je Textstück, ob ein
Zeichen in der Hauptschrift fehlt (`FreeTypeFace.hasCodepoint`), und zerlegt den Text
dann in Läufe: Hauptschrift und Emoji-Schrift getrennt, weil HarfBuzz je Aufruf nur eine
Schrift kennt. Emoji-Glyphen bekommen `font_ref` und `is_color`; `resolveGlyphBatch`
schickt sie an `GlyphCache.getOrRenderFallback`.
- Brauchbar ist nur eine **Bitmap**-Emoji-Schrift (CBDT, `FreeTypeFace.isColorBitmapFont`).
Die COLRv1-Fassung, die Fedora ausliefert, besteht aus Malanweisungen; FreeType 2.13
malt sie nicht aus und liefert ein leeres Bitmap. Debian, Ubuntu und Arch haben CBDT,
sonst lädt zid NotoColorEmoji (10 MB, Fassung v2.047) einmalig nach
`<AppData>/zid/fonts/` — derselbe Weg wie bei der KI-Selbsteinrichtung.
- Bitmap-Schriften lassen keine freie Grösse zu: `finishFace` wählt über `FT_Select_Size`
die nächstliegende feste Grösse und merkt `strike_scale`; `renderStrikeGlyph` verkleinert
das 128-px-Bild mit `bitmap_scale.downscaleBgraToRgba` (Kastenfilter, BGRA nach RGBA, ohne
Vormultiplikation). HarfBuzz meldet für solche Schriften **keinen Vorschub**; ohne
`FreeTypeFace.strikeAdvance` stünde das nächste Zeichen im Emoji.
- Zwei Atlanten: Text bleibt einkanalig, Emoji liegen in `GlyphCache.color_atlas` (RGBA).
Der Vertex trägt einen Schalter (`location(3)`), `shaders/text_atlas.wgsl` mischt zwischen
Maske und Farbbild. Die SVG-Schicht hat deshalb einen eigenen Shader
(`shaders/svg_atlas.wgsl`), weil die zusätzliche Vertexspalte nicht zur `svg_pipeline` passt.
- **Windows:** Rückfall ist Segoe UI Emoji (`seguiemj.ttf`, COLR, liegt
jedem Windows bei), kein Download. MuPDFs FreeType taugt dafür nicht (ohne PNG und
eingebettete Bitmaps gebaut, `slimftoptions.h`). `DirectWriteFace` bietet `hasCodepoint`,
`rawFace` (Zeiger auf die Face selbst), `isColorBitmapFont` (hier: hat COLR-Schichten,
geprüft an 😀) und `renderColorGlyph`: `IDWriteFactory2.TranslateColorGlyphRun` liefert
einfarbige Schichten, jede wird über die GDI-Bitmap in Graustufen gerastert und mit
`bitmap_scale.blendLayer` eingefärbt übereinandergelegt; Masse aus der Em-Box. Glyphen ohne
Schichten (`DWRITE_E_NOCOLOR`, etwa ⚠ in Textform) kommen einfarbig statt als Fehler, der
den Frame abbräche. Formen: `SimpleShaper` kann keine Ligaturen, deshalb formt
`DirectWriteFace.shapeRun` Emoji-Läufe mit dem HarfBuzz aus MuPDFs Drittbibliothek
(`src/text/backends/directwrite/emoji_hb.c`: Symbole `fzhb_*`, Speicher über einen eigenen
MuPDF-Kontext, jeder Aufruf zwischen `fz_hb_lock`/`fz_hb_unlock`). Damit gehen ZWJ-Folgen,
Hautton und Tasten. Flaggen bleiben Buchstaben („DE“): Segoe UI Emoji hat keine
Länderflaggen, Windows zeigt sie selbst so. Der ZWJ wird wie die Variantenwähler beim
Anhängen verworfen, sonst stünde er ohne Ligatur als Strich im Satz.
`hasCodepoint` merkt sich die Antworten für die BMP (`cp_cache`, Bitfelder auf dem Heap):
ohne ihn kostet jedes Formen ohne Cache-Treffer einen COM-Aufruf je Zeichen über ASCII.
- macOS (CoreText) hat keinen Rückfall (`emoji_fallback_supported`), Emoji bleiben leer.
- Zusammengesetzte Zeichen dürfen nie getrennt geformt werden: U+FE0F verlangt die farbige
Form (⚠️ gegen ⚠), U+20E3 macht eine Taste (1️⃣), ZWJ verbindet (👩💻), dazu Hautton und
Tag-Zeichen. `emoji_font.continuesCluster` nennt sie; die Zerlegung hält sie beim
Grundzeichen, und `MarkdownView.appendPiece` klebt sie ans vorige Stück, weil zigdown
`1️⃣` in `1` und den Rest zerlegt. Die Wähler selbst werden beim Formen verworfen: beide
Schriften bilden sie auf ein Ersatzzeichen mit Vorschub ab, das eine Lücke hinterliesse.
- Zum Anschauen: `scripts/fixtures/emoji_test.md` (Überschrift, Liste, Tabelle, Codeblock,
Randfälle). E2E: `python3 scripts/e2e_emoji.py` öffnet eine Textdatei und diese Datei in
der Vorschau, wartet notfalls auf den Download und zählt bunte Pixel.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |