Fontisan: Font analysis tools and utilities

require "fontisan"

# Load a TrueType font (.ttf)
font = Fontisan::TrueTypeFont.from_file("path/to/font.ttf")

# Load an OpenType font (.otf with CFF outlines)
font = Fontisan::OpenTypeFont.from_file("path/to/font.otf")

# Load a specific font from a TTC file
ttc = Fontisan::TrueTypeCollection.from_file("path/to/fonts.ttc")
font = ttc.font_at_index(0)  # Get first font

# Or use FontLoader to auto-detect format
font = Fontisan::FontLoader.load_file("path/to/any-font-file.ttf", font_index: 0)

name_table = font.table("name")

# Get standard name entries
family = name_table.english_name(Fontisan::Tables::Name::FAMILY)
subfamily = name_table.english_name(Fontisan::Tables::Name::SUBFAMILY)
full_name = name_table.english_name(Fontisan::Tables::Name::FULL_NAME)
postscript_name = name_table.english_name(Fontisan::Tables::Name::POSTSCRIPT)

# Get all available names
name_table.name_records.each do |record|
  puts "#{record.name_id}: #{record.string}"
end

head_table = font.table("head")

# Get font revision
revision = head_table.font_revision  # => 7.050994873046875

# Get units per em
units_per_em = head_table.units_per_em  # => 1000

# Get created/modified timestamps
created = head_table.created
modified = head_table.modified

os2_table = font.table("OS/2")

# Get vendor ID
vendor_id = os2_table.ach_vend_id  # => "QUE "

# Check optical size
if os2_table.version >= 5
  lower_size = os2_table.us_lower_optical_point_size  # => 18
  upper_size = os2_table.us_upper_optical_point_size  # => 72
end

# Get weight class
weight = os2_table.us_weight_class  # => 400 (Regular)

post_table = font.table("post")

# Get all glyph names
glyph_names = post_table.glyph_names  # => [".notdef", "space", "exclam", ...]

# Check post table version
version = post_table.version  # => 2.0

cmap_table = font.table("cmap")

# Get all Unicode to glyph index mappings
mappings = cmap_table.unicode_mappings
# => { 0x0020 => 1, 0x0021 => 2, 0x0022 => 3, ... }

# Look up specific  Unicode codepoint
glyph_index = mappings[0x0041]  # => glyph index for 'A'

# Get subtables
subtables = cmap_table.subtables
subtables.each do |subtable|
  puts "Platform #{subtable.platform_id}, Encoding #{subtable.encoding_id}"
end

# Get scripts from GSUB table
gsub = font.table("GSUB")
scripts = gsub.scripts  # => ["DFLT", "latn", "cyrl", "grek", "hebr"]

# Get scripts from GPOS table
gpos = font.table("GPOS")
scripts = gpos.scripts  # => ["DFLT", "latn", "cyrl", "grek", "hebr"]

# Combine scripts from both tables
all_scripts = (gsub.scripts + gpos.scripts).uniq.sort

gsub = font.table("GSUB")

# Get features for a specific script
latin_features = gsub.features(script_tag: "latn")
# => ["cpsp", "kern", "mark", "mkmk"]

# Get features for all scripts
scripts = gsub.scripts
features_by_script = scripts.each_with_object({}) do |script, hash|
  hash[script] = gsub.features(script_tag: script)
end
# => {"DFLT"=>["cpsp", "kern", ...], "latn"=>["cpsp", "kern", ...], ...}

# Combine GSUB and GPOS features
gpos = font.table("GPOS")
all_features = (gsub.features(script_tag: "latn") + gpos.features(script_tag: "latn")).uniq

fvar_table = font.table("fvar")

# Check if font is variable
is_variable = !fvar_table.nil?

# Get variation axes
axes = fvar_table.axes
axes.each do |axis|
  puts "Axis: #{axis.axis_tag}"
  puts "  Name: #{axis.axis_name_id}"
  puts "  Range: #{axis.min_value} to #{axis.max_value}"
  puts "  Default: #{axis.default_value}"
end

# Get named instances
instances = fvar_table.instances
instances.each do |instance|
  puts "Instance: #{instance.subfamily_name_id}"
  puts "  Coordinates: #{instance.coordinates.inspect}"
end

# Ch eck if font has specific tables
has_gsub = font.has_table?("GSUB")  # => true
has_gpos = font.has_table?("GPOS")  # => true
has_fvar = font.has_table?("fvar")  # => false (not a variable font)

# Get list of all table tags
table_names = font.table_names
# => ["GDEF", "GPOS", "OS/2", "cmap", "cvt ", ...]

# Get font format
font_format = font.header.sfnt_version == 0x00010000 ? "TrueType" : "OpenType"

# Get number of glyphs
post = font.table("post")
glyph_count = post.glyph_names.length  # => 2731

# Use InfoCommand to get structured info
cmd = Fontisan::Commands::InfoCommand.new("font.ttf", {})
info = cmd.run  # Returns Fontisan::Models::FontInfo

# Access structured data
puts info.family_name      # => "Libertinus Serif"
puts info.designer         # => "Philipp H. Poll, Khaled Hosny"
puts info.font_format      # => "truetype"

# Serialize to formats
json_output = info.to_json
yaml_output = info.to_yaml

# Get scripts
scripts_cmd = Fontisan::Commands::ScriptsCommand.new("font.ttf", {})
scripts_info = scripts_cmd.run  # Returns Fontisan::Models::ScriptsInfo

scripts_info.scripts.each do |script|
  puts "#{script.tag}: #{script.description}"
end

# Get features for a script
features_cmd = Fontisan::Commands::FeaturesCommand.new(
  "font.ttf",
  { script: "latn" }
)
features_info = features_cmd.run  # Returns Fontisan::Models::FeaturesInfo

features_info.features.each do |feature|
  puts "#{feature.tag}: #{feature.description}"
end