chunky_png 1.3.11 → 1.3.12

data/lib/chunky_png/datastream.rb

@@ -1,5 +1,4 @@
 module ChunkyPNG
-
   # The Datastream class represents a PNG formatted datastream. It supports
   # both reading from and writing to strings, streams and files.
   #
@@ -9,9 +8,8 @@ module ChunkyPNG
   #
   # @see ChunkyPNG::Chunk
   class Datastream
-
     # The signature that each PNG file or stream should begin with.
-    SIGNATURE = ChunkyPNG.force_binary([137, 80, 78, 71, 13, 10, 26, 10].pack('C8'))
+    SIGNATURE = [137, 80, 78, 71, 13, 10, 26, 10].pack("C8").force_encoding(Encoding::BINARY).freeze
 
     # The header chunk of this datastream.
     # @return [ChunkyPNG::Chunk::Header]
@@ -52,22 +50,21 @@ module ChunkyPNG
     ##############################################################################
 
     class << self
-
       # Reads a PNG datastream from a string.
       # @param [String] str The PNG encoded string to load from.
       # @return [ChunkyPNG::Datastream] The loaded datastream instance.
       def from_blob(str)
-        from_io(StringIO.new(str))
+        from_io(StringIO.new(str, "rb"))
       end
 
-      alias :from_string :from_blob
+      alias from_string from_blob
 
       # Reads a PNG datastream from a file.
       # @param [String] filename The path of the file to load from.
       # @return [ChunkyPNG::Datastream] The loaded datastream instance.
       def from_file(filename)
         ds = nil
-        File.open(filename, 'rb') { |f| ds = from_io(f) }
+        File.open(filename, "rb") { |f| ds = from_io(f) }
         ds
       end
 
@@ -75,22 +72,23 @@ module ChunkyPNG
       # @param [IO] io The stream to read from.
       # @return [ChunkyPNG::Datastream] The loaded datastream instance.
       def from_io(io)
+        io.set_encoding(Encoding::BINARY)
         verify_signature!(io)
 
-        ds = self.new
+        ds = new
         while ds.end_chunk.nil?
           chunk = ChunkyPNG::Chunk.read(io)
           case chunk
-            when ChunkyPNG::Chunk::Header;       ds.header_chunk = chunk
-            when ChunkyPNG::Chunk::Palette;      ds.palette_chunk = chunk
-            when ChunkyPNG::Chunk::Transparency; ds.transparency_chunk = chunk
-            when ChunkyPNG::Chunk::ImageData;    ds.data_chunks << chunk
-            when ChunkyPNG::Chunk::Physical;     ds.physical_chunk = chunk
-            when ChunkyPNG::Chunk::End;          ds.end_chunk = chunk
+            when ChunkyPNG::Chunk::Header       then ds.header_chunk = chunk
+            when ChunkyPNG::Chunk::Palette      then ds.palette_chunk = chunk
+            when ChunkyPNG::Chunk::Transparency then ds.transparency_chunk = chunk
+            when ChunkyPNG::Chunk::ImageData    then ds.data_chunks << chunk
+            when ChunkyPNG::Chunk::Physical     then ds.physical_chunk = chunk
+            when ChunkyPNG::Chunk::End          then ds.end_chunk = chunk
             else ds.other_chunks << chunk
           end
         end
-        return ds
+        ds
       end
 
       # Verifies that the current stream is a PNG datastream by checking its signature.
@@ -103,7 +101,7 @@ module ChunkyPNG
       #    the beginning of the stream.
       def verify_signature!(io)
         signature = io.read(ChunkyPNG::Datastream::SIGNATURE.length)
-        unless ChunkyPNG.force_binary(signature) == ChunkyPNG::Datastream::SIGNATURE
+        unless signature == ChunkyPNG::Datastream::SIGNATURE
           raise ChunkyPNG::SignatureMismatch, "PNG signature not found, found #{signature.inspect} instead of #{ChunkyPNG::Datastream::SIGNATURE.inspect}!"
         end
       end
@@ -127,7 +125,7 @@ module ChunkyPNG
       yield(palette_chunk)      if palette_chunk
       yield(transparency_chunk) if transparency_chunk
       yield(physical_chunk)     if physical_chunk
-      data_chunks.each  { |chunk| yield(chunk) }
+      data_chunks.each { |chunk| yield(chunk) }
       yield(end_chunk)
     end
 
@@ -174,19 +172,19 @@ module ChunkyPNG
     # Saves this datastream as a PNG file.
     # @param [String] filename The filename to use.
     def save(filename)
-      File.open(filename, 'wb') { |f| write(f) }
+      File.open(filename, "wb") { |f| write(f) }
     end
 
     # Encodes this datastream into a string.
     # @return [String] The encoded PNG datastream.
     def to_blob
       str = StringIO.new
