fontisan 0.4.3 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b68479ccaac604474e929d9dc4b3de24ec1c79f53e187fd7394cafdf3e02a11
-  data.tar.gz: 27c7dd8fd5afed7656aaaba9a57ea52c78144d66a4346bd4d4b0285c6327c176
+  metadata.gz: 46b8f1b8bf47cb6b91bc1871fc136e0077a7c2d18e99526161ae2ea4085c29d5
+  data.tar.gz: d374dea6fa7de74f605702da037e93fd6a94b8f5082459231b30223a7b8df86f
 SHA512:
-  metadata.gz: 55d3133ec31fb397c671039a8181c5182b62a9cac0108df9a45d551b5def47475d2edbef7e9d921727ad812734351234da82f71c7b8fd1314a16dab83261aa6a
-  data.tar.gz: 4a59af9b12d398575f45018511eeeaea0e49b827efd223f3052ff48f12053087f0e0749498a6be3049f5adb8c880e8461c28167ae7601a7d3dbcaa403e7380e1
+  metadata.gz: 83dc37f826b6f03c37c5ebbac2c8ed5022d0265684af16e308d6aa4b3993b04bd44d61fbd6b538106daf7dd4051c7f5894618856193cc4c60bef547338eaac6f
+  data.tar.gz: f85fc773fbc61b7fb7ea7a41b8b34a05f063584e0992a88e8d0b96d0a5abc73716b4d25df0e75e80388ef582066f5ac009752dbc623d832d76237b4d0ac0d877

data/lib/fontisan/ufo/compile/fvar.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module Fontisan
+  module Ufo
+    module Compile
+      # Builds the OpenType `fvar` (Font Variations) table from a
+      # list of axis definitions and named instances.
+      #
+      # @see https://learn.microsoft.com/en-us/typography/opentype/spec/fvar
+      module Fvar
+        VERSION_MAJOR = 1
+        VERSION_MINOR = 0
+        AXIS_SIZE = 20
+        INSTANCE_SIZE = 4 # + 4 per axis
+        FIXED_SHIFT = 16
+        FIXED_ONE = 1 << FIXED_SHIFT
+
+        # @param font [Fontisan::Ufo::Font]
+        # @param axes [Array<Hash>] axis definitions
+        # @param instances [Array<Hash>] named instance definitions
+        # @return [String, nil] fvar table bytes, or nil if no axes
+        def self.build(font, axes: nil, instances: nil)
+          axes ||= font.info.respond_to?(:axes) ? font.info.axes : nil
+          instances ||= font.info.respond_to?(:named_instances) ? font.info.named_instances : nil
+
+          axes ||= []
+          return nil if axes.empty?
+
+          axes_bytes = build_axes(axes)
+          instances_bytes = build_instances(instances || [], axes.size)
+          header = build_header(axes.size, axes_bytes, instances_bytes, instances)
+          header + axes_bytes + instances_bytes
+        end
+
+        # ---------- header ----------
+
+        # Header is 16 bytes:
+        #   majorVersion (2) + minorVersion (2) + axesArrayOffset (2)
+        #   + reserved (2) + axisCount (2) + axisSize (2)
+        #   + instanceCount (2) + instanceSize (2)
+        def self.build_header(axis_count, axes_bytes, _instances_bytes, instances)
+          axes_offset = 16
+          axes_offset + axes_bytes.bytesize
+
+          [
+            VERSION_MAJOR,
+            VERSION_MINOR,
+            axes_offset,
+            0, # reserved
+            axis_count,
+            AXIS_SIZE,
+            instances&.size || 0,
+            (instances&.size || 0).zero? ? 0 : (INSTANCE_SIZE + axis_count * 4),
+          ].pack("nnnnnnnn")
+        end
+
+        # ---------- axes ----------
+
+        # Each axis record is 20 bytes:
+        #   axisTag (4) + minValue (4) + defaultValue (4) + maxValue (4)
+        #   + flags (2) + axisNameID (2)
+        def self.build_axes(axes)
+          io = +""
+          axes.each do |axis|
+            tag = (axis[:tag] || axis["tag"] || "wght").to_s.ljust(4, " ")[0, 4]
+            min = fixed_value(axis[:min] || axis["min"] || 100)
+            default = fixed_value(axis[:default] || axis["default"] || 400)
+            max = fixed_value(axis[:max] || axis["max"] || 900)
+            flags = axis[:flags] || axis["flags"] || 0
+            name_id = axis[:name_id] || axis["name_id"] || 0
+
+            io << tag
+            io << [min, default, max, flags, name_id].pack("NNNnn")
+          end
+          io
+        end
+
+        # ---------- instances ----------
+
+        # Each instance record: subfamilyNameID (2) + flags (2) + per-axis coords
+        def self.build_instances(instances, axis_count)
+          return +"" if instances.empty?
+
+          io = +""
+          instances.each do |inst|
+            name_id = inst[:name_id] || inst["name_id"] || 0
+            flags = inst[:flags] || inst["flags"] || 0
+            coords = inst[:coords] || inst["coords"] || []
+            padded = coords.first(axis_count) + Array.new([axis_count - coords.size, 0].max, 0)
+            padded = padded.first(axis_count).map { |c| fixed_value(c) }
+
+            io << [name_id, flags].pack("nn")
+            io << padded.pack("N*")
+          end
+          io
+        end
+
+        # ---------- helpers ----------
+
+        # Convert a float to OpenType Fixed 16.16 (int32).
+        def self.fixed_value(value)
+          (value.to_f * FIXED_ONE).to_i
+        end
+        private_class_method :build_header, :build_axes, :build_instances,
+                             :fixed_value
+      end
+    end
+  end
+end

data/lib/fontisan/ufo/compile.rb

@@ -33,6 +33,7 @@ module Fontisan
       autoload :TtfCompiler,  "fontisan/ufo/compile/ttf_compiler"
       autoload :OtfCompiler,  "fontisan/ufo/compile/otf_compiler"
       autoload :Filters,      "fontisan/ufo/compile/filters"
+      autoload :Fvar,         "fontisan/ufo/compile/fvar"
       autoload :Gpos,         "fontisan/ufo/compile/gpos"
       autoload :Head,         "fontisan/ufo/compile/head"
       autoload :Hhea,         "fontisan/ufo/compile/hhea"

data/lib/fontisan/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fontisan
-  VERSION = "0.4.3"
+  VERSION = "0.4.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fontisan
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.4.4
 platform: ruby
 authors:
 - Ribose Inc.
@@ -563,6 +563,7 @@ files:
 - lib/fontisan/ufo/compile/filters/decompose_components.rb
 - lib/fontisan/ufo/compile/filters/flatten_components.rb
 - lib/fontisan/ufo/compile/filters/reverse_contour_direction.rb
+- lib/fontisan/ufo/compile/fvar.rb
 - lib/fontisan/ufo/compile/glyf_loca.rb
 - lib/fontisan/ufo/compile/gpos.rb
 - lib/fontisan/ufo/compile/head.rb