Skip to content

fontlab.flPreferences

flPreferences

flPreferences gives scripts read and write access to almost every setting in FontLab — the same settings you'd normally change in the Preferences dialog. You can read them to understand the current working environment, or write them to temporarily change FontLab's behavior for the duration of your script.

You always access preferences through the singleton:

from fontlab import flPreferences
prefs = flPreferences.instance()

A word of caution: Changes to preferences take effect immediately and globally. If your script changes a preference, it stays changed even after the script finishes — the user's environment is affected. For settings you change temporarily, always save the original value and restore it when you're done:

prefs = flPreferences.instance()

# Save original
old_snap = prefs.snapToGuidelines

# Change for your script
prefs.snapToGuidelines = False

# ... do your scripted work ...

# Restore original
prefs.snapToGuidelines = old_snap

After changing any preferences, call flItems.notifyPreferencesChanged() so all panels and displays pick up the new values.

Window-opening preferences

Property Type Access Meaning
generalActivateFontWindowOnOpen bool read/write Activate the Font window when opening a font; off by default.
generalHideWarningDialogs bool read/write Suppress optional launch/opening dialogs; off by default. See behavior below.

Active window when reopening a font

generalActivateFontWindowOnOpen is a read/write boolean, off by default. When off, opening a font with saved windows returns to its saved active window. This also applies when saving glyph-window contents without panel/window layout. Older files use their saved selected tab when available, or preserve the window activated by the restoration order when no active-window information exists. Set it to True to activate the Font window instead:

flPreferences.instance().generalActivateFontWindowOnOpen = True

Window restoration must be enabled to restore a saved active window.

Suppressing launch and font-opening dialogs

generalHideWarningDialogs is a read/write boolean, off by default, corresponding to Preferences > General > Other > Hide warning dialogs:

from fontlab import flPreferences
prefs = flPreferences.instance()
prefs.generalHideWarningDialogs = True

The change takes effect immediately and is saved for subsequent launches. Set it to False to restore dialogs. It suppresses startup prompts (including crash reporting and Welcome), font-opening warnings, legacy note encoding conversion, and Important Font Note dialogs. Pending crash reports are sent automatically without dialogs; failed uploads are retained for retry. Autosaved fonts are moved to the Keep folder without reopening them. Automatic update checks are suspended while enabled; license restrictions still apply.

Imports follow the configured rounding preference. Optional repairs (merging/renaming elements, renaming masters, removing linked width expressions) and encoding conversion are skipped. Required duplicate-glyph-name and cross-layer-reference repairs still run, with messages in Output. Font collections open all faces. Known damaged autosaves and Sketchboards are skipped without deletion. Opening errors are reported in Output instead of a dialog.

For temporary use, save and restore the value with try/finally. MCP exposes the same setting as general.hide_warning_dialogs through get_preferences and set_preferences.

Getting the Instance

from fontlab import flPreferences
prefs = flPreferences.instance()
print(prefs.editorNodeSize)   # read a value
prefs.editorNodeSize = 8      # write a value

Common Scripting Patterns

from fontlab import flPreferences, flItems

prefs = flPreferences.instance()

# --- Read a value ---
print("Node size:", prefs.editorNodeSize)

# --- Change a value (always save the original first!) ---
orig = prefs.editorNodeSize
prefs.editorNodeSize = 8
# ... do your work ...
prefs.editorNodeSize = orig   # restore

# --- Notify the app after changes ---
flItems.notifyPreferencesChanged()

# --- Save/restore a full preferences snapshot ---
snapshot = prefs.save()
prefs.editorFillOpacity = 0   # make glyphs transparent
# ... do proofing work ...
prefs.load(snapshot)          # restore everything
flItems.notifyPreferencesChanged()

# --- Temporarily disable all snapping ---
snap_props = ['snapToGrid', 'snapToGuidelines', 'snapToOutline',
              'snapToBounds', 'snapToMetrics']
orig_snaps = {p: getattr(prefs, p) for p in snap_props}
for p in snap_props:
    setattr(prefs, p, False)
# ... do work without snapping ...
for p, v in orig_snaps.items():
    setattr(prefs, p, v)

Tutorial

from PythonQt.QtGui import QColor
import fontlab as fl
from fontlab import flPreferences, flItems

# ============================================================
# 1. Get the preferences singleton
# ============================================================

prefs = flPreferences.instance()
print("Preferences loaded. Dark mode:", prefs.isDark)
print("Data path:", prefs.dataPath)

# ============================================================
# 2. Reading preferences
# ============================================================
# These are just attribute reads — safe, no side effects.

print("\n--- Editor display ---")
print(f"  Node size: {prefs.editorNodeSize} px")
print(f"  Fill opacity: {prefs.editorFillOpacity}%")
print(f"  Show curve handles: {prefs.editorShowCurves}")
print(f"  Show coordinates: {prefs.editorCoordinates}")

print("\n--- Nudge distances ---")
print(f"  Arrow key nudge: {prefs.editorNudge1} units")
print(f"  Shift+arrow nudge: {prefs.editorNudge10} units")

print("\n--- Snap settings ---")
print(f"  Snap to guidelines: {prefs.snapToGuidelines}")
print(f"  Snap to outline: {prefs.snapToOutline}")
print(f"  Snap distance: {prefs.editorSnapDistance} px")

print("\n--- Grid ---")
print(f"  Grid X: {prefs.gridDistanceX}, Grid Y: {prefs.gridDistanceY}")
print(f"  Grid opacity: {prefs.gridOpacity}")

