doubleVision 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Tristan Hume
+
+MIT License
+
+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,100 @@
+# DoubleVision
+
+I recently was shown trick by a friend where an image was posted on a website 
+that displayed one thing in the thumbnail and another in the lightbox.
+http://funnyjunk.com/channel/ponytime/rainbow+dash/llhuDyy/15#15
+
+I set out to create a program that generates these images and this is what I came up with.
+
+The output images look like this:
+
+![Sample Image](http://f.cl.ly/items/2u1W1J0m2z3N0T0B3K0y/out.png)
+
+Try downloading it to your computer and then viewing it. Cool eh?
+
+## How it works
+The PNG specification contains a metadata attribute that allows you to specify the gamma to render the image with. The thing is, not all renderers support this.
+
+If an image is created with normal pixels spaced out around a grid of very light-colored pixels.
+The light colored pixels are actually the pixels of the second image reverse-mapped through a gamma function. 
+However, they are so light they look white.
+
+When the image is displayed with a very low gamma (I use 0.023). 
+The normal pixels become almost black and the light pixels become the colors of the second image.
+
+Example:
+![Difference example](https://img.skitch.com/20120427-tjwy5f1gf2xhr9jkfkqi3wxxku.png)
+
+## Why?
+By taking of advantage of this, we can create png files that display a different picture if the renderer supports the gamma attribute.
+
+Things that do not support the gamma attribute:
+
+- Thumbnail renderers (Facebook, etc...)
+- Apple png rendering
+- Windows png rendering
+
+Things that **do** support the gamma attribute:
+
+- Firefox (uses libpng wich supports the attribute)
+- Google Chrome
+
+This can lead to interesting combos. 
+For example: 
+
+- linking the image on facebook can show one image as a thumbnail but a completely different one when the link is clicked.
+- A picture that detects the user's browser. (Chrome/Firefox or Safari)
+- A picture that displays one thing in the browser and a different thing when downloaded to the user's (victim's) computer.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'doubleVision'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install doubleVision
+
+## Usage
+
+Next, run the program like this:
+
+	doubleVision withgamma.png withoutgamma.png out.png
+
+obviously replacing the filenames with your own.
+
+It will combine the images into one image (out.png) that will display
+withgamma.png when viewed with gamma support (e.g. in Firefox) 
+and withoutgamma.png when displayed without gamma support (e.g. As a thumbnail)
+
+## Other Example
+
+![Day and Night](http://f.cl.ly/items/1I291E1a1t2O3S2x2i12/DayNight.png)
+
+Was generated from:
+![Night](http://f.cl.ly/items/031k170c3k1i1Q0m0A3X/Night.png)
+and
+![Day](http://f.cl.ly/items/031k170c3k1i1Q0m0A3X/Day.png)
+
+##FAQ
+
+- Why are the images so dark? - 
+	The images have to be darkened so that they do not show up in the other image. 
+	One image is also full of black pixels which make it look dark.
+- Are you a wizard?
+	Sadly, no. But programmers are almost the same thing.
+
+*Disclaimer: Frequently Asked Questions are not necessarily frequently asked, nor are they always questions.*
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/bin/doubleVision

@@ -0,0 +1,54 @@
+#!/usr/bin/env ruby
+
+require "doubleVision"
+
+require 'optparse'
+
+options = { :gamma => 0.023, :fade1 => 220/255.0, :fade2 => 210/255.0, :shift => 10}
+USAGE = "Usage: doubleVision [options] withgamma.png withoutgamma.png out.png"
+
+optParser = OptionParser.new do |opts|
+  opts.banner = USAGE
+
+	opts.separator " "
+
+	opts.on("-g", "--gamma gamma", Float,
+	  "Specify the gamma value to use.",
+	  "Default: #{options[:gamma]}"
+	) { |v| options[:gamma] = v}
+
+	opts.on("-f","--gammafade fract", Float,
+	  "Specify the factor used to lower the brightness of the first image.",
+	  "Needed for images with full white pixels that show up in the non-gamma image.",
+	  "Default: #{options[:fade1]}"
+	) { |v| options[:fade1] = v}
+	opts.on("-F","--nogammafade fract", Float,
+	  "Specify the factor used to lower the brightness of the second image.",
+	  "Needed for images with bright pixels that show up in the gamma image.",
+	  "Default: #{options[:fade2]}"
+	) { |v| options[:fade2] = v}
+
+	opts.on("-s","--shift fract", Float,
+	  "Specify the amount to shift up brightness in the first image.",
+	  "Needed for images with full black pixels that show up in the non-gamma image.",
+	  "Default: #{options[:shift]}"
+	) { |v| options[:shift] = v}
+
+	opts.separator ""
+
+	opts.on("-h", "--help", "Show this help message.") { puts opts; exit }
+end
+optParser.parse!
+
+outfile = ARGV[2]
+
+puts "Generating image..."
+unless ARGV.length < 3
+	DoubleVision.createImageFiles(ARGV[0],ARGV[1],outfile,options)
+else
+	puts "Must provide images to use."
+	puts optParser
+	exit
+end
+
+puts "Sucessfully created #{outfile}"

data/doubleVision.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/doubleVision/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Tristan Hume"]
+  gem.email         = ["tris.hume@gmail.com"]
+  gem.description   = %q{Allows you to create magic PNG images that display differently in the browser than in thumbnails.}
+  gem.summary       = %q{Generates magic thumbnail images.}
+  gem.homepage      = "https://github.com/trishume/doubleVision"
+
+  gem.add_runtime_dependency 'chunky_png'
+  gem.post_install_message = "Installed! Now run the 'doubleVision' command to try it out."
+  gem.bindir = "bin"
+  gem.executables   << 'doubleVision'
+
+  gem.files         = `git ls-files`.split($\)
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "doubleVision"
+  gem.require_paths = ["lib"]
+  gem.version       = DoubleVision::VERSION
+end

data/lib/doubleVision.rb

@@ -0,0 +1,79 @@
+require "doubleVision/version"
+
+require "chunky_png"
+
+# Manipulates PNG gamma metadata to create images that
+# display differently when rendered in different clients.
+#
+# Can be used to create images that display differently as
+# thumbnails than when they are clicked on sites like facebook.
+module DoubleVision
+  # turns a color component from 0-255 into a new color for the firefox image
+  def DoubleVision.trans(num,options)
+    scaled = num*options[:fade1] + options[:shift]
+    (((scaled/255.0)**(options[:gamma]))*255.0).floor
+  end
+
+  # Takes to ChunkyPNG::Image and returns the chunkypng datastream
+  # of an image that displays img1 when rendered with gamma support
+  # and img2 without it.
+  # 
+  # Will throw an ArgumentError if the images do not have the same dimensions.
+  #
+  # Options is a hash containing various parameters
+  # [:gamma] is the gamma value to use. This should be a very low value.
+  # [:fade1] is the amount to fade the first image. Default is 220/255.0
+  # [:fade2] is the amount to fade the second image. Default is 210/255.0
+  # [:shift] is the amount to shift up the colours of the second image. Default is 10.
+  # The fade and shift parameters are required to properly segment the colors so the algorithm works.
+  def DoubleVision.createImage(img1,img2,options = {})
+    options[:gamma] ||= 0.023
+    options[:fade1] ||= 220/255.0
+    options[:fade2] ||= 210/255.0
+    options[:shift] ||= 10
+
+    if img1.dimension != img2.dimension
+      raise ArgumentError, "Image sizes must have the same dimensions."
+    end
+
+    out = ChunkyPNG::Image.new(img1.dimension.width*2, img1.dimension.height*2,ChunkyPNG::Color::BLACK)
+
+    out.dimension.width.times do |x|
+      out.dimension.height.times do |y|
+        if x % 2 == 0 && y % 2 == 0
+          col = img1[x/2,y/2]
+          r = trans(ChunkyPNG::Color.r(col),options)
+          g = trans(ChunkyPNG::Color.g(col),options)
+          b = trans(ChunkyPNG::Color.b(col),options)
+          out[x,y] = ChunkyPNG::Color.rgb(r,g,b)
+        else
+          col = img2[x/2,y/2]
+          r = (ChunkyPNG::Color.r(col) * options[:fade2]).round
+          g = (ChunkyPNG::Color.g(col) * options[:fade2]).round
+          b = (ChunkyPNG::Color.b(col) * options[:fade2]).round
+          out[x,y] = ChunkyPNG::Color.rgb(r,g,b)
+        end
+      end
+    end
+
+    pngGamma = (options[:gamma]*100000).to_i
+    # turn the integer into a 4 byte big-endian unsigned int byte string
+    bytestr = [pngGamma].pack("L>") 
+    # The chunk is named gAMA because the PNG spec is weird
+    chunk = ChunkyPNG::Chunk::Generic.new("gAMA",bytestr)
+    ds = out.to_datastream
+    ds.other_chunks << chunk
+    ds
+  end
+
+  # Creates a magic image from two png files of the same size.
+  # Takes two filenames and saves the result in outFile.
+  #
+  # Will throw an ArgumentError if the images do not have the same dimensions.
+  def DoubleVision.createImageFiles(file1,file2,outFile,options = {})
+    img1 = ChunkyPNG::Image.from_file(file1)
+    img2 = ChunkyPNG::Image.from_file(file2)
+    out = createImage(img1,img2,options)
+    out.save(outFile)
+  end
+end

data/lib/doubleVision/version.rb

@@ -0,0 +1,3 @@
+module DoubleVision
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: doubleVision
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Tristan Hume
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: chunky_png
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Allows you to create magic PNG images that display differently in the
+  browser than in thumbnails.
+email:
+- tris.hume@gmail.com
+executables:
+- doubleVision
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/doubleVision
+- doubleVision.gemspec
+- examples/Day.png
+- examples/DayNight.png
+- examples/Night.png
+- examples/test1.png
+- examples/test2.png
+- examples/testout.png
+- lib/doubleVision.rb
+- lib/doubleVision/version.rb
+homepage: https://github.com/trishume/doubleVision
+licenses: []
+post_install_message: Installed! Now run the 'doubleVision' command to try it out.
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Generates magic thumbnail images.
+test_files: []