hexapdf 0.1.0

data/lib/hexapdf/font/true_type/table/directory.rb

@@ -0,0 +1,92 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+require 'hexapdf/font/true_type/table'
+
+module HexaPDF
+  module Font
+    module TrueType
+      class Table
+
+        # The main table of an sfnt-housed font file, providing the table directory which contains
+        # information for loading all other tables.
+        #
+        # See: https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6.html
+        class Directory < Table
+
+          # A single entry in the table directory.
+          #
+          # Accessors:
+          #
+          # tag::      The 4 byte name of the table as binary string.
+          # checksum:: Checksum of the table.
+          # offset::   Offset from the beginning of the file where the table can be found.
+          # length::   The length of the table in bytes (without the padding).
+          Entry = Struct.new(:tag, :checksum, :offset, :length)
+
+          # The fixed entry that represents the table directory itself.
+          SELF_ENTRY = Entry.new('DUMMY', 0, 0, 12)
+
+          # The type of file housed by the snft wrapper as a binary string. Two possible values are
+          # 'true' or 0x00010000 for a TrueType font and 'OTTO' for an OpenType font.
+          attr_reader :tag
+
+          # Returns the directory entry for the given tag or +nil+ if no such table exists.
+          def entry(tag)
+            @tables[tag]
+          end
+
+          private
+
+          def load_from_io #:nodoc:
+            with_io_pos(0) do
+              @tag, num_tables = read_formatted(12, "a4n".freeze) # ignore 3 fields
+              @tables = {}
+              num_tables.times do
+                entry = Entry.new(*read_formatted(16, "a4NNN".freeze))
+                @tables[entry.tag] = entry
+              end
+            end
+          end
+
+          def load_default #:nodoc:
+            @tag = 'true'.b
+            @tables = {}
+          end
+
+        end
+
+      end
+    end
+  end
+end

data/lib/hexapdf/font/true_type/table/glyf.rb

