ivan 0.1.0.pre

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: dcd063d2fffdb9889308d5c7e7fb2a43ccbc4e14
+  data.tar.gz: 06dafb619d91ba6f672a7dc9f339dbdc913a76eb
+SHA512:
+  metadata.gz: da3adf2ac9a6f67a2a4d64b03be438765e1ce98b2a2d60489f2d8fa13bd7a83fbd3dcc3636c1cdaf0ee6f4b5d9604e47c445081c4ad5e84269d386c2efe2040f
+  data.tar.gz: 6ba4cf550c4125084211595819d5704f2a8e93af7323a02a7c652dd988700cddebebf8ed9b6efa28db1b20e600f23804aa1a06d6533020a103ac571a74059497

data/lib/composition.rb

@@ -0,0 +1,29 @@
+class Composition
+  attr_reader :buffer
+
+  def initialize(buffer)
+    @buffer = buffer
+  end
+
+  def clip_to_boundary(boundary)
+    @buffer.each_slice(2).with_index do |slice, i|
+      index = i * 2
+      clipped_points = Point.clip_to_boundary(boundary, slice)
+      @buffer[index] = clipped_points[0]
+      @buffer[index+1] = clipped_points[1]
+    end
+    @buffer.reject! {|p| !p }
+    return self
+  end
+
+  def normalize(boundary)
+    scale = 1.0
+    trans = 127
+    @buffer = @buffer.map do |point|
+      point \
+        .scale([scale, scale, 0])
+        .translate([trans, trans, 0])
+    end
+    return self.clip_to_boundary(boundary)
+  end
+end

data/lib/geometry.rb

@@ -0,0 +1,16 @@
+class LineStructError < Exception
+end
+
+class LineIndexRangeError < Exception
+end
+
+Struct.new("Geometry", :points, :lines) do
+  def valid?
+    lines.each do |l|
+      raise LineStructError, "This line is not a 2-tuple" \
+        if l.length != 2
+      raise LineIndexRangeError, "Line vertex with invalid point index" \
+        if not points[l[0]] or not points[l[1]]
+    end
+  end
+end

data/lib/glyph.rb

@@ -0,0 +1,47 @@
+class Glyph
+  extend HasTransforms
+  attr_reader :children
+
+  has_transforms_for Point
+
+  def self.new_from_model(model)
+    return new(Ivan::Models[model])
+  end
+
+  def initialize(geometry)
+    if geometry.valid? then
+      @points = geometry[:points].map do |p|
+        Point.new(*p)
+      end
+      @lines = geometry[:lines]
+      @children = []
+    end
+  end
+
+  def << (child_glyph)
+    @children << child_glyph
+  end
+
+  def project(x = 0, y = 0, z = Ivan.default_focal_length)
+    @points = @points.map do |p|
+      p.project(x, y, z)
+    end
+    @children = @children.map do |c|
+      c.send(:project, x, y, z)
+    end
+    return self
+  end
+
+  def to_buffer
+    my_instructions = []
+    @lines.each do |l|
+      l.each do |p|
+        my_instructions << @points[p]
+      end
+    end
+    self.children.each do |c|
+      my_instructions << c.to_buffer
+    end
+    return my_instructions.flatten
+  end
+end

data/lib/has_transforms.rb

@@ -0,0 +1,25 @@
+module HasTransforms
+  private
+    def delegate_transforms(transforms) 
+      transforms.each do |method_name|
+        define_method(method_name) do |param|
+          @points = @points.map do |p|
+            p.send(method_name, param)
+          end
+          @children = @children.map do |c|
+            c.send(method_name, param)
+          end
+          return self
+        end
+      end
+    end
+
+    def has_transforms_for(*class_names)
+      transform_methods = []
+      class_names.each do |c|
+        transform_methods += c.transforms
+      end
+      transform_methods.uniq!
+      delegate_transforms(transform_methods)
+    end
+end

data/lib/ivan.rb

@@ -0,0 +1,61 @@
+require 'yaml'
+
+require_relative 'point'
+require_relative 'has_transforms'
+require_relative 'geometry'
+require_relative 'glyph'
+require_relative 'composition'
+require_relative 'sender'
+require_relative 'teensyv_sender'
+
+module Ivan
+  @model_path = File.join(File.dirname(File.expand_path(__FILE__)), 'models')
+  @default_focal_length = -125.0
+  Models = {}
+
+  def self.models
+    return Models
+  end
+
+  def self.set_focal_length(val)
+    @default_focal_length = val
+  end
+  
+  def self.set_model_path(path)
+    @model_path = path
+  end
+
+  def self.default_focal_length
+    return @default_focal_length
+  end
+
+  def self.load_models(*model_names)
+    model_names.each do |model_name|
+      model_file = File.read("#{ @model_path }/#{ model_name }.yml")
+      if model_file then
+        geom = YAML.load(model_file)
+        if geom.valid? then
+          Models[model_name] = geom
+        end
+      else
+        return false
+      end
+    end
+    return true
+  end
+
+  def self.copy_model(source, destination)
+    if Models[source] then
+      Models[destination] = Models[source]
+    end
+  end
+
+  def self.save_model(model_name)
+    yaml_out = YAML.dump(Models[model_name])
+    if yaml_out then
+      file_out = File.open("#{ @model_path }/#{model_name}.yml","w")
+      file_out << yaml_out
+      file_out.close
+    end
+  end
+end

