usps_flags 0.1.26 → 0.2.0

data/lib/usps_flags/generate.rb

@@ -8,18 +8,18 @@ class USPSFlags::Generate
     # @param [Boolean] field Whether to generate the flag field (including any border).
     # @param [String] scale The image scale divisor factor.
     # @return [String] Returns the SVG data.
-    def get(flag, outfile: nil, scale: nil, field: true)
+    def svg(flag, outfile: nil, scale: nil, field: true)
       flag = flag.upcase.delete("/", "_", "PENNANT")
       if ["CRUISE", "OIC"].include?(flag)
-        pennant(type: flag, outfile: outfile, scale: scale)
+        USPSFlags::Generate::Flag.pennant(type: flag, outfile: outfile, scale: scale)
       elsif flag == "ENSIGN"
-        ensign(outfile: outfile, scale: scale)
+        USPSFlags::Generate::Flag.ensign(outfile: outfile, scale: scale)
       elsif flag == "US"
-        us(outfile: outfile, scale: scale)
+        USPSFlags::Generate::Flag.us(outfile: outfile, scale: scale)
       elsif flag == "WHEEL"
-        wheel(outfile: outfile, scale: scale)
+        USPSFlags::Generate::Flag.wheel(outfile: outfile, scale: scale)
       else
-        flag(rank: flag, outfile: outfile, scale: scale, field: field)
+        USPSFlags::Generate::Flag.officer(rank: flag, outfile: outfile, scale: scale, field: field)
       end
     end
 
@@ -55,13 +55,12 @@ class USPSFlags::Generate
     def all(svg: true, png: true, zips: true, reset: true)
       remove_static_files if reset
 
-      max_length = USPSFlags::Helpers.valid_flags(:all).map(&:length).max
       puts "\nSVGs generate a single file.",
         "PNGs generate full-res, 1500w, 1000w, 500w, and thumbnail files.",
         "Corresponding rank insignia (including smaller sizes) are also generated, as appropriate."
       USPSFlags::Helpers.log "\n#{Time.now.strftime('%Y%m%d.%H%M%S%z')} – Generating static files...\n\n"
-      USPSFlags::Helpers.log "Flag | SVG | PNG        | Run time\n".rjust(max_length+31),
-        "\n".rjust(max_length+32, "-")
+      USPSFlags::Helpers.log "Flag | SVG | PNG        | Run time\n".rjust(USPSFlags::Helpers.max_flag_name_length+31),
+        "\n".rjust(USPSFlags::Helpers.max_flag_name_length+32, "-")
 
       overall_start_time = Time.now
 
@@ -113,234 +112,62 @@ class USPSFlags::Generate
     # @return [String] Returns the SVG data.
     def spec(outfile: nil, fly: nil, unit: nil, scale: nil)
       fly = fly.nil? ? USPSFlags::Config::BASE_FLY : fly
-      final_svg = ""
-      final_svg << USPSFlags::Core.headers(scale: scale, title: "USPS Trident Specifications")
-      final_svg << USPSFlags::Core.trident_spec(fly: fly, unit: unit)
-      final_svg << USPSFlags::Core.footer
+      svg = ""
+      svg << USPSFlags::Core.headers(scale: scale, title: "USPS Trident Specifications")
+      svg << USPSFlags::Core.trident_spec(fly: fly, unit: unit)
+      svg << USPSFlags::Core.footer
 
-      if outfile.nil?
-        puts final_svg, "\n"
-      else
-        f = ::File.new(outfile, "w+")
-        f.write(final_svg)
-        f.close
-      end
-      final_svg
+      USPSFlags::Helpers.output(svg, outfile: outfile)
     end
 
     private