@@ -0,0 +1,166 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+require 'hexapdf/font/true_type/table'
+
+module HexaPDF
+  module Font
+    module TrueType
+      class Table
+
+        # The 'glyf' table contains the instructions for rendering glyphs and some additional glyph
+        # information.
+        #
+        # This is probably always the largest table in a TrueType font, so care is taken to perform
+        # operations lazily.
+        #
+        # See: https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6glyf.html
+        class Glyf < Table
+
+          # Represents the definition of a glyph. Since the purpose of this implementation is not
+          # editing or rendering glyphs, the raw glyph data is only decoded so far as to get general
+          # information about the glyph.
+          class Glyph
+
+            # Contains the raw byte data of the glyph.
+            attr_reader :raw_data
+
+            # The number of contours in the glyph. A zero or positive number implies a simple glyph,
+            # a negative number a glyph made up from multiple components
+            attr_reader :number_of_contours
+
+            # The minimum x value for coordinate data.
+            attr_reader :x_min
+
+            # The minimum y value for coordinate data.
+            attr_reader :y_min
+
+            # The maximum x value for coordinate data.
+            attr_reader :x_max
+
+            # The maximum y value for coordinate data.
+            attr_reader :y_max
+
+            # The array with the component glyph IDs, or +nil+ if this is not a compound glyph.
+            attr_reader :components
+
+            # Creates a new glyph from the given raw data.
+            def initialize(raw_data)
+              @raw_data = raw_data
+              @number_of_contours, @x_min, @y_min, @x_max, @y_max = @raw_data.unpack('s>5')
+              @number_of_contours ||= 0
+              @components = nil
+              parse_compound_glyph if compound?
+            end
+
+            # Returns +true+ if this a compound glyph.
+            def compound?
+              number_of_contours < 0
+            end
+
+            private
+
+            FLAG_ARG_1_AND_2_ARE_WORDS =    1 << 0 #:nodoc:
+            FLAG_MORE_COMPONENTS =          1 << 5 #:nodoc:
+            FLAG_WE_HAVE_A_SCALE =          1 << 3 #:nodoc:
+            FLAG_WE_HAVE_AN_X_AND_Y_SCALE = 1 << 6 #:nodoc:
+            FLAG_WE_HAVE_A_TWO_BY_TWO =     1 << 7 #:nodoc:
+
+            # Parses the raw data to get the component glyphs.
+            #
+            # This is needed because the component glyphs are referenced by their glyph IDs and
+            # those may change when subsetting the font.
+            def parse_compound_glyph
+              @components = []
+              @component_offsets = []
+              index = 10
+              while true
+                flags, glyph_id = raw_data[index, 4].unpack('n2')
+                @components << glyph_id
+                @component_offsets << index
+                break if flags & FLAG_MORE_COMPONENTS == 0
+
+                index += 4 # fields flags and glyphIndex
+                index += (flags & FLAG_ARG_1_AND_2_ARE_WORDS == 0 ? 2 : 4) # arguments
+                if flags & FLAG_WE_HAVE_A_TWO_BY_TWO != 0 # transformation
+                  index += 8
+                elsif flags & FLAG_WE_HAVE_AN_X_AND_Y_SCALE != 0
+                  index += 4
+                elsif flags & FLAG_WE_HAVE_A_SCALE != 0
+                  index += 2
+                end
+              end
+            end
+
+          end
+
+          # The mapping from glyph ID to Glyph object or +nil+ (if the glyph has no outline).
+          attr_accessor :glyphs
+
+          # Returns the Glyph object for the given glyph ID, or +nil+ if it has no outline (e.g. the
+          # space character).
+          def [](glyph_id)
+            if @glyphs.key?(glyph_id)
+              return @glyphs[glyph_id]
+            elsif !directory_entry
+              return nil
+            end
+
+            offset = font[:loca].offset(glyph_id)
+            length = font[:loca].length(glyph_id)
+
+            if length == 0
+              @glyphs[glyph_id] = Glyph.new('')
+            else
+              raw_data = with_io_pos(directory_entry.offset + offset) { io.read(length) }
+              @glyphs[glyph_id] = Glyph.new(raw_data)
+            end
+          end
+
+          private
+
+          # Nothing to parse here since we lazily parse glyphs.
+          def parse_table
+            @glyphs = {}
+          end
+
+          def load_default #:nodoc:
+            @glyphs = {}
+          end
+
+        end
+
+      end
+    end
+  end
+end

data/lib/hexapdf/font/true_type/table/head.rb