data/lib/models/cube.yml

@@ -0,0 +1,51 @@
+--- !ruby/struct:Struct::Geometry
+points:
+- - -1
+  - -1
+  - 1
+- - 1
+  - -1
+  - 1
+- - 1
+  - 1
+  - 1
+- - -1
+  - 1
+  - 1
+- - -1
+  - 1
+  - -1
+- - 1
+  - 1
+  - -1
+- - -1
+  - -1
+  - -1
+- - 1
+  - -1
+  - -1
+lines:
+- - 0
+  - 1
+- - 1
+  - 2
+- - 2
+  - 3
+- - 3
+  - 0
+- - 3
+  - 4
+- - 2
+  - 5
+- - 1
+  - 7
+- - 4
+  - 6
+- - 4
+  - 5
+- - 0
+  - 6
+- - 6
+  - 7
+- - 7
+  - 5

data/lib/models/square.yml

@@ -0,0 +1,23 @@
+--- !ruby/struct:Struct::Geometry
+points:
+- - -1
+  - -1
+  - 0
+- - 1
+  - -1
+  - 0
+- - 1
+  - 1
+  - 0
+- - -1
+  - 1
+  - 0
+lines:
+- - 0
+  - 1
+- - 1
+  - 2
+- - 2
+  - 3
+- - 3
+  - 0

data/lib/models/tetrahedron.yml

@@ -0,0 +1,27 @@
+--- !ruby/struct:Struct::Geometry
+points:
+- - 1
+  - 1
+  - 1
+- - -1
+  - -1
+  - 1
+- - -1
+  - 1
+  - -1
+- - 1
+  - -1
+  - -1
+lines:
+- - 0
+  - 1
+- - 0
+  - 2
+- - 0
+  - 3
+- - 1
+  - 2
+- - 1
+  - 3
+- - 2
+  - 3

data/lib/point.rb

@@ -0,0 +1,153 @@
+class Point
+  include Math
+  attr_reader :x, :y, :z
+
+  INSIDE = 0; # 0000
+  LEFT = 1;   # 0001
+  RIGHT = 2;  # 0010
+  BOTTOM = 4; # 0100
+  TOP = 8;    # 1000
+
+  def initialize (x = 0, y = 0, z = 0)
+    @x = x;
+    @y = y;
+    @z = z;
+  end
+
+  def screen_safe?(boundary)
+    return ( @x >= boundary[:x_min] and \
+             @x <= boundary[:x_max] and \
+             @y >= boundary[:y_min] and \
+             @y <= boundary[:y_max] and \
+             @z == 0 )
+  end
+
+  def self.interpolate(point1, point2, weight)
+    return Point.new(
+        point1.x + (point2.x - point1.x) * weight,
+        point1.y + (point2.y - point1.y) * weight,
+        point1.z + (point2.z - point1.z) * weight,
+      )
+  end
+
+  def outcode(boundary)
+    outcode = 0
+
+    if self.x < boundary[:x_min] then
+      outcode |= LEFT
+    end
+    if self.x > boundary[:x_max] then
+      outcode |= RIGHT
+    end
+    if self.y < boundary[:y_min] then
+      outcode |= BOTTOM
+    end
+    if self.y > boundary[:y_max] then
+      outcode |= TOP
+    end
+
+    return outcode
+  end
+
+  def self.clip_to_boundary(boundary, points)
+    accepted = false
+
+    while !accepted do
+      outcode0 = points[0].outcode(boundary)
+      outcode1 = points[1].outcode(boundary)
+      if ( (outcode0 | outcode1) == 0 ) then
+        return points
+      elsif (outcode0 & outcode1 != 0) then
+        return [nil, nil]
+      else
+        if (outcode0 != 0) then
+          outcode_out = outcode0
+        else
+          outcode_out = outcode1
+        end
+        x0 = points[0].x
+        y0 = points[0].y
+        x1 = points[1].x
+        y1 = points[1].y
+        if (outcode_out & TOP != 0) then
+          x = x0 + (x1 - x0) * (boundary[:y_max] - y0) / (y1 - y0)
+          y = boundary[:y_max]
+        elsif (outcode_out & BOTTOM != 0) then
+          x = x0 + (x1 - x0) * (boundary[:y_min] - y0) / (y1 - y0)
+          y = boundary[:y_min]
+        elsif (outcode_out & RIGHT != 0) then
+          y = y0 + (y1 - y0) * (boundary[:x_max] - x0) / (x1 - x0)
+          x = boundary[:x_max]
+        elsif (outcode_out & LEFT != 0) then
+          y = y0 + (y1 - y0) * (boundary[:x_min] - x0) / (x1 - x0)
+          x = boundary[:x_min]
+        end
+
+        if (outcode_out == outcode0) then
+          x0 = x
+          y0 = y
+        else
+          x1 = x
+          y1 = y
+        end
+        points[0] = Point.new(x0,y0)
+        points[1] = Point.new(x1,y1)
+      end
+
+    end
+    
+    return points
+  end
+
+  def self.transforms
+    return [:translate,
+            :scale,
+            :rotate_x,
+            :rotate_y,
+            :rotate_z ]
+  end
+
+  def translate(delta)
+    return Point.new( 
+      @x + delta[0],
+      @y + delta[1],
+      @z + delta[2] )
+  end
+
+  def scale(delta)
+    return Point.new( 
+      @x * delta[0],
+      @y * delta[1],
+      @z * delta[2] )
+  end
+
+  def rotate_x(theta)
+    return Point.new( 
+      @x,
+      @y * cos(theta) - @z * sin(theta),
+      @y * sin(theta) + @z * cos(theta) )
+  end
+
+  def rotate_y(theta)
+    return Point.new( 
+      @z * sin(theta) + @x * cos(theta),
+      @y,
+      @z * cos(theta) - @x * sin(theta) )
+  end
+
+  def rotate_z(theta)
+    return Point.new( 
+      @x * cos(theta) - @y * sin(theta),
+      @x * sin(theta) + @y * cos(theta),
+      @z )
+  end
+
+  def project(x = 0, y = 0, z = Ivan.default_focal_length)
+    pov = Point.new(x, y, z)
+    return Point.new( 
+      pov.z * (@x - pov.x) / (@z + pov.z) + pov.x,
+      pov.z * (@y - pov.y) / (@z + pov.z) + pov.y,
+      0 )
+  end
+
+end

