meme_captain 0.1.0 → 0.1.1

data/ChangeLog

@@ -1,3 +1,64 @@
+0.1.1	2012-04-26
+
+    	Update jQuery and fabric.js to latest versions.
+
+	Disable border on image links for IE.
+
+	Disable text positioning for browsers that don't support canvas.
+
+	Add new source images to the site: annoying Facebook girl and you're
+	gonna have a bad time.
+
+	Add new source images to the site: bad luck Brian, laundry room viking,
+	paranoid parrot, conspiracy Keanu, socially awesome awkward penguin
+	and you should feel bad.
+
+	Increase default stroke width to 8 pixels.
+
+	Add new source images to the site: condescending Wonka and first world
+	problems.
+
+	Add unsharp mask step to make text sharper.
+
+	Scale stroke width by supersample.
+
+	Make search result thumbnail size relative to image size.
+
+	Add share on Reddit link.
+
+	Add templateUrl to JSON response and template link to page.
+
+	Add favicon.ico to site.
+
+	Fix 404 error on empty u parameter.
+
+	Add new source images to the site: Ron Swanson and the more you know.
+
+	Add setup document.
+
+	Follow redirects when fetching source images.
+
+	Highlight form fields when they are populated or preloaded.
+
+	Add source image upload support to site.
+
+	Generalize and document thumb sprites script.
+
+	Add docs for setting up lightweight third-party sites.
+
+	Add JSONP support for lightweight third-party sites to use.
+
+	Use Magick::Image.destroy! to reduce memory leaking.
+
+	Handle odd image formats like BMP.
+
+	Add debug logging.
+
+	Write more rspecs.
+
+	Add new source images to the site: bad joke eel, Neil DeGrasse Tyson,
+	Obama not bad and impaired duck.
+
 0.1.0	2012-02-07
 
 	Redesign web interface.
@@ -45,8 +106,7 @@
 	Add new source images to the site: all the things 2, cool story bro,
 	aw yeah, Boromir, Ned Stark.
 
-0.0.8
-        2011-11-23
+0.0.8   2011-11-23
 
 	Start change log.
 

data/Gemfile

@@ -0,0 +1,3 @@
+source :rubygems
+
+gemspec

data/README.md

@@ -76,9 +76,14 @@ http://memecaptain.com/g?u=http%3A%2F%2Fmemecaptain.com%2Fyao_ming.jpg&t1=sure+i
 
 ```json
 {
-  imageUrl: "http://memecaptain.com/c7757f.jpg"
+  imageUrl: "http://memecaptain.com/c7757f.jpg",
+  templateUrl: "http://memecaptain.com/?u=c7757f.jpg"
 }
 ```
 
 Optional parameters t1x, t1y, t1w, t1h, t2x, t2y, t2w, t2h can be added to
 position and size text (see example above).
