compass-rgbapng 0.1.1 → 0.2.1

data/README.md

@@ -1,6 +1,6 @@
 # rgbapng - Compass plugin
 
-rgbapng is a Compass plugin for providing cross browser compatible RGBA support. It works by creating single pixel alpha-transparent PNGs on the fly for browsers that don't support RGBA. It uses the pure Ruby ChunkyPNG library resulting in hassle-free installation and deployment.
+rgbapng is a Compass plugin for providing cross-browser* compatible RGBA support. It works by creating single pixel alpha-transparent PNGs on the fly for browsers that don't support RGBA. It uses the pure Ruby ChunkyPNG library resulting in hassle-free installation and deployment.
 
 ## Installation
 
@@ -20,15 +20,16 @@ And then import the mixins to your SASS/SCSS files:
 
 ### Configurable variables
 
-There is a single variable that defines the path to which your PNG images will be saved. This defaults to `rgbapng` inside your Compass images directory. Change the path globally with:
+There are two customzable global variables. This first `$rgbapng_path` defines the path to which your PNG images will be saved. This defaults to `rgbapng` inside your Compass images directory. The second `$rgbapng_px_size` defines the pixel square size of the generated png. This defaults to a 5x5 square.
 
     $rgbapng_path: 'my_pngs';
+    $rgbapng_px_size: 8;
 
 ### Mixins
 
 There are two mixins available to you.
 
-#### rgba-background($color, [$path])
+#### rgba-background($color, [$path, $pixel])
 
 Sets the background property to use the RGBA value, falling back to the compiled PNG.
 
@@ -39,7 +40,7 @@ Compiles to:
     background: url('/images/rgbapng/000000bf.png?1282127952');
     background: rgba(0, 0, 0, 0.75);
 
-#### rgba-background-inline($color)
+#### rgba-background-inline($color, [$pixel])
 
 Sets the background property to use the RGBA value, falling back to a base64 encoded image data.
 
@@ -61,6 +62,16 @@ There are two `Sass::Script` functions which can be used in your SASS:
     # Returns a String of the base64 encoded image data
     png_base64(color)
 