@@ -0,0 +1,143 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+require 'hexapdf/font/true_type/table'
+require 'hexapdf/utils/bit_field'
+
+module HexaPDF
+  module Font
+    module TrueType
+      class Table
+
+        # The 'head' table contains global information about the font.
+        #
+        # See: https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6head.html
+        class Head < Table
+          extend HexaPDF::Utils::BitField
+
+          # The version of the font (a Rational).
+          attr_accessor :version
+
+          # The revision of the font as set by the manufacturer (a Rational).
+          attr_accessor :font_revision
+
+          # The adjustment value for the checksum.
+          attr_accessor :checksum_adjustment
+
+          # Various font flags. See Flags.
+          attr_accessor :flags
+
+          # The number of units per em for the font. Should be a power of 2 in the range from 64
+          # through 16384.
+          attr_accessor :units_per_em
+
+          # The creation time of the font.
+          attr_accessor :created
+
+          # The modification time of the font.
+          attr_accessor :modified
+
+          # The bounding box for all glyphs of the font in the form [xmin, ymin, xmax, ymax].
+          attr_accessor :bbox
+
+          # Apple Mac style information.
+          attr_accessor :mac_style
+          bit_field(:mac_style, bold: 0, italic: 1, underline: 2, outline: 3, shadow: 4,
+                    condensed: 5, extended: 6)
+
+          # The smallest readable size in pixels per em for this font.
+          attr_accessor :smallest_readable_size
+
+          # Represents an indication of the direction of the glyphs of the font.
+          #
+          # 0:: Mixed directional font
+          # 1:: Font with only left-to-right glyphs
+          # -1:: Font with only right-to-left glyphs
+          # 2:: Font with left-to-right and neutral (e.g. punctuation) glyphs
+          # -2:: Font with right-to-left and neutral (e.g. punctuation) glyphs
+          attr_accessor :font_direction_hint
+
+          # Indicates the type of offset format used in the 'loca' table, 0 for short offsets, 1 for
+          # long offsets.
+          #
+          # See: Loca
+          attr_accessor :index_to_loc_format
+
+          # The checksum for the head table is calculated differently because the
+          # checksum_adjustment value is not used during the calculation.
+          #
+          # See: Table#checksum_valid?
+          def checksum_valid?
+            super unless directory_entry
+
+            data = with_io_pos(directory_entry.offset) { io.read(directory_entry.length) }
+            data[8, 4] = 0.chr * 4
+            directory_entry.checksum == self.class.calculate_checksum(data)
+          end
+
+          private
+
+          def parse_table #:nodoc:
+            @version = read_fixed
+            @font_revision = read_fixed
+            data = read_formatted(46, 'N2n2q>2s>4n2s>3')
+            @checksum_adjustment = data[0]
+            if data[1] != 0x5F0F3CF5 # the magic number
+              raise HexaPDF::Error, "Invalid magic number in 'head' table: #{data[1].to_s(16)}"
+            end
+            @flags, @units_per_em = data[2], data[3]
+            @created, @modified = TIME_EPOCH + data[4], TIME_EPOCH + data[5]
+            @bbox = data[6..9]
+            @mac_style, @smallest_readable_size, @font_direction_hint, @index_to_loc_format =
+              *data[10..13]
+            if data[14] != 0 # glyphDataFormat
+              raise HexaPDF::Error, "Invalid glyph data format value (should be 0): #{data[14]}"
+            end
+          end
+
+          def load_default #:nodoc:
+            @version = 1.to_r
+            @font_revision = 1.to_r
+            @checksum_adjustment = @flags = @mac_style = @smallest_readable_size =
+              @font_direction_hint =  @index_to_loc_format = 0
+            @units_per_em = 64
+            @created = @modified = Time.now
+            @bbox = [0, 0, 0, 0]
+          end
+
+        end
+
+      end
+    end
+  end
+end

data/lib/hexapdf/font/true_type/table/hhea.rb

@@ -0,0 +1,109 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+require 'hexapdf/font/true_type/table'
+
+module HexaPDF
+  module Font
+    module TrueType
+      class Table
+
+        # The 'hhea' (horizontal header) table contains information for layouting fonts whose
+        # characters are written horizontally.
+        #
+        # See: https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6hhea.html
+        class Hhea < Table
+
+          # The version of the table (a Rational).
+          attr_accessor :version
+
+          # The distance from the baseline of the highest ascender (as intended by the font
+          # designer).
+          attr_accessor :ascent
+
+          # The distance from the baseline of the lowest descender (as intended by the font
+          # designer).
+          attr_accessor :descent
+
+          # The typographic line gap (as intended by the font designer).
+          attr_accessor :line_gap
+
+          # The maxium advance width (computed value).
+          attr_accessor :advance_width_max
+
+          # The minimum left side bearing (computed value).
+          attr_accessor :min_left_side_bearing
+
+          # The minimum right side bearing (computed value).
+          attr_accessor :min_right_side_bearing
+
+          # The maximum horizontal glyph extent.
+          attr_accessor :x_max_extent
+
+          # Defines together with #caret_slope_run the mathematical slope of the angle for the
+          # caret.
+          #
+          # The slope is actually the ratio caret_slope_rise/caret_slope_run
+          attr_accessor :caret_slope_rise
+
+          # See #caret_slope_rise.
+          attr_accessor :caret_slope_run
+
+          # The amount by which a slanted highlight on a glyph needs (0 for non-slanted fonts).
+          attr_accessor :caret_offset
+
+          # The number of horizontal metrics defined in the 'hmtx' table.
+          attr_accessor :num_of_long_hor_metrics
+
+          private
+
+          def parse_table #:nodoc:
+            @version = read_fixed
+            @ascent, @descent, @line_gap, @advance_width_max, @min_left_side_bearing,
+              @min_right_side_bearing, @x_max_extent, @caret_slope_rise, @caret_slope_run,
+              @caret_offset, @num_of_long_hor_metrics = read_formatted(32, 's>3ns>6x10n')
+          end
+
+          def load_default #:nodoc:
+            @version = 1.to_r
+            @ascent = @descent = @line_gap = @advance_width_max = @min_left_side_bearing =
+              @min_right_side_bearing = @x_max_extent = @caret_slope_rise = @caret_slope_run =
+              @caret_offset = @num_of_long_hor_metrics = 0
+          end
+
+        end
+
+      end
+    end
+  end
+end