# ============================================================
# 3. Safely changing a preference
# ============================================================
# ALWAYS save the original value so you can restore it.
# Never leave preferences in a changed state when your
# script finishes, unless that's the explicit goal.

orig_node_size = prefs.editorNodeSize

print(f"\nChanging node size from {orig_node_size} to 10...")
prefs.editorNodeSize = 10

# Tell the app to refresh all displays with the new value
flItems.notifyPreferencesChanged()

# ... do some work where larger nodes are helpful ...

# Restore
prefs.editorNodeSize = orig_node_size
flItems.notifyPreferencesChanged()
print("Node size restored.")

# ============================================================
# 4. Saving and restoring a full preferences snapshot
# ============================================================
# prefs.save() returns a dict of all current preference values.
# prefs.load(dict) restores from that dict.
# Use this to make large temporary changes safely.

snapshot = prefs.save()
print(f"\nSaved preferences snapshot ({len(snapshot)} entries).")

# Make some temporary changes for a proofing workflow:
prefs.editorFillOpacity = 0        # transparent fill
prefs.editorShowCurves  = False     # hide handles
prefs.editorCoordinates = False     # hide coordinate display
prefs.colorWorkspace    = QColor(240, 240, 240)   # light grey background
flItems.notifyPreferencesChanged()

print("Temporary proofing preferences applied.")
print("(In a real script, do your proofing work here.)")

# Restore everything from the snapshot
prefs.load(snapshot)
flItems.notifyPreferencesChanged()
print("Preferences fully restored from snapshot.")

# ============================================================
# 5. Temporarily disabling all snapping
# ============================================================
# Useful before running a layout script where snapping
# would interfere with programmatic positioning.

snap_props = [
    'snapToGrid', 'snapToGuidelines', 'snapToFontGuidelines',
    'snapToFontMetrics', 'snapToMetrics', 'snapToOutline',
    'snapToBounds', 'snapToCenters', 'snapToDistance'
]

# Save originals
orig_snaps = {p: getattr(prefs, p) for p in snap_props}

# Disable all snapping
for p in snap_props:
    setattr(prefs, p, False)
flItems.notifyPreferencesChanged()
print("\nAll snapping disabled.")

# ... run your positioning script here ...

# Restore all snap settings
for p, v in orig_snaps.items():
    setattr(prefs, p, v)
flItems.notifyPreferencesChanged()
print("Snap settings restored.")

# ============================================================
# 6. Configuring grid spacing
# ============================================================
# For a 1000-unit UPM font, a 10-unit grid is common.
# setGridDistances() sets both axes at once.

orig_gx = prefs.gridDistanceX
orig_gy = prefs.gridDistanceY

flPreferences.setGridDistances(10.0, 10.0)
flItems.notifyPreferencesChanged()
print(f"\nGrid set to 10×10 (was {orig_gx}×{orig_gy}).")

# Restore
flPreferences.setGridDistances(orig_gx, orig_gy)
flItems.notifyPreferencesChanged()

# ============================================================
# 7. Reading the data path (where scripts and resources live)
# ============================================================

print(f"\nFontLab data path: {prefs.dataPath}")
print(f"Default data path: {prefs.dataPathDefault}")
print(f"Auto-save path: {prefs.pathAutoSave}")

# ============================================================
# 8. Checking dark mode
# ============================================================
# Scripts that generate colours can adapt to the current theme.

if prefs.isDark:
    bg_colour = QColor(30, 30, 30)
    fg_colour = QColor(220, 220, 220)
    print("\nDark mode: using light-on-dark colours.")
else:
    bg_colour = QColor(255, 255, 255)
    fg_colour = QColor(0, 0, 0)
    print("\nLight mode: using dark-on-light colours.")

print("\nPreferences tutorial complete.")

Further preference properties

These members are available through this class. Method arguments are positional unless noted otherwise.

Properties

