hexflex 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2833a0751fc3f43a005521396169e153cd228633
+  data.tar.gz: 51f73e9b9b794272f846b9517b471c9051bdf0eb
+SHA512:
+  metadata.gz: c24254a00503b7a81bd6dea748e34bbca9671cfbf2d6f613a94d7b7af2bf066c955ffe4094ebc4663b6bf09abcb565223d19963e3d51725cc68c279bf10defe3
+  data.tar.gz: 13c1663cfafb6937c5dbfc1a69432ab301015c326629925c7463f9bcdc8bde5319c965400be9d10ff0e1d6b37cdc7326ba13a81e35e89af8e03838b7870d3948

data/.gitignore

@@ -0,0 +1,42 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+/.rake_tasks~
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# development related files
+tags
+feh*
+
+# don't commit these unless you make a design change
+/*.png

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.ruby_gemset

@@ -0,0 +1 @@
+hexflex

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.2.0

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http:contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in hexaflexa.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Tom Dunlap
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Tom Dunlap
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/NOTES

@@ -0,0 +1,7 @@
+[-1,-1, 1,1 -1,1
+
+[0,1, sqrt(3)/2,-1/2, -sqrt(3)/2,-r/2]
+
+[1,0, 
+
+http://www.vitutor.com/geometry/plane/equilateral_triangle.html

data/README.md

@@ -0,0 +1,38 @@
+# Hexflex
+[![Build Status](https://travis-ci.org/aauthor/hexflex.svg?branch=master)](https://travis-ci.org/aauthor/hexflex)
+
+Hexflex is a Ruby gem and command-line tool for automatically generating
+[hexaflexagon] templates.
+
+## Installation
+
+    gem install 'hexaflexa'
+
+...or you can put it in your Gemfile.
+
+## Usage
+
+### as a gem in your ruby project
+
+To create an [RVG] object containing a vector of the hexaflexagon template:
+
+    Hexflex.make_template_vector(side_fills: ARRAY_OF_SIDE_FILLS, template: TEMPLATE)
+
+To save the hexaflexagon template as a file to the disk:
+
+    Hexflex.create_template_image!(side_fills: ARRAY_OF_SIDE_FILLS, template: TEMPLATE, output_file_name: OUTPUT)
+
+Where:
+- a `SIDE_FILL` is a [standard X color] or path to file for a side of the hexaflexagon.  Either three or zero sides should be specified.  The default are cyan, magenta, and yellow.
+- `TEMPLATE` is template the form for the hexaflexagon. It can either be "tape" or "glue". The default is "tape".
+- `OUTPUT` is a path to save the hexaflexagon template image. The default is "out.png".
+
+### as a command-line tool
+
+    hexflex [-s SIDE_FILL -s SIDE_FILL -s SIDE_FILL] [-t TEMPLATE] [-o OUTPUT]
+
+See above for definitions of `SIDE_FILL`, `TEMPLATE`, AND `OUTPUT`.
+
+[hexaflexagon]: https://en.wikipedia.org/wiki/Flexagon#Trihexaflexagon
+[standard X color]: https://en.wikipedia.org/wiki/X11_color_names
+[RVG]: https://rmagick.github.io/rvg.html

data/Rakefile

@@ -0,0 +1,66 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'hexflex'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default =>
+  [:spec, :default_test, :color_test, :image_test, :photo_test, :glue_test]
+
+task :generate_fixtures =>
+  [:default_test, :color_test, :image_test, :photo_test, :glue_test]
+
+TEST_FIXTURES= 'spec/fixtures'
+
+task :default_test do
+  Hexflex.create_template_image!
+  puts 'Default test output to out.png.'
+end
+
+task :color_test do
+  Hexflex.create_template_image!(
+    output_file_name: 'color_test.png',
+    side_fills: [:blue, :green, :yellow]
+  )
+  puts 'Color test output to color_test.png.'
+end
+
+task :image_test do
+  fixture_path = "#{TEST_FIXTURES}/images"
+  Hexflex.create_template_image!(
+    output_file_name: 'image_test.png',
+    side_fills: [
+      "#{fixture_path}/1.png",
+      "#{fixture_path}/2.png",
+      "#{fixture_path}/3.png"
+    ]
+  )
+  puts 'Image test output to image_test.png.'
+end
+
+task :photo_test do
+  fixture_path = "#{TEST_FIXTURES}/photos"
+  Hexflex.create_template_image!(
+    output_file_name: 'photo_test.png',
+    side_fills: [
+      "#{fixture_path}/1.jpg",
+      "#{fixture_path}/2.jpg",
+      "#{fixture_path}/3.jpg"
+    ]
+  )
+  puts 'Photo test output to photo_test.png.'
+end
+
+task :glue_test do
+  fixture_path = "#{TEST_FIXTURES}/photos"
+  Hexflex.create_template_image!(
+    output_file_name: 'glue_test.png',
+    side_fills: [
+      "#{fixture_path}/1.jpg",
+      "#{fixture_path}/2.jpg",
+      "#{fixture_path}/3.jpg"
+    ],
+    template_style: :glue
+  )
+  puts 'Photo test with glue template style output to glue_test.png.'
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "hexflex"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+require "pry"
+Pry.start
+
+# require "irb"
+# IRB.start

data/bin/hexflex

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'hexflex'
+require 'optparse'
+
+options = {}
+OptionParser.new do |opts|
+  opts.banner = 'Usage: hexflex -s SIDE -s SIDE -s SIDE [-t TEMPLATE] [-o OUTPUT]'
+
+  opts.on('-s', '--side SIDE', 'A standard X color or path to image for a side of the hexaflexagon. The defaults are cyan, magenta, and yellow.') do |side|
+    options[:side_fills] ||= []
+    options[:side_fills] << side
+  end
+
+  opts.on('-t', '--template TEMPLATE', 'template the form for the hexaflexagon. It can either be "tape" or "glue". The default is "tape".') do |template|
+    options[:template_style] = template
+  end
+
+  opts.on('-o', '--output OUTPUT', 'A path to save the hexaflexagon template image. The default is "out.png".' ) do |file_name|
+    options[:output_file_name] = file_name
+  end
+end.parse!
+
+Hexflex.create_template_image!(options)

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/hexflex.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hexflex/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "hexflex"
+  spec.version       = Hexflex::VERSION
+  spec.authors       = ["Tom Dunlap"]
+  spec.email         = ["apocryphalauthor@gmail.com"]
+
+  spec.summary       = "Generate hexaflexagons to print and fold!"
+  spec.description   = `cat README.md`
+  spec.homepage      = "http://github.com/aauthor/hexflex"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "bin"
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "rmagick", "~> 2.13"
+  spec.add_dependency "activesupport", "~>4.2"
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.4"
+  spec.add_development_dependency "pry-byebug", "~> 3.1"
+  spec.add_development_dependency "rspec", "~> 3.3"
+end

data/lib/hexflex.rb

@@ -0,0 +1,36 @@
+require 'active_support'
+require 'active_support/core_ext'
+require 'yaml'
+
+require 'hexflex/hexaflexagon'
+require 'hexflex/tape_template'
+require 'hexflex/glue_template'
+
+module Hexflex
+
+  class << self
+
+    DEFAULT_SIDE_FILLS = [:cyan, :magenta, :yellow]
+    DEFAULT_TEMPLATE_STYLE = :tape
+
+    def make_template_vector(side_fills: DEFAULT_SIDE_FILLS, template_style: DEFAULT_TEMPLATE_STYLE)
+      hexaflexagon = Hexaflexagon.new(side_fills)
+      make_template(hexaflexagon, template_style).make_vector
+    end
+
+    def create_template_image!(output_file_name: 'out.png', **options)
+      vector = make_template_vector(options)
+      vector.draw.write(output_file_name)
+    end
+
+    def make_template(hexaflexagon, template_style)
+      case template_style.to_sym
+      when :glue
+        GlueTemplate.new(hexaflexagon)
+      when :tape
+        TapeTemplate.new(hexaflexagon)
+      end
+    end
+
+  end
+end

data/lib/hexflex/base_template.rb

@@ -0,0 +1,28 @@
+require "rvg/rvg"
+
+module Hexflex
+  class BaseTemplate
+
+    class InterfaceViolation < StandardError
+      def message
+        "##{method} must be defined by classes implementing BaseTemplate."
+      end
+
+      def method
+        backtrace.first.split.last.delete("`'")
+      end
+    end
+
+    attr_reader :hexaflexagon, :sides
+
+    def initialize(hexaflexagon)
+      @hexaflexagon = hexaflexagon
+      @sides = hexaflexagon.sides
+    end
+
+    def make_vector
+      fail InterfaceViolation
+    end
+
+  end
+end

data/lib/hexflex/glue_template.rb

@@ -0,0 +1,48 @@
+require 'hexflex/base_template'
+require 'hexflex/triangle_grid'
+require 'hexflex/rvg_template_vectorizer'
+require 'hexflex/triangle'
+
+module Hexflex
+  class GlueTemplate < BaseTemplate
+
+    def make_vector
+      RvgTemplateVectorizer.new(triangle_grid).vectorize
+    end
+
+    private
+
+    def triangle_grid
+      TriangleGrid.new.tap do |grid|
+        grid.place(blank_triangle, 0, 0)
+        grid.place(blank_triangle, 0, 9)
+
+        grid.place(sides[0].triangles[0], 0, 1)
+        grid.place(sides[0].triangles[1], 1, 3)
+        grid.place(sides[0].triangles[2], 1, 4)
+        grid.place(sides[0].triangles[3], 0, 6)
+        grid.place(sides[0].triangles[4], 0, 7)
+        grid.place(sides[0].triangles[5], 1, 9)
+
+        grid.place(sides[2].triangles[0], 0, 3)
+        grid.place(sides[2].triangles[1], 1, 5)
+        grid.place(sides[2].triangles[2], 1, 6)
+        grid.place(sides[2].triangles[3], 0, 8)
+        grid.place(sides[2].triangles[4], 1, 0)
+        grid.place(sides[2].triangles[5], 0, 2)
+
+        grid.place(sides[1].triangles[0], 0, 5)
+        grid.place(sides[1].triangles[1], 1, 7)
+        grid.place(sides[1].triangles[2], 1, 8)
+        grid.place(sides[1].triangles[3], 1, 1)
+        grid.place(sides[1].triangles[4], 1, 2)
+        grid.place(sides[1].triangles[5], 0, 4)
+      end
+    end
+
+    def blank_triangle
+      Triangle.place_holder
+    end
+
+  end
+end

data/lib/hexflex/grid_triangle.rb

@@ -0,0 +1,26 @@
+require 'forwardable'
+
+module Hexflex
+  class GridTriangle
+    extend Forwardable
+
+    attr_reader :triangle, :row, :position
+
+    def_delegators :@triangle, :fill, :image_fill?, :color_fill?, :index
+
+    def initialize(triangle:, row:, position:)
+      @triangle = triangle
+      @row = row
+      @position = position
+    end
+
+    def first_row?
+      row == 0
+    end
+
+    def second_row?
+      row == 1
+    end
+
+  end
+end

data/lib/hexflex/hexaflexagon.rb

@@ -0,0 +1,20 @@
+require "hexflex/side"
+
+module Hexflex
+  class Hexaflexagon
+
+    attr_accessor :sides
+
+    def initialize(side_fills)
+      @raw_fills = side_fills
+      @sides = Array.new(3) do |index|
+        Side.new(fill: side_fills[index])
+      end
+    end
+
+    def triangles
+      self.sides.map(&:triangles).flatten
+    end
+
+  end
+end

data/lib/hexflex/rvg_color_triangle_vectorizer.rb

@@ -0,0 +1,39 @@
+require 'hexflex/triangle_rvg_group'
+
+module Hexflex
+  class RvgColorTriangleVectorizer
+
+    SIMPLE_TRIANGLE_BASE = Math::sqrt(3)
+    SIMPLE_TRIANGLE_HEIGHT = 1.5
+
+    def initialize(triangle)
+      @triangle = triangle
+    end
+
+    def vectorize
+      @vector ||= make_vector
+    end
+
+    private
+
+    def make_vector
+      TriangleRvgGroup.new(
+        make_simple_triangle,
+        base: SIMPLE_TRIANGLE_BASE,
+        height: SIMPLE_TRIANGLE_HEIGHT
+      )
+    end
+
+    def make_simple_triangle
+      base = SIMPLE_TRIANGLE_BASE
+      height = SIMPLE_TRIANGLE_HEIGHT
+      Magick::RVG::Group.new.tap do |group|
+        group.polygon(
+          0, height,
+          base, height,
+          base/2, 0
+        ).styles(fill: @triangle.fill.to_s)
+      end
+    end
+  end
+end

data/lib/hexflex/rvg_image_triangle_vectorizer.rb

@@ -0,0 +1,99 @@
+require 'hexflex/triangle_rvg_group'
+
+module Hexflex
+  class RvgImageTriangleVectorizer
+
+    def initialize(triangle)
+      @triangle = triangle
+      @image = Magick::Image.read(triangle.fill).first
+      @index = triangle.index
+    end
+
+    def vectorize
+      @vector ||= make_vector
+    end
+
+    private
+
+    attr_accessor :image, :index
+
+    def make_vector
+      TriangleRvgGroup.new(
+        make_rvg_group,
+        base: triangle_base,
+        height: triangle_height
+      )
+    end
+
+    def make_rvg_group
+      Magick::RVG::Group.new.tap do |group|
+        group.use(centered_background)
+          .rotate(-60 * index, triangle_base, triangle_height)
+        group.styles(clip_path: clip_path)
+      end
+    end
+
+    def centered_background
+      Magick::RVG::Group.new.tap do |group|
+        group.image(image).tap do |img|
+          if image_tall?
+            img.translate(0, (hexagon_height - image_height) / 2.0)
+          else
+            img.translate((hexagon_width - image_width) / 2.0, 0)
+          end
+        end
+      end
+    end
+
+    def triangle_height
+      if image_tall?
+        (triangle_base / 2.0) * Math.sqrt(3)
+      else
+        image_height / 2.0
+      end
+    end
+
+    def triangle_base
+      if image_wide?
+        (triangle_height / Math.sqrt(3)) * 2.0
+      else
+        image_width / 2.0
+      end
+    end
+
+    def image_height
+      image.rows.to_f
+    end
+
+    def image_width
+      image.columns.to_f
+    end
+
+    def hexagon_height
+      triangle_height * 2
+    end
+
+    def hexagon_width
+      triangle_base * 2
+    end
+
+    def clip_path
+      Magick::RVG::ClipPath.new.tap do |path|
+        path.polygon(
+          0, triangle_height,
+          triangle_base, triangle_height,
+          triangle_base/2, 0
+        )
+      end
+    end
+
+    def image_wide?
+      (image.columns / image.rows.to_f) > (2.0 / Math.sqrt(3))
+    end
+
+    def image_tall?
+      !image_wide?
+    end
+  end
+
+end

data/lib/hexflex/rvg_template_vectorizer.rb

@@ -0,0 +1,94 @@
+require 'rvg/rvg'
+require 'hexflex/rvg_image_triangle_vectorizer'
+require 'hexflex/rvg_color_triangle_vectorizer'
+
+module Hexflex
+  class RvgTemplateVectorizer
+
+    Magick::RVG::dpi = 72
+    attr_reader :triangle_grid
+
+    def initialize(triangle_grid)
+      @triangle_grid = triangle_grid
+    end
+
+    def vectorize
+      @vector ||= make_vector
+    end
+
+    private
+
+    def vector_width
+      10.in
+    end
+
+    def vector_height
+      vector_width * Math::sqrt(3) / triangle_base_lengths_per_row
+    end
+
+    def triangle_base
+      @triangle_base ||=
+        vector_width / triangle_base_lengths_per_row
+    end
+
+    def triangle_height
+      @triangle_height ||=
+        vector_height / 2.0
+    end
+
+    def triangle_base_lengths_per_row
+      (triangle_grid.triangles_per_row + 1) / 2.0
+    end
+
+    def make_vector
+      Magick::RVG.new(vector_width, vector_height).tap do |vector|
+        vector.background_fill = "white"
+
+        triangle_grid.grid_triangles.each do |triangle|
+          triangle_vector = triangle_vector(triangle)
+          vector.use(triangle_vector)
+            .translate(lateral_placement(triangle), vertical_placement(triangle))
+            .rotate(rotation(triangle), triangle_base, triangle_height)
+            .scale(horizonal_normalization(triangle_vector), vertical_normalization(triangle_vector))
+        end
+      end
+    end
+
+    def triangle_vector(triangle)
+      if triangle.image_fill?
+        RvgImageTriangleVectorizer.new(triangle).vectorize
+      else
+        RvgColorTriangleVectorizer.new(triangle).vectorize
+      end
+    end
+
+    def lateral_placement(triangle)
+      if triangle.first_row?
+        lateral_placement = triangle_base * (triangle.position/2).floor
+      else
+        lateral_placement = (triangle_base * ((triangle.position+1)/2).floor) - triangle_base/2.0
+      end
+    end
+
+    def vertical_placement(triangle)
+      triangle.first_row? ? 0 : triangle_height
+    end
+
+    def rotation(triangle)
+      if triangle.first_row? && triangle.position.odd? || triangle.second_row? && triangle.position.even?
+        rotation = 60
+      else
+        rotation = 0
+      end
+    end
+
+    def horizonal_normalization(triangle_vector)
+      triangle_base / triangle_vector.base
+    end
+
+    def vertical_normalization(triangle_vector)
+      triangle_height / triangle_vector.height
+    end
+
+  end
+end

data/lib/hexflex/side.rb

@@ -0,0 +1,19 @@
+require "hexflex/triangle"
+
+module Hexflex
+  class Side
+    attr_accessor :fill, :triangles
+
+    # make a new side of a hexaflexagon
+    # @param [Hash] opts options hash with properties for new side
+    # @option opts [Mixed] :face the fill of the triangle, can be a
+    #   symbol, string, or hex number representing a color
+    def initialize(opts = {})
+      self.fill = opts[:fill]
+      self.triangles = Array.new(6) do |index|
+        Triangle.new(fill: fill, index: index)
+      end
+    end
+
+  end
+end

data/lib/hexflex/tape_placer.rb

@@ -0,0 +1,78 @@
+module Hexflex
+  class TapePlacer
+    attr_reader :canvas, :triangle_vector, :index
+
+    def initialize(canvas, triangle_vector, index)
+      @canvas = canvas
+      @triangle_vector = triangle_vector
+      @index = index.to_i
+
+      @triangle_base = @canvas.width / 5.0
+      @triangle_half_base = @triangle_base / 2.0
+      @triangle_height = @canvas.height / 2.0
+      @triangle_height_after_radius = @triangle_height / 3.0
+    end
+
+    def place!
+      @canvas.use(triangle_vector)
+        .translate(*lateral_placement)
+        .translate(*vertical_placement)
+        .rotate(*rotation)
+        .scale(*normalize_triangle_scale)
+    end
+
+    private
+
+    def lateral_placement
+      if first_row?
+        [@triangle_base * (index_on_row/2).floor, 0]
+      else
+        [(@triangle_base * ((index_on_row+1)/2).floor) - @triangle_base/2.0, 0]
+      end
+    end
+
+    def vertical_placement
+      [0, (@index/9) * @triangle_height]
+    end
+
+    def rotation
+      if rotate?
+        [60, @triangle_base, @triangle_height]
+      else
+        [0]
+      end
+    end
+
+    def pre_rotation_vertical_adjustment
+      if rotate?
+        [0, @triangle_height_after_radius]
+      else
+        [0, 0]
+      end
+    end
+
+    def normalize_triangle_scale
+      [
+        @triangle_base / triangle_vector.triangle_base,
+        @triangle_height / triangle_vector.triangle_height
+      ]
+    end
+
+    def rotate?
+      index.odd?
+    end
+
+    def first_row?
+      index < 9
+    end
+
+    def second_row?
+      !second_row?
+    end
+
+    def index_on_row
+      index % 9
+    end
+
+  end
+end

data/lib/hexflex/tape_template.rb

@@ -0,0 +1,40 @@
+require 'hexflex/base_template'
+require 'hexflex/triangle_grid'
+require 'hexflex/rvg_template_vectorizer'
+
+module Hexflex
+  class TapeTemplate < BaseTemplate
+
+    def make_vector
+      RvgTemplateVectorizer.new(triangle_grid).vectorize
+    end
+
+    private
+
+    def triangle_grid
+      TriangleGrid.new.tap do |grid|
+        grid.place(sides[0].triangles[0], 0, 0)
+        grid.place(sides[0].triangles[1], 0, 1)
+        grid.place(sides[0].triangles[2], 1, 3)
+        grid.place(sides[0].triangles[3], 1, 4)
+        grid.place(sides[0].triangles[4], 0, 6)
+        grid.place(sides[0].triangles[5], 0, 7)
+
+        grid.place(sides[2].triangles[0], 0, 8)
+        grid.place(sides[2].triangles[1], 1, 0)
+        grid.place(sides[2].triangles[2], 0, 2)
+        grid.place(sides[2].triangles[3], 0, 3)
+        grid.place(sides[2].triangles[4], 1, 5)
+        grid.place(sides[2].triangles[5], 1, 6)
+
+        grid.place(sides[1].triangles[0], 1, 1)
+        grid.place(sides[1].triangles[1], 1, 2)
+        grid.place(sides[1].triangles[2], 0, 4)
+        grid.place(sides[1].triangles[3], 0, 5)
+        grid.place(sides[1].triangles[4], 1, 7)
+        grid.place(sides[1].triangles[5], 1, 8)
+      end
+    end
+
+  end
+end

data/lib/hexflex/triangle.rb

@@ -0,0 +1,26 @@
+module Hexflex
+  class Triangle
+
+    attr_accessor :fill, :index
+
+    def initialize(opts = {})
+      @fill = opts[:fill]
+      @index = opts[:index]
+    end
+
+    def image_fill?
+      @fill.to_s.include? '.'
+    end
+
+    def color_fill?
+      !image_fill?
+    end
+
+    class << self
+      def place_holder
+        new(fill: "grey")
+      end
+    end
+
+  end
+end

data/lib/hexflex/triangle_grid.rb

@@ -0,0 +1,25 @@
+require 'hexflex/grid_triangle'
+
+module Hexflex
+  class TriangleGrid
+
+    attr_reader :grid_triangles
+
+    def initialize
+      @grid_triangles = []
+    end
+
+    def place(triangle, row, position)
+      @grid_triangles << GridTriangle.new(
+        triangle: triangle,
+        row: row,
+        position: position
+      )
+    end
+
+    def triangles_per_row
+      grid_triangles.group_by(&:row).values.map(&:count).max
+    end
+
+  end
+end

data/lib/hexflex/triangle_rvg_group.rb

@@ -0,0 +1,18 @@
+require "rvg/rvg"
+
+module Hexflex
+  class TriangleRvgGroup < SimpleDelegator
+
+    SIMPLE_TRIANGLE_BASE = Math::sqrt(3)
+    SIMPLE_TRIANGLE_HEIGHT = 1.5
+
+    attr_reader :base, :height
+
+    def initialize(rvg_group, base:, height:)
+      @base = base
+      @height = height
+      super(rvg_group)
+    end
+
+  end
+end

data/lib/hexflex/version.rb

@@ -0,0 +1,3 @@
+module Hexflex
+  VERSION = "1.0.0"
+end

metadata

@@ -0,0 +1,200 @@
+--- !ruby/object:Gem::Specification
+name: hexflex
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Tom Dunlap
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-02-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rmagick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.13'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+description: |
+  # Hexflex
+  [![Build Status](https://travis-ci.org/aauthor/hexflex.svg?branch=master)](https://travis-ci.org/aauthor/hexflex)
+
+  Hexflex is a Ruby gem and command-line tool for automatically generating
+  [hexaflexagon] templates.
+
+  ## Installation
+
+      gem install 'hexaflexa'
+
+  ...or you can put it in your Gemfile.
+
+  ## Usage
+
+  ### as a gem in your ruby project
+
+  To create an [RVG] object containing a vector of the hexaflexagon template:
+
+      Hexflex.make_template_vector(side_fills: ARRAY_OF_SIDE_FILLS, template: TEMPLATE)
+
+  To save the hexaflexagon template as a file to the disk:
+
+      Hexflex.create_template_image!(side_fills: ARRAY_OF_SIDE_FILLS, template: TEMPLATE, output_file_name: OUTPUT)
+
+  Where:
+  - a `SIDE_FILL` is a [standard X color] or path to file for a side of the hexaflexagon.  Either three or zero sides should be specified.  The default are cyan, magenta, and yellow.
+  - `TEMPLATE` is template the form for the hexaflexagon. It can either be "tape" or "glue". The default is "tape".
+  - `OUTPUT` is a path to save the hexaflexagon template image. The default is "out.png".
+
+  ### as a command-line tool
+
+      hexflex [-s SIDE_FILL -s SIDE_FILL -s SIDE_FILL] [-t TEMPLATE] [-o OUTPUT]
+
+  See above for definitions of `SIDE_FILL`, `TEMPLATE`, AND `OUTPUT`.
+
+  [hexaflexagon]: https://en.wikipedia.org/wiki/Flexagon#Trihexaflexagon
+  [standard X color]: https://en.wikipedia.org/wiki/X11_color_names
+  [RVG]: https://rmagick.github.io/rvg.html
+email:
+- apocryphalauthor@gmail.com
+executables:
+- console
+- hexflex
+- setup
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".ruby_gemset"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE
+- LICENSE.txt
+- NOTES
+- README.md
+- Rakefile
+- bin/console
+- bin/hexflex
+- bin/setup
+- hexflex.gemspec
+- lib/hexflex.rb
+- lib/hexflex/base_template.rb
+- lib/hexflex/glue_template.rb
+- lib/hexflex/grid_triangle.rb
+- lib/hexflex/hexaflexagon.rb
+- lib/hexflex/rvg_color_triangle_vectorizer.rb
+- lib/hexflex/rvg_image_triangle_vectorizer.rb
+- lib/hexflex/rvg_template_vectorizer.rb
+- lib/hexflex/side.rb
+- lib/hexflex/tape_placer.rb
+- lib/hexflex/tape_template.rb
+- lib/hexflex/triangle.rb
+- lib/hexflex/triangle_grid.rb
+- lib/hexflex/triangle_rvg_group.rb
+- lib/hexflex/version.rb
+- tmp/.gitkeep
+homepage: http://github.com/aauthor/hexflex
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Generate hexaflexagons to print and fold!
+test_files: []