photile 0.1.4 → 0.1.5

data/README.md

@@ -1,4 +1,4 @@
-# photile**
+# photile
 
 * * *
 *A ruby gem/library to chop a photo into tiles, watermark them, etc*
@@ -8,32 +8,33 @@
 
 One scenario where this is really useful is image processing for product images. Most product images are shot on white background, which means that there is a big opportunity to reduce image size and improve rendering speed on the web page. Here's what you can do with `photile`: `basic quality reduction` → `watermark your product images` → `break it up into tiles (certain tiles will be all white)` → `compress individual tiles`.
 
-### Functions
+### Installation & Dependencies
 
-* Quality manipulation
-* Loss-less compression
-* Watermarking
-* Tiling
-
-### Piping
-
-The four main functions of `photile` can be used in all combinations possible because of their 'piping' properties (i.e., the Builder Pattern). Each function takes in an image and spits out an image or an array of images. When an array of images is returned any function thereafter is applied to all items in the array. When piping functions the order is relevant as the output of a function becomes the input of another. For example: `tile` → `watermark` (tiles images and then applies a watermark to the smaller, chopped images) is not the same as `watermark` → `tile` (watermarks an image and then creates tiles).
-
-Here are the piping scenarios available
+* **Imagemagick** - Follow the installation instructions [here](http://imagemagick.org) (on Linux you can install it using: `sudo apt-get install imagemagick imagemagick-common`).
+* **Jpegtran** - Follow the installation instructions [here](http://jpegclub.org/jpegtran) (on Linux you can install it using: `sudo apt-get install libjpeg-turbo-progs`).
 
-* `IMAGE` → `Quality Modifier` → `IMAGE`
-* `IMAGE` → `Compressor` → `IMAGE`
-* `IMAGE` + `WATERMARK IMAGE`  → `Watermarker` → `IMAGE`
-* `IMAGE` → `Tiler` → `[IMAGE...IMAGE]`
+```bash
+# https://rubygems.org/gems/gem
+$ photile install photile
+```
 
 ### Examples
 
 ```bash
+# Usage
+$ photile
+Usage: photile [options] infile outfile
+    -q, --quality VALUE              Modify image quality
+    -c, --compress                   Loss-less compress image
+    -w, --watermark FILE             Watermark with given file
+    -t, --tile WIDTHxHEIGHT          Tile to the given dimensions
+    -h, --help                       Display options help
+
 # Basic Examples
 $ photile -quality 80 image-in image-out
 $ photile -compress image-in image-out
 $ photile -watermark image-in image-watermark image-out
-$ photile -tile WIDTHxHEIGHT image-in [image-out-0...image-out-n]
+$ photile -tile WIDTHxHEIGHT image-in image-out
 
 # Advanced Examples
 
@@ -44,19 +45,30 @@ $ photile -quality 80 -compress image-in image-out
 $ photile -watermark -tile WIDTHxHEIGHT image-in image-watermark image-out
 
 # 3. Reduce quality of 'image-in', then compress it and watermark it with 'image-watermark'. Finally, tile the watermarked image to produce '[image-out-0...image-out-n]'
-$ photile -quality 80 -compress -watermark -tile WIDTHxHEIGHT image-in image-watermark [image-out-0...image-out-n]
+$ photile -quality 80 -compress -watermark -tile WIDTHxHEIGHT image-in image-watermark image-out
 ```
 
-### Dependencies
+### Features
 
-* **Imagemagick** - Follow the installation instructions [here](http://imagemagick.org) (on Linux you can install it using: `sudo apt-get install imagemagick imagemagick-common`).
-* **Jpegtran** - Follow the installation instructions [here](http://jpegclub.org/jpegtran) (on Linux you can install it using: `sudo apt-get install libjpeg-turbo-progs`).
+* Quality manipulation
+* Loss-less compression
+* Watermarking
+* Tiling
 
-### More
+### Piping
+
+The four main functions of `photile` can be used in all combinations possible because of their 'piping' properties (i.e., the Builder Pattern). Each function takes in an image and spits out an image or an array of images. When an array of images is returned any function thereafter is applied to all items in the array. When piping functions the order is relevant as the output of a function becomes the input of another. For example: `tile` → `watermark` (tiles images and then applies a watermark to the smaller, chopped images) is not the same as `watermark` → `tile` (watermarks an image and then creates tiles).
+
+Here are the piping scenarios available
 
-Photile uses the amazing [Imagemagick](http://www.imagemagick.org/script/index.php) and [Jpegtran](http://jpegclub.org/jpegtran/) libraries. Imagemagick provides quality, watermarking and tiling properties. Jpegtran provides the loss-less compression. In other words, `photile` is just a layer on top of existing libraries to make certain image processing tasks dead simple. Additionally since `photile` is a gem it can be used directly in Rails to create dynamic workflows.
+* `IMAGE` → `Quality Modifier` → `IMAGE`
+* `IMAGE` → `Compressor` → `IMAGE`
+* `IMAGE` + `WATERMARK IMAGE`  → `Watermarker` → `IMAGE`
+* `IMAGE` → `Tiler` → `[IMAGE...IMAGE]`
+
+### More
 
-** `photile` is in a pre-release α state at the moment.
+Photile uses the amazing [Imagemagick](http://www.imagemagick.org/script/index.php) 6.6.9-7 and [Jpegtran](http://jpegclub.org/jpegtran/) 1.2.0 libraries. Imagemagick provides quality, watermarking and tiling properties. Jpegtran provides the loss-less compression. In other words, `photile` is just a layer on top of existing libraries to make certain image processing tasks dead simple. Additionally since `photile` is a gem it can be used directly in Rails to create dynamic workflows.
 
 * * *
-Copyright (c) 2012 Nitin Dhar. See [MIT-LICENSE](MIT-LICENSE) for details.
+Copyright (c) 2013 Nitin Dhar. See [MIT-LICENSE](MIT-LICENSE) for details.

data/photile.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |s|
   s.bindir                      = 'bin'
   s.license                     = 'MIT'
   s.homepage                    = 'https://github.com/nitindhar7/photile'
-  s.add_development_dependency  'rake', ['>= 0.9.2']
+  s.add_development_dependency  'rake', ['>= 0.8.7']
   s.required_ruby_version       = '>= 1.8.7'
   s.requirements                << 'imagemagick' << 'imagemagick-common' << 'libjpeg-turbo-progs'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: photile
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-15 00:00:00.000000000 Z
+date: 2013-01-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -18,7 +18,7 @@ dependencies:
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: 0.8.7
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: 0.8.7
 description: Photile is just a layer on top of Imagemagick and Jpegtran to make certain
   image processing tasks dead simple.
 email: nitindhar7@yahoo.com