-    def flag(rank: nil, width: USPSFlags::Config::BASE_FLY, outfile: nil, scale: nil, field: true)
-      raise "Error: No rank specified." if rank.nil?
-      rank = rank.to_s.upcase
-
-      final_svg = ""
-      final_svg << USPSFlags::Core.headers(scale: scale, title: rank)
-
-      rank.slice!(0) if !field && USPSFlags::Helpers.valid_flags(:past).include?(rank)
-      rank = "CDR" if rank == "C"
-
-      flag_details = USPSFlags::Helpers.flag_details(rank)
-      trident_color = field ? :white : flag_details[:color]
-
-      final_svg << USPSFlags::Core.field(style: flag_details[:style], color: flag_details[:color]) if field
-
-      final_svg << "<g transform=\"translate(-150, 400)\"><g transform=\"scale(0.58333)\">" if flag_details[:style] == :past
-
-      if flag_details[:type] == :n && flag_details[:count] == 3
-        # The side C/C tridents are angled 45 degrees, and intersect the central one at 1/3 up from the bottom
-        trident = USPSFlags::Core.trident(flag_details[:type], color: trident_color)
-        x_distance = USPSFlags::Config::BASE_FLY*4/39
-        y_distance = USPSFlags::Config::BASE_FLY*5/78
-        final_svg << "<g transform=\"translate(-#{x_distance}, #{y_distance})\"><g transform=\"rotate(-45, #{USPSFlags::Config::BASE_FLY/2}, #{USPSFlags::Config::BASE_HOIST/2})\">\n#{trident}</g></g>"
-        final_svg << "\n#{trident}"
-        final_svg << "<g transform=\"translate(#{x_distance}, #{y_distance})\"><g transform=\"rotate(45, #{USPSFlags::Config::BASE_FLY/2}, #{USPSFlags::Config::BASE_HOIST/2})\">\n#{trident}</g></g>"
-      elsif flag_details[:type] == :n && flag_details[:count] == 2
-        # V/C tridents are angled 45 degrees, and intersect at 15/32 up from the bottom
-        trident = USPSFlags::Core.trident(flag_details[:type], color: trident_color)
-        x_distance = USPSFlags::Config::BASE_FLY*4/55
-        final_svg << "<g transform=\"translate(-#{x_distance})\"><g transform=\"rotate(-45, #{USPSFlags::Config::BASE_FLY/2}, #{USPSFlags::Config::BASE_HOIST/2})\">\n#{trident}</g></g>"
-        final_svg << "<g transform=\"translate(#{x_distance})\"><g transform=\"rotate(45, #{USPSFlags::Config::BASE_FLY/2}, #{USPSFlags::Config::BASE_HOIST/2})\">\n#{trident}</g></g>"
-      elsif [:s, :d].include?(flag_details[:type]) && flag_details[:count] == 3
-        # Cdr and D/C tridents are spaced 1/2 the fly apart with the central one 1/4 the fly above the sides
-        trident = USPSFlags::Core.trident(flag_details[:type], color: trident_color, field_color: flag_details[:color])
-        x_distance = USPSFlags::Config::BASE_FLY/4
-        y_distance = USPSFlags::Config::BASE_FLY/16
-        final_svg << "<g transform=\"translate(-#{x_distance}, #{y_distance})\">\n#{trident}</g>"
-        final_svg << "<g transform=\"translate(0, -#{y_distance+1})\">\n#{trident}</g>"
-        final_svg << "<g transform=\"translate(#{x_distance}, #{y_distance})\">\n#{trident}</g>"
-      elsif [:s, :d].include?(flag_details[:type]) && flag_details[:count] == 2
-        # Lt/C and D/Lt/C tridents are spaced 1/3 the fly apart
-        trident = USPSFlags::Core.trident(flag_details[:type], color: trident_color, field_color: flag_details[:color])
-        x_distance = USPSFlags::Config::BASE_FLY/6
-        final_svg << "<g transform=\"translate(-#{x_distance})\">\n#{trident}</g>"
-        final_svg << "<g transform=\"translate(#{x_distance})\">\n#{trident}</g>"
-      elsif [:s, :d, :stf, :n].include?(flag_details[:type]) && %w[LT DLT].include?(rank)
-        # Swallowtail tridents need to move towards the hoist due to the tails
-        x_distance = USPSFlags::Config::BASE_FLY/10 if field
-        final_svg << "<g transform=\"translate(-#{x_distance})\">" if field
-        final_svg << USPSFlags::Core.trident(flag_details[:type], field_color: flag_details[:color], color: :red)
-        final_svg << "</g>" if field
-      elsif [:s, :d, :stf, :n].include?(flag_details[:type])
-        # All other tridents are centered on the field
-        final_svg << USPSFlags::Core.trident(flag_details[:type], field_color: flag_details[:color])
-      else
-        # Special Flags
-        # Paths were designed for a base fly of 3000 pixels, but the base was changed for more useful fractions.
-        final_svg << "<g transform=\"translate(#{USPSFlags::Config::BASE_FLY/10})\">" unless field
-        final_svg << "<g transform=\"scale(#{Rational(USPSFlags::Config::BASE_FLY,3000).to_f})\">"
-        case flag_details[:type]
-        when :a
-          final_svg << USPSFlags::Core.binoculars(flag_details[:level])
-        when :f
-          final_svg << USPSFlags::Core.trumpet(flag_details[:level])
-        when :fc
-          final_svg << USPSFlags::Core.anchor
-        when :pc
-          final_svg << USPSFlags::Core.lighthouse
-        end
-        final_svg << "</g>"
-        final_svg << "</g>" unless field
-      end
-
-      final_svg << "</g></g>" if flag_details[:style] == :past
-
-      final_svg << USPSFlags::Core.footer
-
-      if outfile.nil?
-        puts final_svg, "\n"
-      elsif outfile != ""
-        f = ::File.new(outfile, "w+")
-        f.write(final_svg)
-        f.close
-      end
-      final_svg
-    end
-
-    def pennant(type: "CRUISE", outfile: nil, scale: nil)
-      type = type.upcase
-      final_svg = ""
-      title = case type
-      when "CRUISE"
-        "Cruise Pennant"
-      when "OIC"
-        "Officer-in-Charge Pennant"
-      end
-      final_svg << USPSFlags::Core.headers(pennant: true, scale: scale, title: title)
-      final_svg << USPSFlags::Core.pennant(type)
-      final_svg << USPSFlags::Core.footer
-
-      if outfile.nil?
-        puts final_svg, "\n"
-      elsif outfile != ""
-        f = ::File.new(outfile, "w+")
-        f.write(final_svg)
-        f.close
-      end
-      final_svg
-    end
-
-    def ensign(outfile: nil, scale: nil)
-      final_svg = ""
-      final_svg << USPSFlags::Core.headers(scale: scale, title: "USPS Ensign")
-      final_svg << USPSFlags::Core.ensign
-      final_svg << USPSFlags::Core.footer
-
-      if outfile.nil?
-        puts final_svg, "\n"
-      elsif outfile != ""
-        f = ::File.new(outfile, "w+")
-        f.write(final_svg)
-        f.close
-      end
-      final_svg
-    end
-
-    def wheel(outfile: nil, scale: nil)
-      width = 4327.4667
-      height = 4286.9333
-      final_svg = ""
-      final_svg << USPSFlags::Core.headers(width: width, height: height, scale: scale, title: "USPS Ensign Wheel")
-      final_svg << USPSFlags::Core.wheel
-      final_svg << USPSFlags::Core.footer
-
-      if outfile.nil?
-        puts final_svg, "\n"
-      elsif outfile != ""
-        f = ::File.new(outfile, "w+")
-        f.write(final_svg)
-        f.close
-      end
-      final_svg
-    end
-
-    def us(outfile: nil, scale: nil)
-      base_hoist = 2000.to_f
-      base_fly = base_hoist * 1.91
-      hoist = scale.nil? ? base_hoist : (base_hoist / scale)
-      fly = hoist * 1.91
-      final_svg = ""
-      final_svg << USPSFlags::Core.headers(width: fly, height: hoist, scale: scale, title: "US Ensign")
-      final_svg << USPSFlags::Core.us
-      final_svg << USPSFlags::Core.footer
-
-      if outfile.nil?
-        puts final_svg, "\n"
-      elsif outfile != ""
-        f = ::File.new(outfile, "w+")
-        f.write(final_svg)
-        f.close
-      end
-      final_svg
-    end
-
     def remove_static_files
       ["SVG", "PNG", "ZIP"].each { |dir| ::FileUtils.rm_rf(Dir.glob("#{USPSFlags::Config.flags_dir}/#{dir}/*")) }
       ["SVG/insignia", "PNG/insignia"].each { |dir| ::FileUtils.mkdir_p("#{USPSFlags::Config.flags_dir}/#{dir}") }
       USPSFlags::Helpers.log "\n - Cleared previous files.\n"
     end
 