Property Type Access
developerBacklightUpdate bool read/write
developerLargeQuickHelp bool read/write
developerNoParameters bool read/write
developerOpenGL bool read/write
developerShowKeys bool read/write
drawFocusRect int read/write
dsigAlgorithm int read/write
dsigAuthority int read/write
dsigCertificatePath QString read/write
dsigPassword QString read/write
dsigPrivateKeyPath QString read/write
dsigTimestamp bool read/write
dsigTimestampUrl QString read/write
dsigUrl QString read/write
dsigWrite bool read/write
editorAllowCache bool read/write
editorAlternativePencil bool read/write
editorAutoNonSpacing bool read/write
editorCenterGlyph bool read/write
editorCloseDistance int read/write
editorCommandSelector bool read/write
editorCopyText bool read/write
editorCross bool read/write
editorCtrl100 bool read/write
editorDeleteSingleNode int read/write
editorFeatures bool read/write
editorFocus bool read/write
editorForcedGrid bool read/write
editorForcedSnap bool read/write
editorHidePlaceholders bool read/write
editorIndependentGlyphMasters bool read/write
editorInstanceLayer bool read/write
editorInterpolate bool read/write
editorInterpolateModifier bool read/write
editorListMaskLayers bool read/write
editorLockInactiveGlyphs bool read/write
editorMatch bool read/write
editorMeterCoordinates bool read/write
editorMinHandle int read/write
editorMissingGlyphs bool read/write
editorModalPen bool read/write
editorNodeFontDefault int read/write
editorNodeFontHovered int read/write
editorNodeHighlightDistance int read/write
editorNodeHitDistance int read/write
editorNoteExpanded bool read/write
editorOffsetDuplicate QPointF read/write
editorOffsetPaste QPointF read/write
editorPantographCurve int read/write
editorPantographKerning int read/write
editorPantographNode int read/write
editorPasteArtwork int read/write
editorPasteContourVisual bool read/write
editorPasteReplace bool read/write
editorPenCorrection bool read/write
editorPenPreview bool read/write
editorPreviewPowerNudge bool read/write
editorProportionalThickness bool read/write
editorRoundKerning bool read/write
editorRoundMetrics bool read/write
editorSetMetrics2Frame bool read/write
editorShortGuides bool read/write
editorShowHiddenNodeName bool read/write
editorShowSb bool read/write
editorSidebarInactive int read/write
editorSmartDelay int read/write
editorStrongRound bool read/write
editorTaperMode int read/write
editorTextWidth int read/write
editorUseItalicAngle int read/write
editorZoneNodes bool read/write
exportOrganizeMode int read/write
exportPPM int read/write
exportSaveFolder QString read/write
exportSaveSketchboard bool read/write
exportSaveWorkspaceVFC uint read/write
exportSaveWorkspaceVFJ uint read/write
exportSessionVFJ bool read/write
featuresAddKerningClasses bool read/write
featuresAddOpenTypeClasses bool read/write
featuresAddTags bool read/write
featuresAddVirtualTags bool read/write
fontAskFileName int read/write
fontAuditInPlace bool read/write
fontAuditStemTolerance double read/write
fontCaptionTop bool read/write
fontClose bool read/write
fontCreateDynamic bool read/write
fontCreateGenerate bool read/write
fontDefaultEncoding QString read/write
fontDefaultMode int read/write
fontDefaultSorting int read/write
fontDrawLines bool read/write
fontExtraIcons bool read/write
fontFriendlyEncoding bool read/write
fontMetricsLimit int read/write
fontMonospaced QString read/write
fontNamFileName QString read/write
fontNamFileNameDefault string read
fontNewNames int read/write
fontNewWindow bool read/write
fontPropertyIcon bool read/write
fontRedBar bool read/write
fontSpaceScroll bool read/write
fontUnicodeUppercase bool read/write
fontWheelBrowse bool read/write
fontWheelScroll int read/write
fontsAutoSaveTimeInterval int read/write
generalActivatePanels bool read/write
generalBeta bool read/write
generalCheckUpdates bool read/write
generalClosePanels bool read/write
generalDarkFont bool read/write
generalDarkGlyph bool read/write
generalSketchboard bool read/write
generalTabs int read/write
generalTabsDrag bool read/write
generalTabsPreview bool read/write
generalVirtualKeys bool read/write
groupsAlign int read/write
groupsColor QColor read/write
groupsContent QString read/write
groupsDoubleClick bool read/write
groupsFill int read/write
groupsMask int read/write
groupsMasters bool read/write
groupsMetrics bool read/write
groupsOpacity int read/write
groupsPreview bool read/write
groupsShiftX double read/write
groupsShiftY double read/write
importCompileFeatures bool read/write
importConvertNames int read/write
importDecompileTables bool read/write
importDetectGenius bool read/write
importDetectServant bool read/write
importExcludeTables QStringList read/write
importLockComposites bool read/write
importOpenFontWindow bool read/write
importRenameCID bool read/write
importSeparateMasters bool read/write
importTrueTypeShortCurves bool read/write
kerningAuditExceptions double read/write
kerningAutoToleranceNegative double read/write
kerningAutoTolerancePositive double read/write
kerningPairs QString read/write
lockFontGuidelines bool read/write
lockFontMetrics bool read/write
lockGrid bool read/write
lockGuidelines bool read/write
lockHints bool read/write
lockMask bool read/write
lockMaskGlobal bool read/write
lockMetrics bool read/write
lockOutline bool read/write
lockPinPoints bool read/write
lockZones bool read/write
mastersBackgroundBrightness int read/write
mastersBarThickness int read/write
mastersPreviewColor int read/write
match uint read/write
matchNudge bool read/write
meterToolActive bool read/write
meterToolDrag bool read/write
metricsFreeMetrics bool read/write
metricsHideCursor bool read/write
metricsSamples QString read/write
metricsSmartNavigation bool read/write
metricsTableArrowsNavigation bool read/write
metricsToStroke bool read/write
openRestorePanels bool read/write
openRestoreWindows bool read/write
openRestoreWindowsGlyphs bool read/write
operationsOCR bool read/write
operationsPowerGuides int read/write
operationsSeparateDetectStrings bool read/write
operationsSeparateMergeOverlapped bool read/write
operationsSeparateMergeStacked bool read/write
operationsTesseractLanguages QString read/write
operationsTracePrecision double read/write
operationsTraceSmoothness double read/write
panelTabs int read/write
panelWrap int read/write
pantographActive bool read/write
pasteEPS bool read/write
pasteIgnoreAppearance bool read/write
saveConflictMode int read/write
showAnchorCloudSelected bool read/write
showElementNote bool read/write
showHoveredCoordinates bool read/write
showNodePositionLarge bool read/write
showNodeStyle int read/write
showPinName bool read/write
showSelectionGlow bool read/write
showStemThickness int read/write
showTapeLine bool read/write
sketchboardAutoSaveTimeInterval int read/write
stringIconLong QString read/write
stringIconShort QString read/write
stringNewTextBlock QString read/write
stringPreview QString read/write
stringSizeGlyphWaterfall QString read/write
stringSizeTextWaterfall QString read/write
stringSticker QString read/write
templateFontFamilyName string read
templateFontId int read
texts QStringList read/write
tthSamples QString read/write
viewAlternative bool read/write
viewAntialiasing bool read/write
workFontFamilyName string read
workFontId int read
zoomAscender int read/write
zoomDescender int read/write
zoomFactorKeyboard double read/write
zoomFactorWheel double read/write
zoomMode int read/write
zoomSize int read/write