data/lib/sender.rb

@@ -0,0 +1,64 @@
+class OutputInitError < Exception
+end
+
+class UnsafeOutputError < Exception
+end
+
+# Sender is an abstract class, and is not meant to be instantiated.
+# Subclass it for the requirements of your application's display hardware.
+
+class Sender
+  @output = nil
+  @boundary = nil
+
+  attr_reader :boundary
+
+  def initialize(config_params)
+    begin
+      post_initialize(config_params)
+    rescue
+      raise OutputInitError, "Output device couldn't be initialized"
+    end
+  end
+
+  def send(buffer)
+    check_safe(buffer)
+    pre_send(buffer)
+    buffer.each_slice(2) do |slice|
+      send_line(slice)
+    end
+  end
+
+  private
+
+    def check_safe(buffer)
+      buffer.each do |i|
+        raise UnsafeOutputError, "Found point #{i.inspect} outside output boundary #{@boundary.inspect}" \
+          if (!i.screen_safe?(@boundary))
+      end
+    end
+
+    def send_line(line)
+      [line[0].x, line[0].y, line[1].x, line[1].y].each do |coord|
+        @output.send(output_message, coordinate_format(coord) )
+      end
+    end
+
+    # Override these methods in concrete subclasses
+
+    def post_initialize(config_params)
+      raise NotImplementedError
+    end
+
+    def pre_send(buffer)
+      raise NotImplementedError
+    end
+
+    def output_message
+      raise NotImplementedError
+    end
+
+    def coordinate_format(value)
+      raise NotImplementedError
+    end
+end

data/lib/teensyv_sender.rb

@@ -0,0 +1,41 @@
+require 'serialport'
+
+class TeensyVSender < Sender
+
+  private
+
+    def post_initialize(config_params)
+      @output = config_params.fetch(:output_class, SerialPort).new(
+        config_params[:port], 
+        config_params.fetch(:baud, 9600), 
+        config_params.fetch(:data_bits, 8),
+        config_params.fetch(:stop_bits, 1)
+      )
+      @boundary = config_params.fetch(:boundary, {
+        x_min: 0,
+        y_min: 0,
+        x_max: 255,
+        y_max: 255
+      })
+    end
+
+    def pre_send(buffer)
+      transmit_instruction_length(buffer.length / 2)
+    end
+
+    def output_message
+      return :write
+    end
+
+    def coordinate_format(value)
+      return value.to_i.chr
+    end
+
+    def transmit_instruction_length(length)
+      high_byte = (length >> 8) & 0xff
+      low_byte = length & 0xff
+      @output.write(high_byte.to_i.chr)
+      @output.write(low_byte.to_i.chr)
+      return length
+    end
+end

metadata

@@ -0,0 +1,194 @@
+--- !ruby/object:Gem::Specification
+name: ivan
+version: !ruby/object:Gem::Version
+  version: 0.1.0.pre
+platform: ruby
+authors:
+- Duncan Malashock
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-07-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: serialport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.7'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+- !ruby/object:Gem::Dependency
+  name: guard-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !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
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !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: ruby-prof
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+description: Creates imagery on analog vector monitors
+email: duncanmalashock@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/composition.rb
+- lib/geometry.rb
+- lib/glyph.rb
+- lib/has_transforms.rb
+- lib/ivan.rb
+- lib/models/cube.yml
+- lib/models/square.yml
+- lib/models/tetrahedron.yml
+- lib/point.rb
+- lib/sender.rb
+- lib/teensyv_sender.rb
+homepage: http://rubygems.org/gems/ivan
+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: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: ivan
+test_files: []