-    def get_file_paths(flag)
-      svg_file = "#{USPSFlags::Config.flags_dir}/SVG/#{flag}.svg"
-      png_file = svg_file.gsub("/SVG/", "/PNG/").gsub(".svg", ".png")
-      svg_ins_file = svg_file.gsub("/SVG/", "/SVG/insignia/")
-      png_ins_file = png_file.gsub("/PNG/", "/PNG/insignia/")
+    def set_file_paths(flag)
+      @svg_file = "#{USPSFlags::Config.flags_dir}/SVG/#{flag}.svg"
+      @png_file = @svg_file.gsub("/SVG/", "/PNG/").gsub(".svg", ".png")
+      @svg_ins_file = @svg_file.gsub("/SVG/", "/SVG/insignia/")
+      @png_ins_file = @svg_file.gsub("/SVG/", "/PNG/insignia/").gsub(".svg", ".png")
+      [@svg_file, @png_file, @svg_ins_file, @png_ins_file]
     end
 
     def generate_static_images_for(flag, svg: true, png: true)
       start_time = Time.now
-      USPSFlags::Helpers.log " |     |  _ _ _ _ _  |         \r".rjust(max_length+31, " ")
+      USPSFlags::Helpers.log " |     |  _ _ _ _ _  |         \r".rjust(USPSFlags::Helpers.max_flag_name_length+31, " ")
       flag = flag.upcase