-      str.set_encoding('ASCII-8BIT')
+      str.set_encoding("ASCII-8BIT")
       write(str)
-      return str.string
+      str.string
     end
 
-    alias :to_string :to_blob
-    alias :to_s :to_blob
+    alias to_string to_blob
+    alias to_s to_blob
   end
 end

data/lib/chunky_png/dimension.rb

@@ -1,5 +1,4 @@
 module ChunkyPNG
-
   # Creates a {ChunkyPNG::Dimension} instance using arguments that can be interpreted
   # as width and height.
   #
@@ -29,8 +28,8 @@ module ChunkyPNG
   # @see ChunkyPNG::Dimension
   def self.Dimension(*args)
     case args.length
-    when 2; ChunkyPNG::Dimension.new(*args)
-    when 1; build_dimension_from_object(args.first)
+    when 2 then ChunkyPNG::Dimension.new(*args)
+    when 1 then build_dimension_from_object(args.first)
     else raise ArgumentError,
       "Don't know how to construct a dimension from #{args.inspect}"
     end
@@ -45,8 +44,8 @@ module ChunkyPNG
     when Array
       ChunkyPNG::Dimension.new(source[0], source[1])
     when Hash
-      width = source[:width] || source['width']
-      height = source[:height] || source['height']
+      width = source[:width] || source["width"]
+      height = source[:height] || source["height"]
       ChunkyPNG::Dimension.new(width, height)
     when ChunkyPNG::Dimension::DIMENSION_REGEXP
       ChunkyPNG::Dimension.new($1, $2)
@@ -58,13 +57,13 @@ module ChunkyPNG
       end
     end
   end
+
   private_class_method :build_dimension_from_object
 
   # Class that represents the dimension of something, e.g. a {ChunkyPNG::Canvas}.
   #
   # This class contains some methods to simplify performing dimension related checks.
   class Dimension
-
     # @return [Regexp] The regexp to parse dimensions from a string.
     # @private
     DIMENSION_REGEXP = /^[\(\[\{]?(\d+)\s*[x,]?\s*(\d+)[\)\]\}]?$/
@@ -89,7 +88,7 @@ module ChunkyPNG
     end
 
     # Checks whether a point is within bounds of this dimension.
-    # @param [ChunkyPNG::Point, ...] A point-like to bounds-check.
+    # @param [ChunkyPNG::Point, ...] point_like A point-like to bounds-check.
     # @return [true, false] True iff the x and y coordinate fall in this dimension.
     # @see ChunkyPNG.Point
     def include?(*point_like)
@@ -98,17 +97,23 @@ module ChunkyPNG
     end
 
     # Checks whether 2 dimensions are identical.
-    # @param [ChunkyPNG::Dimension] The dimension to compare with.
+    # @param [ChunkyPNG::Dimension] other The dimension to compare with.
     # @return [true, false] <tt>true</tt> iff width and height match.
     def eql?(other)
       return false unless other.respond_to?(:width) && other.respond_to?(:height)
       other.width == width && other.height == height
     end
 
-    alias_method :==, :eql?
+    alias == eql?
+
+    # Calculates a hash for the dimension object, based on width and height
+    # @return [Integer] A hashed value of the dimensions
+    def hash
+      [width, height].hash
+    end
 
     # Compares the size of 2 dimensions.
-    # @param [ChunkyPNG::Dimension] The dimension to compare with.
+    # @param [ChunkyPNG::Dimension] other The dimension to compare with.
     # @return [-1, 0, 1] -1 if the other dimension has a larger area, 1 of this
     #   dimension is larger, 0 if both are identical in size.
     def <=>(other)
@@ -121,6 +126,6 @@ module ChunkyPNG
       [width, height]
     end
 
-    alias_method :to_ary, :to_a
+    alias to_ary to_a
   end
 end

data/lib/chunky_png/image.rb

@@ -1,18 +1,16 @@
 module ChunkyPNG
-
   # ChunkyPNG::Image is an extension of the {ChunkyPNG::Canvas} class, that
   # also includes support for metadata.
   #
   # @see ChunkyPNG::Canvas
   class Image < Canvas
-
     # The minimum size of bytes the value of a metadata field should be before compression
     # is enabled for the chunk.
     METADATA_COMPRESSION_TRESHOLD = 300
-    
+
     # @return [Hash] The hash of metadata fields for this PNG image.
     attr_accessor :metadata
-    
+
     # Initializes a new ChunkyPNG::Image instance.
     # @param [Integer] width The width of the new image.
     # @param [Integer] height The height of the new image.
@@ -23,7 +21,7 @@ module ChunkyPNG
       super(width, height, bg_color)
       @metadata = metadata
     end
-    
+
     # Initializes a copy of another ChunkyPNG::Image instance.
     #
     # @param [ChunkyPNG::Image] other The other image to copy.
