gradient 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2b086f81d5d8bc9667fd9ecf8272f154f882402d
-  data.tar.gz: 2ddcd6b8f68940d5dca3f7b6b18809cdc0a73416
+  metadata.gz: 16b46fdf7f784862a6e05230f8717e4485c5794c
+  data.tar.gz: c677d43ca0e4cb0a3df7e28811ec9a442b8b7dce
 SHA512:
-  metadata.gz: 7487c077ae4393109c689ea7ffef938108059d6965e8e04e47747fa8be7d97444f444f3364571de9ad813f604169371b542810c71ef669889cd238bec15675e5
-  data.tar.gz: 46c68629d2e91dfa0432a230886a28c68e60450ab2eef160d8ff2434b91fef2cf68b04c16c2dcf31ae43d92f0c82d6bb4282549e91c880cf5cbae63a9a3b5449
+  metadata.gz: 040beeb18b21d234a733d1790d37f8c0508255cc6f44dcaa5dfaad1a08445736a0ffb0b771beb633b349c808b69e71bb8535788d82b4ef8497c9eadfcd06fa5c
+  data.tar.gz: a6b6060794a681c72d6609af073c0b2f2fde4ec9c247de2c6f65f07ac60bfcabbf449a6810d08257d28aaf6d1a7e52edb39bddaf71c8ce90d3525f92da0251dc

data/.travis.yml

@@ -1,6 +1,6 @@
 language: ruby
 rvm:
-  - 2.0.0
   - 2.1.6
   - 2.2.2
 before_install: gem install bundler -v 1.10.6
+script: bundle exec rspec

data/README.md

@@ -1,4 +1,7 @@
 # Gradient
+[![Gem Version](https://badge.fury.io/rb/gradient.svg)](https://badge.fury.io/rb/gradient)
+[![Build Status](https://travis-ci.org/zeeraw/gradient.svg?branch=master)](https://travis-ci.org/zeeraw/gradient)
+
 Library for dealing with color gradients in ruby
 
 ## Usage
@@ -40,8 +43,28 @@ printer.radial(shape: :circle)
 # => "radial-gradient(circle, rgba(30,87,153,1.0) 0%, rgba(41,137,216,0.02) 49%, rgba(37,131,209,0.0) 50%, rgba(32,124,202,0.02) 51%, rgba(125,185,232,1.0) 100%)"
 ```
 
-### Import Adobe Photoshop Gradient (`.grd`) files
-For many artists a preferred way of creating gradients is through Photoshop.
+### Serialize & deserialize gradients
+To store your gradients in something like a document database,
+you're able to convert a gradient to primitives using `Gradient::Map#serialize`.
+
+```ruby
+Gradient::Map.new(
+  Gradient::Point.new(0, Color::RGB.new(221, 189, 82), 1.0),
+  Gradient::Point.new(1, Color::RGB.new(89, 12, 72), 0.3)
+).serialize
+# => [[0, "rgb", [221, 189, 82], 1.0], [1, "rgb", [89, 12, 72], 0.3]]
+
+```
+
+You can easily turn them back in to ruby objects by using `Gradient::Map.deserialize`.
+
+```ruby
+Gradient::Map.deserialize([[0, "rgb", [221, 189, 82], 1.0], [1, "rgb", [89, 12, 72], 0.3]])
+# => #<Gradient Map #<Point 0 #ddbd52ff> #<Point 100 #590c484d>>
+```
+
+### Import Adobe Photoshop gradient (`.grd`) files
+For many artists, a preferred way of creating gradients is through Photoshop.
 You are able to parse `.grd` files and turn them in to a hash of `Gradient::Map` objects.
 
 ```ruby
@@ -51,6 +74,17 @@ Gradient::GRD.read("./kiwi.grd")
 # }
 ```
 
+### Import SVG gradients
+SVG images can contain multiple gradients, and these can be extracted in the same
+way as for [`.grd`](#import-adobe-photoshop-gradient-grd-files) files.
+
+```ruby
+Gradient::SVG.read("./lemon-lime.svg")
+# => {
+#   "Lemon-Lime"=> #<Gradient Map #<Point 0.0 #ffff00ff> #<Point 20.0 #ffff00ff> #<Point 50.0 #00ff00ff> #<Point 80.0 #ffff00ff> #<Point 100.0 #ffff00ff>>}"
+# }
+```
+
 ### Separate point vectors for opacity and color
 You're able to control the point vectors for color and opacity separately by using a point merger.
 
@@ -74,6 +108,18 @@ gradient = Gradient::Map.new(points)
 # => #<Gradient Map #<Point 0 #1e5799ff> #<Point 49.0 #2989d805> #<Point 50.0 #2583d100> #<Point 51.0 #207cca05> #<Point 100 #7db9e8ff>>
 ```
 
+### Interpolation
+One can find the color and opacity at an arbitrary location using the `#at` method, which returns a new `Gradient::Point`.
+
+```ruby
+map = Gradient::Map.new(
+  Gradient::Point.new(0, Color::RGB.new(0, 128, 255), 1.0),
+  Gradient::Point.new(1, Color::RGB.new(255, 128, 0), 0.0)
+)
+map.at(0.5)
+# => #<Point 50.0 #80808080>
+```
+
 ## Installation
 Add this line to your application's Gemfile:
 
@@ -98,7 +144,7 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
-Bug reports and pull requests are welcome on GitHub at https://github.com/zeeraw/gradient. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on GitHub at https://github.com/zeeraw/gradient. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
 ## License
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -1,5 +1,5 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
 
 RSpec::Core::RakeTask.new(:spec)
 

data/gradient.gemspec

@@ -20,7 +20,8 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "color", "~> 1.8"
-  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_dependency 'nokogiri', '~> 1.6'
+  spec.add_development_dependency "bundler", "~> 1.7"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec"
   spec.add_development_dependency "pry"

data/lib/gradient.rb

@@ -5,8 +5,9 @@ require "gradient/point"
 require "gradient/point_merger"
 require "gradient/map"
 require "gradient/grd"
+require "gradient/svg"
 require "gradient/css_printer"
 
 module Gradient
   require "color"
-end
+end

data/lib/gradient/map.rb

@@ -18,6 +18,26 @@ module Gradient
       "#<Gradient Map #{points.map(&:inspect).join(" ")}>"
     end
 
+    def range
+      @range ||= 
+        begin
+          ends = [:first, :last]
+            .map { |method| points.send(method) }
+            .map(&:location)
+          Range.new(*ends)
+        end
+    end
+
+    def at(location, opts = {})
+      if range.include? location then
+        if 0 == (i = points.find_index { |p| p.location >= location }) then
+          points[0].dup
+        else
+          interpolate_points(points[i-1], points[i], location)
+        end
+      end
+    end
+
     def to_css(**args)
       @css_printer ||= Gradient::CSSPrinter.new(self)
       @css_printer.css(**args)
@@ -31,5 +51,32 @@ module Gradient
       serialize
     end
 
+    private 
+
+    def interpolate_points(point_left, point_right, location)
+      points = [point_left, point_right]
+      color_left, color_right = points.map(&:color)
+      location_left, location_right = points.map(&:location)
+      separation = location_right - location_left
+      if separation == 0.0 then
+        point_right.dup
+      else
+        weight = (location - location_left)/separation
+        r, g, b = [:r, :g, :b].map do |channel|
+          interpolate_floats(color_left.send(channel),
+                             color_right.send(channel),
+                             weight)
+        end
+        color = Color::RGB.from_fraction(r, g, b)
+        opacity = interpolate_floats(point_left.opacity, 
+                                     point_right.opacity,
+                                     weight)
+        Point.new(location, color, opacity)
+      end
+    end
+
+    def interpolate_floats(x0, x1, weight)
+      x0 * (1.0 - weight) + x1 * weight
+    end
   end
-end
+end

data/lib/gradient/svg.rb

@@ -0,0 +1,118 @@
+require 'scanf'
+require 'nokogiri'
+
+module Gradient
+
+  class SVGError < StandardError ; end
+
+  class SVG
+
+    attr_reader :maps
+
+    class << self
+
+      def parse(string_buffer)
+        new.tap do |parser|
+          parser.parse(string_buffer)
+        end.maps
+      end
+
+      def read(file)
+        new.tap do |parser|
+          File.open(file, 'r') do |file|
+            parser.parse(file.read)
+          end
+        end.maps
+      end
+
+      def open(file)
+        read(file)
+      end
+
+    end
+
+    def initialize
+      @maps = {}
+    end
+
+    SVGNS = 'http://www.w3.org/2000/svg'
+
+    def parse(buffer)
+      xml = Nokogiri::XML(buffer)
+      (
+        xml.xpath('//linearGradient') +
+        xml.xpath('//xmlns:linearGradient', 'xmlns' => SVGNS)
+      ).each do |linear_gradient|
+        unless (id = linear_gradient['id']) then
+          raise SVGError, 'linearGradient has no id'
+        end
+        unless (map = parse_linear_gradient(linear_gradient)).points.empty?
+          @maps[id] = map
+        end
+      end
+    end
+
+    private def parse_linear_gradient(linear_gradient)
+      map = Gradient::Map.new
+      linear_gradient.children.each do |node|
+        next unless node.name == 'stop'
+        map.points << parse_stop(node)
+      end
+      map
+    end
+
+    private def parse_stop(stop)
+      unless (offset = stop['offset']) then
+        raise SVGError, 'stop has no offset'
+      end
+      location = parse_location(offset)
+      if (style = stop['style']) then
+        point_from_style(location, style)
+      else
+        point_from_stop(location, stop)
+      end
+    end
+
+    private def point_from_style(location, style)
+      stop = Hash[ style.split(/;/).map { |item| item.split(/:/) } ]
+      point_from_stop(location, stop)
+    end
+
+    private def point_from_stop(location, stop)
+      unless (stop_color = stop['stop-color']) then
+        raise SVGError, 'stop has no stop-color'
+      end
+      color, opacity = parse_stop_color(stop_color)
+      if (stop_opacity = stop['stop-opacity']) then
+        opacity = parse_stop_opacity(stop_opacity)
+      end
+      Gradient::Point.new(location, color, opacity)
+    end
+
+    private def parse_location(offset)
+      unless (location = offset.scanf('%f%%')).count == 1 then
+        raise SVGError, "failed parse of offset #{offset}"
+      end
+      location.first / 100.0
+    end
+
+    private def parse_stop_color(stop_color)
+      parts =
+        if (r, g, b = stop_color.scanf('rgb(%d,%d,%d)')).count == 3 then
+          [Color::RGB.new(r, g, b), 1.0]
+        elsif (r, g, b, a = stop_color.scanf('rgba(%d,%d,%d,%f)')).count == 4 then
+          [Color::RGB.new(r, g, b), a]
+        elsif (color = Color::RGB.by_css(stop_color)) then
+          [color, 1.0]
+        end
+      unless parts then
+        raise SVGError, "failed parse of stop-color #{stop_color}"
+      end
+      parts
+    end
+
+    private def parse_stop_opacity(stop_opacity)
+      stop_opacity.scanf('%f').first
+    end
+  end
+end

data/lib/gradient/version.rb

@@ -1,3 +1,3 @@
 module Gradient
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gradient
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Vieira
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-11-22 00:00:00.000000000 Z
+date: 2016-01-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: color
@@ -24,20 +24,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '1.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -119,6 +133,7 @@ files:
 - lib/gradient/opacity_point.rb
 - lib/gradient/point.rb
 - lib/gradient/point_merger.rb
+- lib/gradient/svg.rb
 - lib/gradient/version.rb
 homepage: https://github.com/zeeraw/gradient
 licenses: