Skip to content

fontlabapp.proof.tabs.named · declarations 001

Back to fontlabapp.proof.tabs.named

RowItem module-attribute

RowItem

SPACE module-attribute

SPACE: RowItem

open_layer_rows

open_layer_rows(rows: tuple[tuple[RowItem, ...], ...], *, expected_id: int, master: str, deadline: float | None = None) -> None

Open exact glyph/layer occurrences in rows, in ONE verified fresh native tab.

What: each row is a tuple of items. An item is (glyph name, exact layer name), or SPACE ((None, "")) for one space. Rows are separated by one line break; an empty row keeps its line, as in open_named_tab. Use it for stacked or side-by-side layer comparisons (Master Text Comparison).

How: the complete immutable request is validated first. Then every requested layer must exist in the font expected_id (flPackage.id, the current font). Only then are native symbols built: a layer item is an fgSymbol with its own layerName; a space is the text symbol list fgSymbolList(" ") and a line break fgSymbolList("\n"), the same text form that open_named_tab uses for line breaks. The tab opens through the shared fresh-tab fence (_open_symbols). master fences the current source master; it does not overwrite the layer of an item.

Why: scripts must not build fgSymbol lists or call requestContent themselves. Any failure before the tab opens opens no tab. Native qualification (space text symbol, layer per symbol) remains open.

open_layer_tab

open_layer_tab(layers: tuple[tuple[str, str], ...], *, expected_id: int, master: str, deadline: float | None = None) -> None

Open exact glyph/layer occurrences in a verified fresh native tab.

Every pair is (glyph name, exact foreground layer name). Preserve auxiliary layers, mixed masters and repeated winners without Unicode/slash substitution. Validate the complete immutable request before native symbol allocation. The separate master argument fences the current source context; it does not overwrite each symbol's requested layer. Native qualification remains open.

open_named_tab

open_named_tab(lines: tuple[tuple[str, ...], ...], *, expected_id: int, master: str, deadline: float | None = None) -> None

Open a fresh empty native tab, verify its identity/font, then set names.

Keep the captured current master explicitly in every symbol layerName. No Unicode lookup, slash parsing, missing-name filtering or master switch. Any build failure opens no tab. Creation/populate failure can leave a new tab; no atomic UI rollback is claimed. Shared App preflight preserves captured activation flags and checks source-font identity.