Class: Fontisan::Svg::GlyphGenerator

Inherits:
Object
  • Object
show all
Defined in:
lib/fontisan/svg/glyph_generator.rb

Overview

Generates SVG glyph elements from glyph outlines

[‘GlyphGenerator`](lib/fontisan/svg/glyph_generator.rb) converts [`GlyphOutline`](lib/fontisan/models/glyph_outline.rb) objects to SVG `<glyph>` elements with proper path data and coordinate transformations.

Responsibilities:

  • Transform glyph outline to SVG path with Y-axis flip

  • Generate SVG glyph element with attributes

  • Handle unicode and glyph name mapping

  • Calculate horizontal advance width

  • Format path data with proper precision

This class uses ViewBoxCalculator for coordinate transformations and GlyphOutline’s to_svg_path method for path generation.

Examples:

Generate SVG glyph element

generator = GlyphGenerator.new(calculator)
xml = generator.generate_glyph_xml(outline, unicode: "A", advance_width: 600)

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(calculator) ⇒ GlyphGenerator

Initialize generator with calculator

Parameters:

Raises:

  • (ArgumentError) —

    If calculator is nil



34
35
36
37
38
 
# File 'lib/fontisan/svg/glyph_generator.rb', line 34

def initialize(calculator)
  raise ArgumentError, "Calculator cannot be nil" if calculator.nil?

  @calculator = calculator
end

Instance Attribute Details

#calculator ⇒ ViewBoxCalculator (readonly)

Returns Coordinate calculator.

Returns:



28
29
30
 
# File 'lib/fontisan/svg/glyph_generator.rb', line 28

def calculator
  @calculator
end

Instance Method Details

#generate_glyph_xml(outline, unicode: nil, glyph_name: nil, advance_width: 0, indent: " ") ⇒ String

Generate SVG glyph element

Parameters:

  • outline (Models::GlyphOutline) —

    Glyph outline

  • unicode (String, nil) (defaults to: nil) —

    Unicode character

  • glyph_name (String, nil) (defaults to: nil) —

    Glyph name

  • advance_width (Integer) (defaults to: 0) —

    Horizontal advance width

  • indent (String) (defaults to: " ") —

    Indentation string

Returns:

  • (String) —

    XML glyph element



48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
 
# File 'lib/fontisan/svg/glyph_generator.rb', line 48

def generate_glyph_xml(outline, unicode: nil, glyph_name: nil,
advance_width: 0, indent: "      ")
  # Build attribute parts
  attr_parts = []

  attr_parts << "unicode=\"#{escape_xml(unicode)}\"" if unicode
  attr_parts << "glyph-name=\"#{escape_xml(glyph_name)}\"" if glyph_name
  attr_parts << "horiz-adv-x=\"#{advance_width}\"" if advance_width&.positive?

  # Generate SVG path with Y-axis transformation
  path_data = generate_svg_path(outline)
  attr_parts << "d=\"#{path_data}\"" if path_data && !path_data.empty?

  "#{indent}<glyph #{attr_parts.join(' ')}/>"
end

#generate_missing_glyph(advance_width: 500, indent: " ") ⇒ String

Generate missing-glyph element

Parameters:

  • advance_width (Integer) (defaults to: 500) —

    Default advance width

  • indent (String) (defaults to: " ") —

    Indentation string

Returns:

  • (String) —

    XML missing-glyph element



69
70
71
 
# File 'lib/fontisan/svg/glyph_generator.rb', line 69

def generate_missing_glyph(advance_width: 500, indent: "      ")
  "#{indent}<missing-glyph horiz-adv-x=\"#{advance_width}\"/>"
end

#generate_svg_path(outline) ⇒ String

Generate SVG path data with coordinate transformation

Transforms the glyph outline from font space to SVG space by flipping the Y-axis. Font coordinates use Y-up (ascender positive), while SVG uses Y-down (origin at top).

Parameters:

Returns:

  • (String) —

    SVG path data



81
82
83
84
85
86
87
88
89
 
# File 'lib/fontisan/svg/glyph_generator.rb', line 81

def generate_svg_path(outline)
  return "" if outline.empty?

  path_parts = outline.contours.map do |contour|
    build_transformed_contour_path(contour)
  end

  path_parts.join(" ")
end