aspect_ratio 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 05bd1cc5c2f1747b539c17d8f31bdc03a24d2623
+  data.tar.gz: 42bff77082ba5fa96724a520413675e3b3882b5e
+SHA512:
+  metadata.gz: 42849f7d573819756c8776b3e220824fb028ad619c32b0f8cd7d457f74c0a769e17cd8f8e5e529afaad626ba3a78d3994acb79c89e234fe994c19b66704fa252
+  data.tar.gz: 2df2833c8bcd8ef43d76ea74935ba0f735666a85a2ac426471bb474f8fd7babd8f166ae1699a9614deed8780aaf92622e8b391bc83c953ac4d883c72f6f5f3a7

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Trung Lê
+
+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,89 @@
+# aspect_ratio
+
+[![Build Status](https://travis-ci.org/envato/aspect_ratio.svg?branch=master)](https://travis-ci.org/envato/aspect_ratio)
+
+Image aspect ratio utilities.
+
+The Ruby port of [node-aspectratio](https://www.npmjs.com/package/aspectratio) npm module. 
+
+## Install
+
+Install globally
+
+```
+gem install aspect_ratio
+```
+
+OR
+
+Install locally with Bundler
+
+Please include 
+
+```
+gem 'aspect_ratio'
+```
+
+in your `Gemfile` then `bundle install`
+
+## Test
+
+```
+ruby test/aspect_ratio_test.rb
+```
+
+## API
+
+### crop(**integer** `width`, **integer** `height`, **string** `ratio`)
+
+Apply a fixed aspect `ratio` crop without distoring the image aspect ratio.
+
+* **integer** `width` - original image width
+* **integer** `height` - original image height
+* **string** `ratio` - new image ratio
+
+> The `ratio` must be on the following format: `x`:`y` where `x` and `y` are
+> integers. The order of `x` and `z` does not matter and `3:4` will be treated
+> as `4:3`.
+
+> By default #crop() will match the orientation of the original image unless a
+> forced orientation is given on the follwing format: `x`:`y`!`z` where `z` is
+> the orientation (`v` for vertical, or `h` for horizontal).
+
+#### Return
+
+This will return an `Array` of four values:
+
+1. **integer** `x` - top lef x coordinate
+2. **integer** `y` - top lef y coordinate
+3. **integer** `width` - new image width
+4. **integer** `height` - new image height
+
+#### Example
+
+```ruby
+require 'aspect_ratio'
+AspectRatio.crop(2048, 768, '4:3');
+// [512, 768, 1024, 768]
+```
+
+![Crop with fixed ratio](./aspect.png)
+
+### resize(**integer** `x`, **integer** `y`, **integer** `maxX`, **integer** `maxY`)
+
+Get resized height and width of an image while perserving the aspect ratio of
+the image.
+
+* **integer** `x` - original image width
+* **integer** `y` - original image height
+* **integer** `maxX` - max image width
+* **integer** `maxY` - max image height
+
+### Return
+
+Returns an `Array` of the resized `x` and `y` values:
+
+* **integer** `x` - resized image width
+* **integer** `y` - resized image height
+
+## [MIT License](./LICENSE)

data/aspect_ratio.gemspec

@@ -0,0 +1,21 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |s|
+  s.name        = 'aspect_ratio'
+  s.version     = '1.0.0'
+  s.date        = '2016-04-26'
+  s.summary     = 'Image aspect ratio calculation utility'
+  s.description = 'Image aspect ratio calculation utility'
+  s.authors     = ['Trung Lê']
+  s.email       = 'trung.le@ruby-journal.com'
+  s.files       = `git ls-files -z -- lib/* LICENSE README.md aspect_ratio.gemspec`.split("\x0")
+  s.homepage    = 'http://github.com/envato/aspect_ratio'
+  s.license     = 'MIT'
+
+  s.require_paths = ['lib']
+  s.required_ruby_version = '>= 2.2.0'
+  s.test_files    = s.files.grep(%r{^(test)/})
+
+  s.add_development_dependency 'minitest',          '~> 5'
+end

data/lib/aspect_ratio.rb

@@ -0,0 +1,69 @@
+require 'bigdecimal'
+
+module AspectRatio
+  def self.resize(x, y, x_max = nil, y_max = nil)
+    x = BigDecimal(x)
+    y = BigDecimal(y)
+
+    if x_max && y_max
+      # Maximum values of height and width given, aspect ratio preserved.
+      if y > x
+        return [(y_max * x / y).round, y_max]
+      else
+        return [x_max, (x_max * y / x).round]
+      end
+    elsif x_max
+      # Width given, height automagically selected to preserve aspect ratio.
+      return [x_max, (x_max * y / x).round]
+    else
+      # Height given, width automagically selected to preserve aspect ratio.
+      return [(y_max * x / y).round, y_max]
+    end
+  end
+
+  def self.crop(x, y, r)
+    orient = r.split('!')[1]
+    ratio  = r.split('!')[0].split(':').sort.map { |r| BigDecimal(r) }
+
+    vertical = y > x
+    rotate = y > x && orient == 'h' || x > y && orient == 'v'
+
+    if (vertical || rotate) && !(vertical && rotate)
+      x = x + y
+      y = x - y
+      x = x - y
+    end
+
+    xʹ = x
+    yʹ = x * (ratio[1] / ratio[0])
+
+    if (yʹ > y) || rotate && (yʹ > x)
+      yʹ = y
+      xʹ = y * (ratio[1] / ratio[0])
+
+      if xʹ > x
+        xʹ = x
+        yʹ = x * (ratio[0] / ratio[1])
+      end
+    end
+
+    Δx = ((x - xʹ) / 2).to_f.floor
+    Δy = ((y - yʹ) / 2).to_f.floor
+
+    if (vertical || rotate) && !(vertical && rotate)
+      [
+        Δy,         # crop top left x
+        Δx,         # crop top left y
+        y - Δy * 2, # crop width
+        x - Δx * 2  # crop height
+      ]
+    else
+      [
+        Δx.to_f,    # crop top left x
+        Δy,         # crop top left y
+        x - Δx * 2, # crop width
+        y - Δy * 2  # crop height
+      ]
+    end
+  end
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: aspect_ratio
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Trung Lê
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-04-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5'
+description: Image aspect ratio calculation utility
+email: trung.le@ruby-journal.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- aspect_ratio.gemspec
+- lib/aspect_ratio.rb
+homepage: http://github.com/envato/aspect_ratio
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: Image aspect ratio calculation utility
+test_files: []
+has_rdoc: