Contents

# frozen_string_literal: true

module TTFunk
  # TrueType font collection. Usually a file with `.ttc` extension.
  class Collection
    include Enumerable

    # Load a TrueType collection.
    #
    # @overload open(io)
    #   @param io [IO] IO to read the collection from.
    #   @yieldparam collection [TTFunk::Collection]
    #   @return [any] whatever the block returns
    # @overload open(file_path)
    #   @param file_path [String, Pathname] Path to the font collection file.
    #   @yieldparam collection [TTFunk::Collection]
    #   @return [any] whatever the block returns
    def self.open(path)
      if path.respond_to?(:read)
        result = yield(new(path))
        path.rewind
        result
      else
        ::File.open(path, 'rb') do |io|
          yield(new(io))
        end
      end
    end

    # @param io [IO(#read & #rewind)]
    # @raise [ArgumentError] if `io` doesn't start with a ttc tag
    def initialize(io)
      tag = io.read(4)
      raise ArgumentError, 'not a TTC file' unless tag == 'ttcf'

      _major, _minor = io.read(4).unpack('n*')
      count = io.read(4).unpack1('N')
      @offsets = io.read(count * 4).unpack('N*')

      io.rewind
      @contents = io.read
      @cache = []
    end

    # Number of fonts in this collection.
    #
    # @return [Integer]
    def count
      @offsets.length
    end

    # Iterate over fonts in the collection.
    #
    # @yieldparam font [TTFunk::File]
    # @return [self]
    def each
      count.times do |index|
        yield(self[index])
      end
      self
    end

    # Get font by index.
    #
    # @param index [Integer]
    # @return [TTFunk::File]
    def [](index)
      @cache[index] ||= TTFunk::File.new(@contents, @offsets[index])
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
ttfunk-1.8.0	lib/ttfunk/collection.rb