-      USPSFlags::Helpers.log "#{flag.rjust(max_length)} |"
+      USPSFlags::Helpers.log "#{flag.rjust(USPSFlags::Helpers.max_flag_name_length)} |"
 
-      svg_file, png_file, svg_ins_file, png_ins_file = get_file_paths(flag)
-
-      past = (flag[0] == "P" && flag != "PORTCAP")
+      set_file_paths(flag)
 
       if svg
-        generate_static_svg(flag, svg_file)
+        generate_static_svg(flag)
       else
         USPSFlags::Helpers.log "-"
       end
 
       if png
-        generate_static_png(flag, png_file)
+        generate_static_png(flag)
       else
         USPSFlags::Helpers.log "- "
       end
+
       run_time = (Time.now - start_time).round(4).to_s[(0..5)].ljust(6, "0")
       USPSFlags::Helpers.log " | #{run_time} s\n"
     end
 
     def generate_static_svg(flag)
-      svg_file, png_file, svg_ins_file, png_ins_file = get_file_paths(flag)
       begin
         USPSFlags::Helpers.log " "
-        get flag, outfile: svg_file, scale: 1
+        svg flag, outfile: @svg_file, scale: 1
         USPSFlags::Helpers.log "S"
-        if past || !USPSFlags::Helpers.valid_flags(:insignia).include?(flag)
+        if USPSFlags::Helpers.valid_flags(:past).include?(flag) || !USPSFlags::Helpers.valid_flags(:insignia).include?(flag)
           USPSFlags::Helpers.log "-"
         else
-          get flag, field: false, outfile: svg_ins_file, scale: 1
+          svg flag, field: false, outfile: @svg_ins_file, scale: 1
           USPSFlags::Helpers.log "I"
         end
       rescue => e
@@ -349,38 +176,35 @@ class USPSFlags::Generate
     end
 
     def generate_static_png(flag)
-      svg_file, png_file, svg_ins_file, png_ins_file = get_file_paths(flag)
       USPSFlags::Helpers.log "  | "
       begin
         USPSFlags::Helpers.log "…\b"
-        png(File.read(svg_file), outfile: png_file) unless ::File.exist?(png_file)
+        png(File.read(@svg_file), outfile: @png_file) unless ::File.exist?(@png_file)
         USPSFlags::Helpers.log "F"