@@ -31,7 +29,7 @@ module ChunkyPNG
       super(other)
       @metadata = other.metadata
     end
-    
+
     # Returns the metadata for this image as PNG chunks.
     #
     # Chunks will either be of the {ChunkyPNG::Chunk::Text} type for small
@@ -49,7 +47,7 @@ module ChunkyPNG
         end
       end
     end
-    
+
     # Encodes the image to a PNG datastream for saving to disk or writing to an IO stream.
     #
     # Besides encoding the canvas, it will also encode the metadata fields to text chunks.
@@ -61,19 +59,19 @@ module ChunkyPNG
     def to_datastream(constraints = {})
       ds = super(constraints)
       ds.other_chunks += metadata_chunks
-      return ds
+      ds
     end
-    
+
     # Reads a ChunkyPNG::Image instance from a data stream.
     #
     # Besides decoding the canvas, this will also read the metadata fields
     # from the datastream.
     #
-    # @param [ChunkyPNG::Datastream] The datastream to read from.
+    # @param [ChunkyPNG::Datastream] ds The datastream to read from.
     def self.from_datastream(ds)
       image = super(ds)
       image.metadata = ds.metadata
-      return image
+      image
     end
   end
 end

data/lib/chunky_png/palette.rb

@@ -40,12 +40,8 @@ module ChunkyPNG
       decoding_map = []
       index = 0
 
-      palatte_bytes = palette_chunk.content.unpack('C*')
-      if transparency_chunk
-        alpha_channel = transparency_chunk.content.unpack('C*')
-      else
-        alpha_channel = []
-      end
+      palatte_bytes = palette_chunk.content.unpack("C*")
+      alpha_channel = transparency_chunk ? transparency_chunk.content.unpack("C*") : []
 
       index = 0
       palatte_bytes.each_slice(3) do |bytes|
@@ -165,7 +161,7 @@ module ChunkyPNG
     #
     # @return [ChunkyPNG::Chunk::Transparency] The tRNS chunk.
     def to_trns_chunk
-      ChunkyPNG::Chunk::Transparency.new('tRNS', map { |c| ChunkyPNG::Color.a(c) }.pack('C*'))
+      ChunkyPNG::Chunk::Transparency.new("tRNS", map { |c| ChunkyPNG::Color.a(c) }.pack("C*"))
     end
 
     # Creates a PLTE chunk that corresponds with this palette to store the r,
@@ -186,7 +182,7 @@ module ChunkyPNG
         colors += ChunkyPNG::Color.to_truecolor_bytes(color)
       end
 
-      ChunkyPNG::Chunk::Palette.new('PLTE', colors.pack('C*'))
+      ChunkyPNG::Chunk::Palette.new("PLTE", colors.pack("C*"))
     end
 
     # Determines the most suitable colormode for this palette.
@@ -219,7 +215,6 @@ module ChunkyPNG
       when 3..4 then 2
       when 5..16 then 4
       when 17..256 then 8
-      else nil
       end
     end
   end

data/lib/chunky_png/point.rb

@@ -1,11 +1,10 @@
 module ChunkyPNG
-  
   # Factory method to create {ChunkyPNG::Point} instances.
-  # 
-  # This method tries to be as flexible as possible with regards to the given input: besides 
+  #
+  # This method tries to be as flexible as possible with regards to the given input: besides
   # explicit coordinates, this method also accepts arrays, hashes, strings, {ChunkyPNG::Dimension}
   # instances and anything that responds to <tt>:x</tt> and <tt>:y</tt>.
-  # 
+  #
   # @overload Point(x, y)
   #   @param [Integer, :to_i] x The x-coordinate
   #   @param [Integer, :to_i] y The y-coordinate
@@ -30,11 +29,11 @@ module ChunkyPNG
   # @see ChunkyPNG::Point
   def self.Point(*args)
     case args.length
-    when 2; ChunkyPNG::Point.new(*args)
-    when 1; build_point_from_object(args.first)
-    else raise ArgumentError, 
+    when 2 then ChunkyPNG::Point.new(*args)
+    when 1 then build_point_from_object(args.first)
+    else raise ArgumentError,
       "Don't know how to construct a point from #{args.inspect}!"
-    end 
+    end
   end
 
   def self.build_point_from_object(source)
@@ -46,20 +45,21 @@ module ChunkyPNG
     when Array
       ChunkyPNG::Point.new(source[0], source[1])
     when Hash
-      x = source[:x] || source['x']
-      y = source[:y] || source['y']
+      x = source[:x] || source["x"]
+      y = source[:y] || source["y"]
       ChunkyPNG::Point.new(x, y)
     when ChunkyPNG::Point::POINT_REGEXP
       ChunkyPNG::Point.new($1.to_i, $2.to_i)
-    else 
+    else
       if source.respond_to?(:x) && source.respond_to?(:y)
         ChunkyPNG::Point.new(source.x, source.y)
-      else 
-        raise ArgumentError, 
+      else
+        raise ArgumentError,
           "Don't know how to construct a point from #{source.inspect}!"
       end
     end
   end
+
   private_class_method :build_point_from_object
 
   # Simple class that represents a point on a canvas using an x and y coordinate.
@@ -69,7 +69,6 @@ module ChunkyPNG
   #
   # @see ChunkyPNG.Point
   class Point
-    
     # @return [Regexp] The regexp to parse points from a string.
     # @private
     POINT_REGEXP = /^[\(\[\{]?(\d+)\s*[,]?\s*(\d+)[\)\]\}]?$/
@@ -79,22 +78,22 @@ module ChunkyPNG
 
     # @return [Integer] The y-coordinate of the point.
     attr_accessor :y
-    
+
     # Initializes a new point instance.
     # @param [Integer, :to_i] x The x-coordinate.
     # @param [Integer, :to_i] y The y-coordinate.
     def initialize(x, y)
       @x, @y = x.to_i, y.to_i
     end
-    
+
     # Checks whether 2 points are identical.
     # @return [true, false] <tt>true</tt> iff the x and y coordinates match
     def eql?(other)
       other.x == x && other.y == y
     end
-    
-    alias_method :==, :eql?
-    
+
+    alias == eql?
+
     # Compares 2 points.
     #
     # It will first compare the y coordinate, and it only takes the x-coordinate into
@@ -106,21 +105,21 @@ module ChunkyPNG
     # @return [-1, 0, 1] <tt>-1</tt> If this point comes before the other one, <tt>1</tt>
     #   if after, and <tt>0</tt> if the points are identical.
     def <=>(other)
-      ((y <=> other.y) == 0) ? x <=> other.x : y <=> other.y
+      (y <=> other.y) == 0 ? x <=> other.x : y <=> other.y
     end
-    
+
     # Converts the point instance to an array.
     # @return [Array] A 2-element array, i.e. <tt>[x, y]</tt>.
     def to_a
       [x, y]
     end
-    
-    alias_method :to_ary, :to_a
-    
+
+    alias to_ary to_a
+
     # Checks whether the point falls into a dimension
-    # @param [ChunkyPNG::Dimension, ...] dimension_like The dimension of which the bounds 
+    # @param [ChunkyPNG::Dimension, ...] dimension_like The dimension of which the bounds
     #   should be taken for the check.
-    # @return [true, false] <tt>true</tt> iff the x and y coordinate fall width the width 
+    # @return [true, false] <tt>true</tt> iff the x and y coordinate fall width the width
     #   and height of the dimension.
     def within_bounds?(*dimension_like)
       ChunkyPNG::Dimension(*dimension_like).include?(self)

data/lib/chunky_png/rmagick.rb

@@ -1,33 +1,31 @@
-require 'rmagick'
+require "rmagick"
 
 module ChunkyPNG
-  
   # Methods for importing and exporting RMagick image objects.
   #
   # By default, this module is disabled because of the dependency on RMagick.
-  # You need to include this module yourself if you want to use it. 
+  # You need to include this module yourself if you want to use it.
   #
   # @example
   #
   #    require 'rmagick'
   #    require 'chunky_png/rmagick'
-  #    
+  #
   #    canvas = ChunkyPNG::Canvas.from_file('filename.png')
   #    image = ChunkyPNG::RMagick.export(canvas)
-  #    
+  #
   #    # do something with the image using RMagick
-  #    
+  #
   #    updated_canvas = ChunkyPNG::RMagick.import(image)
   #
   module RMagick
-    
     extend self
-    
+
     # Imports an RMagick image as Canvas object.
     # @param [Magick::Image] image The image to import
     # @return [ChunkyPNG::Canvas] The canvas, constructed from the RMagick image.
     def import(image)
-      pixels = image.export_pixels_to_str(0, 0, image.columns, image.rows, 'RGBA')
+      pixels = image.export_pixels_to_str(0, 0, image.columns, image.rows, "RGBA")
       ChunkyPNG::Canvas.from_rgba_stream(image.columns, image.rows, pixels)
     end
 
@@ -36,7 +34,7 @@ module ChunkyPNG
     # @return [Magick::Image] The RMagick image constructed from the Canvas instance.
     def export(canvas)
       image = Magick::Image.new(canvas.width, canvas.height)
-      image.import_pixels(0,0, canvas.width, canvas.height, 'RGBA', canvas.pixels.pack('N*'))
+      image.import_pixels(0, 0, canvas.width, canvas.height, "RGBA", canvas.pixels.pack("N*"))
       image
     end
   end