image_mosaic 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 72c39930b3c7187b496a4a57b615adbd3d6d2b2f
+  data.tar.gz: 6aa80f9493ef2c604ca68d3a0dc2a2431fd09d1b
+SHA512:
+  metadata.gz: fa1d1015f6e43dcb13da577b34663215a74ff3baeb9854641fa17d81f2d452c9832f2180f0925e05366dd38b91eea7d9233d138dc5a9ff300f575930ca18ae50
+  data.tar.gz: 7b6d020d22948a5e84e72c3523debdcf7dd321c74ba581f2cdea33f1a64be8b4bccf8f5160ff0da868d498dbf70941611b7227dc314704d206de7e4e40c4e5d1

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,4 @@
+AllCops:
+  TargetRubyVersion: 2.3
+LineLength:
+  Max: 130

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.4.1
+before_install: gem install bundler -v 1.13.7

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Dan Goodwin
+
+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/README.md

@@ -0,0 +1,51 @@
+# ImageMosaic
+[![Build Status](https://travis-ci.org/Dannyguk/image_mosaic.svg?branch=master)](https://travis-ci.org/Dannyguk/image_mosaic)
+
+ImageMosaic takes an array of up to 20 images and returns a collage of the images in a grid format.
+
+Each image in the collage is currently resized to 200x200 pixels. The image it returns in 1000x1000 pixels.
+
+## Installation
+
+ImageMosaic requires ImageMagick to be installed.
+
+OSX
+
+    $ brew install imagemagick
+
+Linux
+
+    $ sudo apt-get install imagemagick
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'image_mosaic'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install image_mosaic
+
+## Usage
+
+Create an image from an array of image URLs. The resulting image is saved to the local file system.
+
+```ruby
+images =  (0..20).map { 'https://unsplash.it/200/200?random' }
+mosaic = ImageMosaic::Construct.new(images)
+mosaic.save
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/dannyguk/image_mosaic.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "image_mosaic"
+
+# 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/setup

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

data/image_mosaic.gemspec

@@ -0,0 +1,36 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'image_mosaic/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "image_mosaic"
+  spec.version       = ImageMosaic::VERSION
+  spec.authors       = ["Dan Goodwin"]
+  spec.email         = ["dangoodwin1@gmail.com"]
+
+  spec.summary       = %q{Generates a grid of images}
+  spec.homepage      = "http://github.com/dannyguk"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = "https://rubygems.org"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.13"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_dependency "mini_magick", "~> 4.6.1"
+end

data/lib/image_mosaic/data/validator.rb

@@ -0,0 +1,22 @@
+module ImageMosaic
+  module Data
+    class Validator
+      def initialize(urls)
+        @urls = urls
+      end
+
+      def items
+        @items ||= create_images.compact
+      end
+
+      private
+
+      def create_images
+        @urls.map do |url|
+          child = Image::Child.new(url)
+          child if child.valid?
+        end
+      end
+    end
+  end
+end

data/lib/image_mosaic/image/child.rb

@@ -0,0 +1,20 @@
+module ImageMosaic
+  module Image
+    class Child
+      def initialize(url)
+        @url = url
+      end
+
+      def valid?
+        image
+        true
+      rescue
+        false
+      end
+
+      def image
+        @image ||= MiniMagick::Image.open(@url)
+      end
+    end
+  end
+end

data/lib/image_mosaic/image/parent.rb

@@ -0,0 +1,47 @@
+module ImageMosaic
+  module Image
+    #Takes an array of images and metrics and then returns a single image of compisited images.
+    class Parent
+      def initialize(items, width: 1000, height: 1000, colour: 'white', columns: 5, cell_dimension: 200)
+        @items = items
+        @width = width
+        @height = height
+        @colour = colour
+        @columns = columns
+        @cell_dimension = cell_dimension
+      end
+
+      def create
+        image.run_command(:convert, '-size', "#{@width}x#{@height}", "xc:#{@colour}", image.path)
+        y = 0
+        sliced_grid.each do |row|
+          x = 0
+          row.each do |cell|
+            @image = add_image(cell, x, y)
+            x += @cell_dimension
+          end
+          y += @cell_dimension
+        end
+        image
+      end
+
+      private
+
+      def sliced_grid
+        @items.each_slice(@columns).to_a
+      end
+
+      def add_image(child_image, x, y)
+        Operations::Compositor.new(@image, child_image).save(x, y, type: 'Over', dimension: @cell_dimension)
+      end
+
+      def temp_file
+        @temp_file ||= Tempfile.new(['image_mosaic', '.png'])
+      end
+
+      def image
+        @image ||= MiniMagick::Image.new(temp_file.path)
+      end
+    end
+  end
+end

data/lib/image_mosaic/operations/compositor.rb

@@ -0,0 +1,30 @@
+module ImageMosaic
+  module Operations
+    # Takes a composite_image
+    # Can then place another image over the top at x, y coordinates and resized to a dimension.
+    class Compositor
+      def initialize(composite_image, child)
+        @composite_image = composite_image
+        @child = child
+      end
+
+      def save(x, y, type: 'Over', dimension: 200)
+        resize_image_to(dimension)
+        @composite_image.composite(child_image) do |composite|
+          composite.compose type
+          composite.geometry "+#{x}+#{y}"
+        end
+      end
+
+      private
+
+      def resize_image_to(dimension)
+        child_image.resize "#{dimension}x#{dimension}^"
+      end
+
+      def child_image
+        @child.image
+      end
+    end
+  end
+end

data/lib/image_mosaic/version.rb

@@ -0,0 +1,3 @@
+module ImageMosaic
+  VERSION = "0.1.0"
+end

data/lib/image_mosaic.rb

@@ -0,0 +1,30 @@
+require "image_mosaic/version"
+require 'mini_magick'
+require 'tempfile'
+require 'securerandom'
+require 'image_mosaic/operations/compositor'
+require 'image_mosaic/data/validator'
+require 'image_mosaic/image/parent'
+require 'image_mosaic/image/child'
+
+module ImageMosaic
+  class Construct
+    def initialize(items)
+      @items = items
+    end
+
+    def save
+      parent.write("#{SecureRandom.uuid}.png")
+    end
+
+    private
+
+    def parent
+      @parent ||= Image::Parent.new(valid_items).create
+    end
+
+    def valid_items
+      @valid_items ||= Data::Validator.new(@items).items
+    end
+  end
+end

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification
+name: image_mosaic
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Dan Goodwin
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-04-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: mini_magick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.6.1
+description: 
+email:
+- dangoodwin1@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- image_mosaic.gemspec
+- lib/image_mosaic.rb
+- lib/image_mosaic/data/validator.rb
+- lib/image_mosaic/image/child.rb
+- lib/image_mosaic/image/parent.rb
+- lib/image_mosaic/operations/compositor.rb
+- lib/image_mosaic/version.rb
+homepage: http://github.com/dannyguk
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+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.6.8
+signing_key: 
+specification_version: 4
+summary: Generates a grid of images
+test_files: []