-        if past || !insignia_flags.include?(flag)
+        if USPSFlags::Helpers.valid_flags(:past).include?(flag) || !USPSFlags::Helpers.valid_flags(:insignia).include?(flag)
           USPSFlags::Helpers.log "-"
         else
           USPSFlags::Helpers.log "…\b"
-          png(File.read(svg_ins_file), outfile: png_ins_file, trim: true) unless ::File.exist?(png_ins_file)
+          png(File.read(@svg_ins_file), outfile: @png_ins_file, trim: true) unless ::File.exist?(@png_ins_file)
           USPSFlags::Helpers.log "I"
         end
         USPSFlags::Helpers.png_sizes.keys.each do |size|
-          if ::File.exist?("#{USPSFlags::Config.flags_dir}/PNG/#{flag}.#{size}.png")
+          USPSFlags::Helpers.log(".") and next if ::File.exist?("#{USPSFlags::Config.flags_dir}/PNG/#{flag}.#{size}.png")
+
+          USPSFlags::Helpers.log "…\b"
+          size, size_key = USPSFlags::Helpers.size_and_key(size: size, flag: flag)
+          USPSFlags::Helpers.resize_png(@png_ins_file, flag: flag, size: size, size_key: size_key) if USPSFlags::Helpers.valid_flags(:insignia).include?(flag)
+          USPSFlags::Helpers.log USPSFlags::Helpers.png_sizes[size_key]
+          if ::File.exist?(@png_ins_file) && ::File.exist?("#{USPSFlags::Config.flags_dir}/PNG/insignia/#{flag}.#{size}.png")
             USPSFlags::Helpers.log "."
-          else
+          elsif ::File.exist?(@png_ins_file) && MiniMagick::Image.open(@png_ins_file)[:width] > size && USPSFlags::Helpers.valid_flags(:insignia).include?(flag)
             USPSFlags::Helpers.log "…\b"
-            size, size_key = USPSFlags::Helpers.size_and_key(size: size, flag: flag)
-            USPSFlags::Helpers.resize_png(png_ins_file, flag: flag, size: size, size_key: size_key)
-            USPSFlags::Helpers.log USPSFlags::Helpers.png_sizes[size_key]
-            if ::File.exist?(png_ins_file) && ::File.exist?("#{USPSFlags::Config.flags_dir}/PNG/insignia/#{flag}.#{size}.png")
-              USPSFlags::Helpers.log "."
-            elsif ::File.exist?(png_ins_file) && MiniMagick::Image.open(png_ins_file)[:width] > size
-              USPSFlags::Helpers.log "…\b"
-              USPSFlags::Helpers.resize_png(png_ins_file, flag: flag, size: size, size_key: size_key)
-              USPSFlags::Helpers.log "i"
-            elsif ::File.exist?(png_ins_file)
-              USPSFlags::Helpers.log "+"
-            else
-              USPSFlags::Helpers.log "-"
-            end
+            USPSFlags::Helpers.resize_png(@png_ins_file, flag: flag, size: size, size_key: size_key)
+            USPSFlags::Helpers.log "i"
+          elsif ::File.exist?(@png_ins_file)
+            USPSFlags::Helpers.log "+"
+          else
+            USPSFlags::Helpers.log "-"
           end
         end
       rescue => e

data/lib/usps_flags/helpers/builders.rb

@@ -0,0 +1,71 @@
+# SVG building helpers.
+#
+# These methods should never need to be called directly, except when designing new flags.
+# @private
+class USPSFlags::Helpers::Builders
+  class << self
+    # Displays an overlay grid with regularly spaced locator markers.
+    #
+    # This is useful for adjusting or creating new SVG data generators, but should not otherwise need to be called.
+    # @private
+    def grid(width: USPSFlags::Config::BASE_FLY, height: USPSFlags::Config::BASE_HOIST)
+      <<~SVG
+        <circle cx="0" cy="0" r="#{width/60}" fill="#000000" fill-opacity="0.4" />
+        <circle cx="#{width}" cy="0" r="#{width/60}" fill="#000000" fill-opacity="0.4" />
+        <circle cx="#{width}" cy="#{height}" r="#{width/60}" fill="#000000" fill-opacity="0.4" />
+        <circle cx="0" cy="#{height}" r="#{width/60}" fill="#000000" fill-opacity="0.4" />
+
+        <circle cx="#{width*1/4}" cy="#{height/2}" r="#{width/60}" fill="#999999" fill-opacity="0.4" />
+        <circle cx="#{width*3/4}" cy="#{height/2}" r="#{width/60}" fill="#999999" fill-opacity="0.4" />
+
+        <circle cx="#{width/2}" cy="#{height*1/4}" r="#{width/60}"  fill="#999999" fill-opacity="0.4" />
+        <circle cx="#{width/2}" cy="#{height/2}" r="#{width/60}"  fill="#000000" fill-opacity="0.4" />
+        <circle cx="#{width/2}" cy="#{height/2}" r="#{width/75}"  fill="#CCCCCC" fill-opacity="0.4" />
+        <circle cx="#{width/2}" cy="#{height/2}" r="#{width/100}" fill="#000000" fill-opacity="0.4" />
+        <circle cx="#{width/2}" cy="#{height*3/4}" r="#{width/60}"  fill="#999999" fill-opacity="0.4" />
+
+        <line x1="0" y1="0" x2="#{width}" y2="0" stroke="#333333" stroke-width="#{width/600}" stroke-opacity="0.5" />
+        <line x1="0" y1="#{height*1/4}" x2="#{width}" y2="#{height*1/4}" stroke="#333333" stroke-width="#{width/600}" stroke-opacity="0.5" />
+        <line x1="0" y1="#{height/2}" x2="#{width}" y2="#{height/2}" stroke="#333333" stroke-width="#{width/600}" stroke-opacity="0.5" />
+        <line x1="0" y1="#{height*3/4}" x2="#{width}" y2="#{height*3/4}" stroke="#333333" stroke-width="#{width/600}" stroke-opacity="0.5" />
+        <line x1="0" y1="#{height}" x2="#{width}" y2="#{height}" stroke="#333333" stroke-width="#{width/600}" stroke-opacity="0.5" />
+
+        <line y1="0" x1="0" y2="#{height}" x2="0" stroke="#333333" stroke-width="#{width/600}" stroke-opacity="0.5" />
+        <line y1="0" x1="#{width*1/6}" y2="#{height}" x2="#{width*1/6}" stroke="#333333" stroke-width="#{width/600}" stroke-opacity="0.5" />
+        <line y1="0" x1="#{width*2/6}" y2="#{height}" x2="#{width*2/6}" stroke="#333333" stroke-width="#{width/600}" stroke-opacity="0.5" />
+        <line y1="0" x1="#{width*3/6}" y2="#{height}" x2="#{width*3/6}" stroke="#333333" stroke-width="#{width/600}" stroke-opacity="0.5" />
+        <line y1="0" x1="#{width*4/6}" y2="#{height}" x2="#{width*4/6}" stroke="#333333" stroke-width="#{width/600}" stroke-opacity="0.5" />
+        <line y1="0" x1="#{width*5/6}" y2="#{height}" x2="#{width*5/6}" stroke="#333333" stroke-width="#{width/600}" stroke-opacity="0.5" />
+        <line y1="0" x1="#{width}" y2="#{height}" x2="#{width}" stroke="#333333" stroke-width="#{width/600}" stroke-opacity="0.5" />
+
+        <line x1="#{width/2}" y1="#{height*1/4}" x2="#{width*3/4}" y2="#{height/2}" stroke="#999999" stroke-width="#{width/600}" stroke-opacity="0.5" />
+        <line x1="#{width*3/4}" y1="#{height/2}" x2="#{width/2}" y2="#{height*3/4}" stroke="#999999" stroke-width="#{width/600}" stroke-opacity="0.5" />
+        <line x1="#{width/2}" y1="#{height*3/4}" x2="#{width*1/4}" y2="#{height/2}" stroke="#999999" stroke-width="#{width/600}" stroke-opacity="0.5" />
+        <line x1="#{width*1/4}" y1="#{height/2}" x2="#{width/2}" y2="#{height*1/4}" stroke="#999999" stroke-width="#{width/600}" stroke-opacity="0.5" />
+
+      SVG
+    end
+
+    # Displays an overlay indicator of concentric circles and radiating lines.
+    #
+    # This is useful for adjusting or creating new SVG data generators, but should not otherwise need to be called.
+    # @private
+    def locator
+      <<~SVG
+        <circle cx="0" cy="0" r="#{USPSFlags::Config::BASE_FLY*2}" fill="#000000" fill-opacity="0.4" />
+        <circle cx="0" cy="0" r="#{USPSFlags::Config::BASE_FLY}" fill="#333333" fill-opacity="0.4" />
+        <circle cx="0" cy="0" r="#{USPSFlags::Config::BASE_FLY/2}" fill="#666666" fill-opacity="0.4" />
+        <circle cx="0" cy="0" r="#{USPSFlags::Config::BASE_FLY/4}" fill="#999999" fill-opacity="0.4" />
+        <circle cx="0" cy="0" r="#{USPSFlags::Config::BASE_FLY/8}" fill="#CCCCCC" fill-opacity="0.4" />
+        <circle cx="0" cy="0" r="#{USPSFlags::Config::BASE_FLY/16}" fill="#FFFFFF" fill-opacity="0.4" />
+
+        <line x1="-#{USPSFlags::Config::BASE_FLY}" y1="-#{USPSFlags::Config::BASE_HOIST}" x2="#{USPSFlags::Config::BASE_FLY}" y2="#{USPSFlags::Config::BASE_HOIST}"  stroke="#FFFFFF" stroke-width="#{USPSFlags::Config::BASE_FLY/600}" />
+        <line x1="-#{USPSFlags::Config::BASE_FLY}" y1="#{USPSFlags::Config::BASE_HOIST}" x2="#{USPSFlags::Config::BASE_FLY}" y2="-#{USPSFlags::Config::BASE_HOIST}" stroke="#FFFFFF" stroke-width="#{USPSFlags::Config::BASE_FLY/600}" />
+        <line x1="0" y1="#{USPSFlags::Config::BASE_HOIST}" x2="0" y2="-#{USPSFlags::Config::BASE_HOIST}" stroke="#FFFFFF" stroke-width="#{USPSFlags::Config::BASE_FLY/600}" />
+        <line x1="-#{USPSFlags::Config::BASE_FLY}" y1="0" x2="#{USPSFlags::Config::BASE_FLY}" y2="0" stroke="#FFFFFF" stroke-width="#{USPSFlags::Config::BASE_FLY/600}" />
+
+        <rect x="0" y="0" width="#{USPSFlags::Config::BASE_FLY/30}" height="#{USPSFlags::Config::BASE_FLY/30}" fill="#333333" fill-opacity="0.6" />
+      SVG
+    end
+  end
+end

