fontlabapp.vfjo
vfjo
vfjo: VFJ Objects, a Box-based workflow over FontLab 9.1 object JSON.
What: fontlabapp.vfjo casts the object JSON of
fontlabapp.objects.json_data onto python-box, so glyphs, layers,
elements, contours, anchors and hints read and edit as attributes. It adds
safe whole-object edits (move, scale, rename, set_width,
add_suffix, edit_nodes) and paste into the font with Undo.
nodes holds the node-string model (Node).
How: loads/load/from_glyphs/from_clipboard return
Objects; Objects.data is the box tree. Data is validated by
json_data.Envelope.parse on the way in and out. Reading a missing key
raises; a misspelt new key on a known level raises; add_key adds a key
on purpose. move and scale change element transforms (components
and transformed elements) or nodes, and anchors, guidelines and hints
follow, so the data stays consistent. edit_nodes refuses to change a
contour's point count (hints address points by index).
Undo: only paste (and Objects.paste) changes a font. Glyph data
becomes new glyphs through json_data.paste_glyphs: Edit > Undo removes
them one step per new glyph plus one for the outlines
(GLYPHS_UNDO_TEXT). Layer, element and contour data is added to the
current glyph's active layer through json_data.paste_shapes as one
step; with font= it must be the current font. available,
NEEDS_91, PARTIAL_TEXT, GLYPHS_UNDO_TEXT and
PartialWriteError are re-exported so scripts need only vfjo.
Limits: never reads FontLab's vic/* clipboard (that binding crashes
9.1.9812, Fontlab/fl#8655). Checked live in FontLab 9.1.9812 with Lato and
python-box 7.4.1: from_glyphs(["o", "Aogonek"]), add_suffix,
move(40, 0), set_width(w + 80) and paste gave correct nodes,
anchors, component offsets and widths in both masters; a misspelt read
raised BoxKeyError and a misspelt write UnknownKeyError. scale,
Undo and shape paste are not yet checked live.
How to use::
from fontlabapp import vfjo
objs = vfjo.from_glyphs(["o"]) # selected glyphs by default
vfjo.add_suffix(objs, ".shift")
vfjo.move(objs, 100, 0); vfjo.set_width(objs, lambda w: w + 200)
objs.paste() # new glyph o.shift, with Undo
Modules
Complete member index
Every captured member retains its own identity. Identical captured declaration text is linked once; this does not establish native inheritance or interchangeable objects.
| Member | Kind | Signature | Summary |
|---|---|---|---|
__dir__ |
function | () -> list[str] |
List only the names published by this package. |
__getattr__ |
function | (name: str) -> Any |
Resolve one public name only when it is requested. |