All registered methods are static and take positional arguments.

Constructors: flPreferences()

Native bases: object

Captured native MRO: flPreferences, object

Native new allocation evidence (not an init overload): (args, *kwargs) Create and return a new object. See help(type) for accurate signature.

Supplemental documentation: Preferences. The captured declaration exposes doInterpolate, fontAuditTests, instance, load, save, saveView, setFontAuditTest, setGridDistances, sourceMetricsSamples, unicode2text, ConflictOverwrite, ConflictRename, ConflictSkip, DestinationAsk, DestinationFolder and DsigAlgorithmSHA256. It is created with no captured constructor overloads.

Source: FontLab Proteus API documentation

Source: generated/fontlab.py: flPreferences captured declaration

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
ConflictOverwrite attribute int
ConflictRename attribute int
ConflictSkip attribute int
ConflictTrash attribute int
ContentCurrent attribute int
ContentInstances attribute int
ContentMasters attribute int
ContentVisible attribute int
CoordinanesNone attribute int
CoordinatesAll attribute int
CoordinatesSelected attribute int
CurvatureLarge attribute int
CurvatureMedium attribute int
CurvatureSmall attribute int
CurvatureSmart attribute int
DestinationAsk attribute int
DestinationFolder attribute int
DestinationSource attribute int
DrawFocusAlways attribute int
DrawFocusNever attribute int
DrawFocusPanels attribute int
DsigAlgorithmMD5 attribute int
DsigAlgorithmSHA1 attribute int
DsigAlgorithmSHA256 attribute int
DsigAlgorithmSHA384 attribute int
DsigAlgorithmSHA512 attribute int
DsigAuthorityCommercial attribute int
DsigAuthorityDefault attribute int
DsigAuthorityIndividual attribute int
FontCaptionAuto attribute int
FontCaptionLarge attribute int
FontCaptionMedium attribute int
FontCaptionSmall attribute int
GroupsAlignCenter attribute int
GroupsAlignLeft attribute int
GroupsAlignRight attribute int
GroupsFillAlways attribute int
GroupsFillAuto attribute int
GroupsFillNever attribute int
GroupsMaskMask attribute int
GroupsMaskNone attribute int
GroupsMaskOutline attribute int
InactiveNodeNone attribute int
InactiveNodeNormal attribute int
InactiveNodeSmall attribute int
InterpretName attribute int
InterpretWeight attribute int
InterpretWidth attribute int
KeepDraw attribute int
KeepGuidesHints attribute int
KeepInsertDelete attribute int
KeepNone attribute int
MastersBackground attribute int
MastersBar attribute int
MastersNone attribute int
MatchAll attribute int
MatchConvertSegment attribute int
MatchDeleteNode attribute int
MatchGuides attribute int
MatchHints attribute int
MatchInsertNode attribute int
MatchInsertShape attribute int
MatchPins attribute int
MatchRenameNode attribute int
MetricsHideAnchors attribute int
MetricsHideFontGuides attribute int
MetricsHideFontMetrics attribute int
MetricsHideGlyphMetrics attribute int
MetricsHideGrid attribute int
MetricsHideGuides attribute int
MetricsHideHints attribute int
MetricsHideZones attribute int
ModeCategories attribute int
ModeCodepages attribute int
ModeIndex attribute int
ModeNames attribute int
ModeNone attribute int
ModeRanges attribute int
ModeScripts attribute int
NiceGlyphs attribute int
NiceNone attribute int
NicePdf attribute int
NiceRobo attribute int
NiceUni attribute int
NodeNameAlways attribute int
NodeNameCoordinates attribute int
NodeNameNever attribute int
NodeStyleAuto attribute int
NodeStyleFlat attribute int
NodeStyleFrame attribute int
OrganizeNone attribute int
OrganizePSN attribute int
OrganizeProfile attribute int
OrganizeSGN attribute int
OrganizeTFN attribute int
OrganizeTFN_Profile attribute int
PasteAlign attribute int
PasteAscender_Descender attribute int
PasteCapsHeight_Baseline attribute int
PasteCapsHeight_Descender attribute int
PasteUPM_Descender attribute int
PasteUnscaled attribute int
PowerAll attribute int
PowerFont attribute int
PowerGlyph attribute int
PowerMetrics attribute int
PowerZones attribute int
RainbowNoCenterline attribute int
RainbowNoEdges attribute int
RainbowNoRainbow attribute int
RainbowNone attribute int
RainbowShow attribute int
RoundAll attribute int
RoundNone attribute int
RoundOn attribute int
SaveFolderAsk attribute int
SaveFolderFolder attribute int
SaveFolderSource attribute int
SaveWorkspacePanels attribute int
SaveWorkspaceWindows attribute int
SingleBreak attribute int
SingleRemove attribute int
TaperBody attribute int
TaperEdge attribute int
TaperEverywhere attribute int
TaperNone attribute int
ThicknessNormal attribute int
ThicknessThick attribute int
ThicknessThin attribute int
TransformModeRotate attribute int
TransformModeScale attribute int
TransformModeSlant attribute int
UseItalicAll attribute int
UseItalicMetrics attribute int
UseItalicNone attribute int
ViewAnchorGroups attribute int
ViewAnchors attribute int
ViewBackground attribute int
ViewContourDirection attribute int
ViewCoordinates attribute int
ViewCount attribute int
ViewCounters attribute int
ViewCurvature attribute int
ViewFilledPreview attribute int
ViewFontAudit attribute int
ViewFontGuides attribute int
ViewFontMetrics attribute int
ViewGlobalMask attribute int
ViewGlyphBar attribute int
ViewGlyphGuides attribute int
ViewGlyphMetrics attribute int
ViewGrid attribute int
ViewGroups attribute int
ViewHandles attribute int
ViewHintShadows attribute int
ViewHints attribute int
ViewInactiveGlyphs attribute int
ViewKerningGroups attribute int
ViewLocalMask attribute int
ViewMasterLinks attribute int
ViewMeasurement attribute int
ViewMeasurementPanel attribute int
ViewMetricsTable attribute int
ViewModeKerning attribute int
ViewModeMetrics attribute int
ViewModeOutline attribute int
ViewModePreview attribute int
ViewModeText attribute int
ViewNodeLinks attribute int
ViewNodes attribute int
ViewPins attribute int
ViewRulers attribute int
ViewSelectionFrame attribute int
ViewShapeConnection attribute int
ViewShapeFrame attribute int
ViewShapeGuides attribute int
ViewShapeLinks attribute int
ViewStickers attribute int
ViewString attribute int
ViewTapeLine attribute int
ViewThickness attribute int
ViewTunni attribute int
ViewZones attribute int
WindowsFontTabs attribute int
WindowsTabs attribute int
WindowsWindows attribute int
ZoomModeLines attribute int
ZoomModeMetrics attribute int
ZoomModeSafe attribute int
ZoomModeSize attribute int
__init__ function (self, /, *args: Any, **kwargs: Any) -> None Initialize self. (shared captured text)
colorEncoding attribute Any The colour used for encoding indicators (Unicode assignment markers).
colorFontCell attribute Any The background colour of glyph cells in the font window.
colorGrid attribute Any The colour of grid lines in the glyph editor.
colorKerning attribute Any The colour used to display kerning pairs in the metrics window.
colorMask attribute Any The colour of the mask overlay in the glyph editor.
colorMaskGlobal attribute Any The colour of the global mask overlay.
colorMaskLocal attribute Any The colour of the local (glyph-level) mask overlay.
colorMetrics attribute Any The colour of metrics lines (baseline, cap height, x-height, etc.) in the editor.
colorMetricsLines attribute Any The colour of secondary metrics lines.
colorWorkspace attribute Any The background colour of the workspace canvas area.
convertDetectZoneTags attribute Any When converting from PS to TT (or vice versa), automatically detect alignment zone tags.
convertPostScriptPrecision attribute Any How precisely curves are fitted when converting to PostScript cubic format.
convertTrueTypePrecision attribute Any How precisely curves are fitted when converting to TrueType quadratic format.
convertTrueTypeShortCurves attribute Any Use the short-curve optimization in TrueType output — this creates shorter, more efficient curve data but may slightly alter curve shapes.
dataPath attribute Any The path to the FontLab user data directory — where scripts, brushes, and other user resources are stored.
dataPathDefault attribute Any The factory-default data path.
defaultTexts attribute Any The list of default sample text strings used in the Metrics and Text windows.
developerBacklightUpdate attribute Any
developerLargeQuickHelp attribute Any
developerNoParameters attribute Any
developerOpenGL attribute Any
developerShowKeys attribute Any
doInterpolate function () -> bool Returns whether variable font interpolation is currently enabled.
drawFocusRect attribute Any
dsigAlgorithm attribute Any
dsigAuthority attribute Any
dsigCertificatePath attribute Any
dsigPassword attribute Any
dsigPrivateKeyPath attribute Any
dsigTimestamp attribute Any
dsigTimestampUrl attribute Any
dsigUrl attribute Any
dsigWrite attribute Any
editorAcrossGlyphs attribute Any Allow editing operations (like node dragging) to span across multiple glyphs in the metrics view.
editorAcrossLayers attribute Any Allow operations to affect multiple master layers simultaneously.
editorAcrossShapes attribute Any Allow operations to span multiple shapes within a glyph.
editorAllowCache attribute Any
editorAlternativePencil attribute Any
editorAutoNonSpacing attribute Any
editorCenterGlyph attribute Any
editorClickSelectsCurve attribute Any Whether clicking directly on a curve segment selects it (and its nodes).
editorCloseDistance attribute Any
editorCommandSelector attribute Any
editorContrast attribute Any Enhance outline contrast for better visibility against the background.
editorCoordinates attribute Any Whether to show coordinate values next to selected nodes.
editorCoordinatesEditable attribute Any Whether coordinate values shown next to nodes can be edited inline by clicking.
editorCopyText attribute Any
editorCross attribute Any
editorCtrl100 attribute Any
editorCurvatureOpacity attribute Any The opacity of curvature combs (0.0–1.0).
editorCurvatureSize attribute Any The size of curvature comb spines.
editorDarkPreview attribute Any Use a dark background in Preview mode (simulates dark-on-light rendering).
editorDeleteSingleNode attribute Any
editorDirectKerning attribute Any Enable direct kerning mode — allows dragging sidebearings to adjust kerning in the metrics view.
editorDragInactiveShape attribute Any Whether inactive shapes can be dragged without first activating them.
editorFastPreview attribute Any Use faster but lower-quality preview rendering.
editorFeatures attribute Any
editorFillOpacity attribute Any The opacity of the glyph fill colour in the editor, as a percentage (0 = transparent, 100 = solid).
editorFillOpenContours attribute Any Fill open contours with colour in the editor (so they look like closed paths even when they aren't).
editorFixedBCP attribute Any Keep off-curve control points at fixed positions when moving their on-curve neighbor.
editorFocus attribute Any
editorForcedGrid attribute Any
editorForcedSnap attribute Any
editorFrameSelectsOnNodes attribute Any When using frame (rubber-band) selection, only capture nodes whose on-curve point is inside the frame.
editorGestures attribute Any Enable trackpad gesture operations (pinch-to-zoom, etc.).
editorGuideHitDistance attribute Any How close the cursor needs to be to a guideline to click and select it, in screen pixels.
editorHidePlaceholders attribute Any
editorInactiveHandles attribute Any Show Bézier handles for shapes that are not currently the active/selected shape.
editorInactiveNodes attribute Any How inactive (non-selected-shape) nodes are displayed: 0 = hidden, other values = different rendering modes.
editorInactiveWireframe attribute Any Display inactive shapes as wireframe outlines rather than filled shapes.
editorIndependentGlyphMasters attribute Any
editorInertion attribute Any Enable inertia scrolling (the view continues to scroll after you lift your finger).
editorInstanceLayer attribute Any
editorInterpolate attribute Any
editorInterpolateModifier attribute Any
editorKeyboardJoin attribute Any Allow joining open contour endpoints using a keyboard shortcut.
editorLayerDoubleClick attribute Any Double-clicking on a glyph activates its layer for editing.
editorListMaskLayers attribute Any
editorLockInactiveGlyphs attribute Any
editorMatch attribute Any
editorMeterCoordinates attribute Any
editorMetricsDoubleClick attribute Any Double-clicking in the metrics window enters edit mode for that glyph.
editorMinHandle attribute Any
editorMissingGlyphs attribute Any
editorModalPen attribute Any
editorNodeColor attribute Any The colour scheme for nodes — an index into FontLab's built-in node colour palettes.
editorNodeFontDefault attribute Any
editorNodeFontHovered attribute Any
editorNodeHighlightDistance attribute Any
editorNodeHitDistance attribute Any
editorNodeSize attribute Any The size of node circles in the editor, in screen pixels.
editorNoteExpanded attribute Any
editorNudge1 attribute Any The small nudge distance — the amount moved per arrow key press.
editorNudge10 attribute Any The large nudge distance — the amount moved with Shift + arrow key.
editorOffsetDuplicate attribute Any
editorOffsetPaste attribute Any
editorOutlineThickness attribute Any The thickness of the outline stroke drawn around glyph contours in the editor, in pixels.
editorPantographCurve attribute Any
editorPantographKerning attribute Any
editorPantographNode attribute Any
editorPasteArtwork attribute Any
editorPasteContourVisual attribute Any
editorPasteReplace attribute Any
editorPenCorrection attribute Any
editorPenPreview attribute Any
editorPreviewPowerNudge attribute Any
editorProportionalThickness attribute Any
editorRoundKerning attribute Any
editorRoundMetrics attribute Any
editorScrollBars attribute Any Show scroll bars in the glyph editor.
editorSetMetrics2Frame attribute Any
editorShiftConstrains attribute Any The Shift key constrains movement to horizontal or vertical axes.
editorShiftExtendsSelection attribute Any Shift-clicking adds to the current selection rather than replacing it.
editorShortGuides attribute Any
editorShowCoordinates attribute Any Controls coordinate display mode for selected nodes.
editorShowCurves attribute Any Whether to show Bézier curve handles (the "arms" extending from smooth nodes).
editorShowHiddenNodeName attribute Any
editorShowNodeName attribute Any Controls whether node names are shown (0 = never, other values = various display modes).
editorShowSb attribute Any
editorSidebarInactive attribute Any
editorSmartDelay attribute Any
editorSnapDistance attribute Any How close (in screen pixels) the cursor needs to be to a snap target for snapping to activate.
editorStrongRound attribute Any
editorTaperMode attribute Any
editorTextWidth attribute Any
editorTopBottom attribute Any Show top and bottom metrics lines (ascender/descender) in the editor.
editorUndoSelection attribute Any Include selection state in the undo history (so undoing an edit also restores the previous selection).
editorUseItalicAngle attribute Any
editorZoneNodes attribute Any
editorZoomAscender attribute Any When switching to a new glyph in the editor, automatically zoom to fit the ascender height.
exportConflictMode attribute Any What to do when an export file already exists: 0 = overwrite, 1 = ask, etc.
exportContent attribute Any What to include in the export (all glyphs, only glyphs with outlines, etc.).
exportDestinationFolder attribute Any The default folder path where exported font files are saved.
exportDestinationMode attribute Any Where exported files go: 0 = same folder as source, 1 = specified folder, etc.
exportJsonContours attribute Any Include contour data in JSON format exports.
exportJsonFormatting attribute Any Pretty-print (format with indentation) JSON exports for readability.
exportOrganizeMode attribute Any
exportPPM attribute Any
exportSaveFolder attribute Any
exportSaveSketchboard attribute Any
exportSaveVFJ attribute Any Automatically save a VFJ (JSON font) copy alongside the exported binary font.
exportSaveWorkspaceVFC attribute Any
exportSaveWorkspaceVFJ attribute Any
exportSessionVFJ attribute Any
featuresAddKerningClasses attribute Any
featuresAddOpenTypeClasses attribute Any
featuresAddTags attribute Any
featuresAddVirtualTags attribute Any
fontAbsentGray attribute Any Grey out glyph cells for glyphs that don't have outlines (absent from the current layer).
fontAllGlyphs attribute Any Show all glyphs regardless of the current encoding — useful for seeing the full glyph inventory.
fontAskFileName attribute Any
fontAuditInPlace attribute Any
fontAuditStemTolerance attribute Any
fontAuditTests function () -> Any Returns the list of audit test IDs that are currently enabled.
fontCaptionEditable attribute Any Allow glyph names to be edited inline by clicking the caption under each cell.
fontCaptionHeight attribute Any The height in pixels of the caption row below each glyph cell.
fontCaptionTop attribute Any
fontClose attribute Any
fontColoredCaption attribute Any Use colour for glyph name captions (based on glyph mark colour).
fontColoredItems attribute Any Colour-code glyph cells based on their mark colour.
fontCreateDynamic attribute Any
fontCreateGenerate attribute Any
fontDefaultEncoding attribute Any
fontDefaultMode attribute Any
fontDefaultSorting attribute Any
fontDrawLines attribute Any
fontExtraIcons attribute Any
fontFriendlyEncoding attribute Any
fontMarkBright attribute Any Use brighter, more saturated mark colours.
fontMarkOpacity attribute Any The opacity of glyph mark colour overlays in the font window (0–255).
fontMetricsLimit attribute Any
fontMonospaced attribute Any
fontNamFileName attribute Any
fontNamFileNameDefault attribute Any
fontNameUnicode attribute Any Show Unicode codepoint values alongside glyph names in the font window.
fontNewNames attribute Any
fontNewWindow attribute Any
fontNoteIcon attribute Any Show a small note icon in glyph cells that have notes attached.
fontNoteText attribute Any Show the note text directly inside glyph cells.
fontPropertyIcon attribute Any
fontRedBar attribute Any
fontShowGlyphMetrics attribute Any Show metrics values (advance width etc.) in each glyph cell.
fontSpaceScroll attribute Any
fontUnicodeName attribute Any Display glyph names as their Unicode alias names (e.g.
fontUnicodeUppercase attribute Any
fontWheelBrowse attribute Any
fontWheelScroll attribute Any
fontsAutoSaveTimeInterval attribute Any
generalActivateFontWindowOnOpen attribute Any
generalActivatePanels attribute Any
generalBeta attribute Any
generalCheckUpdates attribute Any
generalClosePanels attribute Any
generalDarkFont attribute Any
generalDarkGlyph attribute Any
generalHideWarningDialogs attribute Any
generalSketchboard attribute Any
generalTabs attribute Any
generalTabsDrag attribute Any
generalTabsPreview attribute Any
generalVirtualKeys attribute Any
gridDistanceX attribute Any Horizontal grid spacing in font units.
gridDistanceY attribute Any Vertical grid spacing in font units.
gridItalicAngle attribute Any Tilt the grid by the font's italic angle, so the grid aligns with the slant of italic letters.
gridOpacity attribute Any The opacity of grid lines (0.0–1.0). 0 = invisible, 1 = fully opaque.
gridPointOpacity attribute Any The opacity of grid intersection dots (0.0–1.0).
gridSlant attribute Any A manual slant angle for the grid, in degrees.
groupsAlign attribute Any
groupsColor attribute Any
groupsContent attribute Any
groupsDoubleClick attribute Any
groupsFill attribute Any
groupsMask attribute Any
groupsMasters attribute Any
groupsMetrics attribute Any
groupsOpacity attribute Any
groupsPreview attribute Any
groupsShiftX attribute Any
groupsShiftY attribute Any
hintMaxH attribute Any Maximum number of horizontal hints allowed per glyph during auto-hinting.
hintMaxV attribute Any Maximum number of vertical hints per glyph.
hintMinH attribute Any Minimum horizontal stem width (in font units) that the auto-hinter will generate a hint for.
hintMinV attribute Any Minimum vertical stem width for auto-hinting.
historyStoreSelection attribute Any Include selection state in the undo history — undo steps will also restore what was selected.
historyStoreViewPoint attribute Any Include the scroll position in the undo history — undo steps restore the view position too.
importCompileFeatures attribute Any
importComponents attribute Any Keep composite components when importing — True preserves components, False decomposes them on open.
importConvertCurves attribute Any Automatically convert curve types (TT↔PS) when importing fonts.
importConvertNames attribute Any
importDecompileFeatures attribute Any Decompile binary OpenType features into source code on import.
importDecompileTables attribute Any
importDecompose attribute Any Decompose all composites to plain contours on import.
importDetectGenius attribute Any
importDetectServant attribute Any
importExcludeTables attribute Any
importLockComposites attribute Any
importOpenFontWindow attribute Any
importRenameCID attribute Any
importRoundCoordinates attribute Any Round all coordinates to integer values on import.
importSeparateMasters attribute Any
importTrueTypeShortCurves attribute Any
inactiveMastersOpacity attribute Any The opacity (0.0–1.0) of inactive master layer overlays shown in the glyph editor.
instance function () -> flPreferences Returns the global preferences singleton.
interpolateSmartRound attribute Any Use smart rounding when interpolating variable font masters — produces cleaner integer coordinates.
isDark attribute Any
kerningAuditExceptions attribute Any
kerningAutoToleranceNegative attribute Any
kerningAutoTolerancePositive attribute Any
kerningPairs attribute Any
load function (arg0: dict[str, Any]) -> Any Restores preferences from a previously saved dict.
lockFontGuidelines attribute Any
lockFontMetrics attribute Any
lockGrid attribute Any
lockGuidelines attribute Any
lockHints attribute Any
lockMask attribute Any
lockMaskGlobal attribute Any
lockMetrics attribute Any
lockOutline attribute Any
lockPinPoints attribute Any
lockZones attribute Any
mastersBackgroundBrightness attribute Any
mastersBarThickness attribute Any
mastersPreviewColor attribute Any
match attribute Any
matchNudge attribute Any
meterToolActive attribute Any
meterToolDrag attribute Any
metricsFreeMetrics attribute Any
metricsHideCursor attribute Any
metricsNudge1 attribute Any The small nudge distance in the Metrics window (for sidebearing and kerning adjustments).
metricsNudge10 attribute Any The large nudge distance in the Metrics window.
metricsSamples attribute Any
metricsSmartNavigation attribute Any
metricsTableArrowsNavigation attribute Any
metricsToStroke attribute Any
namecaptionFont function (*args: Any, **kwargs: Any) -> Any QFont namecaptionFont (bool condensed)
namecaptionFontFamilyName function (*args: Any, **kwargs: Any) -> Any String namecaptionFontFamilyName (bool condensed)
namecaptionFontId function (*args: Any, **kwargs: Any) -> Any Int namecaptionFontId (bool condensed)
openRestorePanels attribute Any
openRestoreWindows attribute Any
openRestoreWindowsGlyphs attribute Any
operationsOCR attribute Any
operationsPowerGuides attribute Any
operationsSeparateDetectStrings attribute Any
operationsSeparateMergeOverlapped attribute Any
operationsSeparateMergeStacked attribute Any
operationsTesseractLanguages attribute Any
operationsTracePrecision attribute Any
operationsTraceSmoothness attribute Any
options2tracer_precision function () -> float Converts the current auto-trace options to a precision value (used internally by the tracer).
options2tracer_smoothness function () -> int Converts the current auto-trace options to a smoothness value.
panelFontSize attribute Any The font size (in points) used in FontLab's panels and UI controls.
panelTabs attribute Any
panelWrap attribute Any
pantographActive attribute Any
pasteEPS attribute Any
pasteIgnoreAppearance attribute Any
pathAutoSave attribute Any The path to the auto-save directory where FontLab stores recovery copies.
pythonClearContext attribute Any Clear the Python scripting context between script runs.
qobject attribute Any (shared captured text)
renderBlackWhite attribute int
renderClearType attribute int
renderGrayScale attribute int
save function () -> dict[str, Any] Serializes all current preferences to a Python dict.
saveBackupFolder attribute Any Save backup copies of fonts in a dedicated backup folder rather than alongside the original.
saveConflictMode attribute Any
saveView function () -> Any Persists the current window layout so it's restored on next launch.
setFontAuditTest function (id: int, value: bool) -> Any Enables or disables a specific font audit test by ID.
setGridDistances function (x: float, y: float) -> Any Sets both horizontal and vertical grid spacing in one call.
showAnchorCloudSelected attribute Any
showElementNote attribute Any
showHoveredCoordinates attribute Any
showNodePositionLarge attribute Any
showNodeStyle attribute Any
showPinName attribute Any
showSelectionGlow attribute Any
showStemThickness attribute Any
showTapeLine attribute Any
sketchboardAutoSaveTimeInterval attribute Any
smartGuides attribute Any Enable smart guides — automatically-created temporary guidelines that appear when objects are aligned or equally spaced.
snapToBounds attribute Any Snap to bounding box edges of nearby objects.
snapToCenters attribute Any Snap to the centre point of bounding boxes.
snapToDistance attribute Any Equal-distance snapping — snaps to positions that maintain equal spacing between objects.
snapToFontGuidelines attribute Any Snap to font-level guidelines (those that apply to all glyphs).
snapToFontMetrics attribute Any Snap to font-level metrics lines (cap height, x-height, ascender, etc.).
snapToGrid attribute Any Snap to the grid lines.
snapToGuidelines attribute Any Snap to glyph-level guidelines.
snapToHints attribute Any Snap to hint positions (zones and stems).
snapToMask attribute Any Snap to the contours of the local mask layer.
snapToMaskGlobal attribute Any Snap to the contours of the global mask layer.
snapToMetrics attribute Any Snap to glyph-level metrics (advance width, sidebearings).
snapToOutline attribute Any Snap to the outlines of other contours/shapes.
snapToPinPoints attribute Any Snap to anchor points (pin points).
snapToStems attribute Any Snap to the edges of defined stem zones.
snapToZones attribute Any Snap to alignment zone boundaries.
sourceMetricsSamples function () -> str Returns the source text used for metrics sample strings.
stringIconLong attribute Any
stringIconShort attribute Any
stringNewTextBlock attribute Any
stringPreview attribute Any
stringSizeGlyphWaterfall attribute Any
stringSizeTextWaterfall attribute Any
stringSticker attribute Any
templateFont attribute Any The Qt font used for rendering template UI elements.
templateFontFamilyName attribute Any
templateFontId attribute Any
texts attribute Any
tracer2options_precision function (curve_fit: float) -> float Maps a curve_fit value back to a tracer precision setting.
tracer2options_smoothness function (straighten_angle: int) -> float Maps a straighten_angle value back to a tracer smoothness setting.
tthHintingFlag attribute Any A bitmask of TrueType hinting flags.
tthHintingTolerance attribute Any The tolerance value for TrueType hinting operations.
tthPPM attribute Any The default pixels-per-em (PPM/PPX) size used when previewing TrueType hinting in the editor.
tthRender attribute Any The TrueType rendering mode for hinting preview: 0 = monochrome, 1 = grayscale, 2 = ClearType, etc.
tthSamples attribute Any
unicode2text function (unc: int) -> str
viewAlternative attribute Any
viewAntialiasing attribute Any
workFont attribute Any The Qt font used in editors and work areas.
workFontFamilyName attribute Any
workFontId attribute Any
zoomAscender attribute Any
zoomDescender attribute Any
zoomFactorKeyboard attribute Any
zoomFactorWheel attribute Any
zoomMode attribute Any
zoomSize attribute Any