data/lib/usps_flags/helpers/spec_arrows.rb

@@ -0,0 +1,81 @@
+# Trident specification sheet arrows.
+#
+# These methods should never need to be called directly.
+# @private
+class USPSFlags::Helpers::SpecArrows
+  class << self
+    # Creates a vertical arrow for the trident spec sheet.
+    #
+    # This is used USPSFlags::Core.trident_spec, and should never need to be called directly.
+    # @private
+    def vertical(x, top, bottom, pointer_top = nil, pointer_bottom = nil, label: nil, label_offset: (USPSFlags::Config::BASE_FLY/120), label_offset_y: 0, label_align: "left", color: "#CCCCCC", stroke_width: (USPSFlags::Config::BASE_FLY/600), stroke_dash: "10, 10", font_size: (USPSFlags::Config::BASE_FLY/60), arrow_size: (USPSFlags::Config::BASE_FLY/120), fly: USPSFlags::Config::BASE_FLY, unit: nil)
+      label = bottom - top if label.nil?
+      label = label.to_i if label - label.to_i == 0
+      label = Rational(label) * fly / USPSFlags::Config::BASE_FLY
+      if label == label.to_i
+        label = label.to_i
+        label_fraction = ""
+      else
+        label, label_fraction = label.to_simplified_a
+      end
+      svg = ""
+      unless pointer_top.nil?
+        svg << <<~SVG
+          <line x1="#{x}" y1="#{top}" x2="#{pointer_top}" y2="#{top}" stroke="#{color}" stroke-width="#{stroke_width}" stroke-dasharray="#{stroke_dash}" />
+        SVG
+      end
+      unless pointer_bottom.nil?
+        svg << <<~SVG
+          <line x1="#{x}" y1="#{bottom}" x2="#{pointer_bottom}" y2="#{bottom}" stroke="#{color}" stroke-width="#{stroke_width}" stroke-dasharray="#{stroke_dash}" />
+        SVG
+      end
+
+      svg << <<~SVG
+        <path d="M#{x} #{top} l #{arrow_size} #{arrow_size} M#{x} #{top} l -#{arrow_size} #{arrow_size} M#{x} #{top} l 0 #{bottom - top} l #{arrow_size} -#{arrow_size} M#{x} #{bottom} l -#{arrow_size} -#{arrow_size}" stroke="#{color}" stroke-width="#{stroke_width}" fill="none" />
+        <g>
+          <style><![CDATA[tspan{font-size: #{USPSFlags::Config::FRACTION_SCALE}%;}]]></style>
+          <text x="#{x + label_offset}" y="#{(top+bottom)/2+(USPSFlags::Config::BASE_HOIST/150)+label_offset_y}" font-family="sans-serif" font-size="#{font_size}px" fill="#041E42" text-anchor="#{label_align}">#{label} <tspan>#{label_fraction}</tspan> #{unit}</text>
+        </g>
+      SVG
+
+      svg
+    end
+
+    # Creates a horizontal arrow for the trident spec sheet.
+    #
+    # This is used USPSFlags::Core.trident_spec, and should never need to be called directly.
+    # @private
+    def horizontal(y, left, right, pointer_left = nil, pointer_right = nil, label: nil, label_offset: (USPSFlags::Config::BASE_FLY/45), label_offset_x: 0, label_align: "middle", color: "#CCCCCC", stroke_width: (USPSFlags::Config::BASE_FLY/600), stroke_dash: "10, 10", font_size: (USPSFlags::Config::BASE_FLY/60), arrow_size: (USPSFlags::Config::BASE_FLY/120), fly: USPSFlags::Config::BASE_FLY, unit: nil)
+      label = right - left if label.nil?
+      label = label.to_i if label - label.to_i == 0
+      label = Rational(label) * fly / USPSFlags::Config::BASE_FLY
+      if label == label.to_i
+        label = label.to_i
+        label_fraction = ""
+      else
+        label, label_fraction = label.to_simplified_a
+      end
+      svg = ""
+      unless pointer_left.nil?
+        svg << <<~SVG
+          <line x1="#{left}" y1="#{y}" x2="#{left}" y2="#{pointer_left}" stroke="#{color}" stroke-width="#{stroke_width}" stroke-dasharray="#{stroke_dash}" />
+        SVG
+      end
+      unless pointer_right.nil?
+        svg << <<~SVG
+          <line x1="#{right}" y1="#{y}" x2="#{right}" y2="#{pointer_right}" stroke="#{color}" stroke-width="#{stroke_width}" stroke-dasharray="#{stroke_dash}" />
+        SVG
+      end
+
+      svg << <<~SVG
+        <path d="M#{left} #{y} l #{arrow_size} #{arrow_size} M#{left} #{y} l #{arrow_size} -#{arrow_size} M#{left} #{y} l #{right - left} 0 l -#{arrow_size} -#{arrow_size} M#{right} #{y} l -#{arrow_size} #{arrow_size}" stroke="#{color}" stroke-width="#{stroke_width}" fill="none" />
+        <g>
+          <style><![CDATA[tspan{font-size: #{USPSFlags::Config::FRACTION_SCALE}%;}]]></style>
+          <text x="#{(left+right)/2+label_offset_x}" y="#{y + label_offset}" font-family="sans-serif" font-size="#{font_size}px" fill="#041E42" text-anchor="#{label_align}">#{label} <tspan>#{label_fraction}</tspan> #{unit}</text>
+        </g>
+      SVG
+
+      svg
+    end
+  end
+end