+## * Cross-browser? Really?
+
+OK, caveat time. When I say "cross-browser", what I really mean is all browsers that either natively support RGBA or support alpha-transparent PNGs. What I don't mean, is IE6. If alpha-transparency in IE6 is important to you, here are some suggestions:
+
+* Use [DD_BelatedPNG](http://www.dillerdesign.com/experiment/DD_belatedPNG/) JavaScript library to bootstrap PNG support to IE6.
+* Don't use this plugin at all and instead create your own mixin using [Microsoft's proprietary filters](http://dimox.net/cross-browser-rgba-support/) - just make sure you wash your hands afterwards!
+* Be a rebel and either forget about IE6 or serve it up a [universal stylesheet](http://forabeautifulweb.com/blog/about/universal_internet_explorer_6_css).
+
+The choice is yours.
+
 ## Credit where it's due
 
 * The CSS technique used was initially described by Lea Verou in [Bulletproof, cross-browser RGBA backgrounds, today](http://leaverou.me/2009/02/bulletproof-cross-browser-rgba-backgrounds/).

data/lib/rgbapng/functions.rb

@@ -7,31 +7,31 @@ require "base64"
 # to which generated PNGs are saved.
 
 module Sass::Script::Functions
-  
-  def png_pixelate(c, dir = "rgbapng")
+
+  def png_pixelate(c, dir = "rgbapng", px = 5)
     color = ChunkyPNG::Color.rgba(c.red, c.green, c.blue, (c.alpha * 100 * 2.55).round)
-    image = ChunkyPNG::Image.new(1,1, color)
+    image = ChunkyPNG::Image.new(px.to_i, px.to_i, color)
     dir   = dir.is_a?(Sass::Script::String) ? dir.value : dir
-    file  = File.join(dir, ChunkyPNG::Color.to_hex(color).gsub(/^#/, "") + ".png")
+    file  = File.join(dir, ChunkyPNG::Color.to_hex(color).gsub(/^#/, "") + "-#{ px.to_s }.png")
     path = File.join(Compass.configuration.images_path, file)
-        
+
     if !File.exists?(path) || options[:force]
-      puts "Writing #{file}"
+      puts "Writing #{file}" unless options[:quiet]
       [Compass.configuration.images_path, File.join(Compass.configuration.images_path, dir)].each do |d|
-        Dir.mkdir(d) unless File.exists?(d)        
+        Dir.mkdir(d) unless File.exists?(d)
       end
       image.save(path)
     end
-    
+
     Sass::Script::String.new(file)
   end
 
-  def png_base64(c)
+  def png_base64(c, px = 5)
     color = ChunkyPNG::Color.rgba(c.red, c.green, c.blue, (c.alpha * 100 * 2.55).round)
-    image = ChunkyPNG::Image.new(1,1, color)
+    image = ChunkyPNG::Image.new(px.to_i, px.to_i, color)
     data  = Base64.encode64(image.to_blob).gsub("\n", "")
-    
+
     Sass::Script::String.new("url('data:image/png;base64,#{data}')")
   end
-  
+
 end

data/lib/stylesheets/_rgbapng.scss

@@ -1,17 +1,23 @@
-/*
-  Mixins are slightly modified from Benjamin Doherty's first implementations: http://gist.github.com/377912
-  rgba-background mixin can now be passed an option $dir variable
-*/
+// Mixins are slightly modified from Benjamin Doherty's first implementations: http://gist.github.com/377912
+// rgba-background mixin can now be passed an option $dir variable
 
-$rgbapng_path: 'rgbapng';
+$rgbapng_path:    'rgbapng' !default;
+$rgbapng_px_size: 5 !default;
 
-@mixin rgba-background($color, $dir:$rgbapng_path){
-  background: image_url(png_pixelate($color, $dir));
+@mixin rgba-background($color, $dir:$rgbapng_path, $pixel:$rgbapng_px_size){
+  background: rgba-png($color, $dir, $pixel);
   background: $color;
 }
 
-@mixin rgba-background-inline($color){
-  background: png_base64($color);
+@mixin rgba-background-inline($color, $pixel:$rgbapng_px_size){
+  background: rgba-inline($color, $pixel);
   background: $color;
 }
 
+@function rgba-png($color, $dir:$rgbapng_path, $pixel:$rgbapng_px_size) {
+  @return image_url(png_pixelate($color, $dir, $pixel));
+}
+
+@function rgba-inline($color, $pixel:$rgbapng_px_size) {
+  @return png_base64($color, $pixel);
+}

metadata

@@ -1,94 +1,85 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: compass-rgbapng
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 1
-  - 1
-  version: 0.1.1
+version: !ruby/object:Gem::Version
+  version: 0.2.1
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Aaron Russell
 - Benjamin Doherty
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2010-08-18 00:00:00 +01:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2013-06-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: compass
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 10
-        - 0
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 0.10.0
   type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: chunky_png
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 8
-        - 0
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+- !ruby/object:Gem::Dependency
+  name: chunky_png
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 0.8.0
   type: :runtime
-  version_requirements: *id002
-description: Compass plugin for providing cross-browser compatible RGBA support by creating transparent PNGs on the fly for browsers that don't support RGBA. Uses the pure Ruby ChunkyPNG library for hassle free install and deployment.
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+description: Compass plugin for providing cross-browser compatible RGBA support by
+  creating transparent PNGs on the fly for browsers that don't support RGBA. Uses
+  the pure Ruby ChunkyPNG library for hassle free install and deployment.
 email: aaron@gc4.co.uk
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - LICENSE
 - README.md
 - lib/rgbapng/functions.rb
 - lib/rgbapng.rb
 - lib/stylesheets/_rgbapng.scss
-has_rdoc: false
 homepage: http://github.com/aaronrussell/compass-rgbapng
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
+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.3.6
+rubygems_version: 1.8.25
 signing_key: 
 specification_version: 3
-summary: Compass plugin for providing cross-browser compatible RGBA support by creating transparent PNGs on the fly for browsers that don't support RGBA.
+summary: Compass plugin for providing cross-browser compatible RGBA support by creating
+  transparent PNGs on the fly for browsers that don't support RGBA.
 test_files: []
-