+
+If you want to host a customized version of the memecaptain.com web interface
+on your own web server but use the memecaptain.com backend see
+[lightweight front end](https://github.com/mmb/meme_captain/blob/master/doc/lightweight_front_end.md).

data/config.ru

@@ -3,12 +3,14 @@ $:.unshift(File.join(File.dirname(__FILE__), 'lib'))
 require 'mongo'
 require 'mongo_mapper'
 require 'rack'
+require 'rack/contrib/jsonp'
 require 'rack/rewrite'
 
 require 'meme_captain'
 
 use Rack::ConditionalGet
 use Rack::Sendfile
+use Rack::JSONP
 
 use Rack::Static, :urls => %w{/tmp}, :root => 'public'
 
@@ -22,6 +24,8 @@ MemeCaptain::MemeData.ensure_index [
   [:texts, 1],
 ]
 
+MemeCaptain::Upload.ensure_index :upload_id
+
 MemeCaptain::SourceFetchFail.ensure_index :url
 
 use Rack::Rewrite do

data/doc/lightweight_front_end.md

@@ -0,0 +1,64 @@
+If you want to host your own custom Meme Captain site but do not want to set
+up the ruby backend you can use the memecaptain.com backend. In this scenario,
+the HTML, Javscript and CSS are hosted on your web server and the meme images
+are created on and hosted on memecaptain.com.
+
+This is an option if you are on shared hosting and do not have access to
+ruby or MongoDB or do not want to deal with setting them up.
+
+Download the files at these locations and save them in your document root:
+
+* http://memecaptain.com/
+* http://memecaptain.com/css/screen.css
+* http://memecaptain.com/js/fabric.min.js
+* http://memecaptain.com/js/meme_captain.js
+* http://memecaptain.com/source_images.json
+
+The css in js should go in css and js directories in your document root so
+that they match the url paths.
+
+Find this line in js/meme_captain.js
+
+```
+genUrl = '/g',
+```
+
+and change it to
+
+```
+genUrl = 'http://memecaptain.com/g',
+```
+
+# Changing the Default Source Images
+
+The source image thumbnails that show up on the page are driven by a JSON
+description and a single image that contain CSS sprites. The JSON and image
+must be regenerated to change them.
+
+The rmagick ruby gem must be installed:
+
+```sh
+gem install rmagick
+```
+
+Get and run the script:
+
+```sh
+wget https://raw.github.com/mmb/meme_captain/master/script/thumb_sprites.rb
+RUBYOPT='r rubygems'
+ruby thumb_sprites.rb -u URL_ROOT -s SOURCE_URL_PREFIX SOURCE_IMAGE_PATH/*
+```
+
+SOURCE_IMAGE_PATH is the directory where the source images are stored.
+URL_ROOT is the root url of the Meme Captain installation. SOURCE_URL_PREFIX
+is the part between the root url and the image filenames in the image urls.
+
+For example if the images are stored in /var/www/meme.com/source and the
+url root is http://meme.com/, use:
+
+```sh
+ruby thumb_sprites.rb -u http://meme.com/ -s source/ /var/www/meme.com/source/*
+```
+
+Copy the generated source_images.json and thumbs_xxx.jpg files to the Meme
+Captain document root.

data/doc/setup.md

@@ -0,0 +1,13 @@
+# Requirements
+
+* a Ruby/Rack web application environment (such as
+[Passenger](http://www.modrails.com/))
+
+* Ruby gem dependencies (see the gemspec)
+
+* [MongoDB](http://www.mongodb.org/)
+
+You will most likely need a dedicated or virtual private server to run
+MongoDB as most shared hosting does not support it. See the lightweight front
+end document for how host the static HTML/CSS/Javascript only and use
+memecaptain.com for the backend.

data/lib/meme_captain/image_list/fetch.rb

@@ -11,6 +11,8 @@ module MemeCaptain
       def fetch!(url)
         curl = Curl::Easy.perform(url) do |c|
           c.useragent = 'Meme Captain http://memecaptain.com/'
+          c.follow_location = true
+          c.max_redirects = 3
         end
         unless curl.response_code == 200
           raise FetchError.new(curl.response_code)

data/lib/meme_captain/meme.rb

@@ -24,7 +24,6 @@ module MemeCaptain
     text_layer = Magick::Image.new(
       img.page.width * super_sample, img.page.height * super_sample) {
       self.background_color = 'none'
-      self.density = 72.0 * super_sample
     }
 
     text_poss.each do |text_pos|
@@ -50,7 +49,15 @@ module MemeCaptain
         min_pointsize = text_pos.min_pointsize * super_sample
 
         draw = Magick::Draw.new {
-          text_pos.draw_options.each { |k,v| self.send("#{k}=", v) }
+          text_pos.draw_options.each do |k,v|
+            # options that need to be scaled by super sample
+            if [
+              :stroke_width
+              ].include?(k)
+              v *= super_sample
+            end
+            self.send("#{k}=", v)
+          end
         }
 
         draw.extend Draw
@@ -77,15 +84,20 @@ module MemeCaptain
       end
     end
 
-    text_layer.resize!(1.0 / super_sample)
+    if super_sample != 1
+      text_layer.resize!(1.0 / super_sample)
+      text_layer = text_layer.unsharp_mask
+    end
 
     img.each do |frame|
       frame.composite!(text_layer, -frame.page.x, -frame.page.y,
         Magick::OverCompositeOp)
       frame.strip!
     end
-    img
 
+    text_layer.destroy!
+
+    img
   end
 
   # Shortcut to generate a typical meme with text at the top and bottom.

data/lib/meme_captain/memebg.rb

@@ -0,0 +1,62 @@
+require 'RMagick'
+
+module MemeCaptain
+
+  module_function
+
+  # Public: Generate a pie slice meme background.
+  #
+  # size     - The side length in pixels of the generated image.
+  # colors   - An Array of color strings (any values that RMagick accepts).
+  # num_rays - The Fixnum of rays to create.
+  # block    - An optiona block passed to Draw.new for specifying additional
+  #            draw options
+  # 
+  # Examples
+  # 
+  #   memebg(400, %w{red orange yellow green blue indigo violet}, 20) {
+  #     # draw options
+  #     # self.stroke = 'white'
+  #   }.display
+  #
+  # Returns a Magick::Image of the meme background.
+  def memebg(size, colors, num_rays, &block)
+    # make circle 5% too big to avoid empty space at corners from rounding
+    # errors
+    circle_radius = Math.sqrt(2 * ((size / 2.0) ** 2)) * 1.05
+
+    side_len = 2 * circle_radius
+
+    start_x = side_len
+    start_y = circle_radius
+
+    center = "#{circle_radius},#{circle_radius}"
+
+    img = Magick::Image.new(side_len, side_len)
+
+    color_cycle = colors.cycle
+
+    (1..num_rays).each do |ray_index|
+      ray_radius = 2 * Math::PI / num_rays * ray_index
+
+      end_x = circle_radius + (Math.cos(ray_radius) * circle_radius)
+      end_y = circle_radius - (Math.sin(ray_radius) * circle_radius)
+
+      svg = "M#{center} L#{start_x},#{start_y} A#{center} 0 0,0 #{end_x},#{end_y} z"
+
+      draw = Magick::Draw.new {
+        instance_eval(&block)  if block_given?
+        self.fill = color_cycle.next
+      }
+
+      draw.path svg
+      draw.draw img
+
+      start_x = end_x
+      start_y = end_y
+    end
+
+    img.crop! Magick::CenterGravity, size, size
+  end
+
+end

data/lib/meme_captain/norm_params.rb

@@ -0,0 +1,92 @@
+module MemeCaptain
+
+  # Normalize query string parameters.
+  #
+  # Provide defaults, do some basic validation and convert some parameters
+  # to floats or integers.
+  class NormParams
+
+    def initialize(params={})
+      @u = ''
+      
+      @t1 = ''
+      @t2 = ''
+
+      @t1x = 0.05
+      @t1y = 0
+      @t1w = 0.9
+      @t1h = 0.25
+
+      @t2x = 0.05
+      @t2y = 0.75
+      @t2w = 0.9
+      @t2h = 0.25
+
+      load params
+    end
+
+    # Load query string parameters.
+    #
+    # Do some basic validation and convert some parameters to floats or
+    # integers.
+    def load(params)
+      params.select { |k,v|
+        [
+         :u,
+         :t1,
+         :t2,
+        ].include? k.to_sym }.each do |k,v|
+          send "#{k}=", v.to_s
+        end
+
+      params.select { |k,v|
+        [
+         :t1x,
+         :t1y,
+         :t1w,
+         :t1h,
+
+         :t2x,
+         :t2y,
+         :t2w,
+         :t2h,
+        ].include?(k.to_sym) and !v.to_s.empty? }.each do |k,v|
+          send "#{k}=", convert_metric(v)
+        end
+    end
+
+    # Return a sorted string representation of the fields.
+    def signature
+      instance_variables.sort.map { |v|
+        name = v[1..-1] # remove @
+        "#{name}#{instance_variable_get(v)}"
+      }.join
+    end
+
+    attr_accessor :u
+
+    attr_accessor :t1
+    attr_accessor :t2
+
+    attr_accessor :t1x
+    attr_accessor :t1y
+    attr_accessor :t1w
+    attr_accessor :t1h
+
+    attr_accessor :t2x
+    attr_accessor :t2y
+    attr_accessor :t2w
+    attr_accessor :t2h
+
+    private
+
+    # Convert a metric string to a float or integer.
+    #
+    # Expects a string.
+    def convert_metric(metric)
+      metric.index('.') ? metric.to_f : metric.to_i
+    end
+
+  end
+
+end

data/lib/meme_captain/pretty_format.rb

@@ -0,0 +1,12 @@
+require 'pp'
+
+module MemeCaptain
+
+  module_function
+
+  # Format an object like pp would would and return the formatted string.
+  def pretty_format(o)
+    PP.pp o, dump = ''
+  end
+
+end