imagefont

type Font struct {
	Data     []byte
	Previews []Preview // In the same order as the input frames.
}

type Frame struct {
	Image          image.Image
	Columns, Rows  int  // Zero selects 32 columns and an aspect-ratio-derived row count.
	CodepointStart rune // Zero allocates after the preceding frame, starting at U+E000.
}

type Options struct {
	Family, PostScript string
	// TileWidth and TileHeight are bitmap dimensions at 32ppem. Both zero selects
	// 16×32. Otherwise width must be 8..24 and height 16..48. These adapt image
	// tiles to terminal cell spacing without changing the font's text metrics.
	TileWidth, TileHeight int
}

type PreserveOptions struct {
	Tables           map[string][]byte
	SourcePostScript string
	// SourceName retains an exact bundled full face name when PostScript names
	// are shared by different installed files. Empty uses SourcePostScript.
	SourceName string
	Variations map[string]float64
	// FamilyClass is the native public typographic classification (0..15).
	FamilyClass           uint8
	PointSize             int
	CellWidth, CellHeight int
	Baseline              int
	// TextHeight is the original font's natural line height rounded up, before
	// profile spacing. Monaco needs this to preserve Terminal's special layout.
	TextHeight int
	// LegacyAliases restores old BMP gallery characters during an explicit
	// migration. Off by default so fallback-font private-use icons are retained.
	LegacyAliases bool
}

type Preview struct {
	Text                      string
	Columns, Rows             int
	WidthPixels, HeightPixels int // Dimensions of the 32ppem strike; the other strike doubles both.
	CodepointStart            rune
}