data/lib/hexapdf/font/true_type/table/hmtx.rb

@@ -0,0 +1,79 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+require 'hexapdf/font/true_type/table'
+
+module HexaPDF
+  module Font
+    module TrueType
+      class Table
+
+        # The 'hmtx' (horizontal metrics) table contains information for the horizontal layout
+        # of each glyph in the font.
+        #
+        # See: https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6hmtx.html
+        class Hmtx < Table
+
+          # Contains the horizontal layout information for one glyph, namely the :advance_width and
+          # the :left_side_bearing.
+          Metric = Struct.new(:advance_width, :left_side_bearing)
+
+          # An array of Metric objects, one for each glyph in the font.
+          attr_accessor :horizontal_metrics
+
+          # Returns the Metric object for the give glyph ID.
+          def [](glyph_id)
+            @horizontal_metrics[glyph_id]
+          end
+
+          private
+
+          def parse_table #:nodoc:
+            nr_entries = font[:hhea].num_of_long_hor_metrics
+            @horizontal_metrics = nr_entries.times.map { Metric.new(*read_formatted(4, 'ns>')) }
+            last_advance_width = @horizontal_metrics[-1].advance_width
+            read_formatted(directory_entry.length - 4 * nr_entries, 's>*').map do |lsb|
+              @horizontal_metrics << Metric.new(last_advance_width, lsb)
+            end
+          end
+
+          def load_default #:nodoc:
+            @horizontal_metrics = []
+          end
+
+        end
+
+      end
+    end
+  end
+end

data/lib/hexapdf/font/true_type/table/loca.rb

@@ -0,0 +1,79 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+require 'hexapdf/font/true_type/table'
+
+module HexaPDF
+  module Font
+    module TrueType
+      class Table
+
+        # The 'loca' (location) table contains the offsets of the glyphs relative to the start of
+        # the 'glyf' table.
+        #
+        # See: https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6loca.html
+        class Loca < Table
+
+          # The array containing the byte offsets for each glyph relative to the start of the 'glyf'
+          # table.
+          attr_accessor :offsets
+
+          # Returns the byte offset for the given glyph ID relative to the start of the 'glyf'
+          # table.
+          def offset(glyph_id)
+            @offsets[glyph_id]
+          end
+
+          # Returns the length of the 'glyf' entry for the given glyph ID.
+          def length(glyph_id)
+            @offsets[glyph_id + 1] - @offsets[glyph_id]
+          end
+
+          private
+
+          def parse_table #:nodoc:
+            entry_size = font[:head].index_to_loc_format
+            @offsets = read_formatted(directory_entry.length, (entry_size == 0 ? 'n*' : 'N*'))
+            @offsets.map! {|offset| offset * 2} if entry_size == 0
+          end
+
+          def load_default #:nodoc:
+            @offsets = []
+          end
+
+        end
+
+      end
+    end
+  end
+end